IGMP commands

group

Syntax

group [grp-ip-address] [host | interface | saps]

group summary [host | interface | saps]

Context

show>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document

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.

host

Displays hosts for the multicast group addresses.

interface

Displays interfaces for the multicast group addresses.

saps

Displays SAPs for the multicast group addresses.

Output

The following output is an example of IGMP 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
===============================================================================
(*,225.0.0.1)
    Fwd List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.1)
    Fwd List  : 112.112.1.1            Up Time : 0d 00:00:30
    Blk List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.2,225.0.0.1)
    Fwd List  : 112.112.1.1            Up Time : 0d 00:00:30
(*,225.0.0.2)
    Fwd List  : 112.112.1.2            Up Time : 0d 00:00:21
(11.11.0.1,225.0.0.2)
    Blk List  : 112.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 
===============================================================================
(*,225.0.0.1)                     1                      0
(11.11.0.1,225.0.0.1)             1                      1
(11.11.0.2,225.0.0.1)             1                      0
(*,225.0.0.2)                     1                      0
(11.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
===============================================================================
(*,224.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 which are statically configured

Fwd List

Displays the list of interfaces in the forward list

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 the specified IP interface name up to 32 characters.

ip-address

Displays the information associated with the specified IP address.

Values

a.b.c.d

grp-address

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

Values

a.b.c.d, multicast group address or 0

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 output fields.

Sample output
A:Dut-C# show router igmp interface 
===============================================================================
IGMP Interfaces
===============================================================================
Interface               Adm  Oper Querier         Cfg/Opr Num     Policy
                                                  Version Groups 
-------------------------------------------------------------------------------
C_Rx_net1               Up   Up   10.2.1.3        3/3     900     none
C_Rx_acc1               Up   Up   10.1.1.3        3/3     900     none
C_Rx_acc2               Up   Up   10.1.2.3        3/3     900     none
C_Rx_net2               Up   Up   10.2.2.3        3/3     900     none

-------------------------------------------------------------------------------
Interfaces : 4
===============================================================================
*A:Dut-C# show router igmp interface detail 
===============================================================================
IGMP Interface C_Rx_net1
===============================================================================
Interface          : C_Rx_net1
Admin Status       : Up                 Oper Status        : Up
Querier            : 10.2.1.3           Querier Up Time    : 0d 00:00:55
Querier Expiry Time: N/A                Time for next query: 0d 00:01:51
Admin/Oper version : 3/3                Num Groups         : 900
Policy             : none               Subnet Check       : Enabled
Max Groups Allowed : No Limit           Max Groups Till Now: 900
Use LAG port weight: no 
Router Alert Check : Enabled            Max Sources Allowed: No Limit
                                        Max GrpSrcs Allowed: No Limit
Redundant Multicast: no                 Red. Multicast Fwd : N/A
-------------------------------------------------------------------------------
IGMP Group
-------------------------------------------------------------------------------
Group Address : 239.225.1.1             Up Time       : 0d 00:00:51
Interface     : C_Rx_net1               Expires       : N/A
Last Reporter : 10.2.1.1                Mode          : include
V1 Host Timer : Not running             Type          : dynamic
V2 Host Timer : Not running             Compat Mode   : IGMP Version 3
-----------------------------------------------
Source Address   Expires       Type    Fwd/Blk 
-----------------------------------------------
10.1.1.2         0d 00:04:07   dynamic Fwd
-------------------------------------------------------------------------------
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 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

Displays 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 specific 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 earlier 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 Earlier Version Querier Present timers for the interface.

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.

Parameters

interface-name

Displays information associated with the specified interface name up to 32 characters.

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
-----------------------------------------------------------------
<234.1.1.1 - 234.1.1.2>   10.1.1.1                     
                             
<232.1.1.1 - 232.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

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 the specified IP interface name up to 32 characters.

ip-addr

Displays the information associated with the specified IP address.

Values

a.b.c.d

Output

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

Sample output
*A:Dut-C# show router igmp static 
===================================================================
IGMP Static Group Source
===================================================================
Source           Group            Interface
-------------------------------------------------------------------
*                239.1.2.1        C_Rx_acc1
10.2.1.1         239.12.1.1       C_Rx_acc1
*                239.1.1.1        C_Rx_net2
-------------------------------------------------------------------
Static (*,G)/(S,G) Entries : 3
===================================================================
Table: Output fields: IGMP static

Label

Description

Source

Displays entries which represent 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

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

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 the specified IP interface name up to 32 characters.

ip-address

Displays the information associated with the specified IP address.

Values

a.b.c.d

service-id

Displays the information associated with the specified service ID.

Values

1 to 2147483647 | 64 char max

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

Column that 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 which did 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 will retry a query