Table of Contents

Chapter 1 IGMP Configuration Commands. 1-1

1.1 IGMP Configuration Commands. 1-1

1.1.1 debugging igmp. 1-1

1.1.2 display igmp group. 1-4

1.1.3 display igmp group port-info. 1-5

1.1.4 display igmp interface. 1-7

1.1.5 display igmp routing-table. 1-9

1.1.6 fast-leave. 1-10

1.1.7 igmp. 1-12

1.1.8 igmp enable. 1-12

1.1.9 igmp fast-leave. 1-13

1.1.10 igmp group-policy. 1-14

1.1.11 igmp last-member-query-interval 1-15

1.1.12 igmp max-response-time. 1-16

1.1.13 igmp require-router-alert 1-17

1.1.14 igmp robust-count 1-18

1.1.15 igmp send-router-alert 1-19

1.1.16 igmp static-group. 1-19

1.1.17 igmp timer other-querier-present 1-21

1.1.18 igmp timer query. 1-21

1.1.19 igmp version. 1-22

1.1.20 last-member-query-interval 1-23

1.1.21 max-response-time. 1-24

1.1.22 require-router-alert 1-25

1.1.23 reset igmp group. 1-26

1.1.24 robust-count 1-27

1.1.25 send-router-alert 1-28

1.1.26 timer other-querier-present 1-28

1.1.27 timer query. 1-29

1.1.28 version. 1-30

 

Chapter 1  IGMP Configuration Commands

 

 

1.1  IGMP Configuration Commands

1.1.1  debugging igmp

Syntax

debugging igmp { all | event | leave [ basic-acl-number ] | report [ advanced-acl-number ] | query [ advanced-acl-number ] | timer }

undo debugging igmp { all | event | leave | report | query | timer }

View

User view

Default Level

1: Monitor level

Parameter

all: Specifies all types of IGMP debugging.

event: Specifies IGMP event debugging.

leave: Specifies IGMP leave message debugging.

basic-acl-number: Basic ACL number.

report: Specifies IGMP report message debugging.

advanced-acl-number: Advanced ACL number.

query: Specifies IGMP query message debugging.

timer: Specifies IGMP timer debugging.

Description

Use the debugging igmp command to enable IGMP debugging.

Use the undo debugging igmp command to disable IGMP debugging.

By default, IGMP debugging is disabled.

Table 1-1 debugging igmp event command output description

Field	Description
Creating/creation/created aux join/aux prune adding interface/deleting downstream deleting/unregister/deleted Enqueue/Dequeing Elected/ Un-elected	Event types include: l      Creating/creation/created l      Join/prune l      Adding outgoing interface/deleting outgoing interface l      Being deleted/unregistered/deleted l      Enqueuing/dequeuing l      Elected/un-elected
Interface interfacename(ifadd)	Interface that responds to events (interface address)
(sadd, gadd)	(S, G) entry
(*, gadd)	(*, G) entry

 

Table 1-2 debugging igmp leave command output description

Field	Description
LEAVE	IGMP leave message
Interfacename(ifadd)	Interface that receives messages (interface address)
group gadd	Address of the group that a host will leave
Ignoring	Ignoring the IGMP leave message

 

Table 1-3 debugging igmp query command output description

Field	Description
version <1-3>	Version of the IGMP query
Interfacename(ifadd)	Interface that sends/receives messages (interface address)
Ignoring	Ignoring the IGMP query
Received/Send	Received/sent IGMP query
General/group specific query/group-source specific query	IGMP general query/group-specific query/group-and-source specific query
Group gadd	Group address to be queried

 

Table 1-4 debugging igmp report command output description

Field	Description
Ignoring	Ignoring the IGMP membership report message
IS_IN/IS_EX/TO_IN/TO_EX/ALLOW/BLOCK	Record type of IGMPv3 membership report
Group gadd	Group address of IGMP membership report
(sadd, gadd)	(S, G) entry
v1/v2/v3	Version of IGMP membership report
Interfacename(ifadd)	Interface that sent/received messages (interface address)

 

Table 1-5 debugging igmp timer command output description

Field	Description
Source sadd timeout	The multicast source timer times out.
Group gadd timeout	The multicast group timer times out.
Other querier present timeout	The other querier present interval timer times out.
Interfacename(ifadd)	Interface that sends/receives messages (interface address)
Deleting v1 host timer	IGMPv1 host timer times out.
Deleting v2 host timer	IGMPv2 host timer times out.
Setting v1 host timer	Setting IGMPv1 host timer
Setting v2 host timer	Setting IGMPv2 host timer

 

Example

# Enable IGMP timer debugging.

<Sysname> debugging igmp timer

*Mar 26 14:20:10:635 2007 Sysname IGMP/7/TIMER:Setting v2 host timer for group 235.1.1.1 on interface Vlan-interface20(1.1.1.1) (B033137)

// IGMPv2 host timer is set.

*Mar 26 14:20:11:635 2007 Sysname IGMP/7/TIMER:Group 235.1.1.1 timeout. Deleting group record associated with interface Vlan-interface20(1.1.1.1). (B012920)

// The multicast group timer times out.

1.1.2  display igmp group

Syntax

display igmp group [ group-address | interface interface-type interface-number ] [ static | verbose ]

View

Any view

Default Level

1: Monitor level

Parameter

group-address: Multicast group address.

interface interface-type interface-number: Displays the IGMP multicast group information about a particular interface.

static: Displays the information of statically joined IGMP multicast groups.

verbose: Displays the detailed information of IGMP multicast groups.

Description

Use the display igmp group command to view IGMP multicast group information.

Note that:

l           If you do not specify a multicast group address, this command will display the IGMP information of all multicast groups.

l           If you do not specify an interface, this command will display the IGMP multicast group information on all the interfaces.

l           If you do not use the static keyword, this command will display the detailed information about dynamically joined IGMP multicast groups.

Example

# Display the information about dynamically joined IGMP multicast groups on all interfaces.

<Sysname> display igmp group

Total 3 IGMP Group(s).

Interface group report information

 Vlan-interface245(192.168.245.2):

 Total 3 IGMP Groups reported

  Group Address       Last Reporter   Uptime      Expires

   239.192.0.1     192.168.245.1   00:02:25    00:01:53

   239.192.245.1   192.168.245.1   00:02:17    00:01:49

   239.255.255.250 192.168.245.111 00:02:24    00:01:55

Table 1-6 display igmp group command output description

Field	Description
Group address	Multicast group address
Last reporter	Address of the last host that reported its multicast membership
Uptime	Length of time for which the multicast group has been up (hours:minutes:seconds)
Expires	Length of time in which the multicast group will expire (hours:minutes:seconds)

 

1.1.3  display igmp group port-info

Syntax

display igmp group port-info [ vlan vlan-id ] [ slot slot-id ] [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameter

vlan-id: VLAN ID. If you do not specify a VLAN, this command will display the Layer 2 port information of IGMP multicast groups in all VLANs.

slot slot-id: Displays the Layer 2 port information about IGMP multicast groups on the specified card. If you do not specify a slot number, this command will display the Layer 2 port information about IGMP multicast groups on the SRPU.

verbose: Displays the detailed information about Layer 2 ports of IGMP multicast groups.

Description

Use the display igmp group port-info command to view Layer 2 port information of IGMP multicast groups..

Example

# View detailed Layer 2 ports information of IGMP multicast groups.

<Sysname> display igmp group port-info verbose

    Total 4 IP Group(s).

    Total 4 IP Source(s).

    Total 4 MAC Group(s).

 

  Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port

  Subvlan flags: R-Real VLAN, C-Copy VLAN

  Vlan(id):12.

    Total 1 IP Group(s).

    Total 1 IP Source(s).

    Total 1 MAC Group(s).

    Router port(s):total 1 port.

            Eth2/1/15                            (D)

    IP group(s):the following ip group(s) match to one mac group.

      IP group address:225.1.1.1

        (10.1.1.3, 225.1.1.1):

          Attribute:    MFIB

          Host port(s):total 0 port.

    MAC group(s):

      MAC group address:0100-5e01-0101

          Host port(s):total 0 port.

 

  Vlan(id):245.

    Total 3 IP Group(s).

    Total 3 IP Source(s).

    Total 3 MAC Group(s).

    Router port(s):total 0 port.

    IP group(s):the following ip group(s) match to one mac group.

      IP group address:239.192.0.1

        (0.0.0.0, 239.192.0.1):

          Attribute:    Host Board

          Host port(s):total 1 port.

            Eth2/1/20                            (D)

    MAC group(s):

      MAC group address:0100-5e40-0001

          Host port(s):total 1 port.

            Eth2/1/20

    IP group(s):the following ip group(s) match to one mac group.

      IP group address:239.255.255.250

        (0.0.0.0, 239.255.255.250):

          Attribute:    Host Board

          Host port(s):total 1 port.

            Eth2/1/20                            (D)

    MAC group(s):

      MAC group address:0100-5e7f-fffa

          Host port(s):total 1 port.

            Eth2/1/20

    IP group(s):the following ip group(s) match to one mac group.

      IP group address:239.192.245.1

        (0.0.0.0, 239.192.245.1):

          Attribute:    Host Board

          Host port(s):total 1 port.

            Eth2/1/20                            (D)

    MAC group(s):

      MAC group address:0100-5e40-f501

          Host port(s):total 1 port.

            Eth2/1/20

Table 1-7 display igmp group port-info command output description

Field	Description
Total 4 IP Group(s).	Total number of IP multicast groups
Total 4 IP Source(s).	Total number of IP multicast sources
Total 4 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, A-Aggregation port	Port flags: D for dynamic port, S for static port, A for aggregation port, and C for a port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for a real egress sub-VLAN under the current entry, and C for a sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
IP group address	Address of IP multicast group
MAC group address	Address of MAC multicast group
Attribute	Attribute of IP multicast group
Host port(s)	Number of host ports

 

1.1.4  display igmp interface

Syntax

display igmp interface [ interface-type interface-number ] [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameter

interface-type interface-number: Specifies an interface to display the IGMP information about. If no interface is specified, this command will display the related information of all IGMP-enabled interfaces.

verbose: Displays the detailed IGMP configuration and running information.

Description

Use the display igmp interface command to view IGMP configuration and running information of the specified interface or all IGMP-enabled interfaces.

Example

# View the IGMP configuration and running status on all IGMP-enabled interfaces.

<Sysname> display igmp interface

Interface information

 Vlan-interface240(10.1.2.2):

   IGMP is enabled

   Current IGMP version is 2

   Value of query interval for IGMP(in seconds): 60

   Value of other querier present interval for IGMP(in seconds): 125

   Value of maximum query response time for IGMP(in seconds): 10

   Querier for IGMP: 10.1.2.2 (this router)

 

 Vlan-interface245(192.168.245.2):

   IGMP is enabled

   Current IGMP version is 2

   Value of query interval for IGMP(in seconds): 60

   Value of other querier present interval for IGMP(in seconds): 125

   Value of maximum query response time for IGMP(in seconds): 10

   Querier for IGMP: 192.168.245.2 (this router)

  Total 3 IGMP Groups reported

Table 1-8 display igmp interface command output description

Field	Description
Vlan-interface240(10.1.2.2)	Interface name (IP address)
IGMP is enabled	IGMP is enabled.
Current IGMP version	Version of IGMP currently running on the interface
Value of query interval for IGMP(in seconds)	IGMP general query interval, in seconds
Value of other querier present interval for IGMP(in seconds)	Other querier present interval, in seconds
Value of maximum query response time for IGMP(in seconds)	Maximum response time for IGMP general queries, in seconds
Querier for IGMP	IP address of the querier
Total 3 IGMP Groups reported	Total number of groups recorded on the interface.

 

1.1.5  display igmp routing-table

Syntax

display igmp routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] ] *

View

Any view

Default Level

1: Monitor level

Parameter

group-address: Multicast group address.

source-address: Multicast source address.

mask: Subnet mask of the multicast group/source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group/source address. For a multicast source address, this argument has an effective value range of 0 to 32; for a multicast group address, this argument has an effective value range of 4 to 32. The system default is 32 in both cases.

Description

Use the display igmp routing-table command to view the routing information of the IGMP routing table.

 

 

Example

# View IGMP routing table information

<Sysname> display igmp routing-table

Routing table

 Total 2 entries

 

 00001. (*, 225.1.1.1)

       List of 1 downstream interface

        Vlan-interface245 (20.1.1.1),

                   Protocol: STATIC

 

 00002. (*, 239.255.255.250)

       List of 1 downstream interface

        Vlan-interface246 (20.20.20.20),

                   Protocol: IGMP

Table 1-9 display igmp routing-table command output description

Field	Description
00001	Sequence number the (*, G) entry
(*, 225.1.1.1)	An (*, G) entry of the IGMP routing table
List of 1 downstream interface	Downstream interface list: these interfaces need to forward multicast packets
Protocol	Protocol type

 

1.1.6  fast-leave

Syntax

fast-leave [ group-policy acl-number ]

undo fast-leave

View

IGMP view

Default Level

2: System view

Parameters

acl-number: Basic ACL number.

Description

Use the fast-leave command to enable fast leave processing for multicast group members globally.

Use the undo fast-leave command to disable fast leave processing globally.

By default, fast leave processing is disabled, namely, the IGMP querier sends an IGMP group-specific query upon receiving an IGMP leave message from a host, instead of sending a Leave notification directly to the upstream.

This command is the same as the igmp fast-leave command for interface view, but the value configured by the igmp fast-leave command has a higher priority, that is, the system gives priority to configurations made in interface view.

 

 

Related commands: igmp fast-leave, last-member-query-interval.

Examples

# Enable the fast leave function globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] fast-leave

1.1.7  igmp

Syntax

igmp

undo igmp

View

System view

Default Level

2: System level

Parameters

None

Description

Use the igmp command to enter IGMP view.

Use the undo igmp command to remove configurations performed in IGMP view.

Note that IP multicast must be enabled on the device before this command can take effect.

Related commands: igmp enable; multicast routing-enable in Multicast Routing and Forwarding Commands in the IP Multicast Volume.

Examples

# Enter IGMP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] igmp

[Sysname-igmp]

1.1.8  igmp enable

Syntax

igmp enable

undo igmp enable

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp enable command to enable IGMP on the current interface.

Use the undo igmp enable command to disable IGMP on the current interface.

By default, IGMP is disabled on an interface.

Note that:

l           IP multicast must be enabled on the device before this command is meaningful.

l           Before IGMP is enabled on an interface, any other IGMP feature configured on the interface will not take effect.

l           After IGMP is enabled on a VLAN interface, IGMP Snooping cannot be enabled in the VLAN corresponding to the VLAN interface, and vice versa.

Related commands: igmp.

Examples

# Enable IGMP on VLAN-interface 11.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp enable

1.1.9  igmp fast-leave

Syntax

igmp fast-leave [ group-policy acl-number ]

undo igmp fast-leave

View

POS interface view

Default Level

2: System level

Parameters

acl-number: Basic ACL number. If you do not include this option in your command, this command will take effect for all multicast groups.

Description

Use the igmp fast-leave command to enable the fast leave function on the current interface for multicast group members.

Use the undo igmp fast-leave command to disable the fast leave function on the current interface.

By default, the fast leave function is disabled, namely, the IGMP querier sends an IGMP group-specific query upon receiving an IGMP leave message from a host, instead of sending a Leave notification directly to the upstream.

Related commands: fast-leave, igmp lastmember-queryinterval.

By using the group-policy keyword, you can configure an ACL rule to implement control specific to certain groups.

 

 

Examples

# Enable fast leave for multicast group members on POS 4/1/1.

<Sysname> system-view

[Sysname] interface pos 4/1/1

[Sysname-Pos4/1/1] igmp fast-leave

1.1.10  igmp group-policy

Syntax

igmp group-policy acl-number [ version-number ]

undo igmp group-policy

View

POS interface view

Default Level

2: System level

Parameters

acl-number: Basic or advanced ACL number.

version-number: IGMP version. If you do not specify an IGMP version, the configured group filter will apply to IGMP reports of all versions.

Description

Use the igmp group-policy command to configure a multicast group filter on the current interface.

Use the undo igmp group-policy command to remove the configured multicast group filter.

Be default, no multicast group filter is configured, namely a host can join any multicast group.

 

 

Related commands: display igmp group.

Examples

# Configure an ACL rule so that hosts on the subnet attached to POS 4/1/1 can join multicast group 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2005

[Sysname-acl-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2005] quit

[Sysname] interface pos 4/1/1

[Sysname-Pos4/1/1] igmp group-policy 2005

1.1.11  igmp last-member-query-interval

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: IGMP last-member query interval in seconds.

Description

Use the igmp last-member-query-interval command to configure the last-member query interval on the current interface.

Use the undo igmp last-member-query-interval command to restore the last member query interval to the system default on the current interface.

By default, the last-member query interval is 1 second.

Related commands: last-member-query-interval, igmp robust-count, display igmp interface.

Examples

# Set the last-member query interval to 3 seconds on Vlan-interface11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp last-member-query-interval 3

1.1.12  igmp max-response-time

Syntax

igmp max-response-time interval

undo igmp max-response-time

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Maximum response time in seconds for IGMP general queries.

Description

Use the igmp max-response-time command to configure the maximum response time for IGMP general queries on the current interface.

Use the undo igmp max-response-time command to restore the maximum response time for IGMP general queries to the system default.

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: max-response-time, igmp timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds on Vlan-interface11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp max-response-time 8

1.1.13  igmp require-router-alert

Syntax

igmp require-router-alert

undo igmp require-router-alert

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp require-router-alert command to configure the interface to discard IGMP messages that do not carry the Router-Alert option.

Use the undo igmp require-router-alert command to restore the default configuration.

By default, the device does not check the Router-Alert option, namely it passes all the IGMP messages it receives to the upper layer protocol for processing.

After you use the igmp require-router-alert command, when the interface receives an IGMP message, the device checks the Router-Alert option carried in the IGMP message. If the device finds that the message does not carry the Router-Alert option, the device discards the IGMP message.

Related commands: require-router-alert, igmp send-router-alert.

Examples

# Configure Vlan-interface11 to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp require-router-alert

1.1.14  igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

robust-value: IGMP querier robustness variable. The IGMP querier robustness variable determines the number of general queries the IGMP querier sends on startup and the number of IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Description

Use the igmp robust-count command to configure the IGMP querier robustness variable on the current interface.

Use the undo igmp robust-count command to restore the system default.

By default, the IGMP querier robustness variable is 2.

Related commands: robust-count, igmp timer query, igmp last-member-query-interval, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 on VLAN-interface 11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp robust-count 3

1.1.15  igmp send-router-alert

Syntax

igmp send-router-alert

undo igmp send-router-alert

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp send-router-alert command on the current interface to enable insertion of the Router-Alert option in IGMP messages to be sent.

Use the undo igmp send-router-alert command on the current interface to disable insertion of the Router-Alert option in IGMP messages to be sent.

By default, IGMP messages are sent with the Router-Alert option.

Related commands: igmp require-router-alert, igmp require-router-alert.

Examples

# Disable insertion of the Router-Alert option into IGMP messages that leave Vlan-interface11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] undo igmp send-router-alert

1.1.16  igmp static-group

Syntax

igmp static-group group-address [ source source-address ]

undo igmp static-group { all | group-address [ source source-address ] }

View

POS interface view

Default Level

2: System level

Parameters

all: Specifies to remove all static multicast groups that the current interface has joined.

group-address: Multicast group address.

source-address: Multicast source address.

Description

Use the igmp static-group command to configure the current interface to be a statically connected member for the specified multicast group or source-group.

Use the undo igmp static-group command to restore the default.

By default, an interface is not a static member for any multicast group or source-group.

If the specified multicast address is in the SSM multicast address range, you must specify a multicast source address at the same time; otherwise IGMP routing table entries cannot be established. There is no such a restriction if the specified multicast group address is not in the SSM multicast address range.

 

 

Examples

# Configure POS 4/1/1 as a statically connected member for multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface pos4/1/1

[Sysname-Pos4/1/1] igmp static-group 224.1.1.1

# Configure POS 4/1/1 as a statically connected member for multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface pos4/1/1

[Sysname-Pos4/1/1] igmp static-group 232.1.1.1 source 192.168.1.1

1.1.17  igmp timer other-querier-present

Syntax

igmp timer other-querier-present interval

undo igmp timer other-querier-present

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: Other querier present interval in seconds.

Description

Use the igmp timer other-querier-present command to configure the other querier present interval on the current interface.

Use the undo igmp timer other-querier-present command to restore the default configuration.

By default, the other querier present interval is 125 seconds.

Related commands: timer other-querier-present, igmp timer query, igmp robust-count, igmp max-response-time, display igmp interface.

Examples

# Set the other querier present interval to 200 seconds on VLAN-interface 11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp timer other-querier-present 200

1.1.18  igmp timer query

Syntax

igmp timer query interval

undo igmp timer query

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

interval: IGMP query interval in seconds, namely the interval between IGMP general queries sent by the querier.

Description

Use the igmp timer query command to configure the IGMP query interval on the current interface.

Use the undo igmp timer query command to restore the system default.

By default, the IGMP query interval is 60 seconds.

The IGMP querier periodically sends IGMP general queries to decide whether any multicast group member exists on the local subnet. You can modify this interval as required.

Related commands: timer query, igmp timer other-querier-present, display igmp interface.

Examples

# Set the IGMP general query interval to 125 seconds on Vlan-interface11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp timer query 125

1.1.19  igmp version

Syntax

igmp version version-number

undo igmp version

View

VLAN interface view, POS interface view

Default Level

2: System level

Parameters

version-number: IGMP version.

Description

Use the igmp version command to configure the IGMP version on the current interface.

Use the undo igmp version command to restore the IGMP version to the system default.

The default IGMP version is version 2.

All systems (including hosts and routers) on the same subnet must run the same version of IGMP, and cannot automatically switch between different IGMP versions.

Related commands: version.

Examples

# Set the IGMP version to IGMPv1 on Vlan-interface11.

<Sysname> system-view

[Sysname] interface vlan-interface 11

[Sysname-Vlan-interface11] igmp version 1

1.1.20  last-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP view

Default Level

2: System level

Parameters

interval: Last-member query interval in seconds.

Description

Use the last-member-query-interval command to configure the global IGMP last-member query interval.

Use the undo last-member-query-interval command to restore the global IGMP last member query interval to the system default.

By default, the IGMP last-member query interval is 1 second.

This command is the same as the igmp last-member-query-interval command for interface view, but the value configured by the igmp last-member-query-interval command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp last-member-query-interval, robust-count, display igmp interface.

Examples

# Set the global IGMP last-member interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] lastmember-queryinterval 3

1.1.21  max-response-time

Syntax

max-response-time interval

undo igmp max-response-time

View

IGMP view

Default Level

2: System level

Parameters

interval: Maximum response time for IGMP general queries in seconds.

Description

Use the max-response-time command to configure the maximum response time for IGMP general queries.

Use the undo max-response-time command to restore globally the maximum response time for IGMP general queries to the system default.

By default, the maximum response time for IGMP general queries is 10 seconds.

This command is the same as the igmp max-response-time command for interface view, but the value configured by the igmp max-response-time command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp max-response-time, timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 8

1.1.22  require-router-alert

Syntax

require-router-alert

undo require-router-alert

View

IGMP view

Default Level

2: System level

Parameters

None

Description

Use the require-router-alert command to configure the router to discard IGMP messages that do not carry the Router-Alert option.

Use the undo require-router-alert command to restore the default configuration.

By default, the device does not check the Router-Alert option, namely it handles all the IGMP messages it received to the upper layer protocol for processing.

After you use the require-router-alert command, when an IGMP message arrives, the device checks the Router-Alert option carried in the IGMP message. If the device finds that the message does not carry the Router-Alert option, the device discards the IGMP message.

This command is the same as the igmp require-router-alert command for interface view, but the value configured by the igmp require-router-alert command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp require-router-alert.

Examples

# Configure the router to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] require-router-alert

1.1.23  reset igmp group

Syntax

reset igmp group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

View

User view

Default Level

2: System level

Parameters

all: The first all specifies to clear IGMP multicast group information on all interfaces, while the second all specifies to clear the information of all IGMP multicast groups.

interface interface-type interface-number: Clears the IGMP group information on the specified interface.

group-address: Multicast group address.

source-address: Multicast source address.

mask: Subnet mask of the multicast group/source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group/source address. For a multicast group address, this argument has an effective value range of 4 to 32; for a multicast source address, this argument has an effective value range of 0 to 32. The system default is 32 in both cases.

Description

Use the reset igmp group command to clear IGMP multicast group information.

Note that:

l           When clearing the IGMP multicast group information of a VLAN interface, this command also clears the IGMP Snooping multicast group information for that VLAN.

l           This command cannot clear IGMP multicast group information of static joins.

Related commands: display igmp group.

Examples

# Clear all the IGMP multicast group information on all interfaces.

<Sysname> reset igmp group all

# Clear all IGMP multicast group information on VLAN-interface 100.

<Sysname> reset igmp group interface vlan-interface 100 all

# Clear the information of multicast group 225.0.0.1 on VLAN-interface 100.

<Sysname> reset igmp group interface vlan-interface 100 225.0.0.1

1.1.24  robust-count

Syntax

robust-count robust-value

undo robust-count

View

IGMP view

Default Level

2: System level

Parameters

robust-value: IGMP querier robustness variable. The IGMP querier robustness variable determines the default number of general queries the IGMP querier sends on startup and the number of IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Description

Use the robust-count command to configure the IGMP querier robustness variable globally.

Use the undo robust-count command to restore the default setting.

By default, the IGMP querier robustness variable is 2.

This command is the same as the igmp robust-count command for interface view, but the value configured by the igmp robust-count command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp robust-count, last-member-query-interval, timer query, timer other-querier-present, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 3

1.1.25  send-router-alert

Syntax

send-router-alert

undo send-router-alert

View

IGMP view

Default Level

2: System level

Parameters

None

Description

Use the send-router-alert command to enable globally the insertion of the Router-Alert option into IGMP messages to be sent.

Use the undo send-router-alert command to disable globally the insertion of the Router-Alert option into IGMP messages to be sent.

By default, an IGMP message carries the Router-Alert option.

This command is the same as the igmp send-router-alert command for interface view, but the value configured by the igmp send-router-alert command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp send-router-alert, require-router-alert.

Examples

# Globally disable the insertion of the Router-Alert option in IGMP messages to be sent.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] send-router-alert

1.1.26  timer other-querier-present

Syntax

timer other-querier-present interval

undo timer other-querier-present

View

IGMP view

Default Level

2: System level

Parameters

interval: Other querier present interval.

Description

Use the timer other-querier-present command to configure the global other querier present interval.

Use the undo timer other-querier-present command to restore the default.

By default, the other querier present interval is 125 seconds.

This command is the same as the igmp timer other-querier-present command for interface view, but the value configured by the igmp timer other-querier-present command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp timer other-querier-present, timer query, robust-count, max-response-time, display igmp interface.

Examples

# Set the global value of the other querier present interval to 200 seconds.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer other-querier-present 200

1.1.27  timer query

Syntax

timer query interval

undo timer query

View

IGMP view

Default Level

2: System level

Parameters

interval: IGMP query interval in seconds, namely interval between IGMP general queries sent by the querier.

Description

Use the timer query command to configure the IGMP query interval globally.

Use the undo timer query command to restore the default setting.

By default, IGMP query interval is 60 seconds.

This command is the same as the igmp timer query command for interface view, but the value configured by the igmp timer query command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp timer query, timer other-querier-present, display igmp interface.

Examples

# Set the global value of the IGMP query interval to 125 seconds.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer query 125

1.1.28  version

Syntax

version version-number

undo version

View

IGMP view

Default Level

2: System level

Parameters

version-number: IGMP version.

Description

Use the version command to configure the global IGMP version.

Use the undo version command to restore the global IGMP version to the system default.

The default IGMP version is version 2.

This command is the same as the igmp version command for interface view, but the value configured by the igmp version command has a higher priority, that is, the system gives priority to configurations made in interface view.

Related commands: igmp version.

Examples

# Set the global IGMP version to IGMPv1.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] version 1