Table Of Contents

Cable Commands: show a through show cable l

show application-buckets

show bridge cable-modem

show cable admission-control

show cable arp-filter

show cable bundle

show cable bundle multicast

show cable burst-profile

show cable calls

show cable clock

show cable clock dti counters

show cable clock dti status

show cable device access-group

show cable dsg

show cable dsg tunnel

show cable filter

show cable flap-list

show cable flap-list wb-rf

show cable hop

show cable host access-group

show cable ib-ipc

show cable l2-vpn dot1q-vc-map

show cable leasequery-filter

show cable load-balance

show cable logging

Cable Commands: show a through show cable l

---

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

New Commands

Command	Cisco IOS Software Release
show cable clock dti counters	12.3(23)BC
show cable clock dti status,	12.3(23)BC
show cable ib-ipc	12.3(23)BC
show cable flap-list wb-rf	12.2(33)SCB

Modified Commands

Command	Cisco IOS Software Release
show cable admission-control	12.3(23)BC
show cable clock	12.3(23)BC
show cable filter	12.2(33)SCA
show cable l2-vpn dot1q-vc-map	12.2(33)SCA
show cable logging	12.3(23)BC5
show cable logging	12.2(33)SCB
show cable hop	12.3(23)BC7

Replaced Commands

Command	Replacement Command	Effective Cisco IOS Release
show cable dsg	show cable dsg tunnel	12.3(13a)BC

show application-buckets

To displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS, use the show application-buckets command in privileged EXEC mode. The configured rules for any given bucket are displayed in order of precedence in the Rule field.

show application-buckets [ bucket-no n ]

Syntax Description

bucket-no n

You may specify a specific bucket number on the Cisco CMTS to display parameters for that bucket and no others. Valid range is 1 to 8, or all buckets if no specific bucket is designated.

Command Default

No default behavior or values for this command. However, Cisco IOS Release 12.3(21)BC supports default operation and non-default configuration for feature on the Cisco CMTS.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(21)BC	This command was introduced for the Cisco uBR10012 router and the Cisco uBR7246VXR router.

Usage Guidelines

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

•Service Flow Admission Control for the Cisco Cable Modem Termination System

Examples

The following example illustrates sample output of the show application-buckets command.

Router# show cable application-type 

For bucket 1, Name PktCable 

     Packetcable normal priority gates

     Packetcable high priority gates

For bucket 2, Name PCMM-Vid 

     PCMM gate app-id = 30

For bucket 3, Name Gaming 

     PCMM gate app-id = 40

For bucket 4, Name  

For bucket 5, Name  

For bucket 6, Name  

For bucket 7, Name  

For bucket 8, Name HSD 

     Best-effort (CIR) flows

Related Commands

Command	Description
cable admission-control ds-bandwidth	Sets minor, major and exclusive thresholds for downstream voice or data bandwidth for each or all interfaces on the Cisco CMTS
cable admission-control preempt priority-voice	Changes the default PacketCable Emergency 911 call preemption functions on the Cisco CMTS, supporting throughput and bandwidth requirements for Emergency 911 calls above all other buckets on the Cisco CMTS.
cable admission-control us-bandwidth	Configures global or interface-level upstream bandwidth thresholds and exclusive or non-exclusive resources on the Cisco CMTS.
cable application-type include	Associates an application type with a specific and prioritized bucket on the Cisco CMTS.
cable application-type name	Assigns an alpha-numeric name for the specified bucket.
debug cable admission-control flow-categorization	Displays service flow categorization results, enabled when a service flow is classified.
show application-buckets	Displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS.
show interface cable admission-control reservation	Displays service flows, categorizations, and bandwidth consumption on the Cisco CMTS, for the specified interface, and the specified service flow direction.

show bridge cable-modem

To display bridging information for the router's cable interface, use the show bridge cable-modem command in privileged EXEC mode.

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

show bridge cable-modem number

Syntax Description

number

Identifies the cable interface (always 0).

Command Default

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3(4)NA	This command was introduced for the Cisco uBR904 cable access router.
12.0(4)XI1	Support was added for the Cisco uBR924 cable access router.
12.1(3)XL	Support was added for the Cisco uBR905 cable access router.
12.1(5)XU1	Support was added for the Cisco CVA122 Cable Voice Adapter.
12.2(2)XA	Support was added for the Cisco uBR925 cable access router.

Examples

The following example shows sample output for this show bridge cable-modem command:

Router# show bridge cable-modem 0 

Total of 300 station blocks, 298 free

Codes: P - permanent, S - self

Bridge Group 59:

Table 0-29 describes the significant fields shown in the display.

Table 0-29 show bridge cable-modem Field Descriptions

Field	Description
Total of 300 station blocks	Total number of forwarding database elements in the system. The memory to hold bridge entries is allocated in blocks of memory sufficient to hold 300 individual entries. When the number of free entries falls below 25, another block of memory sufficient to hold another 300 entries is allocated. Thus, the total number of forwarding elements in the system is expanded dynamically, as needed, limited by the amount of free memory in the router.
Bridge Group	The number of the bridge group to which this interface is assigned.

---

Tip In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.

---

Related Commands

Command	Description
show dhcp	Displays the current DHCP settings on point-to-point interfaces.
show interfaces cable-modem	Displays information about the cable interface.

show cable admission-control

To display the current admission control configuration and status on a Cisco CMTS router, or on a specified interface, use the show cable admission-control command in privileged EXEC mode.

show cable admission-control [global] [interface slot/port | slot/subslot/port] [all]

Syntax Description

global	(Optional)Displays the following information: •Parameters that have been configured for admission control •Number of requests that have crossed minor, major and critical levels for each resource
interface slot/port | slot/subslot/port	(Optional) Allows you to display admission control information for the specified interface or port. This includes the following: •Values for US throughput resources •Values for DS throughput resources The Cisco universal broadband routers differ in slot selection as follows: •slot/subslot/port—For the Cisco uBR10012 router, slot can range from 5 to 8, subslot can be 0 or 1, and port can be 0 to 4 (depending on the cable interface) •slot/port—On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
all	(Optional) Displays information for all interfaces configured for Admission Control on the Cisco CMTS.

Defaults

There are no default behaviors or values.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(13a)BC	This command was introduced on the Cisco uBR10012 router and the Cisco uBR7246VXR router.
12.3(23)BC	This command was updated; new fields were added to the output.

Usage Guidelines

This command offers flexible syntax that enables display of Admission Control as specifically configured on the Cisco CMTS. Refer to examples for additional information.

Examples

The following example illustrates upstream and downstream Admission Control information for the specified cable interface:

Router# show cable admission-control interface 7/0/0

Interface  Cable7/0/0

 Resource - Upstream Bandwidth 

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

Thresholds applicable to upstream ports with no interface level

 configurations in place

Bucket                  Minor          Major         Exclusive         Non-Excls

No                      Level          Level         Level             Level    

1                         0              0              0                 0

2                         0              0              0                 0

3                         0              0              0                 0

4                         0              0              0                 0

5                         0              0              0                 0

6                         0              0              0                 0

7                         0              0              0                 0

8                         0              0              0                 0

Downstream Bit Rate (bits per second) = 24273316

 Resource - Downstream Bandwidth

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

Bkt    Name   Minor # of  Major # of  Excls # of  Non-Ex Curr. Curr. Conf  # of

No            Level Times Level Times Level Times Level  Resv  Ovrsb Level Rej

1             0     0     0     0     0     0     100*    0.0   0.0  G       0

2             0     0     0     0     0     0     100*    0.0   0.0  G       0

3             0     0     0     0     0     0     100*    0.0   0.0  G       0

4             0     0     0     0     0     0     100*    0.0   0.0  G       0

5             0     0     0     0     0     0     100*    0.0   0.0  G       0

6             0     0     0     0     0     0     100*    0.0   0.0  G       0

7             0     0     0     0     0     0     100*    0.0   0.0  G       0

8             0     0     0     0     0     0     100*   12.3   0.0  G       0

 Note: * indicates that the thresholds are implicit

 Resource - Modular Downstream Bandwidth

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

Interface       Total(Kbps)       Reservable(Kbps)       Allocated(Kbps)

Mo1/0/0:0            19405                  12424                   3100

Table 30 describes the significant fields in the display above.

Table 30 show cable admission-control Field Descriptions for Upstream and Downstream Throughput 

Field	Description
Sched Type	Available for upstream only, this field displays the following information: •UGS—UGS thresholds configured and traffic rates. •RTPS—RTPS thresholds configured and traffic rates. •BE—Best Effort thresholds configured and traffic rates.
Flow Type	Available for Downstream only, this field displays voice and data information: •voice—Voice thresholds configured and traffic rates. •data—Data thresholds configured and traffic rates.
Class Name	Available for upstream only,
Minor Level	The minor threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	The number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Major Level	The major threshold as currently defined in a percentage on the Cisco CMTS.
# of Times	The number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Exclusive Level	The percentage of exclusive throughput that is reserved for the corresponding traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
# of Times	The number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
Non-Excls Level	The percentage of non-exclusive throughput configured on the Cisco CMTS. Commonly used with Best Effort (lowest priority) traffic.
Curr Reserv	Percentage of throughput reserved exclusively for the corresponding flow type.
Conf Level	The Configuration Level is intended to indicate the scope of configuration is actually applied for that US/ DS (whether the global, interface or the upstream level is applied). Values in this field can be as follows: •U—Upstream •I—Interface •G—Global

The following example illustrate all Admission Control information for the specified upstream port:

Router# show cable admission-control interface c8/0/1 upstream all

US   Sched  Class  Minor  # of    Major  # of   Excls  # of   Non-Ex  Curr.   Conf

Port type   Name   Level  Times   Level  Times  Level  Times  Level   Reserv  Level

0    UGS    -      23     0       27     0      30     0      5       22      U

0    RTPS   -      12     0       15     0      20     0      7       10      U

1    UGS    name1  30     10      35     10     40     9      5       34      I

The following example illustrates upstream and downstream Admission Control information for the specified interface:

Router# show cable admission-control interface c8/0/1

Interface c8/0/1:

Resource - Upstream Bandwidth

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

Sched   Class   Minor   # of    Major   # of   Exclusive # of    Non-Excls

Type    Name    Level   Times   Level   Times  Level     Times   Level

UGS     -       25      5       30      4      40        2       5

RTPS    -       14      0       18      0      25        0       5

BE      -       16      21      18      20     20        100     5

Resource - Downstream Bandwidth

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

Flow   Minor   # of    Major   # of    Excls   # of    Non-Excls   Curr.    Conf

Type   Level   Times   Level   Times   Level   Times   Level       Reserv   Level

voice  35      10      40      8       45      6       0           38       I

The following example illustrates upstream and downstream Admission Control information with the global keyword:

Router# show cable admission-control global

Resource    Minor   # times    Major   # times   Critical   # times   Current

cpu-5sec    50%     0         70%      0         90%        0         0

proc-mem    50%     0         70%      0         90%        0         0

io-mem      50%     1         60%      1         70%        1         75

total-mem   50%     0         70%      0         90%        0         0

Number of Packetcable voice calls = 80/100 (maximum)

Resource - Upstream Bandwidth

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

Sched   Class   Minor   # of    Major   # of    Exclusive   # of    Non-Excls

Type    Name    Level   Times   Level   Times   Level       Times   Level

UGS     -       25      5       30      4       40          2       5

UGS     name1   7       2       10      2       15          0       4

UGS     name2   10      1       15      1       20          1       4

RTPS    -       14      0       18      0       25          0       5

Resource - Downstream Bandwidth

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

Flow    Minor    # of    Major    # of     Exclusive   # of    Non-Excls

Type    Level    Times   Level    Times    Level       Times   Level

voice   35       10      40       8        45          6       0

Table 31 describes the significant fields for the global keyword used in the example above.

Table 31 show cable admission-control Field Descriptions with global Keyword

Field	Description
CM-Registration event	The counter increments once for every cable modem that crosses a threshold during its registration. For example, if the minor, major and critical thresholds on the Cisco CMTS are 60%, 70% and 80% respectively, and a cable modem tries to register when the current value is 80%, then the cable modem is allowed to register, but the counters for minor, major and critical thresholds are each incremented by one.
Voice-Call event	The counter increments if the resource check fails when a voice-call is made. For example, assume both the MTAs are on the same Cisco CMTS, and minor, major and critical thresholds for I/O memory are 50%, 60% and 70%, respectively. Then assume the current I/O memory value is 75%. In this scenario, before the gate creation, Admission Control performs an I/O memory check. This results in the counters for minor, major and critical thresholds each being incremented by one, and the voice call fails. No Packetcable gates are created because the voice calls fail.

Related Commands

Command	Description
cable admission-control	Configures the CPU and memory thresholds for the Cisco CMTS and supporting broadband processing engines (BPEs)
cable admission-control event	Configures and enables Admission Control event types on the Cisco CMTS.
cable admission-control ds-bandwidth	Configures Admission Control downstream bandwidth thresholds on the Cisco CMTS.
cable admission-control us-bandwidth	Configures Admission Control upstream bandwidth thresholds on the Cisco CMTS.
clear cable admission control counters	Clears all Admission Control resource counters on the Cisco CMTS.
debug cable admission-control	Enables automatic Admission Control troubleshooting processes on the Cisco CMTS.

show cable arp-filter

To display the total number of Address Resolution Protocol (ARP) replies and requests that have been sent and received, including the number of requests that have been filtered, use the show cable arp-filter command in privileged EXEC mode.

show cable arp-filter cable slot/port [ip-requests-filtered number] [requests-filtered number | replies-filtered number]

show cable arp-filter cable slot/subslot/port [ip-requests-filtered number] [requests-filtered number | replies-filtered number]

Syntax Description

cable slot/port	Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7246VXR router. On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
[ip-requests-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or forwarding more filtered ARP requests for IP packets than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default. Note This field shows the modems that are forwarding IP traffic that could be an part of an attack, such as TCP SYN floods, ping scans, and so forth.
[requests-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or forwarding more filtered ARP requests than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default.
[replies-filtered number]	(Optional) Displays the Service IDs (SIDs) that are generating or filtering more filtered ARP replies than the specified minimum number of packets. The valid range for number is 1 to 65535, with no default.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC2	This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers.
12.2(15)BC2b	The ip-requests-filtered option was added to display the specific Service IDs (SIDs) that are generating or forwarding a minimum number of ARP packets.

Usage Guidelines

The cable arp filter command enables the filtering of ARP request and reply packets on a cable interface. ARP packets might need to be filtered when a user on the cable network generates a large volume of ARP traffic as part of a theft-of-service or denial-of-service attack, or when a virus is using ARP requests to find other computers that it might infect.

The show cable arp-filter command displays the total number of ARP reply packets that have been received and the number of ARP request packets that have been sent on the cable interface, as well as the number of such packets that have been filtered.

---

Tip To clear the counters on all interfaces, use the clear counters command. To clear the counters on a specific interface, use the clear counters cable interface command.

---

Examples

The following example shows the typical output from the show cable arp-filter command on a Cisco uBR10012 router. The displays for other Cisco CMTS platforms are similar.

Router# show cable arp-filter Cable5/0/0 

ARP Filter statistics for Cable5/0/0:

  Replies Rcvd: 177387 total, 1869 unfiltered, 8824 filtered 

  Requests Sent For IP: 68625 total, 964 unfiltered, 36062 filtered 

  Requests Forwarded: 7969175 total, 7213 unfiltered, 366167 filtered 

Router# 

Table 0-32 describes the fields shown in the display.

Table 0-32 show cable arp-filter Field Descriptions 

Field	Description
Replies Rcvd
Total	Total number of ARP reply packets received on the cable interface since power-on.
Unfiltered	Number of ARP reply packets that the cable interface received and accepted while filtering was enabled using the cable arp filter reply-accept command.
Filtered	Number of ARP reply packets that the cable interface dropped while filtering was enabled, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter reply-accept command.
Requests Sent For IP
Total	Total number of ARP request packets that the cable interface was asked to forward since power-on.
Unfiltered	Number of ARP request packets that the cable interface sent while filtering was enabled using the cable arp filter request-send command.
Filtered	Number of ARP request packets that the cable interface dropped, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter request-send command.
Requests Forwarded
Total	Total number of ARP request packets that the cable interface was asked to forward to the ARP proxy since power-on.
Unfiltered	Number of ARP request packets that the cable interface sent to the ARP proxy while filtering was enabled using the cable arp filter request-send command.
Filtered	Number of ARP request packets for the ARP proxy that the cable interface dropped, because they would have otherwise exceeded the allowable threshold value that was configured for the interface using the cable arp filter request-send command.
Note All counters are 16-bit counters, with a maximum value of 65,535 packets. If the number of packets exceeds this amount, the counter wraps back to zero and begins incrementing again.

---

Note The Total counts in the show cable arp-filter command continue to increment, regardless of whether ARP filtering has been enabled. The Unfiltered and Filtered counts increment only when ARP filtering has been enabled using the cable arp filter command. When cable ARP filtering is disabled, these counters retain their current values until manually reset, using the clear counters command.

---

The following example shows how to display the devices that are generating or filtering more than 100 ARP requests per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c7/0/0 requests-filtered 100 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 50.3.81.4       12407          0                    0  

Router# show cable arp-filter c7/0/0 requests-filtered 100 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 50.3.81.4       14597          0                    0  

Router# 

The following example shows how to display the devices that are generating or filtering more than 200 ARP replies per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c5/0/0 replies-filtered 200 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.53b6.562f 50.3.81.6       0              0                    2358  

Router# show cable arp-filter c5/0/0 replies-filtered 200 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.53b6.562f 50.3.81.6       0              0                    4016 

Router# 

The following example shows how to display the devices that are generating or filtering more than 10 ARP requests for IP packets per reporting period. Repeat the command to see how quickly the device is generating ARP packets.

Router# show cable arp-filter c3/0 ip-requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

2    0006.2854.71e7 50.3.72.4       0              1926                 0

Router# 

Table 0-33 describes the fields shown in the display.

Table 0-33 show cable arp-filter Detail Field Descriptions 

Field	Description
SID	Service ID (SID) of the device.
MAC Address	Hardware (MAC-layer) address of the cable modem or CPE device.
IP Address	IP address of the cable modem or CPE device.
Req-Filtered	Total number of ARP requests that the device has generated or forwarded.
Req-For-IP-Filtered	Total number of ARP requests that the device has generated or forwarded for IP packets.
Rep-Filtered	Total number of ARP replies that the device has generated or forwarded.
Note The Req-Filter and Rep-Filtered counters are 16-bit counters, with a maximum value of 65,535 packets. If the number of packets exceeds this amount, the counter wraps back to zero and begins incrementing again.

Clearing the ARP Packet Counters

The following example shows the cable ARP counters being cleared by the clear counters cable interface command. This can be useful because the ARP counters are 16-bit counters that can wrap around to zero relatively quickly when large amounts of ARP traffic is being generated. Also, the ARP packet counters could include SIDs that had forwarded large amounts of ARP traffic in the past, but that are not currently forwarding such traffic. Clearing the counters allows you to clearly see the SIDS that are currently forwarding the ARP traffic that is triggering the ARP filters.

Router# show cable arp cable 3/0 

ARP Filter statistics for Cable3/0:

  Replies Rcvd: 3278 total. 84 unfiltered, 3194 filtered

  Requests Sent For IP: 941 total. 30 unfiltered, 911 filtered

  Requests Forwarded: 941 total. 37 unfiltered, 904 filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

1    0006.2854.72d7 10.3.81.4       8              0                    0

23   0007.0e02.b747 10.3.81.31      32             0                    0

57   0007.0e03.2c51 10.3.81.31      12407          0                    0

...

81   00C0.c726.6b14 10.3.81.31      23             0                    0

Router# clear counter cable 5/1/0 

Clear "show interface" counters on this interface [confirm] y 

08:17:53.968: %CLEAR-5-COUNTERS: Clear counter on interface Cable5/1/0 by console 

Router# show cable arp cable 5/1/0 

ARP Filter statistics for Cable3/0:

  Replies Rcvd: 0 total. 0 unfiltered, 0 filtered

  Requests Sent For IP: 0 total. 0 unfiltered, 0 filtered

  Requests Forwarded: 0 total. 0 unfiltered, 0 filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

57   0007.0e03.2c51 10.3.81.31      20             0                    0 

81   00C0.c726.6b14 10.3.81.31      12             0                    0 

Router# show cable arp-filter cable 5/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered   Req-For-IP-Filtered  Rep-Filtered

57   0007.0e03.2c51 10.3.81.31      31             0                    0 

81   00C0.c726.6b14 10.3.81.31      18             0                    0 

Router# 

---

Note The clear counters command clears all of the packet counters on an interface, not just the ARP packet counters.

---

Related Commands

Command	Description
cable arp	Activates cable Address Resolution Protocol (ARP).
cable arp filter	Controls the number of ARP packets that are allowable for each Service ID (SID) on a cable interface.
cable proxy-arp	Activates cable proxy ARP on the cable interface.
clear arp	Clears the ARP table on the router.
clear counters	Clears the packet counters on all interfaces or on a specific interface.
debug cable arp filter	Displays debugging messages about the filtering of ARP broadcasts.

show cable bundle

To display the forwarding table for the specified interface, use the show cable bundle in user EXEC or privileged EXEC mode.

show cable bundle n forwarding-table

Syntax Description

n	Specifies the bundle identifier. Valid range is from 1 to 255.
forwarding-table	Displays the forwarding table for the specified interface.

Command Modes

User EXEC or Privileged EXEC

Command History

Release	Modification
12.0(7)XR2	This command was introduced.
12.0(8) SC	This command was supported.
12.1(2) EC1	This command was supported.
12.2(4)BC1	Support was added to the Release 12.2 BC train.
12.1(13)EC, 12.2(11)BC1	The Flags, Location, link, and sublink fields were added to the display to aid in debugging.
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.

Usage Guidelines

•Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and configured to be in a virtual bundle after loading the software image.

•In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the virtual bundle disappears.

•Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly.

•The virtual bundle interface accumulates the counters from members; counters on member links are not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle counter on the members before adding them to the bundle, or before loading the image (for Cisco IOS Release 12.3(21)BC and later).

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

Examples

The following is a typical example of the show cable bundle command:

Router# show cable bundle 1 forwarding-table 

MAC address       Interface    Flags Location   link     sublink

00c0.5e01.0203    Cable8/0/0     3   64E5BF60   0        64E5BE00

00c0.5e01.0203    Cable7/0/0     3   64E5BE00   0        0 

00c0.5e01.0101    Cable8/0/0     3   64E5BEE0   0        64E5BE40

00c0.5e01.0101    Cable7/0/0     3   64E5BE40   0        0 

00c0.a375.cc1c    Cable8/0/0     1   64E5BEC0   0        0 

00c0.0e01.a835    Cable8/0/0     1   64E5BEA0   0        0 

00c0.0e01.a799    Cable8/0/0     1   64E5BDE0   0        0 

00c0.0e01.a405    Cable8/0/0     1   64E5BF00   0        0 

00c0.0e01.a5d1    Cable7/0/0     1   64E5BE20   0        0 

00c0.0e01.a5d9    Cable8/0/0     1   64E5BE60   0        0 

00c0.0e01.a5e1    Cable7/0/0     1   64E5BF40   0        0 

00c0.0e01.a5f1    Cable7/0/0     1   64E5BE80   0        0 

00c0.0eb4.0a41    Cable5/0/0     1   63704D1C   0        0

00c0.f03b.ed59    Cable6/1/0     1   6370427C   0        0

00c0.f03b.ed97    Cable6/1/0     1   63703F3C   0        0

00c0.0eb4.1373    Cable5/0/0     1   6370479C   0        0

00c0.f03b.edd3    Cable6/1/0     1   637042BC   0        0

00c0.7371.6df6    Cable5/0/0     1   63703DFC   0        0

Table 0-34 describes the fields shown in the show cable bundle command display.

Table 0-34 show cable bundle Command Field Descriptions 

Field	Description
MAC address	Identifies the MAC (hardware) address for each interface in the bundle.
Interface	Identifies the cable interface slot and port number.
Flag	The current value of the flag byte for this bundle entry. The following bits can be set: •Bit 0 (0x01) = Bundle is active. •Bit 1 (0x02) = Bundle is a static multicast group. Note If more than one bit is set, add the values together. For example, 3 indicates an active, static multicast group.
Location	The location in the router's memory for the flags byte for this bundle entry. This value is useful only to TAC engineers during debugging.
link	The value of the link pointer for this bundle entry. This value is useful only to TAC engineers during debugging.
sublink	The value of the sublink pointer for this bundle entry. This value is useful only to TAC engineers during debugging.

---

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.

---

The following example shows typical output for the show cable bundle fowarding-table command, supporting virtual interface bundling on the Cisco CMTS in later 12.3 BC Cisco IOS releases:

Router# show cable bundle 1 forwarding-table

MAC address       Interface    Flags Location   link     sublink

00c0.5e01.0203    Cable8/0/0     3   64E5BF60   0        64E5BE00

00c0.5e01.0203    Cable7/0/0     3   64E5BE00   0        0 

00c0.5e01.0101    Cable8/0/0     3   64E5BEE0   0        64E5BE40

00c0.5e01.0101    Cable7/0/0     3   64E5BE40   0        0 

00c0.a375.cc1c    Cable8/0/0     1   64E5BEC0   0        0 

00c0.0e01.a835    Cable8/0/0     1   64E5BEA0   0        0 

00c0.0e01.a799    Cable8/0/0     1   64E5BDE0   0        0 

00c0.0e01.a405    Cable8/0/0     1   64E5BF00   0        0 

00c0.0e01.a5d1    Cable7/0/0     1   64E5BE20   0        0 

00c0.0e01.a5d9    Cable8/0/0     1   64E5BE60   0        0 

00c0.0e01.a5e1    Cable7/0/0     1   64E5BF40   0        0 

00c0.0e01.a5f1    Cable7/0/0     1   64E5BE80   0        0 

00c0.0eb4.0a41    Cable5/0/0     1   63704D1C   0        0

00c0.f03b.ed59    Cable6/1/0     1   6370427C   0        0

00c0.f03b.ed97    Cable6/1/0     1   63703F3C   0        0

00c0.0eb4.1373    Cable5/0/0     1   6370479C   0        0

00c0.f03b.edd3    Cable6/1/0     1   637042BC   0        0

00c0.7371.6df6    Cable5/0/0     1   63703DFC   0        0

Total = 18, sublink total = 2 

Free = 1016, low_mark = 1016

Related Commands

Command	Description
cable bundle	Creates an interface bundle.
show ip interface brief	Displays a brief summary of an interface's IP information and status, to include virtual interface bundle information.
show pxf cable	Displays multicast echo, packet intercept, or source-verify features for one or all cable interfaces, to include information for virtual interface bundles.

show cable bundle multicast

To display Multicast information for the specified virtual interface bundle, based on IGMPv3, use the show cable bundle multicast command in privileged EXEC mode:

show cable bundle bundle# multicast group

show cable bundle bundle# multicast [ MAC addr | IP addr ]

Syntax Description

bundle#	The alphanumeric identifier for the virtual interface bundle.
group	Multicast group membership identifier.
MAC addr	Optional parameter specifies the MAC address for which to return information.
IP addr	Optional parameter specifies the IP address for which to return information.

Command Modes

User EXEC or Privileged EXEC

Command History

Release

Modification

12.3(21)BC

This command was introduced to support virtual interface bundling on the Cisco CMTS. 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.

Usage Guidelines

•Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and configured to be in a virtual bundle after loading the software image.

•In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the virtual bundle disappears.

•Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly.

•The virtual bundle interface accumulates the counters from members; counters on member links are not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle counter on the members before adding them to the bundle, or before loading the image (for Cisco IOS Release 12.3(21)BC and later).

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

Examples

The following example illustrates this new command. This command translates the bundle's multicast MAC address to Multicast IP address information, including the associated multicast source.

Router# show cable bundle bundle1.1 multicast

CableBundle  Interface   Source IP        Multicast IP     MAC Address

1            Bundle1.1   *                230.1.1.1        0100.5e00.0001

The following example illustrates multicast information for the specified virtual bundle:

Router# sh cable bundle 1 multicast 

CableBundle  Interface   Source IP        Multicast IP     MAC Address

1            Bundle1     *                239.0.0.100      0100.5e00.0001

To translate a MAC address back to Multicast IP address, use the following optional syntax:

show cable bundle bundle# multicast [ <MAC addr | IP addr >]

The following example illustrates this enhanced show command:

Router# show cable bundle bundleID multicast 0100.5e00.0001

MAC address       Interface    Flags Location   link     sublink

0100.5e00.0001    Bundle1        1   646FE4D8   0        646FE4EC

0100.5e00.0001    Cable6/0/0     1   646FE4EC   0        0

^^^^^^^^^^^^^^

Related Commands

Command	Description
cable bundle	Creates an interface bundle.
show ip interface brief	Displays a brief summary of an interface's IP information and status, to include virtual interface bundle information.
show pxf cable	Displays multicast echo, packet intercept, or source-verify features for one or all cable interfaces, to include information for virtual interface bundles.

show cable burst-profile

To display the upstream data burst profiles used to configure the upstream PHY, use the show cable burst-profile command in privileged EXEC mode.

show cable burst-profile

---

Note This command has been deprecated and removed in the current versions of the Cisco IOS software for all Cisco CMTS routers.

---

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3 NA	This command was introduced.
11.3(5)NA, 12.0(5)T1, 12.0(6)SC, 12.1(2)EC1	This command was removed and replaced with the show cable modulation-profile command.

Usage Guidelines

This command displayed configuration of the cable burst profiles, which were what DOCSIS initially used to control the data, ranging, and station maintenance bursts. The Cisco CMTS routers now support a more comprehensive set of modulation profiles, which are displayed by the show cable modulation-profilecommand.

---

Note The show cable burst-profile command displayed fields and values that were supported only in the initial versions of the DOCSIS specification. The current DOCSIS 1.0 and 1.1 specifications use different parameters and values, as shown by the show cable modulation-profile command.

---

Examples

The following example shows typical output from the show cable burst-profile command:

Router# show cable burst-profile 

Burst   Type Preamb Diff   FEC err FEC      Scrambl Max   Guard Last     Scrambl profile

number                             length           size  size  shortened

1       1    48     no     0x0     0x6      0x152   1     16    1         yes

2       1    48     no     0x0     0x6      0x152   1     12    1         no

3       1    48     no     0x5     0x2C     0x152   0     48    1         yes

4       1    48     no     0x5     0x2C     0x152   0     48    1         yes

5       1    48     no     0x5     0x32     0x152   0     20    1         yes

6       1    48     no     0x0     0x32     0x152   0     20    1         no

Router# 

Table 0-35 describes the fields shown in the show cable burst-profile command display.

Table 0-35 show cable burst-profile Field Descriptions

Field	Description
Burst profile number	The number of the burst profile.
Type	Type of burst profile.
Preamb length	Length of the preamble.
Diff encode	Shows if there is a diff encode.
FEC err correct	Shows the forward error correction.
FEC codeword length	Shows the length of the forward error correction codeword.
Scrambl seed	Shows the seed of the scrambler.
Max size	Designates the maximum burst size.
Guard size	Indicates the guard time size.
Last codeword shortened	Shows the last codeword shortened.
Scrambl	Indicates whether scramble is enabled (yes) or not (no).

---

Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.

---

Related Commands

Command	Description
cable upstream modulation-profile	Configures a spectrum group to use a specified frequency.
show cable hop	Displays CM configuration settings.
show cable modulation-profile	Displays the currently defined modulation profiles.
show interface cable sid	Displays cable interface information.

show cable calls

To display voice call history information and status for PacketCable Emergency 911 Services Listing and History, use the show cable calls command in privileged EXEC mode. This command displays voice call history information that is enabled with the cable high-priority-call-window command in global configuration mode.

show cable calls show cable calls [ interface cslot | slot/subslot ]

Syntax Description

interface	Selects the interface for which to enable PacketCable E911 call history.
slot | slot/subslot	Designates the slot or slot and port for a particular cable interface on the Cisco  router. The following are the valid values for the Cisco uBR7246VXR router: •slot can range from 3 to 6 The following are the valid values for the Cisco uBR10012 router: •slot = 5 to 8 •subslot = 0 or 1

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(13a)BC	This command was introduced supporting PacketCable Emergency 911 Services Listing and History on the Cisco CMTS: •Cisco uBR7246VXR router •Cisco uBR10012 router

Usage Guidelines

This command supports the PacketCable Emergency 911 Services Listing and History feature on the Cisco CMTS. Cisco IOS release 12.3(13a)BC introduces enhanced informational support for PacketCable Emergency 911 calls on the Cisco CMTS, to include the following information and related history:

•active Emergency 911 calls

•recent Emergency 911 calls

•regular voice calls

•voice calls made after recent Emergency 911 calls

To set the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911 calls, use the cable high-priority-call-window command in global configuration mode. To remove the call window configuration from the Cisco CMTS, use the no form of this command:

cable high-priority-call-window minutes

no cable high-priority-call-window

The following command example configures the call window on the Cisco uBR10012 router to be one minute in length:

Router(config)# cable high-priority-call-window 1

Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available in the following document on Cisco.com:

•PacketCable and PacketCable Multimedia for the Cisco CMTS

Examples

The following example illustrates call status on the Cisco CMTS:

Router# show cable calls

Interface   ActiveHiPriCalls  ActiveAllCalls  PostHiPriCallCMs  RecentHiPriCMs

Cable3/0    0                 0               0                 1              

Cable3/1    0                 0               0                 0              

Cable4/0    0                 0               0                 1              

Cable4/1    0                 0               0                 0              

Total       0                 0               0                 2              

Router #

The following command example illustrates that one Emergency 911 call was made on the Cable8/1/1 interface on the Cisco uBR10012 router during the window set for high priority calls:

Router# show cable calls

Interface   ActiveHiPriCalls  ActiveAllCalls  PostHiPriCallCMs  RecentHiPriCMs

Cable5/0/0  0                 0               0                 0              

Cable5/0/1  0                 0               0                 0              

Cable5/1/0  0                 0               0                 0              

Cable5/1/1  0                 0               0                 0              

Cable5/1/2  0                 0               0                 0              

Cable5/1/3  0                 0               0                 0              

Cable5/1/4  0                 0               0                 0              

Cable6/0/0  0                 0               0                 0              

Cable6/0/1  0                 0               0                 0              

Cable7/0/0  0                 0               0                 0              

Cable7/0/1  0                 0               0                 0              

Cable8/1/0  0                 0               0                 0              

Cable8/1/1  1                 1               0                 0              

Cable8/1/2  0                 0               0                 0              

Cable8/1/3  0                 0               0                 0              

Cable8/1/4  0                 0               0                 0              

Total       1                 1               0                 0 

Related Commands

Command	Description
cable high-priority-call-window	Sets the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911 calls.
show cable modem calls	Displays voice call information for a particular cable modem.

show cable clock

To display clock reference status information for the clock card and to display information about displaying Timing, Communicaton and Control (TCC) card DOCSIS Timimg Interface (DTI) client and server statistic counts, use the show cable clock command in user EXEC or privileged EXEC mode.

show cable clock [slot] {client port id | server port id | counters}

Syntax Description

slot	(Optional) Identifies a TCC interface on the Cisco RF Gateway 10. Valid TCC slots are 13 and 14.
client port id	Specifies the DTI client port ID. Valid port values are 1 and 2.
server port id	Specifies the DTI server port ID. Valid port values are 1 and 2.
counters	Specifies the DTI client counters.

Command Default

Information on the TCC DTI client and server is displayed. Counters are not displayed.

Command Modes

User EXEC or Privileged EXEC

Command History

Release	Modification
12.1(1a)T1	This command was introduced.
12.1(2)EC1	This command was supported on the EC train.
12.2(1)XF1, 12.2(4)BC1	This command was supported for the Cisco uBR10012 universal broadband router.
12.3(23)BC	This command was supported for DTI mode.
12.2(44)SQ	This command was modified in Cisco IOS Release 12.2(44)SQ to support the Cisco RF Gateway 10. The slot, client, server, and counters options were added.

Usage Guidelines

This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following configurations:

•A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national clock source.

---

Note Beginning in Cisco IOS Release 12.3(23)BC, TCC+ is replaced with DOCSIS Timing and Control Card (DTCC).

---

•A Cisco uBR7246 VXR router using a Cisco uBR-MC16S, Cisco uBR-MC16E, Cisco uBR-MC28C, or Cisco uBR-MC28C-BNC cable interface line card. The router must also be equipped with a Cisco cable clock card and be running Cisco IOS 12.1(1a)T1, 12.1(2)EC1, or a later release. The Cisco cable clock card should be connected to an external national clock source.

Only these cable interface cards support the external clock card reference from a clock card to distribute that signal to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will not synchronize their downstream SYNC messages with the external clock source.

Each CM or STB must also support VoIP applications and the clock feature set. For example, the Cisco uBR924, running Cisco IOS Release 12.0(7)T or later, supports clock card feature automatically.

---

Note This command does not appear if a clock card is not installed in the system.

---

Examples

The following sample output from the show cable clock command on a Cisco uBR7246VXR router shows that both external sources are available and the clock card is providing the clock reference:

Router# show cable clock 

Clockcard primary input is present

Clockcard secondary input is present

Cable clock reference is clockcard primary input

Cable3/0 Timestamp clock reference is from Clockcard 

Cable4/0 Timestamp clock reference is from Clockcard 

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that both external sources are available and that the TCC+ card in slot 1/1 is providing the clock reference:

Router# show cable clock 

Number of TCCplus Cards in the Chassis: 2

Active TCCplus Card is in slot: 1 subslot: 1

Backup TCCplus Card is in slot: 2 subslot: 1

Clock reference used by the active card is Primary T1 

External T1 References:

Card: 1/1

Primary T1  : Available

Secondary T1: Available

Card: 2/1

Primary T1  : Available

Secondary T1: Available

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that the TCC+ card in slot 1/1 is in maintenance mode, and that the TCC+ card in slot 2/1 is providing the clock reference:

Router# show cable clock 

Number of TCCplus Cards in the Chassis: 2

TCCplus card in 1/1 under maintenance

Active TCCplus Card is in slot: 2 subslot: 1

Clock reference used by the active card is Primary T1 

External T1 References:

Card: 2/1

Primary T1  : Available 

Secondary T1: Available 

---

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.

---

The following sample output from the show cable clock command on a Cisco uBR10012 router shows that the DTCC card in slot 1/1 is in DTI mode.

Router# show cable clock 

Number of TCC Cards in the Chassis: 1

Active TCC Card is in slot: 1 subslot: 1,(DTCC Eightbells card)

Clock reference used by the active card is DTI

Active TCC card in slot 1/1 

TCC Card 1/1 DTI status: 

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

    Active Client port             : 2 

    Active Client status           : normal 

    Active Client Server status    : freerun 

    Active Client frame error rate : < 2% 

    Active Client CRC error count  : 0xAD 

    Standby Client Signal detected : yes 

No card in slot 2/1 

Cisco RF Gateway 10

The following example shows the TCC DTI client and server statistic counts information:

Router# show cable clock

DTI Client status: TCC 13

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

Client status                  : normal

Client clock type              : ITU type 1

Client firmware version        : 7

Client dti version             : 0

Client timestamp               : 657519453

Client phase correction        : 65535

Client normal time             : 65535

Client holdover time           : 0

Client transition t3 count     : 0

Client transition t4 count     : 1

Client transition t6 count     : 0

Client transition t7 count     : 0

Client port switch count       : 1

Client Integral Frequency Term : 64518

Client EFC Value               : 63282

DTI Client Port 1 Status:

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

   Port Status             : Active

   Signal detected         : yes

   CRC error count         : 2

   Frame error rate        : < 2%

   Cable advance           : 2560

    -- Connected server information ---

    Server status                  : Active free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

DTI Client Port 2 Status:

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

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 66

   Frame error rate        : > 5%

   Cable advance           : 0

DTI Client status: TCC 14

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

Client status                  : normal

Client clock type              : ITU type 1

Client firmware version        : 7

Client dti version             : 0

Client timestamp               : 672169320

Client phase correction        : 65535

Client normal time             : 65535

Client holdover time           : 0

Client transition t3 count     : 0

Client transition t4 count     : 1

Client transition t6 count     : 0

Client transition t7 count     : 0

Client port switch count       : 1

Client Integral Frequency Term : 64760

Client EFC Value               : 63832

DTI Client Port 1 Status:

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

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 26

   Frame error rate        : > 5%

   Cable advance           : 0

DTI Client Port 2 Status:

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

   Port Status             : Active

   Signal detected         : yes

   CRC error count         : 2

   Frame error rate        : < 2%

   Cable advance           : 1792

    -- Connected server information ---

    Server status                  : Active free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

The following is sample output of a TCC card in slot 13 on a Cisco RF Gateway 10:

Router#show cable clock 13 client 1

DTI Client Port 1 Status:

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

   Port Status             : Inactive

   Signal detected         : no

   CRC error count         : 63006

   Frame error rate        : > 5%

   Cable advance           : 0x0000

Table 36 describes the significant fields shown in the display.

Table 36 show cable clock client Field Descriptions

Field	Description
Port status	Indicates the current status of the DTI port on the TCC card.
Signal detected	Indicates whether the DTI signal was detected.
CRC error count	The number of cyclic redundancy check (CRC) errors. It can indicate intermittent upstream, laser clipping, or common-path distortion.

The following example shows the server status of the TCC card in slot 13 on a Cisco RFGW-10:

Router#show cable clock 13 server 2

TCC Card 13 port 2 DTI Server status:

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

    Server signal detected         : yes

    Server status                  : free-run

    Root Server clock type         : ITU type 3

    Root Server source             : none

    Server Type                    : Root

    Client Performance Stable      : yes

    Client Cable advance Valid     : yes

    TOD Setting Mode               : Short

    TOD gpssec                     : 902825745

    TOD leap seconds               : 14

Table 37 describes the significant fields shown in the display.

Table 37 show cable clock server Field Descriptions

Field	Description
Server signal detected	Indicates whether the server was detected.
Server status	Indicates the state in which the serer is functioning. The states are warm-up, free-run state, fast mode, normal, holdover, or bridge mode.
Root server source	The server source such as internal, external, GPSor none.
Root server clock type	The clock type. The types are 1, 2, 3 or ITU Stratum 3 or DTI Min. clock.
TOD setting mode	Displays the time (user time, NTP, GPS) mode such as short or long.

The following is a sample output showing the counters on TCC card 13 on Cisco RFGW-10:

Router#show cable clock 13 counters

TCC Card 13 DTI counters:

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

    Client Normal time             : 0x1EB6

    Client Holdover time           : 0x0000

    Client Phase Correction        : 0

    Client Freq Correction         : 63213

    Client EFC Correction          : 61039

    Client transition count t3     : 0

    Client transition count t4     : 1

    Client transition count t6     : 0

    Client transition count t7     : 0

    Client port switch count       : 1

Related Commands

Command	Description
show controllers clock-reference	Displays hardware information, register values, and current counters for the cable clock card.
show cable clock dti status	Displays information on the DOCSIS Timing Interface (DTI) Client status.
cable clock free-run	Allows the clock to be in free-run mode.
clear cable clock counters	Clears DTI client transition counters of a TCC DTI client and server.

show cable clock dti counters

To display DTI counters for the clock card, use the show cable clock dti counters command in user EXEC or privileged EXEC mode.

show cable clock dti counters slot/subslot

Syntax Description

slot/subslot

Specifies the slot and subslot location of the DTCC ports. Valid values are 1/1 or 2/1.

Command Modes.

User EXEC or Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was supported for DTI mode.

Examples

The following is a sample output from the show cable clock dti counters command in user EXEC mode:

Router> show cable clock dti counters 1/1

TCC Card 1/1 DTI counters:

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

    Client Normal time             : 0xFFFF

    Client Holdover time           : 0x0000

    Client Phase Correction        : 0x0000

    Client Freq Correction         : 0xFBD7

    Client EFC Correction          : 0xF7AD

    Client transition count t3     : 0x00

    Client transition count t4     : 0x01

    Client transition count t6     : 0x00

    Client transition count t7     : 0x00

Related Commands

Command	Description
cable clock dti clear-counters	Resets the counters that are displayed with the show cable clock dti counters command.
show cable clock dti status	Displays information on the DOCSIS Timing Interface (DTI) Client status.

show cable clock dti status

To display information on the DOCSIS Timing Interface (DTI) Client status, use the show cable clock dti status command in privileged EXEC mode.

show cable clock dti status

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was introduced for the Cisco uBR10012 router.

Usage Guidelines

Use this command to display information on the DTI Client status.

Examples

The following is a sample output from the show cable clock dti command:

Router# show cable clock dti status

Status of DTI component:

Active TCC card in slot 1/1

TCC Card 1/1 DTI status:

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

    Active Client port             : 2

    Active Client status           : normal

    Active Client Server status    : freerun

    Active Client frame error rate : < 2%

    Active Client CRC error count  : 0x06

    Standby Client Signal detected : no

No card in slot 2/1

Related Commands

Command	Description
show cable clock	Displays clock reference status information for the clock card.

show cable device access-group

To display a list of CMs and their customer premises equipment (CPE) devices, along with their access groups, use the show cable device access group command in privileged EXEC mode.

show cable device [ip-address] access-group

---

Note The show cable device access-group command is not supported on the Cisco uBR10012 universal broadband router.

---

Syntax Description

ip-addr

(Optional) Specifies the IP address for a particular CM or host.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.NA	This command was introduced.
12.1(3a)EC1	Support was added to the Release 12.1 EC train.
12.2(4)BC1	Support was added to the Release 12.2 BC train for the Cisco uBR7100 series and Cisco uBR7200 series routers. (This command might appear in the CLI for the Cisco uBR10012 router but is not functional.)

Usage Guidelines

This command displays information about both CMs and their associated CPE devices. To display information only for hosts and other CPE devices, use the show cable host access-group command. To display information only for CMs, use the show cable modem 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.

Examples

The following example shows how to display a list of the CMs and their hosts:

Router# show cable device access-group 

MAC address      IP address      Type    Access-group

00d0.ba77.7595   10.20.114.34    modem   resident 

0020.4065.828c   10.27.29.128    modem   resident 

0080.c6f9.b42e   24.168.220.52   host

0020.7806.defe   192.168.28.134  host

0020.4066.5c5c   10.27.33.128    modem   resident 

0050.baa0.5ccd   24.168.223.251  host

0020.4070.56d8   10.27.29.129    modem   resident 

0050.046f.f4cf   192.168.33.25   host

0020.40b4.0c80   10.27.33.129    modem   resident 

0050.bacf.5d89   192.168.37.113  host

0020.4071.698e   10.27.29.130    modem   resident 

0050.1800.a8cb   192.168.33.90   host

0020.407a.c196   10.27.33.130    modem   resident 

0040.d00f.44f0   192.168.34.128  host

0020.407f.0c2c   10.27.33.131    modem   resident 

0050.e456.9641   192.168.39.66   host

0020.4071.65de   10.27.29.131    modem   resident 

0050.badd.2883   192.168.32.230  host

0020.4071.64b4   10.27.29.132    modem   resident 

0050.badd.3b12   192.168.33.246  host

00D0.ba41.41fc   10.27.33.132    modem   resident 

0020.78c7.f887   192.168.32.32   host

00D0.ba3d.871e   10.27.29.133    modem   resident 

00e0.2969.a1a5   192.168.36.246  host

00D0.ba40.fff3   10.27.29.135    modem   resident 

0020.78d5.ddf0   192.168.32.107  host

00001.02c5.9936   192.168.38.233 host

00D0.ba40.fe30   10.27.33.157    modem   resident 

0020.78d0.fb32   192.168.28.45   host

00D0.ba3b.e08d   10.27.33.158    modem   resident 

0050.1800.f458   192.168.36.209  host

0002.e301.df8f   192.168.30.191  host

00D0.ba3e.7b9c   10.27.29.158    modem   resident 

00a0.2451.b7eb   24.168.223.41   host

00D0.ba3c.3ff2   10.27.29.160    modem   resident 

0080.c7db.afba   192.168.33.153  host

00D0.2717.1899   192.168.39.189  host

00D0.ba33.a164   10.27.33.161    modem   resident 

Router# 

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

Table 0-38 Descriptions for the show cable device access-group Fields 

Field	Description
MAC Address	The MAC address for the CM or CPE device.
IP Address	The IP address that the DHCP server has assigned to the CM or CPE device.
Type	Identifies the type of device: •host = CPE device •modem = cable modem
Access-group	Displays the access group name or number in use (if any) for this CM or CPE device.

---

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 device	Configures the access list for a CM device or host.
cable host access-group	Configures the access list for the specified hosts.
clear cable host	Clears the host from the table.
show cable host access-group	Displays the hosts behind the CMs in the network, along with their access groups.
show cable modem access-group	Displays the access groups for the CMs on a particular cable interface.

show cable dsg

To display the current DOCSIS Set-Top Gateway (DSG) tunneling parameters, use the show cable dsg command in privileged EXEC mode.

show cable dsg {stats | tunnel} [vendor CA-vendor-name | tunnel-mac-address]

Syntax Description

stats	Displays configuration and run-time statistics about the currently-defined DSG tunnels.
tunnel	Displays the mapping of DSG tunnels to vendors or well-known MAC addresses.
vendor CA-vendor-name	(Optional) Displays information about a specific Conditional Access (CA) vendor. This parameter can be any arbitrary string up to 8 characters in length.
tunnel-MAC-address	(Optional) Displays information for the specified well-known MAC address for the DSG tunnel. If you specify a MAC address of 0000.0000.0000, the command displays information for all DSG tunnels, which is the default display.

Defaults

Displays information for all DSG tunnels.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(15)BC2	This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers.
12.3(9a)BC	This command was introduced on the Cisco uBR10012 router.
12.3(13a)BC	This command is obsolete and replaced by the show cable dsg tunnel command.

Examples

The following example shows a typical display for the show cable dsg tunnel form of the command:

Router# show cable dsg tunnel 

Group-ip        Src-ip          Tunnel-MAC      Interface   Packets   CA-vendor  

225.2.2.2       *               0001.0002.0003  Cable3/0    1589      BBB 

230.6.6.6       *               000d.000d.000d  Cable3/0    12868464  abc

230.7.7.7       *               000e.000e.000e  Cable3/0    24330138  abc

230.4.4.4       *               000b.000b.000b  Cable3/0    22008648  cisco

230.5.5.5       *               000c.000c.000c  Cable3/0    6424012   abc

229.1.1.1       *               0009.0009.0009  Cable3/0    12868440  cisco

228.1.1.1       *               0008.0008.0008  Cable3/0    6424012   cisco

230.1.1.1       *               000a.000a.000a  Cable3/0    24370812  cisco

230.8.8.8       *               000f.000f.000f  Cable3/0    23035116  abc

Router# 

The following example shows a typical display for the show cable dsg stats command:

Router# show cable dsg stats 

DSG statistics information

DSG keepalive is set

Vendor: DDD, Tunnel count: 1

Vendor: BBB, Tunnel count: 2

Vendor name is DDD, tunnel MAC is 0001.0002.0003

Group address is 226.2.2.2, source address is * 

  Interface is Cable5/1,   mapping entry is used 1

    Received 5968 packets,  forwarded 5289 packets

    Dropped 679 packets,  last second rate 16878 bits/sec

Vendor name is BBB, tunnel MAC is 0009.0010.0011

Group address is 227.2.2.2, source address is * 

  Interface is Cable3/0,  interface Cable3/0 is bundle master

  mapping entry is used 2

    Received 0 packets,  forwarded 0 packets

    Dropped 0 packets,  last second rate 0 bits/sec

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

    Received 5970056 packets,  forwarded 400333 packets

    Dropped 5569723 packets,  last second rate 96768 bits/sec

Router# 

The following example shows a typical display for the show cable dsg stats command for an individual vendor:

Router# show cable dsg stats vendor CCC 

DSG statistics information

DSG keepalive is set

Vendor: CCC, Tunnel count: 1

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

    Received 5970056 packets,  forwarded 400333 packets

    Dropped 5569723 packets,  last second rate 96768 bits/sec

Router# 

---

Note The packet counters for both the stats and tunnel options for a particular DSG tunnel continue to increase as long as traffic is received over that tunnel. If the tunnel does not receive any traffic for three minutes or more, the counters are automatically reset to 0.

---

The following example shows a typical display for the show cable dsg stats command for an individual vendor when the associated cable interface is shut down. The Received, Forwarded, and Dropped counters are not displayed when an interface is shut down.

Router(config)# interface c5/1 

Router(config-if)# shutdown 

Router(config-if)# exit 

Router(config)# exit 

Router# show cable dsg stats vendor CCC 

DSG statistics information

DSG keepalive is set

Vendor: CCC, Tunnel count: 1

Vendor name is CCC, tunnel MAC is 0005.0006.0007

Group address is 228.3.3.3, source address is * 

  Interface is Cable5/1,   mapping entry is used 2

Router# 

Table 39 describes the major fields shown in the show cable dsg command:

Table 39 show cable dsg Field Descriptions 

Field	Description
DSG keepalive is set	If keepalive messages have been enabled for an IP multicast group, using the cable dsg keepalive command, this message is displayed.
Dest-ip, Group address	Multicast group IP address for the DSG stream.
Src-ip, Source address	Source IP address for the DSG stream. If an asterisk (*) appears as the source IP address, it indicates that the source IP address is 0.0.0.0, which allows any IP address as the source IP address.
Mapped-MAC, Tunnel-MAC	Well-known MAC address used for the DSG tunnel. If you configured the DSG tunnel with a MAC address of 0000.0000.0000 using the cable dsg command, this field shows the MAC address that the CMTS derived using the MAC to IP multicast addressing mapping that is specified in RFC 1112.
Interface	Cable interface on which this DSG tunnel is configured.
mapping entry is used	Number of times that this particular DSG tunnel mapping has been used to resolve the well-known MAC address from the tunnel's group address. This can be used as a very rough approximation of the number set-top boxes (STBs) that have been mapped to this DSG tunnel since the last time the counter was cleared. Note Use the clear cable dsg command to clear this counter.
Packets	Number of packets transmitted over the DSG tunnel.
CA-vendor	Name for the Conditional Access (CA) vendor that owns this tunnel.
Received	Number of packets received by the multicast group. This counter includes all interfaces that are receiving traffic for the multicast group. The field is not shown when an interface is shut down, but the counter continues to increase as long as the multicast group is receiving traffic. When the interface is reenabled, the counter shows the latest number of packets received.
Forwarded	Number of packets forwarded on the cable interface for the multicast group. This counter is reset to 0 whenever an interface is shut down and reenabled. The field is not shown when an interface is shut down.
Dropped	Number of packets that were dropped that were for the multicast group. This counter includes all interfaces that are receiving traffic for the multicast group. The field is not shown when an interface is shut down, but the counter continues to increase as long as the multicast group is receiving traffic and dropping packets. When the interface is reenabled, the counter shows the latest number of packets dropped.

---

Note The Received and Dropped counters reflect activity for the multicast group and are not affected when a cable interface is shut down and reenabled, as long as the multicast group continues to receive traffic. The Forwarded counter reflects activity for the particular cable interface and is reset to zero whenever the interface is shut down and reenabled. All packet counters are also automatically reset to zero if the DSG tunnel does not receive traffic for three minutes or more.

---

Related Commands

Command	Description
cable dsg	Enables the DOCSIS Set-Top Gateway (DSG) on a cable interface, and configures its tunnel-mapping parameters.
cable dsg keepalive	Enables keepalive messages over DOCSIS Set-Top Gateway (DSG) tunnels on a cable interface.
clear cable dsg	Resets counters related to DOCSIS Set-Top Gateway (DSG) tunnels.
debug cable dsg	Enables the display of debugging messages for the operation of the DOCSIS Set-Top Gateway (DSG) feature.

show cable dsg tunnel

To display information about Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel configuration on a Cisco CMTS router, use the show cable dsg tunnel command in privileged EXEC mode.

show cable dsg tunnel tunnel-id [cfrs | clients | interfaces | statistics | verbose]

Syntax Description

tunnel-id	(Optional) Alphanumeric identifier for a specified tunnel.
cfrs	Show DSG tunnel classifiers.
clients	Show DSG tunnel clients.
interfaces	Show DSG tunnel interfaces.
stats	Show DSG tunnel statistics.
verbose	Show DSG tunnel detail information.

Defaults

No default behaviors or values

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.3(13a)BC	This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC	The output was modified to support A-DSG 1.2. •The "TG id" field was added to the show cable dsg tunnel and verbose forms of the command. •The "State" and "MAC Addr" fields switched places in the show cable dsg tunnel verbose form of the command. •The "vendor group" field was added to the show cable dsg tunnel clients form of the command.
12.2SB	This command was integrated into Cisco IOS Release 12.2SB. Support for the Cisco uBR7225VXR router was added.

Usage Guidelines

This command replaces the show cable dsg form of command available in Cisco IOS Release 12.3(9a)BC.

Examples

The following example displays CLI help for show cable dsg tunnel command syntax.

Router# show cable dsg tunnel 1 ?

cfrs        Show DSG tunnel classifiers

clients     Show DSG tunnel clients

interfaces  Show DSG tunnel interfaces

statistics  Show DSG tunnel statistics

verbose     Show DSG tunnel detail information

|           Output modifiers

<cr>

Examples: Displaying information about all A-DSG Tunnels

The following command displays tunnel MAC address, state, associated classifiers, and state information for Advanced-mode DSG version 1.1 tunnels on a Cisco CMTS router. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel

tunnel tunnel tunnel          cfr  cfr   tunnel in  rule rule  client service

id     state  mac-addr        id   state interface  id   state listId class

1      en     0100.5e01.0114  1    en    Cable6/0   1    en    2      SI

                              5    en               7    en    10    

                              11   en               8    en    2     

                              14   en               20   en    2     

                                         Cable6/1   1    en    4     

                                                    3    en    3     

                                                    4    en    4     

                                                    11   en    2     

2      en     0100.5e01.011e  2    en    Cable6/0   2    en    2      NDS-CA

                              10   en   

3      en     0100.5e01.0128  3    en    Cable6/0   3    en    3      NDS-APP

4      en     0100.5e01.0132  4    en    Cable6/0   4    en    4      MOTO-CA

5      en     0100.5e01.013c  9    en    Cable6/0   5    en    5      MOTO-APP

                                         Cable6/1   5    en    5     

6      dis    0100.5e01.0146             Cable6/0   6    en    6      SA-CA

                                         Cable6/1   6    en    6     

7      dis    0100.5e01.0150  7    en    Cable6/1   8    en    7      SA-APP

                              13   dis  

8      en     0100.5e01.0119  8    en                                 NDS-DNLD

9      en     0100.5e01.0133                                          MOTO-DNLD

10     en     0100.5e01.0147                                          SA-DNLD

11     en     2222.2222.2222                                          

12     en     3333.3333.3333  12   en                                 

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID ("TG id") field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel

     tunnel              TG      cfr     tunnel   rule   client service

id  state mac-addr       id    id  state I/F    id state listId class

1      en 0100.5e01.0001 1     1      en C5/0   1     en 1      DSG-Rate1

                               6      en

                               7      en

                               8      en

2      en 0100.5e01.0002 1     2      en C5/0   2     en 2

3      en 0100.5e01.0003 1     3      en C5/0   3     en 3

4      en 0002.0002.0001 2     4      en C5/0   4     en 1

                                         C5/1   1     en 1

5      en 0002.0002.0002 2     5      en C5/0   5     en 2      DSG-Rate2

                                         C5/1   2     en 2

6      en 0002.0002.0003 2     9      en C5/0   6     en 21

                                         C5/1   3     en 21

Examples: Displaying Information for a Specified A-DSG Tunnel

The following example displays the same information as the show cable dsg tunnel command, but for a specified tunnel. The following example shows sample output for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1

tunnel tunnel tunnel          cfr  cfr   tunnel in  rule rule  client service

id     state  mac-addr        id   state interface  id   state listId class

1      en     0100.5e01.0114  1    en    Cable6/0   1    en    2      SI

                              5    en               7    en    10    

                              11   en               8    en    2     

                              14   en               20   en    2     

                                         Cable6/1   1    en    4     

                                                    3    en    3     

                                                    4    en    4     

                                                    11   en    2     

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID ("TG id") field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel 1

     tunnel              TG      cfr     tunnel   rule   client service

id  state mac-addr       id    id  state I/F    id state listId class

1      en 0100.5e01.0001 1     1      en C5/0   1     en 1      DSG-Rate1

                               6      en

                               7      en

                               8      en

Examples: Displaying Information for A-DSG Tunnel Classifiers

The following example displays detailed information about all A-DSG classifiers associated with the specified tunnel.

Router# show cable dsg tunnel 1 cfrs

tunnel cfr   cfr   cfr destination ip   source ip        srcPre d_port d_port

id     id    state pri address          address          length start  end

1      1     en    1   230.1.1.20       0.0.0.0          32     0      65535 

       5     en    1   230.1.1.60       0.0.0.0          32     0      65535 

       11    en    1   224.25.25.134    0.0.0.0          32     0      65535 

       14    en    0   230.1.1.20       0.0.0.0          32     1000   2000  

Examples: Displaying Information for A-DSG Tunnel Clients

The following example displays detailed information about all the clients associated with the specified tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1 clients

tunnel client client client          client

id     listId id     id type         address

1      2      1      CA System ID    0X951         

              3      Broadcast                     

              8      MAC Addr        1111.1111.1111

       3      1      Application ID  0X1           

       4      1      CA System ID    0X701         

       10     1      Application ID  0X6           

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the "vendor group" field in support of A-DSG version 1.2 as shown below:

Router# show cable dsg tunnel 1 clients

tunnel client client client          client          vendor

id     listId id     id type         address         group

1      1      1      MAC Addr        0100.5e00.0001 

              2      Application ID  0x0951         

              3      Broadcast       Unspecified    

              4      Broadcast       4              

Examples: Displaying Information for A-DSG Tunnel Interfaces

The following example displays all the interfaces and rules associated with a specified tunnel.

Router# show cable dsg tunnel 1 interfaces 

tunnel downstream   rule

id     interface    id

1      Cable6/0     1   7   8   20  

       Cable6/1     1   3   4   11  

Examples: Displaying Information for A-DSG Tunnel Statistics

The following example displays the packets statistics information about the specified tunnel.

Router# sh cab dsg tunnel 1 statistics 

tunnel cfr   cfr   destination ip   source ip        total      total

id     id    state address          address          forwarded  received

1      1     en    230.1.1.20       0.0.0.0          0          0         

       5     en    230.1.1.60       0.0.0.0          0          0         

       11    en    224.25.25.134    0.0.0.0          0          0         

       14    en    230.1.1.20       0.0.0.0          0          0         

Examples: Displaying Detailed Information for a Specified A-DSG Tunnel

The following example shows all the detailed information about a specified tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).

Router# show cable dsg tunnel 1 verbose

Tunnel ID                     : 1

MAC Addr                      : 0100.5e01.0114

State                         : enable

Cfr Id                        : 1

State                         : enable

Priority                      : 1

Dest IP                       : 230.1.1.20

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 5

State                         : enable

Priority                      : 1

Dest IP                       : 230.1.1.60

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 11

State                         : enable

Priority                      : 1

Dest IP                       : 224.25.25.134

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 0

Dest Port End                 : 65535

Forwarded                     : 0

Received                      : 0

Cfr Id                        : 14

State                         : enable

Priority                      : 0

Dest IP                       : 230.1.1.20

Src IP                        : 0.0.0.0

Src Prefix Length             : 32

Dest Port Start               : 1000

Dest Port End                 : 2000

Forwarded                     : 0

Received                      : 0

Client List Id                : 2

Client Id                     : 1

Client Id Type                : CA System ID: 0951

Client Id                     : 3

Client Id Type                : Broadcast

Client Id                     : 8

Client Id Type                : MAC Addr: 1111.1111.1111

Client List Id                : 3

Client Id                     : 1

Client Id Type                : Application ID: 0001

Client List Id                : 4

Client Id                     : 1

Client Id Type                : CA System ID: 0701

Client List Id                : 10

Client Id                     : 1

Client Id Type                : Application ID: 0006

Interface                     : Cable6/0

Rule Id                       : 1

Rule Id                       : 7

Rule Id                       : 8

Rule Id                       : 20

Interface                     : Cable6/1

Rule Id                       : 1

Rule Id                       : 3

Rule Id                       : 4

Rule Id                       : 11

Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the "TG id" field in support of A-DSG version 1.2. The "State" and "MAC Addr" fields also switched positions in the output.

Router# show cable dsg tunnel 1 verbose 

Tunnel ID                                       : 1

State                                           : enable

MAC Addr                                        : 0100.5e01.0001

TG Id                                           : 1

Cfr Id                                          : 1

State                                           : enable

Priority                                        : 0

Dest IP                                         : 230.1.0.1

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 6

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.6

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 7

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.7

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Cfr Id                                          : 8

State                                           : enable

Priority                                        : 0

Dest IP                                         : 231.1.1.8

Src IP                                          : 0.0.0.0

Src Prefix Length                               : 32

Dest Port Start                                 : 0

Dest Port End                                   : 65535

Forwarded                                       : 0

Received                                        : 0

Client List Id                                  : 1

Client Id                                       : 1

Client Id Type                                  : MAC Addr        0100.5e00.0001

Client Id                                       : 2

Client Id Type                                  : Application ID  0x0951

Client Id                                       : 3

Client Id Type                                  : Broadcast       Unspecified

Client Id                                       : 4

Client Id Type                                  : Broadcast       4

Interface                                       : Cable5/0

Rule Id                                         : 1

Related Commands

Command	Description
debug cable dsg	Enables general, DCD or packet-related debugging.
show cable dsg tg	Displays information about A-DSG tunnel groups on a Cisco CMTS router.
show interface	Displays general interface information for the specified or all interfaces.
show interface cable dsg downstream	Displays A-DSG configuration and status information for downstream interfaces.

show cable filter

To display the DOCSIS 1.1 filter groups that are currently defined, use the show cable filter command in user EXEC or privileged EXEC mode.

show cable filter [group group-index [index index-num]] [verbose]

Syntax Description

group group-id	(Optional) Specifies the filter group to be displayed. The valid range is 1 to 256.
index index-num	(Optional) Specifies the index of the particular filter within a group to be displayed. The valid range is 1 to 128 on a uBR7200 series router and 1 to 255 on a uBR10012 router.
verbose	(Optional) Displays complete information about the filter groups in a format that is easier to read than the default display.

Command Modes

User EXEC, Privileged EXEC (#)

Command History

Release	Modification
12.1(6)EC1	This command was introduced on the Cisco uBR7100 series and Cisco uBR7200 series routers.
12.2(2)XF, 12.2(4)BC1	This command was supported on the Cisco uBR10012 routers.
12.2(8)BC2	An option was added to the cable filter group command to allow filter groups to be activated and deactivated without removing the filter group's configuration.
12.2(33)SCA	The output was changed to add fields for IPv6 information, including the "v6" field in the show cable filter command, and the "Source IPv6 Address," and "Destination IPv6 Address" fields of the show cable filter verbose command.

Examples

The following example shows a typical display of the show cable filter command:

Router# show cable filter 

 Filter SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action  Status

Grp Id                                                              Flags

1   1                                         256             137   0,0   drop active

1   2                      10.37.11.151/24    6               23    2,0   drop active

1   3                                         17        68    67    0,0   drop active

1   4                                         256             161   0,0   drop active

1   5                                         256             53    0,0   drop active

1   6                      10.37.11.151/29    256                         accept active

1   7   10.37.11.196/29    10.11.0.98/32      256                         accept active

1   8   10.37.11.195/32    10.11.0.98/32      6                           drop active

1   9   10.37.11.195/32    10.11.0.98/32      256                         accept active

1   10  10.37.11.194/32    10.11.0.98/16      6                           accept active

1   11  10.37.11.193/32    10.11.0.98/8       17                          drop active

1   12  10.37.11.192/32    10.11.0.98/32      6   F,F                     accept active

1   13  10.37.11.191/32    10.11.0.98/32      17  F,F                     accept active

1   14  10.37.11.190/32    10.11.0.98/24      17  8,F                     accept active

1   15  10.37.11.189/32    10.11.0.98/32      256 F,8                     drop active

1   16  10.37.11.189/32    10.11.0.98/32      256 F,8                     accept active

1   17  10.37.11.188/32    10.11.0.98/8       17                          accept active

1   18  10.37.11.188/32    10.11.0.98/32      6                           drop active

1   19  10.37.11.187/32    10.11.0.98/30      256                         accept active

1   20                     10.11.0.98/0       256                         drop active

Router#

The following shows typical output for the verbose form of this command:

Router# show cable filter group 10 index 10 verbose 

Filter Group                                : 1

Filter Index                                : 1

Matches                                     : 0

    Match action                            : accept

    Status                                  : active

Filter Group                                : 10

Filter Index                                : 10

Matches                                     : 0

    Source IP Address                       : 10.7.7.7/16

    Destination IP Address                  : 10.8.8.8/16

    IP Protocol type                        : 256

    IP ToS (Mask, Value)                    : 1, 2

    TCP/UDP Source Port                     : 2000

    TCP/UDP Destination Port                : 3000

    TCP Flags (mask, value)                 : 0, 0

    Match action                            : accept

    Status                                  : active

Router# 

IPv6 Examples

The following examples show examples of output for the show cable filter commands with changes beginning in Cisco IOS Release 12.2(33)SCA in support of IPv6 cable filter groups. Table 40 describes the output fields.

Router# show cable filter 

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Router# show cable filter group 254

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Router# show cable filter group 254 index 128

Filter    SrcAddr/Mask       DestAddr/Mask      Prot ToS  SPort DPort TCP   Action Status

Grp Id v6                                                             Flags

254 128Y  Use Verbose        Use Verbose                                    drop   active

Table 40 show cable filter Field Descriptions 

Field	Description
Filter Gp	ID number of the filter group. Defined by the group-id argument of the cable filter group command.
Filter Id	Index number of the filter group. Defined by the index-num argument of the cable filter group command.
v6	IP version 6 filter group type indicator. Defined by the ip-version keyword of the cable filter group command. Possible values are Y or N.
SrcAddr/Mask	•IP version 4—Filter source IP address and mask to be matched by the filter. Defined by the src-ip and src-mask keywords of the cable filter group command.. •IP version 6—"Use Verbose" appears because IPv6 addresses will not fit in the output display area; need to use the show cable filter group verbose command to view IPv6 addresses.
DestAddr/Mask	•IP version 4—Filter destination IP address and mask to be matched by the filter. Defined by the dest-ip and dest-mask keywords of the cable filter group command. •IP version 6—"Use Verbose" appears because IPv6 addresses will not fit in the output display area; need to use the show cable filter group verbose command to view IPv6 addresses.
Prot	IP protocol number(s) to be matched by the filter. Defined by the ip-proto keyword of the cable filter group command.
ToS	Type of Service mask and value to be matched by the filter. Defined by the ip-tos keyword of the cable filter group command.
SPort	TCP/UDP source port number to be matched by the filter. Defined by the src-port keyword of the cable filter group command.
DPort	TCP/UDP destination port number to be matched by the filter. Defined by the dest-port keyword of the cable filter group command.
TCP Flags	TCP flag mask and value to be matched by the filter. Defined by the tcp-flags keyword of the cable filter group command.
Action	Action to be taken on packet (accept or drop) when filter match occurs. Defined by the match-action keyword of the cable filter group command.
Status	Filter group status (active or inactive). Defined by the status keyword of the cable filter group command.

Router# show cable filter group 254 index 128 verbose

Filter Group                         : 254

Filter Index                         : 128

Filter Version                       : IPv6

Matches                              : 0

    Source IPv6 address              : 2001:33::20B:BFFF:FEA9:741F/128

    Destination IPv6 address         : 2001:1::224/128

    Match action                     : drop

    Status                           : active

Table 41 describes the output fields.

Table 41 show cable filter verbose Field Descriptions

Field	Description
Filter Group	ID number of the filter group. Defined by the group-id argument of the cable filter group command.
Filter Index	Index number of the filter group. Defined by the index-num argument of the cable filter group command.
Filter Version	IP version of the filter group. Defined by the ip-version keyword of the cable filter group command. Possible values are IPv4 or IPv6.
Matches: Source IP address or Matches: Source IPv6 address	•Source IP address—IPv4 source IP address and mask to be matched by the filter. Defined by the src-ip and src-mask keywords of the cable filter group command. •Source IPv6 address—IPv6 source IP address and prefix to be matched by the filter. Defined by the v6-src-address and v6-src-pfxlen keywords of the cable filter group command.
Matches: Destination IP address or Matches: Destination IPv6 address	•Destination IP address—IPv4 destination IP address and mask to be matched by the filter. Defined by the dest-ip and dest-mask keywords of the cable filter group command. •Destination IPv6 address—IPv6 destination IP address and prefix to be matched by the filter. Defined by the v6-dest-address and v6-dest-pfxlen keywords of the cable filter group command.
Matches: IP Protocol type	IP protocol number(s) to be matched by the filter. Defined by the ip-proto keyword of the cable filter group command.
Matches: IP ToS (Mask, Value)	Type of Service mask and value to be matched by the filter. Defined by the ip-tos keyword of the cable filter group command.
Matches: TCP/UDP Source Port	TCP/UDP source port number to be matched by the filter. Defined by the src-port keyword of the cable filter group command.
Matches: TCP/UDP Destination Port	TCP/UDP destination port number to be matched by the filter. Defined by the dest-port keyword of the cable filter group command.
Matches: TCP Flags (mask, value)	TCP flag mask and value to be matched by the filter. Defined by the tcp-flags keyword of the cable filter group command.
Matches: Match action	Action to be taken on packet (accept or drop) when filter match occurs. Defined by the match-action keyword of the cable filter group command.
Matches: Status	Filter group status (active or inactive). Defined by the status keyword of the cable filter group command.

Related Commands

Command	Description
cable filter group	Creates, configures, and activates a DOCSIS 1.1 filter group that filters packets on the basis of the TCP/IP and UDP/IP headers.

show cable flap-list

To display the cable flap-list on a Cisco CMTS, use the show cable flap-list command in user EXEC or privileged EXEC mode.

show cable flap-list

show cable flap-list [cable slot/port | cable slot/subslot/port][upstream port][sort-flap | sort-time]

show cable flap-list sort-interface [sort-flap | sort-time]

Syntax Description

cable slot/port	(Optional) Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers, where: •slot—Specifies the chassis slot number of the cable interface line card. •port—Specifies the downstream port number. Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.
cable slot/subslot/port	(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where: •slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8. •subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1. •port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
upstream port	(Optional) Displays the flap list for a particular upstream on the selected cable interface.
sort-interface	(Optional) Displays the flap list for all cable interfaces, sorted by interface.
sort-flap	(Optional) Sorts the list by the number of times the CM has flapped.
sort-time	(Optional) Sorts the list by the most recent time the CM is detected to have flapped.

Command Modes

User EXEC (>), Privileged EXEC (#)

Command History

Release	Modification
11.3 NA	This command was introduced.
12.0(3)T	This command was supported on the Cisco mainline release.
12.0(7)XR and 12.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.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

Usage Guidelines

The sort options operate differently on the different Cisco CMTS routers. On the Cisco uBR7100 series and Cisco uBR7200 series routers, the sort options apply to all cable interface line cards and merge the output into a single display.

On the Cisco uBR10012 router, the sort options apply to individual cable interface line cards. For example, the sort-time option sorts all of the flap entries on the first cable interface line card (c5/0/0), then the entries on the second card (c5/1/0), and so forth.

---

Note Occasionally, the show cable flap-list command might temporarily show duplicate entries for the same cable modem. This can occur after a cable modem has gone offline and before it has completed the registration process and come back online. When the cable modem does reach the online state, the duplicate entries disappear.

---

---

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 the output of the show cable flap-list command:

router# show cable flap-list 

MAC Address     Upstream     Ins   Hit   Miss  CRC   P-Adj Flap  Time

 0010.7bb3.fd19  Cable5/0/U1  0     2792  281   0    *45    58    Jul 27 16:54:50

 0010.7bb3.fcfc  Cable5/0/U1  0     19    4     0    !43    43    Jul 27 16:55:01

 0010.7bb3.fcdd  Cable5/0/U1  0     19    4     0    *3     3     Jul 27 16:55:01

---

Note The asterisk (*) in the P-Adj field indicates that a power adjustment has been made for that CM. The exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

---

The following example shows the display of flap-list tables sorted by MAC address:

router# show cable flap-list sort-flap 

Mac Addr           CableIF    Ins    Hit   Miss    CRC  P-Adj   Flap    Time

0010.1eab.2c0b     C6/0 U0    108    318     27      0      0    108 Sep 10 15:26:56 

0010.1eb2.bb07     C6/0 U0      0    293     31      1      1      1 Sep 10 15:15:49

0010.7b6b.71cd     C6/0 U0      1    288     32      0      0      1 Sep 10 15:12:13

0010.1eb2.bb8f     C6/0 U0      1    295     30      0      0      1 Sep 10 15:11:44

The following example shows the display of flap-list tables sorted by time:

Router# show cable flap-list sort-time 

Mac Addr       CableIF    Ins    Hit   Miss    CRC  P-Adj   Flap    Time

00e0.2222.2202 C4/0 U0    464   2069    242      0    421    885 Oct 16 22:47:23

0010.7b6b.57e1 C4/0 U0      0   2475     43      0   1041   1041 Oct 16 22:47:04

Table 42 describes the fields displayed by the show flap-list command.

Table 42 show cable flap-list Command Field Descriptions 

Field	Description
Mac Addr	The MAC address for the CM.
CableIF	The cable interface line card, including upstream, for this CM.
Ins	The number of times the CM 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 CM 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 CM 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 CM. It can indicate intermittent upstream, laser clipping, or common-path distortion.
P-Adj	The number of times the headend instructed the CM 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. CMs with high flap counts have high SIDs and might not register.
Time	The most recent time that the CM dropped the connection.

Related Commands

Command	Description
cable flap-list aging	Specifies the number of days to keep a CM in the flap-list table before aging it out of the table.
cable flap-list insertion-time	Sets the insertion time interval that determines whether a CM is placed in the flap list.
cable flap-list miss-threshold	Specifies the miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold	Specifies the power-adjust threshold for recording a CM flap-list event.
cable flap-list size	Specifies the maximum number of CMs that can be listed in the flap-list table.
clear cable flap-list	Clears all the entries in the flap-list table.
debug cable flap	Displays information about the operation of the CM flap list that is maintained for the cable interfaces.
ping docsis	Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate.
show cable modem	Displays information about all CMs on an interface or about a particular CM.
show cable modem flap	Displays flap list statistics for one or more cable modems.

show cable flap-list wb-rf

To display the wideband RF related data for all w-online cable modems, use the show cable flap-list wb-rf command in privileged EXEC mode.

show cable flap-list [cable slot/subslot/port] wb-rf [modular-cable slot/bay/port WB RF channel number] [QAM | MDD]

Syntax Description

cable slot/subslot/port	(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where: •slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8. •subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1. •port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
modular-cable slot/bay/port	(Optional) Displays information for all CMs on the specified modular cable interface on a Cisco uBR10012 router, where •slot—The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs. •bay—The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay). •port—Specifies the interface number on the SPA.
WB RF channel number	(Optional) Specifies the wideband RF channel number.
QAM	(Optional) Specifies the number of QAM flaps.
MDD	(Optional) Specifies the number of MDD flaps.

Command Modes

Privileged EXEC (#)

Command History

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

Usage Guidelines

None

Examples

The following is a sample output of the show cable flap-list wb-rf command:

router# show cable flap-list wb-rf

RF       Timeout Recover Failure Recover Flaps CM      Percent

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

3/0/0 1  1       1       0       0       1     3       33 

      2  0       0       1       0       1     3       33 

Related CommandsR

Command	Description
show cable flap-list	Displays the cable flap-list on a Cisco CMTS.
clear cable flap-list	Clears all the entries in the flap-list table.
debug cable flap	Displays information about the operation of the CM flap list that is maintained for the cable interfaces.
show cable modem flap	Displays flap list statistics for one or more cable modems.

show cable hop

To display cable-hop statistics on a Cisco CMTS, use the show cable hop command in user EXEC or privileged EXEC mode.

show cable hop [cable slot/port] [upstream uport] [history] [threshold]

show cable hop [cable slot/subslot/port ] [upstream uport] [history] [threshold]

Syntax Description

cable slot/port	(Optional) Specifies a cable interface on the Cisco uBR7100 series and Cisco uBR7200 series routers. On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	(Optional) Specifies a cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
upstream uport	(Optional) Specifies an upstream port for which to display the frequency hop status.
history	(Optional) Displays changes from one state to another, at any time and for any reason, for frequency, modulation, and channel width.
threshold	(Optional) Displays the user defined thresholds and current carrier-to-noise ratio (CNR), signal-to-noise ratio (SNR), correctable forward error correction (FEC) percentage, uncorrectable FEC percentage, and missed station maintenances percentage values of the upstreams.

Command Modes

User EXEC, Privileged EXEC

Command History

Release	Modification
12.0(4)XI	This command was introduced.
12.3(13a)BC	This command was enhanced with the addition of two new keywords, history and threshold.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
12.3(23)BC7	The output of the show cable hop history command is modified to include more information in the `change from' and `change to' fields of the output. Now, the modulation profile number is displayed when a change occurs, instead of the modulation order.

Examples

The following example shows typical output from the show cable hop command:

Router# show cable hop 

Upstream      Port       Poll Missed Min    Missed Hop   Hop     Corr    Uncorr

Port          Status     Rate Poll   Poll   Poll   Thres Period  FEC     FEC

                         (ms) Count  Sample Pcnt   Pcnt  (sec)   Errors  Errors

Cable4/0/U0   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U1   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U2   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U3   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U4   down       1000 * * *   frequency not set    * * * 0       0

Cable4/0/U5   down       1000 * * *   frequency not set    * * * 0       0

Cable5/0/U0   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U1   down       1000 * * *   frequency not set    * * * 0       0

Cable5/0/U2   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U3   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U4   down       1000 * * *   interface is down    * * * 0       0

Cable5/0/U5   down       1000 * * *   interface is down    * * * 0       0

Cable6/0/U0   down       1000 * * *   interface is down    * * * 0       0

Cable6/0/U1   22.000 Mhz 1000 * * *set to fixed frequency * * *  31375  1912

Cable6/0/U2   26.000 Mhz 1000 * * *set to fixed frequency * * *  0      0

Cable6/0/U3   admindown  1000 * * *   frequency not set   * * *  0      0

The following example shows typical output from the show cable hop upstream command:

Router# show cable hop c2/0 upstream 2 

Upstream    Port       Poll Missed Min    Missed Hop   Hop     Corr    Uncorr

Port        Status     Rate Poll   Poll   Poll   Thres Period  FEC     FEC

                       (ms) Count  Sample Pcnt   Pcnt  (sec)   Errors  Errors

Cable2/0/U2 admindown  1000 * * *   frequency not set    * * * 0       0      

Router# 

Table 43 describes the fields displayed by the show cable hop and show cable hop upstream commands.

Table 43 show cable hop Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
Port Status	Lists the status of the port. Valid states are down if frequency is unassigned or admindown if the port is shut down. If the port is up, this column shows the center frequency of the channel.
Poll Rate	The rate that station maintenance polls are generated (in milliseconds).
Missed Poll Count	The number of missing polls, per codeword/FEC block.
Min Poll Sample	The number of polls in the sample, per codeword/FEC block.
Missed PollPcnt	The ratio of missing polls to the number of polls, expressed as a percentage.
Hop Thres Pcnt	The level that the missed poll percentage must exceed to trigger a frequency hop, expressed as a percentage.
Hop Period	The maximum rate that frequency hopping will occur (in seconds).
Corr FEC Errors	The number of correctable forward error corrections (FEC) errors on this upstream port, per codeword/FEC block.
Uncorr FEC Errors	The number of uncorrectable FEC errors on this upstream port, per codeword/FEC block.
Note The show cable hop and show controllers cable commands display FEC errors per codewords, while the show interface cable upstream command displays FEC errors per packets, where a packet could contain multiple codewords.

The following example shows typical output from the show cable hop threshold command:

Router# show cable hop c6/0/0 threshold

Upstream SNR(dB) CNR(dB) CorrFEC% UncorrFEC% MissedSM% 

Port Val Thre1 Thre2 Val Thre1 Thre2 Pcnt Thre Pcnt Thre Pcnt Thre 

Ca6/0/0/U0 27   25   15    39   35   25    0    3    0    1           75   75 

Ca6/0/0/U1 31   25   15    51   35   25    0    3    0    1           90   75 

Ca6/0/0/U2 --   35   25    --   35   25    0    3    0    1           0    75 

Ca6/0/0/U3 --   35   25    --   35   25    0    3    0    1           0    75 

Table 44 describes the fields displayed by the show cable hop threeshold command.

Table 44 show cable hop threshold Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
SNR (dB)	The signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).
CNR (dB)	The current upstream carrier-to-noise ratio (CNR) for a particular cable modem (CM), in decibels (dB).
Corr FEC Errors	The number of correctable forward error corrections (FEC) errors on this upstream port, per codeword/FEC block.
Uncorr FEC Errors	The number of uncorrectable FEC errors on this upstream port, per codeword/FEC block.
Missed SM	The number of missing station maintenance polls, per codeword/FEC block.

The following example shows typical output from the show cable hop history command:

Router# show cable hop c8/1/1 upstream 0 history

F = Frequency Hop, M = Modulation Change, C = Channel Width Change

Upstream   Action             Chg    Chg    Action

Port       Time          Code From   To     Reason

C8/1/1 U0  Feb 20 12:21:29 M  142    141    SNR 28>=28 CFEC 0<=3 UnCFEC 0<=1

           Feb 20 12:09:08 F   0.000 24.000 Configuration changed

Table 45 describes the fields displayed by the show cable hop history command.

Table 45 show cable hop history Command Field Descriptions 

Field	Description
Upstream Port	The upstream port for this information line.
Action Time	The time of the spectrum management action.
Code	The code associated with the type of hop.
Chg From	The previous state of the spectrum management action.
Chg To	The current state of the spectrum management action.
Action Reason	The reason for changing the frequency.

Related Commands

Command	Description
cable spectrum-group hop period	Changes the minimum time between frequency hops.
cable spectrum-group hop threshold	Specifies a frequency hop threshold for a spectrum group.
cable upstream hop-priority	Configures the priority of the corrective actions to be taken when a frequency hop is necessary due to ingress noise on the upstream.
cable upstream modulation-profile	Configures up to three modulation profiles to an upstream port to activate Dynamic Upstream Modulation.
cable upstream threshold	Configures the upstream for the CNR and FEC threshold values to be used in determining the allowable noise levels.
cable upstream threshold hysteresis	Configures a hysteresis value to be used in conjunction with the dynamic modulation upgrade thresholds.
clear cable hop	Clears the forward error corrections (FEC) hop counters on one or all cable interfaces on a Cisco CMTS.
show cable host access-group	Displays the statistics for the host behind the CM.
show cable modem	Displays CM configuration settings.

show cable host access-group

To display the hosts and other customer premises equipment (CPE) devices behind the CMs in the network, along with their access groups, use the show cable host access-group command in privileged EXEC mode.

show cable host [ip-address | mac-address] access-group

---

Note The show cable host command is not supported on the Cisco uBR10012 universal broadband router.

---

Syntax Description

mac-addr	(Optional) Specifies the 48-bit hardware address for a particular CM or host.
ip-addr	(Optional) Specifies the IP address for a particular CM or host.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.NA	This command was introduced.
12.1(3a)EC1	Support was added to the Release 12.1 EC train.
12.2(4)BC1	Support was added to the Release 12.2 BC train for the Cisco uBR7100 series and Cisco uBR7200 series routers. (This command also appears in the CLI for the Cisco uBR10012 router but is not functional.)

Usage Guidelines

This command displays information only for hosts and other CPE devices. To display information for CMs and their associated CPE devices, use the show cable device access-group command. To display information only for CMs, use the show cable device 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.

Examples

The following example shows how to display all the hosts behind the CMs in the network:

router# show cable host access-group 

MAC address      IP address      Type    Access-group

0080.c6f9.b42e   24.168.220.52   host

0020.7806.defe   192.168.28.134  host

0050.baa0.5ccd   24.168.223.251  host

0050.046f.f4cf   192.168.33.25   host

0050.bacf.5d89   192.168.37.113  host

0050.1800.a8cb   192.168.33.90   host

0040.d00f.44f0   192.168.34.128  host

0050.e456.9641   192.168.39.66   host

0050.badd.2883   192.168.32.230  host

0050.badd.3b12   192.168.33.246  host

0020.78c7.f887   192.168.32.32   host

00e0.2969.a1a5   192.168.36.246  host

0020.78d5.ddf0   192.168.32.107  host

00001.02c5.9936  192.168.38.233  host

0020.78d0.fb32   192.168.28.45   host

0050.1800.f458   192.168.36.209  host

0002.e301.df8f   192.168.30.191  host

00a0.2451.b7eb   24.168.223.41   host

0080.c7db.afba   192.168.33.153  host

00D0.2717.1899   192.168.39.189  host

Router# 

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

Table 0-46 show cable host access-group Field Descriptions 

Field	Description
MAC Address	The MAC address for the CPE device.
IP Address	The IP address that the DHCP server has assigned to the CPE device.
Type	Identifies the type of device. With this command, this field should always be host to indicate a CPE device. Use the show cable device access-group or show cable modem access-group command to display information for CMs.
Access-group	Displays the access group name or number in use (if any) for this CPE device.

---

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 device	Configures the access list for a CM device or host.
cable host access-group	Configures the access list for the specified hosts.
clear cable host	Clears the host from the table.
show cable device access-group	Displays a list of CMs and their CPE devices, along with their access groups.
show cable modem access-group	Displays the access groups for the CMs on a particular cable interface.

show cable ib-ipc

To display the status of local IB IPC server and information on participating line cards, use the show cable ib-ipc command in privileged EXEC mode.

show cable ib-ipc {status | ports}

Syntax Description

status	Displays status of local IB IPC server.
ports	Displays information on participating line cards.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.3(23)BC	This command was introduced for the Cisco uBR10012 router.

Examples

The following is sample output from the show cable ib-ipc command. The command show cable ib-ipc ports displays the internal virtual channel identifiers and internal service flows for Ironbus based IPC.

Router# show cable ib-ipc ports

6/0: LCP High Priority VCCI 135, SFID 32891 

LCP Normal Priority VCCI 135, SFID 135 

8/0: LCP High Priority VCCI 153, SFID 32909 

LCP Normal Priority VCCI 153, SFID 153

show cable l2-vpn dot1q-vc-map

To display the mapping of one or all cable modems to IEEE 802.1Q Virtual Local Area Networks (VLANs) on the router's Ethernet interfaces, use the show cable l2-vpn dot1q-vc-map command in privileged EXEC mode.

show cable l2-vpn dot1q-vc-map [mac-address [vpn vpnid][verbose]] [customer cust-name][vpn vpnid]

Syntax Description

mac-address	(Optional) Displays the mapping for the cable modem with the specified hardware MAC address.
vpn vpnid	(Optional) Displays Layer 2 VPN information on a cable modem with the specified MAC address, or for the specified VPN ID across all cable modems.
verbose	(Optional) Displays additional information about the Layer 2 mapping, including the number of packets and bytes received on the upstream and downstream.
customer cust-name	(Optional) Displays the VLAN mappings for this particular customer name.

Defaults

Displays information for all cable modems that have a defined IEEE 802.1Q VLAN mapping.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC2	This command was introduced for Cisco uBR7246VXR universal broadband routers.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA on the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers. Support for the Cisco uBR7225VXR router was added. The vpn keyword was added and the output fields were modified to display L2VPN information.

Usage Guidelines

This command displays the cable modem to VLAN mappings that have been defined using the cable dot1q-vc-map command. It displays the MAC address, service ID (SID), and cable interface being used by the cable modem, and the interface and VLAN ID to which it has been mapped.

---

Tip The customer option displays only those VLAN mappings that have been configured with a particular customer name, using the cable dot1q-vc-map command.

---

The command also displays L2VPN information for cable modem traffic and service flows on CMTS router Ethernet interfaces that have been defined using the cable l2-vpn-service default-nsi command.

Examples

TLS in Cisco IOS Release 12.2BC Examples

The following example shows typical output for the show cable l2-vpn dot1q-vc-map command for all cable modems that are mapped to IEEE 802.1Q VLANs:

Router# show cable l2-vpn dot1q-vc-map 

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID   Priv Bits

0010.7bed.9c95 FE0/0.2                 3         Cable4/0    3     0 

0007.0e03.69f9 FE0/0.1                 4         Cable4/0    1     0 

Router# 

The following example shows typical output for a particular cable modem with the MAC address of 0001.0203.0405:

Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405 

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID   Priv Bits

0010.7bed.9c91 GE2/0                   5         Cable5/0    7     0 

Router# 

The following example shows a typical example for the verbose option:

Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405 verbose 

MAC Address                         : 0010.7bed.9c91 

Prim Sid                            : 7 

Cable Interface                     : Cable5/0 

Ethernet Interface                  : GigabitEthernet2/0 

DOT1Q VLAN ID                       : 5 

Total US pkts                       : 6 

Total US bytes                      : 1402 

Total DS pkts                       : 71 

Total DS bytes                      : 21975 

Table 47 describes the fields shown in the display.

Table 47 show cable l2-vpn dot1q-vc-map Field Descriptions 

Field	Description
MAC Address	Hardware (MAC) address for the CM being mapped.
Ethernet Interface	Destination interface (Ethernet, Fast Ethernet, or Gigabit Ethernet) for the VLAN being used for the mapping.
VLAN ID	Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet interface for the traffic coming from the CM.
Cable Intf	Cable interface to which the CM is connected.
SID	Primary service ID (SID) for this cable modem.
Priv Bits	Identifies the current settings of the two privacy bits in the extended header (EH) that is used for BPI-encrypted packets. •First bit = Enable bit. Set to 1 when BPI or BPI+ is enabled. •Second bit = Toggle bit. Matches the least-significant bit (LSB) of the key sequence number (KSN) in the EH. For example, a value of "0" indicates that BPI is not enabled. A value of "10" indicates that BPI is enabled and that the KSN is an even number. A value of "11" indicates that BPI is enabled and that the KSN is an odd number. Note For more information on these bits, see the DOCSIS Baseline Privacy Interface Plus Interface Specification (SP-BPI+-I08-020301 or later).
Total US pkts/bytes	Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by this cable modem.
Total DS pkts/bytes	Total number of packets and bytes received on the downstream from the Layer 2 tunnel by this cable modem.

L2VPN over Cable in Cisco IOS Release 12.2SB Examples

The following example shows sample output of VLAN information for all cable modems configured for L2VPN support:

Router# show cable l2-vpn dot1q-vc-map

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPN ID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of VLAN information for a VPN with ID 0234560001:

Router# show cable l2 dot1q-vc-map vpn 0234560001               

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPNID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of VLAN information for a VPN with ID 0234560001 on the cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001    

MAC Address    Ethernet Interface      VLAN ID   Cable Intf  SID  Customer Name/VPNID

0014.f8c1.fd66 GigabitEthernet4/0/0        68    Cable6/0/0  3    0234560001

The following example shows sample output of detailed VLAN information for a VPN with ID 0234560001 on the cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001 verbose

MAC Address                         : 0014.f8c1.fd66

Prim Sid                            : 3

Cable Interface                     : Cable6/0/0

VPN ID                              : 0234560001

L2VPN SAID                          : 12294

Upstream SFID                       : 23

Downstream CFRID[SFID]              : 2[24]

CMIM                                : 0x60

Ethernet Interface                  : GigabitEthernet4/0/0

DOT1Q VLAN ID                       : 68

Total US pkts                       : 1372

Total US bytes                      : 500226

Total US pkt Discards               : 0

Total US byte Discards              : 0

Total DS pkts                       : 1248

Total DS bytes                      : 415584

Total DS pkt Discards               : 0

Total DS byte Discards              : 0

The following example shows sample output of detailed VLAN information for a cable modem with MAC address 0014.f8c1.fd66:

Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 verbose

MAC Address                         : 0014.f8c1.fd66

Prim Sid                            : 3

Cable Interface                     : Cable6/0/0

L2VPNs provisioned                  : 1

DUT Control/CMIM                    : Enable/0xFFFFFFFF

VPN ID                              : 0234560001

L2VPN SAID                          : 12294

Upstream SFID                       : 23

Downstream CFRID[SFID]              : 2[24]

CMIM                                : 0x60

Ethernet Interface                  : GigabitEthernet4/0/0

DOT1Q VLAN ID                       : 68

Total US pkts                       : 1374

Total US bytes                      : 501012

Total US pkt Discards               : 0

Total US byte Discards              : 0

Total DS pkts                       : 1250

Total DS bytes                      : 416250

Total DS pkt Discards               : 0

Total DS byte Discards              : 0

Table 48 describes the fields shown in the display.

Table 48 show cable l2-vpn dot1q-vc-map with L2VPN Field Descriptions 

Field	Description
MAC Address	Hardware (MAC) address for the CM being mapped.
Prim Sid	Primary service ID for the CM.
Cable Interface	Cable interface to which the CM is connected.
L2VPNs provisioned	Number of L2VPNs supported by the CM.
DUT Control/CMIM	State of Downstream Unencrypted Traffic (DUT) filtering and Cable Modem Interface Mask (CMIM).
VPN ID	Identification number of the Layer 2 VPN tunnel.
L2VPN SAID	Layer 2 VPN Security Association Identifier (SAID).
Upstream SFID	Upstream Service Flow Identifier (SFID).
Downstream CFRID [SFID]	Downstream classifiers (classifier identifiers) and corresponding downstream service flows identifiers for this L2VPN.
CMIM	Cable Modem Interface Mask.
Ethernet Interface	Ethernet Network System Interface (NSI).
DOT1Q VLAN ID	Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet interface for the traffic coming from the CM.
Total US pkts/bytes	Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by this CM.
Total US pkt/byte Discards	Total number of packets and bytes dropped on the upstream to the Layer 2 tunnel by this CM.
Total DS pkts/bytes	Total number of packets and bytes received on the downstream from the Layer 2 tunnel by this CM.
Total DS pkt/byte Discards	Total number of packets and bytes dropped on the downstream from the Layer 2 tunnel by this CM.

Related Commands

Command	Description
cable l2-vpn-service dot1q	Enables the use of Layer 2 tunnels for the Customer Premises Equipment (CPE) traffic that is behind cable modems so that individual CPE traffic can be routed over a particular Virtual Local Area Network (VLAN).
cable dot1q-vc-map	Maps a cable modem to a particular VLAN on a local outbound Ethernet interface.
cable l2-vpn-service default-nsi	Configures an Ethernet Network System Interface for Layer 2 VPN support over cable.
debug cable l2-vpn	Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs.

show cable leasequery-filter

To display the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request messages that have been filtered for all cable modems (CMs) or for a particular cable interface, use the show cable leasequery-filter command in privileged EXEC mode.

show cable leasequery-filter [cable slot/port [requests-filtered [minimum-requests] ] ]

show cable leasequery-filter [cable slot/subslot/port [requests-filtered [minimum-requests] ] ]

Syntax Description

cable slot/port	(Optional) Displays information for all CMs on the specified cable interface and downstream port on the Cisco uBR7246VXR router. On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
cable slot/subslot/port	(Optional) Displays information for all CMs on the specified cable interface on the Cisco uBR10012 router. The following are the valid values: •slot = 5 to 8 •subslot = 0 or 1 •port = 0 to 4 (depending on the cable interface)
requests-filtered [minimum-requests]	(Optional) Displays the number of DHCP LEASEQUERY requests that have been filtered for each particular cable modem on a cable interface. •minimum-requests—(Optional) Displays only those cable modems for which the router has filtered at least this minimum number of lease queries. The valid range for minimum-requests is 1 to 65535, with a default of 1.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC1d, 12.2(15)BC2b	This command was introduced for the Cisco uBR7100 series, Cisco uBR7246VXR, and Cisco uBR10012 universal broadband routers.

Usage Guidelines

The show cable leasequery-filter command displays the total number of DHCP LEASEQUERY requests that have been filtered on a Cisco Cable Modem Termination System (CMTS) router and on a particular cable interface. This command can also optionally display details for each particular cable modem on an interface that has had DHCP lease queries filtered.

Examples

The following example shows how to display the total number of DHCP LEASEQUERY requests that have been filtered on the router and on a particular cable interface:

Router# show cable leasequery-filter 

Lease Query Filter statistics for Unknown Sid 

 Requests Sent : 138 total. 41 unfiltered, 97 filtered 

Router# show cable leasequery-filter cable 8/1/0 

Lease Query Filter statistics for Cable8/1/0:

 Requests Sent : 35 total. 25 unfiltered, 10 filtered

The following example shows how to display a list of cable modems on a cable interface and the number of DHCP LEASEQUERY messages that have been filtered for each:

Router# show cable leasequery-filter cable 8/1/0 requests-filtered 

Sid  MAC Address    IP Address      Req-Filtered

1    0050.7366.1243 92.1.1.20       0 

2    0007.0e06.953b 95.1.1.24       0 

3    0007.0e06.97b5 93.1.1.24       2 

4    00d0.ba45.4bd5 91.1.1.35       0 

5    0007.0e06.9773 95.1.1.23       12 

6    0001.42aa.737d 94.1.1.23       645 

7    0001.42aa.738b 95.1.1.22       0 

8    00d0.ba45.4955 92.1.1.23       0 

9    0007.0e06.51ef 94.1.1.25       0 

10   00d0.ba77.743b 91.1.1.36       3 

11   0001.42aa.6e6f 93.1.1.22       2 

12   0007.0e06.512f 91.1.1.23       2 

13   0007.0e06.5137 92.1.1.25       0 

14   0007.0e06.9be7 92.1.1.24       0 

15   0002.b970.0027 92.1.1.22       1 

16   0001.42aa.738d 91.1.1.21       10 

Router# 

The following example shows how to display a list of cable modems on a cable interface that have had 10 or more DHCP LEASEQUERY messages that have been filtered:

Router# show cable leasequery-filter cable 8/1/0 requests-filtered 10 

Sid  MAC Address    IP Address      Req-Filtered

5    0007.0e06.9773 95.1.1.23       12 

6    0001.42aa.737d 94.1.1.23       645 

16   0001.42aa.738d 91.1.1.21       10 

Router# 

Related Commands

Command	Description
cable arp	Activates the cable Address Resolution Protocol (ARP).
cable arp filter	Controls the number of ARP requests and replies that are forwarded on a cable interface.
cable source-verify	Enables verification of IP addresses for cable modems (CMs) and customer premises equipment (CPE) devices on the upstream.
cable source-verify leasequery-filter downstream	Controls the number of DHCP lease query messages that are sent for unknown IP addresses on all cable downstream interfaces on the Cisco CMTS router.
cable source-verify leasequery-filter upstream	Controls the number of DHCP lease query messages that are sent for unknown IP addresses per each service ID (SID) on an upstream.

show cable load-balance

To display real-time statistical and operational information for load-balancing operations on the router, use the show cable load-balance command in privileged EXEC mode.

show cable load-balance [group n] [all | load | pending | statistics | target]

Syntax Description

group n	(Optional) Specifies the number of the load-balance group to be displayed. The valid range is 1 to 20. The default is to display information for all load-balance groups.
all	(Optional) Display all information listed below.
load	(Optional) Displays current interface load and load-balance group assignments.
pending	(Optional) Displays list of cable modems that are currently being moved from one downstream or upstream to another.
statistics	(Optional) Displays cumulative statistics for load-balancing operations.
target	(Optional) Displays the current and target interfaces (upstreams and downstreams) that are being used for load balancing.

Defaults

Displays information for all load-balance groups for each cable interface and its current load and load-balancing status.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.2(15)BC1	This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers.

Usage Guidelines

Use the show cable load-balance command to display the current, real-time statistics for load-balancing operations.

Examples

The following example shows typical output for the default display for the show cable load-balance command:

Router# show cable load-balance 

Interface            State      Group Utilization  Reserved Modems Flows Weight

Cable6/1 (0 MHz)     down       0     0%(0%/0%)    0%       0      0     27   

Cable6/0 (0 MHz)     initial    0     0%(0%/0%)    0%       0      0     27   

Cable5/0 (0 MHz)     down       0     0%(0%/0%)    0%       0      0     27   

Cable4/1 (0 MHz)     down       0     0%(0%/0%)    0%       0      0     27   

Cable4/0 (0 MHz)     down       0     0%(0%/0%)    0%       0      0     27   

Cable3/1 (0 MHz)     down       0     0%(0%/0%)    0%       0      0     27   

Cable3/0 (0 MHz)     up         0     0%(0%/0%)    0%       31     68    27   

Cable3/0/U0          up         1     0%           0%       8      8     5.1

Cable3/0/U1          up         1     1%           0%       8      9     5.1

Cable3/0/U2          up         1     1%           0%       7      7     2.5

Cable3/0/U3          up         1     1%           0%       8      10    2.5

Router# 

The following example shows typical output for the all option for the show cable load-balance command. This option displays information that is displayed by all of the other options for this command.

Router# show cable load-balance all 

Group  Interval  Method      Threshold

                             Minimum  Static  Enforce  Ugs 

1      10        modems      5        10%     10%      70%

2      10        modems      5        10%     10%      70%

3      5         service-flo 5        5%      5%       70%

10     10        modems      5        10%     ---      ---

11     10        utilization ---      25%     25%      70%

Current load:

Interface            State      Group Utilization  Reserved Modems Flows Weight

Cable5/1/0 (459 MHz) up         1     25%(25%/8%)  0%       33     66    27   

Cable5/1/0/U0        up         1     7%           0%       29     29    2.5

Cable5/1/0/U1        up         1     7%           0%       29     29    2.5

Cable5/1/0/U2        up         1     15%          0%       29     29    2.5

Cable5/1/0/U3        up         1     6%           0%       30     30    2.5

Cable5/0/0 (669 MHz) up         1     6%(0%/6%)    0%       115    230   26

Cable5/0/0/U0        up         1     6%           0%       29     29    2.5

Cable5/0/0/U1        initial    1     0%           0%       0      0     2.5

Cable5/0/0/U2        down       1     0%           0%       0      0     2.5

Cable5/0/0/U3        down       1     0%           0%       0      0     2.5

Cable6/0/0 (663 MHz) up         1     20%(0%/20%)  0%       98     196   26

Cable6/0/0/U0        up         1     21%          0%       24     24    2.5

Cable6/0/0/U1        up         1     17%          0%       25     25    2.5

Cable6/0/0/U2        suspicious 1     11%          0%       25     25    2.5

Cable6/0/0/U3        up         1     32%          0%       24     24    2.5

Cable8/0/0 (453 MHz) up         1     9%(0%/9%)    7%       87     178   38   

Cable8/0/0/U0        up         1     9%           7%       87     89    10.2

Target assignments:

Interface            State      Group  Target

Cable5/1/0 (453 MHz) up         1      Cable5/0/0/2 (669 MHz) [enforce]

Cable5/1/0/U0        up         1 

Cable5/1/0/U1        up         1 

Cable5/1/0/U2        up         1 

Cable5/1/0/U3        up         1 

Cable5/0/0 (669 MHz) up         1 

Cable5/0/0/U0        up         1      Cable5/0/0/U1 [enforce]

Cable5/0/0/U1        initial    1 

Cable5/0/0/U2        down       1 

Cable5/0/0/U3        down       1 

Cable6/0/0 (663 MHz) up         1       453 MHz

Cable6/0/0/U0        up         1      Cable6/0/0/U2 [enforce]

Cable6/0/0/U2        up         1 

Cable6/0/0/U2        suspicious 1 

Cable6/0/0/U3        up         1 

Cable8/0/0 (453 MHz) up         1 

Cable8/0/0/U0        up         1 

Statistics:

Target interface     State      Transfers

                                Complete  Pending   Retries   Failures

Cable5/1/0 (453 MHz) up         0         0         0         0 

Cable5/1/0/U0        up         0         0         0         0 

Cable5/1/0/U1        up         0         0         5         0 

Cable5/1/0/U2        up         2         0         0         0 

Cable5/1/0/U3        up         4         0         0         0 

Cable5/0/0 (669 MHz) up         15        0         69        4 

Cable5/0/0/U0        up         33        0         1         0 

Cable5/0/0/U1        initial    22        0         11        0 

Cable5/0/0/U2        down       55        0         11        0 

Cable5/0/0/U3        down       29        0         12        0 

Cable6/0/0 (663 MHz) up         0         0         0         0 

Cable6/0/0/U0        up         12        0         0         0 

Cable6/0/0/U2        up         0         0         0         0 

Cable6/0/0/U2        suspicious 16        10        92        31 

Cable6/0/0/U3        up         0         0         0         0 

Cable8/0/0 (453 MHz) up         0         0         0         0 

Cable8/0/0/U0        up         0         0         0         18 

Pending:

Modem          Group  Source interface  Target interface      Retries

0005.5e48.cb49 1      Cable5/0/0U0       U1                   0

0000.39ef.0655 1      Cable6/0/0         453 MHz              0

0000.39ed.5256 1      Cable6/0/0         453 MHz              0

0000.39b2.264e 1      Cable6/0/0         453 MHz              0

0000.39ef.2455 1      Cable6/0/0         453 MHz              0

0000.39ef.e655 1      Cable6/0/0         453 MHz              0

0000.39eb.e855 1      Cable6/0/0         453 MHz              0

0000.39ed.7056 1      Cable6/0/0         Cable5/0/0 (663 MHz) 1

0000.3946.b056 1      Cable6/0/0         453 MHz              3

0000.39ef.2855 1      Cable6/0/0         453 MHz              0

0000.39b2.344e 1      Cable6/0/0         453 MHz              0

0000.3946.7c56 1      Cable6/0/0/U1      U2                   0

00a0.73b0.4bc7 1      Cable6/0/1         Cable6/0/0 (669 MHz) 1

Router#

Table 49 describes the fields shown in the show cable load-balance displays.

Table 49 show cable load-balance Field Descriptions (default display) 

Field	Description
Fields for the Default Displays and for the load Option
Interface	Cable interface (downstream or upstream) that belongs to a load-balance group.
Group	Number of the load-balance group to which this cable interface has been assigned.
Utilization	Current load usage for the cable interface, expressed as a percentage of the total bandwidth. For upstreams, this field shows a single percentage value, which shows the average percentage of bandwidth being used on that upstream. For downstreams, this field shows a set of three percentage values: •The first percentage shows the load usage for the entire interface. •The second percentage (within the parentheses) shows the load for the downstream. •The third percentage (within the parentheses) shows the average load for all upstreams on this downstream. For example, if this field shows "18%(18%/12%)", it indicates that the downstream and upstreams on the interface are running at an average load of 18 percent, the downstream itself is running at an average load of 18 percent, and all upstreams for this downstream are running at an average load of 12 percent. Note This field is a long-term average of the upstream utilization. To display a short-term average of the utilization, use the show interface cable mac-scheduler command.
State	Current state of the cable interface, as it affects load balancing operations. The following indicate normal operational states, depending on the configuration: •down—Interface is administratively shut down. The CMTS does not use the interface for load balancing. •initial—Interface is currently in the initialization phase. The CMTS will use the interface for load balancing after the initialization completes. •up—Interface is administratively up and should be passing traffic. The CMTS is actively using the interface for load balancing. •testing—Interface is currently under a load-balancing test. The CMTS will not use the interface for normal load balancing operations until the test completes. The following states are observed when there are issues with the LB operations. The CMTS is not using interfaces in these states for load balancing operations (except for the suspicious state), but continues to monitor them and update their status every time the CMTS polls the interfaces for their current load usage: •suspicious—Interface is in an unknown state. The interface might be up and passing traffic and supports load balancing operations. The CMTS attempts to re-initialize the interface after a timeout period. If that fails, the interface remains in suspicious state till the maximum number of retries (10) or the number of timer timeout attempts (3) have been exhausted. If the interface does not initialize even after exhausting the maximum number of retries or timeout attempts, the CMTS marks it as disabled. •disabled—Interface has been disabled because a load-balancing test is occurring or because the interface could not be initialized after 10 attempts. If a test is not occurring and the interface can still not be initialized, the CMTS marks the interface as unstable. •unstable—Interface has failed repeated initialization attempts. The CMTS will attempt to reinitialize the interface after a timeout period.
Reserved	Percentage of bandwidth that is currently reserved by unsolicited grant service (UGS) service flows.
Modems	Number of cable modems currently online this cable interface.
Flows	Number of active service flows currently on this cable interface.
Weight	Interface bandwidth, in megabits per second (mbps), for the downstream or upstream. The system uses this value in calculating whether the loads on the interfaces are balanced. Changing a channel parameter, such as modulation profile or channel width, that affects the channel's bandwidth also changes the weight value.
Additional Fields When Displaying Load-Balance Groups
Interval	How often, in seconds, the Cisco CMTS determines the current load on each cable interface in the load balance group, as configured using the cable load-balance group interval command.
Method	Load balancing method being used for this load balance group, as configured using the cable load-balance group (global configuration) command.
Threshold	Thresholds configured for this load balance group, as configured using the cable load-balance group threshold command: •Minimum = Minimum difference in the number of cable modems or service flows that can exist on two interfaces in the group before cable modems are moved between the interfaces. If the imbalance between interfaces is below this value, cable modems are not moved. This field contains a value only when the group is configured for the modems or service-flows method of load balancing. (This value is configured using the load minimum option of the cable load-balance group threshold command.) •Static = Minimum difference in the percentage of total load that must exist between interfaces in a load-balance group before the Cisco CMTS performs static load balancing. When the load between interfaces is greater than this value, cable modems that are in the process of registering with the CMTS are moved between interfaces until the load difference is again below this value. (This value is configured using the load option of the cable load-balance group threshold command.) •Enforce = Minimum difference in the percentage of total load that must exist between interfaces in a load-balance group before the Cisco CMTS performs dynamic load balancing and begins moving cable modems that are currently online. When the difference in load between two interfaces falls below this value, the CMTS stops dynamic load balancing and performs static load balancing. (This value is configured using the enforce option of the cable load-balance group threshold command.) •Ugs = Percentage of the bandwidth that is allocated for Unsolicited Grant Services (UGS) traffic, such as Voice-over-IP (VoIP), that is in use on an interface because the CMTS moves cable modems that are online with active UGS service flows. (This value is configured using the ugs option of the cable load-balance group threshold command.)
Additional Fields for the target Option
Interface	Source downstream or upstream interface that is part of a cable load balance group. If the Target field contains a value, this indicates that this source interface is currently oversubscribed, and that the CMTS is trying to reduce its load by moving cable modems from the source interface to the target interface.
Target	Downstream or upstream interface to which cable modems on the source interface are being moved as part of load balancing operations. This field can shown the following information: •If this is a downstream interface, the display also shows the center frequency for the downstream within the parentheses. •If only a frequency is shown, the CMTS is moving cable modems to a different center frequency on the same downstream interface. •When the display includes the words "enforce", it indicates that the CMTS is performing dynamic load balancing on the interfaces and is moving cable modems that are currently online. •If this field is blank, then the source interface is not currently oversubscribed, and the CMTS is not trying to reduce its load.
Additional Fields for the statistics Option
Target interface	Downstream or upstream interface. If this is a downstream interface, the display also shows the center frequency for the downstream within the parentheses.
Transfers	Counters that track the following statistics for the indicated target interface. •Complete = Number of cable modems that were successfully moved to the target interface. •Pending = Number of cable modems that are currently in the process of being moved to the target interface. •Retries = Number of times that the CMTS unsuccessfully tried to move the same cable modem to the target interface. The reason for the retries could be that one or MAC-layer messages to the cable modem were dropped because of RF noise, or because the cable modem is not DOCSIS-compliant. If the number of retries exceeds five for a particular cable modem, the CMTS counts this as a failure. •Failures = Number of times that the CMTS exceeded the maximum number of allowable retries (5) when trying to move a particular cable modem to the target interface. A large number of failures could indicate one or more of the possible problems: –The specific cable modems are not DOCSIS-compliant. –One or both interfaces are having problems passing traffic. –One or both interfaces are having persistent RF noise problems. –The source and target interfaces are not combined in the same node and do not share the same physical connectivity (which is required when interfaces are part the same load-balance group).
Additional Fields for the pending Option
Modem	Hardware (MAC) address for the cable modem that is current in the process of being moved as part of load balancing operations.
Source interface	Downstream or upstream cable interface on which the cable modem is currently online.
Target interface	Downstream or upstream cable interface to which the CMTS is trying to move the cable modem, so as to load balance the interfaces in this load balance group. If the CMTS is moving the cable modem to a different frequency on the same downstream interface, this field shows only the new center frequency.
Retries	Number of times that the CMTS has attempted to move this cable modem to the target interface. The CMTS attempts to move the cable modem five times before stopping any further attempts and counting this load balancing move as a failure.

Related Commands

Command	Description
cable load-balance exclude	Excludes a particular cable modem, or all cable modems from a particular vendor, from one or more types of load-balancing operations.
cable load-balance group (global configuration)	Creates and configures a load-balance group.
cable load-balance group (interface configuration)	Assigns a downstream to a load-balance group.
cable load-balance group interval	Configures the frequency of the load-balancing policy updates.
cable load-balance group policy ugs	Configures how the Cisco CMTS should load balance cable modems with active unsolicited grant service (UGS) service flows.
cable load-balance group threshold	Configures the threshold values that a load-balance group should use for load-balancing operations.
cable upstream load-balance group	Assigns an upstream to a load-balance group.
clear cable load-balance	Clears the counters or state machine used to track load-balancing operations.

show cable logging

To display the log of messages about bad IP source addresses on the cable interfaces, use the show cable logging command in user EXEC or privileged EXEC mode.

show cable logging [badipsource | summary] [slot]

Syntax Description

badipsource	Displays the contents of the error log buffer containing the error messages for bad IP source addresses.
summary	Displays the status of the logging feature and its buffer.
slot	(Optional) Displays the log for a particular cable interface on the Cisco uBR7200 series router. The slot parameter can range from 3 to 6, depending on the cable interface. Note This option is supported only on the Cisco uBR-MC16U/X, Cisco uBR10-MC5X20U, Cisco uBR10-MC5X20H and Cisco uBR-MC28U/X cable interface line card.

Command Modes

User EXEC (>)

Privileged EXEC (#)

Command History

Release	Modification
12.1(13)EC	This command was introduced for the Cisco uBR7100 series and Cisco uBR7200 series universal broadband routers.
12.2(11)CY	Support was added for the Cisco uBR10012 universal broadband router.
12.2(11)BC2	Support was added to the Release 12.2 BC train for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(15)CX	Support was added to display the log buffer on an individual Cisco uBR-MC28U/X cable interface line card on the Cisco uBR7200 series router.
12.2(15)BC2	Support was added for the Cisco uBR-MC16U/X, Cisco uBR10-MC5X20U and Cisco uBR10-MC5X20H cable interface line cards.
12.3(21)BC	This command was enhanced to support logging events tracked with the Cable Duplicate MAC Address Reject feature on the Cisco CMTS, when so configured. This supports the detection of cloned cable modems.
12.2(33)SCA	This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
12.3(23)BC5	The command output was modified to display the line card's CPU revision number.
12.2(33)SCB	This command was integrated into Cisco IOS Release 12.2(33)SCB.

Usage Guidelines

For additional information about the Cable Duplicate MAC Address Reject feature on the Cisco CMTS, or enforced DOCSIS 1.1 security, refer to the following document on Cisco.com:

•Cable Duplicate MAC Address Reject for the Cisco CMTS

The cable logging badipsource command creates a circular buffer that contains the BADIPSOURCE error messages that the Cisco CMTS generates when it discovers a CM or CPE device using an unauthorized IP address. If the buffer becomes full, the oldest messages are deleted to make room for the newer messages.

Use the show cable logging command to display the current contents of the buffer. After you have viewed all of the error messages in the current buffer, use the clear cable logging command to clear out the buffer to make room for newer messages.

Use the show cable logging summary command to check whether the logging feature is enabled and the status of the logging buffer.

The Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X) contain an onboard processor that also maintains its own log buffer. To display the contents of this log, add the card's slot number after the show cable logging command.

Examples

The following example shows a typical display of the show cable logging badipsource command. The oldest messages are displayed first.

Router# show cable logging badipsource 

00:01:19: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/1, IP packet from invalid source. 
IP=10.44.50.13, MAC=0050.0f02.1d15, Expected SID=1, Actual SID=1

00:01:26: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/1, IP packet from invalid source. 
IP=10.44.50.13, MAC=0050.0f02.1d15, Expected SID=1, Actual SID=1

01:49:33: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source. 
IP=0.0.0.44, MAC=0030.eb00.029d, Expected Interface=Cable6/1/0 SID=2833

02:12:03: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source. 
IP=0.0.0.44, MAC=0030.eb15.73bd, Expected Interface=Cable6/1/0 SID=2800

02:12:43: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source. 
IP=0.0.0.44, MAC=00e0.ca01.287a, Expected Interface=Cable6/1/0 SID=3299

02:22:50: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source. 
IP=0.0.0.44, MAC=0030.eb00.02a2, Expected Interface=Cable6/1/0 SID=394

The following example shows the display of the show cable logging badipsource command when logging has not been enabled with the cable logging badipsource command:

Router# show cable logging badipsource 

Cable logging: BADIPSOURCE Disabled

The following example shows a typical display for the summary option, showing whether logging is enabled, the total size of the buffer, how many bytes are currently used, and how many error messages have been logged since the buffer was last cleared.

Router# show cable logging summary 

Cable logging: BADIPSOURCE Enabled

                Total buffer size (bytes): 1000000

                Used buffer size (bytes) : 36968 

                Logged messages          : 231 

The following example shows a typical display for the summary option, indicating the line card's CPU revision number. The display given below is specific to the uBR7200 series routers.

Router# show cable logging summary slot 6

Current LC State Info for slot 6

CLC CPU: BCM1250(Rev A8/A10) 

 - Status - NO NPE/CLC OIR Timeout detected

Last Process Executed = Per-minute Jobs (4 ms count = 0ms)

Intr Busy Count = 0

Sched Flag Count = 2076

Status = 0x0

Late Poll Etime = 0

LC IPC Reply Status = 0

Interrupted PC/Level Trace

60475E5C/0x0        60475D98/0x0        60406D60/0x0        60406D70/0x0       

604754E4/0x0        60335188/0x0        60406D38/0x0        60475E50/0x0       

604761DC/0x0        60406D70/0x0        604761DC/0x0        60476994/0x0       

60407810/0x0        6047101C/0x0        60470EFC/0x0        60475E5C/0x0       

604759C0/0x0        60471014/0x0        60337F04/0x0        60406D4C/0x0       

60475E50/0x0        60473EB0/0x0        60475E54/0x0        60476150/0x0       

604761D4/0x0        604756FC/0x0        60407810/0x0        60337F80/0x0       

60335230/0x0        60475E94/0x0        60406D60/0x0        604756FC/0x0       

604761DC/0x0        60475694/0x0        60406CD4/0x0        60470EF0/0x0       

60475DBC/0x0        60406D38/0x0        60476954/0x0        604077D0/0x0       

60406CDC/0x0        60406CE0/0x0        609FA0C0/0x0        60470EFC/0x0       

604754DC/0x0        604077F0/0x0        60475E1C/0x0        60471018/0x0       

60337F58/0x0        60406D38/0x0        60475694/0x0        60475E3C/0x0       

60406D68/0x0        60337F50/0x0        60470EF0/0x0        60406D60/0x0       

604756A8/0x0        60406D38/0x0        60475DC4/0x0        60406D48/0x0       

Cable logging: BADIPSOURCE Disabled  Slot 6

 Cable logging: LAYER2EVENTS Disabled  Slot 6

 Cable logging: OVERLAPIP Disabled  Slot 6

Related Commands

cable logging badipsource	Logs error messages about bad IP source addresses on the cable interfaces.
cable source-verify	Enables verification of IP addresses for CMs and CPE devices on the upstream.
clear cable logging	Removes all error messages about bad IP source addresses on the cable interfaces from the error log buffer.