3.4. Show, Clear, and Debug Command Reference

3.4.1. Command Hierarchies

  1. Show Commands
  2. Clear Commands
  3. Debug Commands

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]
— mcast-reporting-statistics ip-address
— ssm-translate
— 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
— tunnel-interface

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 

IGMP Group Output

The following table describes the output fields for IGMP group information.

Table 3:  IGMP Group Information Output Fields  

Label

Description

IGMP Groups

Displays the IP multicast sources corresponding to the IP multicast groups.

Fwd List

Displays the list of interfaces in the forward list.

Blk List

Displays the list of interfaces in the blocked list.

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#

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—
[1..2148007980] | <svc-name:64 char max>
ip-int-name—
IP interface name. A string up to 32 characters.
detail—
Displays detailed information.
group—
Displays information from the group IP address.
grp-address—
Group IP address in format: a.b.c.d

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 shows IGMP hosts information.

Parameters 
grp-address—
Specifies the group IP address in format: a.b.c.d
service-id —
[1 to 2148007980]|<svc-name: 64 characters maximum>
ip-int-name—
IP interface name. A string up to 32 characters.
ip-address—
IP address in format: a.b.c.d
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—
Only displays the information associated with the specified IP interface name.
ip-address—
Only displays the information associated with the specified IP address.
group grp-ip-address—
Only displays IP multicast group address for which this entry contains information.
detail—
Displays detailed IP interface information along with the source group information learned on that interface.
Output 

IGMP Interface Output

The following table provides IGMP field descriptions.

Table 4:  IGMP Fields  

Label

Description

Interface

Displays the interfaces that participate in the IGMP protocol.

Adm

Admin Status

Displays the administrative state for the IGMP protocol on this interface.

Oper

Oper Status

Displays the current operational state of IGMP protocol on the interface.

Querier

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

Querier Up Time

Displays the time since the querier was last elected as querier.

Querier Expiry Timer

Displays 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

Displays the policy that is to be applied on the interface.

Group Address

Displays the IP multicast group address for which this entry contains information.

Up Time

Displays the time since this source group entry got created.

Last Reporter

Displays 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.

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#

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—
IP interface name. A string up to 32 characters.
Output 

IGMP Interface Output

The following table provides IGMP field descriptions.

Table 5:  IGMP Fields  

Label

Description

Group Range

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

Source

Displays the unicast address that sends data on an interface.

SSM Translate Entries

Displays the total number of SSM translate entries.

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
-----------------------------------------------------------------

static

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

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

Parameters 
ip-int-name—
Only displays the information associated with the specified IP interface name.
ip-addr—
Only displays the information associated with the specified IP address.
Output 

Static IGMP Output

The following table provides static IGMP field descriptions.

Table 6:  IGMP Static Fields  

Label

Description

Source

Displays entries which represents a source address from which receivers are interested/not interested in receiving multicast traffic.

Group

Displays the IP multicast group address for which this entry contains information.

Interface

Displays the interface name.

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#

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—
Only displays the information associated with the specified IP interface name.
ip-address—
Only displays the information associated with the specified IP address.
Output 

IGMP Statistics Output

The following table provides statistical IGMP field descriptions.

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

Displays the total number of IGMP packets received on this interface.

Transmitted

Displays the total number of IGMP packets transmitted from this interface.

General Interface Statistics

Lists the general IGMP statistics.

Bad Length

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

Bad Checksum

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

Unknown Type

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

Drops

Displays the total number of IGMP packets dropped on this interface.

Rx Non Local

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

Rx Wrong Version

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

Policy Drops

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

No Router Alert

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

Rx Bad Encodings

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

Rx Pkt Drops

Displays the total number of IGMP receive packet drops on this interface.

Local Scope Pkts

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

Resvd Scope Pkts

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

MCAC Policy Drops

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

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# 

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 

IGMP Status Output

The following table provides IGMP status field descriptions.

Table 8:  IGMP Status Fields  

Label

Description

Admin State

Displays the administrative status of IGMP.

Oper State

Displays 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

Displays the number of times the router will retry a query.

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#

tunnel-interface

Syntax 
tunnel-interface
Context 
show>router>igmp
Description 

This command displays tunnel interface information.

Output 

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:

Interface and group/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.
fwd-service service-id—
[1to 2148007980] | <svc-name:64 char max>
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.
fwd-service service-id—
[1to 2148007980] | <svc-name:64 char max>
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 
fwd-service service-id—
[1 to 2148007978]|<svc-name: 64 characters maximum>
ip-int-name—
Debugs the 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.
fwd-service service-id—
[1 to 2148007978]|<svc-name: 64 characters maximum>
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 the 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.
Values—
IP interface address

 

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.

The no form of the command disables the debugging.

Output 

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.