3.4. Show, Clear, and Debug Command Reference

3.4.1. Command Hierarchies

3.4.1.1. Show Commands

show
— router
— igmp
group [grp-ip-address] [hosts | interfaces | saps]
group summary [hosts | interfaces | saps]
group-interface [fwd-service service-id] [ip-int-name] [detail] [group] [grp-address]
hosts [detail] [fwd-service service-id] [grp-interface ip-int-name]
hosts [host ip-address] [group grp-address] [detail]
hosts summary
interface [ip-int-name | ip-address] [group] [grp-ip-address] [detail]
ssm-translate interface interface-name
static [ip-int-name | ip-addr]
statistics [ip-int-name | ip-address]
statistics group-interface [fwd-service service-id] [ip-int-name]
statistics host [ip-address]
status

3.4.1.2. Clear Commands

clear
— router
— igmp
database [group grp-ip-address [source src-ip-address]]
database interface {ip-int-name | ip-address} [group grp-ip-address [source src-ip-address]]
database host ip-address [group grp-ip-address [source src-ip-address]]
database host all [group grp-ip-address [source src-ip-address]]
database group-interface interface-name [fwd-service service-id] [group grp-ip-address [source src-ip-address]]
database group-interface all
statistics group-interface [fwd-service service-id] ip-int-name
statistics group-interface all
statistics host ip-address
statistics host all
statistics [interface ip-int-name | ip-address]
version group-interface [fwd-service service-id] ip-int-name
version group-interface all
version host ip-address
version host all
version [interface ip-int-name | ip-address]

3.4.1.3. Debug Commands

debug
— router
— igmp
[no] group-interface [fwd-service service-id] [ip-int-name]
[no] host [ip-address]
[no] host [fwd-service service-id] group-interface ip-int-name
[no] interface [ip-int-name | ip-address]
mcs [ip-int-name]
— no mcs
[no] misc
packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
packet [query | v1-report | v2-report | v3-report | v2-leave] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}] group-interface ip-int-name
packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
— no packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]
— no packet [query | v1-report | v2-report | v3-report | v2-leave] group-interface ip-int-name
— no packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address

3.4.2. Command Descriptions

3.4.2.1. Show Commands

The command outputs in the following section are examples only; actual displays may differ depending on supported functionality and user configuration.

group

Syntax 
group [grp-ip-address] [hosts | interfaces | saps]
group summary [hosts | interfaces | saps]
Context 
show>router>igmp
Description 

This command displays the multicast group and (S,G) addresses. If no grp-ip-address parameters are specified, then all IGMP group, (*,G) and (S,G) addresses are displayed.

Parameters 
grp-ip-address—
Displays specific multicast group addresses.
hosts—
Displays hosts for the multicast group address.
interfaces—
Displays interfaces for the multicast group address.
saps—
Displays SAPs for the multicast group address.
Output 

The following is an example of IGMP group information. Table 3 describes the output fields for IGMP group information.

Sample Output
*B:Dut-C# show router igmp group 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups
===============================================================================
(*,239.0.0.1)
    Fwd List  : 239.112.1.2            Up Time : 0d 00:00:21
(10.11.0.1,239.0.0.1)
    Fwd List  : 239.112.1.1            Up Time : 0d 00:00:30
    Blk List  : 239.112.1.2            Up Time : 0d 00:00:21
(10.11.0.2,239.0.0.1)
    Fwd List  : 239.112.1.1            Up Time : 0d 00:00:30
(*,239.0.0.2)
    Fwd List  : 239.112.1.2            Up Time : 0d 00:00:21
(10.11.0.1,239.0.0.2)
    Blk List  : 239.112.1.2            Up Time : 0d 00:00:21
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C# 
 
*B:Dut-C# show router igmp group summary 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups Summary          Nbr Fwd Hosts          Nbr Blk Hosts
===============================================================================
(*,239.0.0.1)                     1                      0
(10.11.0.1,239.0.0.1)             1                      1
(10.11.0.2,239.0.0.1)             1                      0
(*,239.0.0.2)                     1                      0
(10.11.0.1,239.0.0.2)             0                      1
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C# 
 
A:NYC# show router igmp group 239.24.24.24
===============================================================================
IGMP Groups
===============================================================================
(*,239.24.24.24)                       Up Time : 0d 05:23:23
    Fwd List  : nyc-vlc
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 1
===============================================================================
A:NYC#
Table 3:  IGMP Group Information Output Fields  

Label

Description

IGMP Groups

The IP multicast sources corresponding to the IP multicast groups.

Fwd List

The list of interfaces in the forward list.

Blk List

The list of interfaces in the blocked list.

group-interface

Syntax 
group-interface [fwd-service service-id] [ip-int-name] [detail] [group] [grp-address]
Context 
show>router>igmp>group-interface
Description 

This command displays IGMP group-interface information.

Parameters 
service-id
Specifies the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

ip-int-name—
Specifies an IP interface name, up to 32 characters.
detail—
Displays detailed information.
group—
Displays information for the group IP address.
grp-address—
Displays information for the group IP address in the multicast group address format or zero.

hosts

Syntax 
hosts [detail] [fwd-service service-id] [grp-interface ip-int-name]
hosts [host ip-address] [group grp-address] [detail]
hosts summary
Context 
show>router>igmp
Description 

This command displays IGMP hosts information.

Parameters 
grp-address—
Specifies the group IP address.
service-id
Specifies the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

ip-int-name—
Specifies an IP interface name, up to 32 characters.
ip-address—
Specifies an IP address.
Output 

The following output is an example of IGMP host information.

Sample Output
*B:Dut-C# show router igmp hosts 
===============================================================================
IGMP Hosts
===============================================================================
Host            Oper    Oper    Fwd   GrpItf            Num    Subscriber      
                State   Version Svc                     Groups                 
-------------------------------------------------------------------------------
239.112.1.1     Up      3       1     gi_1_1            1      sub_1           
239.112.1.2     Up      3       1     gi_1_1            2      sub_1           
239.112.1.3     Up      3       1     gi_1_2            0      sub_2           
-------------------------------------------------------------------------------
Hosts : 3
===============================================================================
*B:Dut-C# 
 
*B:Dut-C# show router igmp hosts detail 
===============================================================================
IGMP Host 239.112.1.1
===============================================================================
Oper Status      : Up         MacAddress     : 00:00:00:00:00:01
Oper version     : 3          Subscriber     : sub_1
Num Groups       : 1          GrpItf         : gi_1_1
Max Grps Till Now: 2          IGMP-Policy    : pol1
PPPoE SessionId  : 1          Next query time: 0d 00:02:03
FwdSvcId         : 1                                                            
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address    : 239.0.0.1      Up Time    : 0d 00:00:24
Expires          : Not running    Mode       : Include
V1 Host Timer    : Not running    Type       : Dynamic
V2 Host Timer    : Not running    Compat Mode: IGMP Version 3
Redir.vRtrId     : N/A            Redir.Intf : N/A
-----------------------------------------------------------
Source Address     Expires        Type         Fwd/Blk 
-----------------------------------------------------------
10.11.0.1          0d 00:03:56    Dynamic      Fwd        
10.11.0.2          0d 00:03:56    Dynamic      Fwd 
===============================================================================
IGMP Host 239.112.1.2
===============================================================================
Oper Status      : Up         MacAddress     : 00:00:00:00:00:01
Oper version     : 3          Subscriber     : sub_1
Num Groups       : 2          GrpItf         : gi_1_1
Max Grps Till Now: 2          IGMP-Policy    : pol1
PPPoE SessionId  : 2          Next query time: 0d 00:02:03
FwdSvcId         : 1                                                            
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address    : 239.0.0.1      Up Time    : 0d 00:00:16
Expires          : 0d 00:04:05    Mode       : Exclude
V1 Host Timer    : Not running    Type       : Dynamic
V2 Host Timer    : Not running    Compat Mode: IGMP Version 3
Redir.vRtrId     : N/A            Redir.Intf : N/A
-----------------------------------------------------------
Source Address     Expires        Type         Fwd/Blk 
-----------------------------------------------------------
10.11.0.1          0d 00:00:00    Dynamic      Blk        
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address    : 239.0.0.2      Up Time    : 0d 00:00:16
Expires          : 0d 00:04:04    Mode       : Exclude
V1 Host Timer    : Not running    Type       : Dynamic
V2 Host Timer    : Not running    Compat Mode: IGMP Version 3
Redir.vRtrId     : N/A            Redir.Intf : N/A
-----------------------------------------------------------
Source Address     Expires        Type         Fwd/Blk 
-----------------------------------------------------------
10.11.0.1          0d 00:00:00    Dynamic      Blk 
===============================================================================
IGMP Host 239.112.1.3
===============================================================================
Oper Status      : Up         MacAddress     : 00:00:00:00:00:02
Oper version     : 3          Subscriber     : sub_2
Num Groups       : 0          GrpItf         : gi_1_2
Max Grps Till Now: 1          IGMP-Policy    : pol1
PPPoE SessionId  : 1          Next query time: 0d 00:00:48
FwdSvcId         : 1                                                            
-------------------------------------------------------------------------------
Hosts : 3                             
===============================================================================
*B:Dut-C# 
 
*B:Dut-C# show router igmp statistics host 239.112.1.1 
==================================================
IGMP Host Statistics 239.112.1.1
==================================================
Message Type        Received       Transmitted                                 
--------------------------------------------------
Queries             0              580           
Report V1           0              0             
Report V2           0              0             
Report V3           5              0             
Leaves              0              0             
-------------------------------------------------------------------------------
General Host Statistics
-------------------------------------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Bad Receive If    : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0                 
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
MCAC Policy Drops : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G)             : 0
(*,G)             : 0
==================================================
*B:Dut-C# show subscriber-mgmt igmp-policy 

interface

Syntax 
interface [ip-int-name | ip-address] [group] [grp-ip-address] [detail]
Context 
show>router>igmp
Description 

This command displays IGMP interface information.

Parameters 
ip-int-name—
Displays information associated with the specified IP interface name.
ip-address—
Displays information associated with the specified IP address.
group grp-ip-address
Displays IP multicast group address information for the specified group IP address.
detail—
Displays detailed IP interface information along with the source group information learned on that interface.
Output 

The following output is an example of IGMP interface information. Table 4 provides IGMP field descriptions.

Sample Output
*A:ALA-BA# show router 100 interface 
===============================================================================
Interface Table (Service: 100)
===============================================================================
Interface-Name                   Adm         Opr(v4/v6)  Mode    Port/SapId    
   IP-Address                                                    PfxState      
-------------------------------------------------------------------------------
IGMP_to_CE                       Up          Up          VPRN    1/1/7         
   10.1.1.1/24                                                   n/a
system                           Up          Up          VPRN    loopback      
   10.20.1.2/32                                                  n/a
-------------------------------------------------------------------------------
Interfaces : 2
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 interface IGMP_to_CE 
===============================================================================
Interface Table (Service: 100)
===============================================================================
Interface-Name                   Adm         Opr(v4/v6)  Mode    Port/SapId    
   IP-Address                                                    PfxState      
-------------------------------------------------------------------------------
IGMP_to_CE                       Up          Up          VPRN    1/1/7         
   10.1.1.1/24                                                   n/a
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 igmp interface              
===============================================================================
IGMP Interfaces
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy       
                                                  Version Groups               
-------------------------------------------------------------------------------
IGMP_to_CE              Up   Up   10.1.1.1        1/1     3       igmppol      
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 igmp interface IGMP_to_CE 
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy       
                                                  Version Groups               
-------------------------------------------------------------------------------
IGMP_to_CE              Up   Up   10.1.1.1        1/1     3       igmppol      
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 igmp interface 10.1.1.1   
===============================================================================
IGMP Interface 10.1.1.1
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy       
                                                  Version Groups               
-------------------------------------------------------------------------------
IGMP_to_CE              Up   Up   10.1.1.1        1/1     3       igmppol      
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 igmp interface IGMP_to_CE group 239.1.1.1 
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy       
                                                  Version Groups               
-------------------------------------------------------------------------------
IGMP_to_CE              Up   Up   10.1.1.1        1/1     3       igmppol      
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address : 239.1.1.1               Up Time       : 0d 00:03:52            
Interface     : IGMP_to_CE              Expires       : never                  
Last Reporter : 0.0.0.0                 Mode          : exclude                
V1 Host Timer : Not running             Type          : static                 
V2 Host Timer : Not running             Compat Mode   : IGMP Version 3         
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
 
*A:ALA-BA# show router 100 igmp interface IGMP_to_CE group 239.1.1.1 detail 
===============================================================================
IGMP Interface IGMP_to_CE
===============================================================================
Interface          : IGMP_to_CE                                                
Admin Status       : Up                 Oper Status        : Up                
Querier            : 10.1.1.1           Querier Up Time    : 0d 00:04:01       
Querier Expiry Time: N/A                Time for next query: 0d 00:13:42       
Admin/Oper version : 1/1                Num Groups         : 3                 
Policy             : igmppol            Subnet Check       : Disabled          
Max Groups Allowed : 16000              Max Groups Till Now: 3                 
MCAC Policy Name   :                    MCAC Const Adm St  : Enable            
MCAC Max Unconst BW: no limit           MCAC Max Mand BW   : no limit          
MCAC In use Mand BW: 0                  MCAC Avail Mand BW : unlimited         
MCAC In use Opnl BW: 0                  MCAC Avail Opnl BW : unlimited         
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address : 239.1.1.1               Up Time       : 0d 00:04:02            
Interface     : IGMP_to_CE              Expires       : never                  
Last Reporter : 0.0.0.0                 Mode          : exclude                
V1 Host Timer : Not running             Type          : static                 
V2 Host Timer : Not running             Compat Mode   : IGMP Version 3         
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#
Table 4:  IGMP Fields  

Label

Description

Interface

The interfaces that participate in the IGMP protocol.

Adm

Admin Status

The administrative state for the IGMP protocol on this interface.

Oper

Oper Status

The current operational state of IGMP protocol on the interface.

Querier

The address of the IGMP querier on the IP subnet to which the interface is attached.

Querier Up Time

The time since the querier was last elected as querier.

Querier Expiry Timer

The time remaining before the querier ages out. If the querier is the local interface address, the value will be zero.

Cfg/Opr Version

Admin/Oper version

Cfg — The configured version of IGMP running on this interface. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

Opr — The operational version of IGMP running on this interface. If the cfg value is 3 but all of the routers in the local subnet of this interface use IGMP version v1 or v2, the operational version will be v1 or v2.

Num Groups

The number of multicast groups which have been learned by the router on the interface.

Policy

The policy that is to be applied on the interface.

Group Address

The IP multicast group address for which this entry contains information.

Up Time

The time since this source group entry got created.

Last Reporter

The IP address of the source of the last membership report received for this IP Multicast group address on this interface. If no membership report has been received, this object has the value 0.0.0.0.

Mode

The mode is based on the type of membership report(s) received on the interface for the group. In the 'include' mode, reception of packets sent to the specified multicast address is requested only from those IP source addresses listed in the source-list parameter of the IGMP membership report. In 'exclude' mode, reception of packets sent to the given multicast address is requested from all IP source addresses except those listed in the source-list parameter.

V1 Host Timer

The time remaining until the local router will assume that there are no longer any IGMP version 1 members on the IP subnet attached to this interface. Upon hearing any IGMPv1 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv2 Leave messages for this group that it receives on this interface.

V2 Host Timer

The time remaining until the local router will assume that there are no longer any IGMP version 2 members on the IP subnet attached to this interface. Upon hearing any IGMPv2 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv3 Leave messages for this group that it receives on this interface.

Type

Indicates how this group entry was learned. If this group entry was learned by IGMP, it will be set to “dynamic”. For statically configured groups, the value will be set to 'static'.

Compat Mode

Used in order for routers to be compatible with older version routers. IGMPv3 hosts must operate in version 1 and version 2 compatibility modes. IGMPv3 hosts must keep state per local interface regarding the compatibility mode of each attached network. A host's compatibility mode is determined from the Host Compatibility Mode variable which can be in one of three states: IGMPv1, IGMPv2 or IGMPv3. This variable is kept per interface and is dependent on the version of General Queries heard on that interface as well as the Older Version Querier Present timers for the interface.

mcast-reporting-statistics

Syntax 
mcast-reporting-statistics ip-address
Context 
show>router>igmp
Description 

This command displays IGMP multicast reporting statistics.

Parameters 
ip-address—
Displays the information associated with the specified IP address.

ssm-translate

Syntax 
ssm-translate
ssm-translate interface interface-name
Context 
show>router>igmp
Description 

This command displays IGMP SSM translate configuration information.

Parameters 
interface-name—
Specifies the IP interface name, up to 32 characters.
Output 

The following is an example of SSM translate information. Table 5 provides IGMP field descriptions.

Sample Output
================================================================= 
IGMP SSM Translate Entries
=================================================================
Group Range               Source                     Interface
-----------------------------------------------------------------
<239.1.1.1 - 239.1.1.2>   10.1.1.1                     -
                             
<239.1.1.1 - 239.1.1.5>   00.1.1.2                     ies-abc
-----------------------------------------------------------------
Table 5:  IGMP Fields  

Label

Description

Group Range

The address ranges of the multicast groups for which this router can be an RP.

Source

The unicast address that sends data on an interface.

SSM Translate Entries

The total number of SSM translate entries.

static

Syntax 
static [ip-int-name | ip-address]
Context 
show>router>igmp
Description 

This command displays static IGMP, (*,G) and (S,G) information.

Parameters 
ip-int-name—
Displays information associated with the specified IP interface name, up to 32 characters.
ip-address—
Displays information associated with the specified IP address.
Output 

The following is an example of IGMP static information. Table 6 provides static IGMP field descriptions.

Sample Output
*A:ALA-BA# show router 100 igmp static 
==================================================================
IGMP Static Group Source
==================================================================
Source           Group            Interface                         
------------------------------------------------------------------
10.11.11.11      239.136.22.3     IGMP_to_CE                      
*                239.1.1.1        IGMP_to_CE                      
10.22.22.22      239.255.255.255  IGMP_to_CE                      
------------------------------------------------------------------
Static (*,G)/(S,G) Entries : 3
==================================================================
*A:ALA-BA#
Table 6:  IGMP Static Fields  

Label

Description

Source

Entries that represent a source address from which receivers are interested/not interested in receiving multicast traffic.

Group

The IP multicast group address for which this entry contains information.

Interface

Displays the interface name.

statistics

Syntax 
statistics [ip-int-name | ip-address]
statistics group-interface [fwd-service service-id] [ip-int-name]
statistics host [ip-address]
Context 
show>router>igmp
Description 

This command displays IGMP statistics information.

Parameters 
ip-int-name—
Displays information associated with the specified IP interface name, up to 32 characters.
ip-address—
Displays information associated with the specified IP address.
Output 

The following is an example of IGMP statistics information. Table 7 provides statistical IGMP field descriptions.

Sample Output
*A:ALA-BA# show router igmp interface "IGMP_to_CE"
==================================================
IGMP Interface IGMP_to_CE Statistics
==================================================
Message Type        Received       Transmitted
--------------------------------------------------
Queries             0              0
Report V1           0              0
Report V2           0              0
Report V3           0              0
Leaves              0              0
--------------------------------------------------
Interface General Statistics
--------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Drops             : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0                 
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
MCAC Policy Drops : 0
--------------------------------------------------
Interface Source Group Statistics
--------------------------------------------------
(S,G)             : 0
(*,G)             : 0
==================================================
*A:ALA-BA#
 
*B:Dut-C# show router igmp statistics host 
==================================================
IGMP Host Statistics
==================================================
Message Type        Received       Transmitted                                 
--------------------------------------------------
Queries             0              1739          
Report V1           0              0             
Report V2           0              0             
Report V3           10             0             
Leaves              0              0             
-------------------------------------------------------------------------------
General Host Statistics
-------------------------------------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Bad Receive If    : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0                 
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
MCAC Policy Drops : 0
==================================================
*B:Dut-C# 
Table 7:  IGMP Statistics Fields  

Label

Description

IGMP Interface Statistics

Lists the IGMP statistics for a particular interface.

Message Type

Queries — The number of IGMP general queries transmitted or received on this interface.

Report — The total number of IGMP V1, V2, or V3 reports transmitted or received on this interface.

Leaves — The total number of IGMP leaves transmitted on this interface.

Received

The total number of IGMP packets received on this interface.

Transmitted

The total number of IGMP packets transmitted from this interface.

General Interface Statistics

The general IGMP statistics.

Bad Length

The total number of IGMP packets with bad length received on this interface.

Bad Checksum

The total number of IGMP packets with bad checksum received on this interface.

Unknown Type

The total number of IGMP packets with unknown type received on this interface.

Drops

The total number of IGMP packets dropped on this interface.

Rx Non Local

The total number of IGMP packets received from a non-local sender.

Rx Wrong Version

The total number of IGMP packets with wrong versions received on this interface.

Policy Drops

The total number of IGMP packets dropped by import policies on this interface.

No Router Alert

The total number of IGMPv3 packets received on this interface which did not have the router alert flag set.

Rx Bad Encodings

The total number of IGMP packets with bad encodings received on this interface.

Rx Pkt Drops

The total number of IGMP receive packet drops on this interface.

Local Scope Pkts

The total number of IGMP packets with local scope received on this interface.

Resvd Scope Pkts

The total number of IGMP packets with reserved scope received on this interface.

MCAC Policy Drops

The total number of IGMP packets dropped by MCAC policies on this interface.

status

Syntax 
status
Context 
show>router>igmp
Description 

This command displays IGMP status information.

If IGMP is not enabled, the following message appears:

A:NYC# show router igmp status
MINOR: CLI IGMP is not configured.
A:NYC#
Output 

The following is an example of IGMP status information. Table 8 provides IGMP status field descriptions.

Sample Output
*A:ALA-BA# show router 100 igmp status     
===============================================================================
IGMP Status
===============================================================================
Admin State                       : Up                                         
Oper State                        : Up                                         
Query Interval                    : 1024                                       
Last Member Query Interval        : 1024                                       
Query Response Interval           : 1023                                       
Robust Count                      : 10                                         
===============================================================================
*A:ALA-BA#
Table 8:  IGMP Status Fields  

Label

Description

Admin State

The administrative status of IGMP.

Oper State

The current operating state of this IGMP protocol instance on this router.

Query Interval

The frequency at which IGMP query packets are transmitted.

Last Member Query Interval

The maximum response time inserted into group-specific queries sent in response to leave group messages, and is also the amount of time between group-specific query messages.

Query Response Interval

The maximum query response time advertised in IGMPv2 queries.

Robust Count

The number of times the router will retry a query.

tunnel-interface

Syntax 
tunnel-interface
Context 
show>router>igmp
Description 

This command displays tunnel interface information.

Output 

The following is an example of IGMP tunnel interface information.

Output Sample
*A:Dut-C# show router igmp tunnel-interface 
===============================================================================
IGMP Tunnel-Interfaces
===============================================================================
LSP/LDP        Type        SenderAddr     IfIndex           AdmState  OperState
-------------------------------------------------------------------------------
1              ldp         10.20.1.3      74218             Up        Up
2              ldp         10.20.1.3      74219             Up        Up
3              ldp         10.20.1.3      74220             Up        Up
4              ldp         10.20.1.3      74221             Up        Up
5              ldp         10.20.1.3      74222             Up        Up
-------------------------------------------------------------------------------
Interfaces : 5
===============================================================================

3.4.2.2. Clear Commands

database

Syntax 
database [group grp-ip-address] [source src-ip-address]
database interface {ip-int-name | ip-address} [group grp-ip-address] [source src-ip-address]
database host ip-address [group grp-ip-address] [source src-ip-address]
database host all [group grp-ip-address] [source src-ip-address]
database group-interface interface-name [fwd-service service-id] [group grp-ip-address] [source src-ip-address]
database group-interface all
Context 
clear>router>igmp
Description 

This command clears IGMP or PIM database statistics on a specified interface or IP address.

Parameters 
group grp-ip-address
Clears the multicast group address (IPv4/IPv6) or zero in the specified address group.
source src-ip-address
Clears the IGMP database from the specified source IP address.
interface ip-int-name
Clears the IGMP database on the specified interface.
interface ip-address
Clears the IGMP database on the specified IP address.
host ip-address
Clears the IGMP database on the specified host.
host all—
Clears the IGMP database on all hosts.
group-interface interface-name
Clears the IGMP database on the specified group interface.
group-interface all—
Clears the IGMP database on all group interfaces.

statistics

Syntax 
statistics group-interface [fwd-service service-id] ip-in-name
statistics group-interface all
statistics host ip-address
statistics host all
statistics [interface ip-int-name | ip-address]
Context 
clear>router>igmp
Description 

This command clears IGMP statistics on a specified interface or IP address.

Note:

An interface, group, and source cannot be specified at the same time.

Parameters 
group-interface interface-name
Clears the IGMP statistics on the specified group interface.
group-interface all—
Clears the IGMP statistics on all group interfaces.
service-id
Specifies the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

host ip-address
Clears the IGMP statistics on the specified host.
host all—
Clears the IGMP statistics on all hosts.
interface ip-int-name
Clears the IGMP statistics on the specified interface.
interface ip-address
Clears the IGMP statistics on the specified IP address.

version

Syntax 
version group-interface [fwd-service service-id] ip-in-name
version group-interface all
version host ip-address
version host all
version [interface ip-int-name | ip-address]
Context 
clear>router>igmp
Description 

This command clears the IGMP version on a specified interface or IP address.

Parameters 
group-interface interface-name
Clears the IGMP version on the specified group interface.
group-interface all—
Clears the IGMP version on all group interfaces.
service-id
Specifies the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

host ip-address
Clears the IGMP version on the specified host.
host all—
Clears the IGMP version on all hosts.
interface ip-int-name
Clears the IGMP version on the specified interface.
interface ip-address
Clears the IGMP version on the specified IP address.

3.4.2.3. Debug Commands

group-interface

Syntax 
[no] group-interface [fwd-service service-id] [ip-int-name]
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP group-interface.

The no form of the command disables debugging.

Parameters 
service-id
Debugs information associated with the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

ip-int-name—
Debugs information associated with the specified IP interface name.
Values—
IP interface address

 

host

Syntax 
[no] host [ip-address]
[no] host [fwd-service service-id] group-interface ip-int-name
Context 
debug>router>igmp
Description 

This command enables debugging for the IGMP host.

The no form of the command disables debugging.

Parameters 
ip-address—
Debugs the information associated with the specified IP address.
service-id
Debugs information associated with the service ID.
Values—
service-id: 1 to 2148278386
svc-name: up to 64 characters.

 

group-interface ip-int-name
Debugs the information associated with the specified IP interface name.
Values—
IP interface address

 

interface

Syntax 
[no] interface [ip-int-name | ip-address]
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP interfaces.

The no form of this command disables the IGMP interface debugging for the specifies interface name or IP address.

Parameters 
ip-int-name—
Debugs the information associated with the specified IP interface name.
ip-address—
Debugs the information associated with the specified IP address.

mcs

Syntax 
mcs [ip-int-name]
no mcs
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP multicast servers (MCS).

The no form of the command disables the IGMP interface debugging for the specifies interface name.

Parameters 
ip-int-name—
Debugs the information associated with the specified IP interface name.
Values—
IP interface address

 

misc

Syntax 
[no] misc
Context 
debug>router>igmp
Description 

This command enables debugging for IGMP miscellaneous information.

The no form of the command disables the debugging.

Output 

The following is shows debugged IGMP miscellaneous information

Sample Output
A:ALA-CA# debug router 100 igmp misc 
*A:ALA-CA# show debug 
debug
    router "100"
        igmp
            misc
        exit
    exit
exit
*A:ALA-CA# 

packet

Syntax 
packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
packet [query | v1-report | v2-report | v3-report | v2-leave] [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}] group-interface ip-int-name
packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address [mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}]
no packet [query | v1-report | v2-report | v3-report | v2-leave] [ip-int-name | ip-address]
no packet [query | v1-report | v2-report | v3-report | v2-leave] group-interface ip-int-name
no packet [query | v1-report | v2-report | v3-report | v2-leave] host ip-address
Context 
debug>router>igmp
Description 

This command enables/disables debugging for IGMP packets.

Parameters 
query—
Specifies to log the IGMP group- and source-specific queries transmitted and received on this interface.
v1-report—
Specifies to debug IGMP V1 reports transmitted and received on this interface.
v2-report—
Specifies to debug IGMP V2 reports transmitted and received on this interface.
v3-report—
Specifies to debug IGMP V3 reports transmitted and received on this interface.
v2-leave—
Specifies to debug the IGMP Leaves transmitted and received on this interface.
ip-int-name—
Debugs the information associated with the specified IP interface name.
Values—
IP interface address

 

ip-address—
Debugs the information associated with the specified IP address.