IGMP commands

group

Syntax

group [grp-ip-address]

group summary

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

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

Parameters

grp-ip-address

Displays specific multicast group addresses.

Output

The following output is an example of IGMP multicast group information, and Table: Output fields: IGMP group describes the output fields.

Sample output
*B:Dut-C# show router igmp group 
===============================================================================
IGMP Interface Groups
===============================================================================
===============================================================================
IGMP Host Groups
===============================================================================
(*,224.0.0.1)
    Fwd List  : 239.112.1.2            Up Time : 0d 00:00:21
(10.11.0.1,224.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,224.0.0.1)
    Fwd List  : 239.112.1.1            Up Time : 0d 00:00:30
(*,224.0.0.2)
    Fwd List  : 239.112.1.2            Up Time : 0d 00:00:21
(10.11.0.1,224.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   Nbr Blk 
===============================================================================
(*,224.0.0.1)                     1                      0
(10.11.0.1,224.0.0.1)             1                      1
(10.11.0.2,224.0.0.1)             1                      0
(*,224.0.0.2)                     1                      0
(10.11.0.1,225.0.0.2)             0                      1
-------------------------------------------------------------------------------
(*,G)/(S,G) Entries : 5
===============================================================================
*B:Dut-C# 

A:NYC# show router igmp group 224.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: Output fields: IGMP group

Label

Description

IGMP Groups

Displays the IP multicast sources corresponding to the IP multicast groups that4 are statically configured

Fwd List

Displays the list of interfaces in the forward list

Blk List

Displays the list of interfaces in the blocked list

ssm-translate

Syntax

ssm-translate

ssm-translate interface interface-name

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP SSM translate configuration information.

Output

The following output is an example of IGMP SSM translate information, and Table: Output fields: IGMP SSM-translate describes the output fields.

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>   10.1.1.2                     ies-abc
-----------------------------------------------------------------
Table: Output fields: IGMP SSM-translate

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

interface

Syntax

interface [ip-int-name | ip-address] [group] [grp-address] [detail]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays IGMP interface information.

Parameters

ip-int-name

Displays the information associated with only the specified IP interface name.

ip-address

Displays the information associated with only the specified IP address.

group grp-address

Displays only the 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

The following output is an example of IGMP interface information, and Table: Output fields: IGMP interface describes the fields.

Sample output
show router igmp interface output

*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 none
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:ALA-BA#


*A:7210SAS>show>router# interface

===============================================================================
Interface Table (Router: Base)
===============================================================================
Interface-Name                   Adm         Opr(v4/v6)  Mode    Port/SapId
   IP-Address                                                    PfxState
-------------------------------------------------------------------------------
system                           Up          Up/Down     Network system
   10.3.3.3/32                                                    n/a
toD_1                            Up          Up/Down     Network 1/1/6
   10.1.3.3/24                                                   n/a
toE_1                            Up          Up/Down     Network 1/1/5
   10.1.2.3/24                                                   n/a
toIxia_1                         Up          Up/Down     IES     1/1/16:1
   10.2.1.3/24                                                   n/a
-------------------------------------------------------------------------------
Interfaces : 4
===============================================================================
*A:7210SAS>show>router#
Table: Output fields: IGMP interface

Label

Description

Interface

Specifies 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 is zero.

Cfg/Opr Version

Admin/Oper version

Cfg — 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 — operational version of IGMP running on this interface. For example, if the cfg value is 3 but all the routers in the local subnet of this interface use IGMP version v1 or v2, the operational version is v1 or v2

Num Groups

Displays the number of multicast groups that 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 was 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 reports 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 specific multicast address is requested from all IP source addresses except those listed in the source-list parameter.

V1 Host Timer

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

V2 Host Timer

Displays the time remaining until the local router assumes there are no longer IGMP version 2 members on the IP subnet attached to this interface. Upon hearing an IGMPv2 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores 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 is set to ‟dynamic.” For statically configured groups, the value is set to ‟static.”

Compat Mode

Used 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 about the compatibility mode of each attached network. A host compatibility mode is determined by the Host Compatibility Mode variable, which can be in one of the following 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.

static

Syntax

static [ip-int-name | ip-addr]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

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

Parameters

ip-int-name

Displays the information associated with only the specified IP interface name.

ip-addr

Displays the information associated with only the specified IP address.

Output

The following output is an example of static IGMP information, and Table: Output fields: IGMP static describes the fields.

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: Output fields: IGMP static

Label

Description

Source

Displays entries that represent a source address from which receivers are interested or not interested in receiving multicast traffic

Group

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

Interface

Displays the interface name

statistics

Syntax

statistics [ip-int-name | ip-address]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command displays IGMP statistics information.

Parameters

ip-int-name

Displays the information associated with only the specified IP interface name.

ip-address

Displays the information associated with only the specified IP address.

Output

The following output is an example of IGMP statistics information, and Table: Output fields: IGMP statistics describes the output fields.

Sample output
*A:dut-e>show>router# igmp statistics

==================================================
IGMP Interface Statistics
==================================================
Message Type        Received       Transmitted
--------------------------------------------------
Queries             0              57
Report V1           0              0
Report V2           0              0
Report V3           0              0
Leaves              0              0
--------------------------------------------------
Global 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
--------------------------------------------------
Global Source Group Statistics
--------------------------------------------------
(S,G)             : 0
(*,G)             : 75
==================================================
*A:dut-e>show>router#
Table: Output fields: IGMP statistics

Label

Description

IGMP Interface Statistics

Displays the IGMP statistics for a particular interface

Message Type

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

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

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

Displays 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

Bad Receive If

Displays the total number of IGMP packets incorrectly received 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 times IGMP protocol instance matched the host IP address or group/source addresses specified in the import policy

No Router Alert

Displays the total number of IGMPv3 packets received on this interface that do not have the router alert flag set

status

Syntax

status

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

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 output is an example of IGMP status information, and Table: Output fields: IGMP status describes the output fields.

Sample output
*A:ALA-BA# show>router# igmp status

===============================================================================
IGMP Status
===============================================================================
Admin State                       : Up
Oper State                        : Up
Query Interval                    : 125
Last Member Query Interval        : 1
Query Response Interval           : 10
Robust Count                      : 2
===============================================================================
*A:ALA-BA#
Table: Output fields: IGMP status

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

Displays the frequency at which IGMP query packets are transmitted

Last Member Query Interval

Displays 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

Displays the maximum query response time advertised in IGMPv2 queries

Robust Count

Displays the number of times the router retries a query