display mld-snooping group [ vlan vlan-id ] [ chassis chassis-number slot slot-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the MLD snooping group information on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument refers to the ID of the IRF member device, and the slot-number argument refers to the number of the slot where the card resides. If this option is not specified, the command displays the information of MLD snooping groups on all MPUs in the IRF member device. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

verbose: Displays detailed MLD snooping group information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display mld-snooping group to display MLD snooping group information, including both dynamic and static MLD snooping group entries. If you do not specify a VLAN, this command displays MLD snooping group information in all VLANs.

Examples

# Display detailed MLD snooping group information in VLAN 4000 on the card in slot 9 on IRF member device 1.

<Sysname> display mld-snooping group vlan 4000 chassis 1 slot 9 verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port

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

Vlan(id):4000.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port unit board: Mask(0x0000000000000000)

Router port(s):total 0 port(s).

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

IP group address:FF1E::101

(::, FF1E::101):

Attribute: Host Port

Host port unit board: Mask(0x0000000000000000)

Host port(s):total 1 port(s).

GE1/9/0/48 (D) ( 00:03:35 )

MAC group(s):

MAC group address:3333-0000-0101

Host port unit board: Mask(0x0000000000000000)

Host port(s):total 1 port(s).

GE1/9/0/48

Table 1 Command output

Field	Description
Total 1 IP Group(s).	Total number of IPv6 multicast groups.
Total 1 IP Source(s).	Total number of IPv6 multicast sources.
Total 1 MAC Group(s).	Total number of MAC multicast groups.
Port flags: D-Dynamic port, S-Static port, C-Copy port, P-PIM port	Port flags: · D—A dynamic port. · S—A static port. · C—A port copied from a (*, G) entry to an (S, G) entry. · P—A port that IPv6 PIM snooping adds.
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: · R—Real egress sub-VLAN under the current entry. · C—Sub-VLAN copied from a (*, G) entry to an (S, G) entry.
Router port unit board	Mask indicating a board with a router port residing on it.
Router port(s)	Number of router ports.
( 00:03:35 )	Remaining time of the aging timer for the dynamic member port or router port: · In standalone mode, to display the remaining life of a non-aggregation port that does not belong to the MPU, you must specify the number of the slot where the corresponding card resides by using slot slot-number. This is not required for an aggregation port. · In IRF mode, to display the remaining life of a non-aggregation port that does not belong to the MPU, you must specify the ID of the IRF member device and the slot number of the card with chassis chassis-number slot slot-number. For an aggregation port, you do not need to do this.
IP group address	Address of IPv6 multicast group.
(::, FF1E::101)	(S, G) entry. If the IPv6 multicast source is not specified, the field in the S position displays the double colon (::).
MAC group address	Address of MAC multicast group.
Attribute	Attribute of IPv6 multicast group.
Host port unit board	Mask indicating a board with a member port residing on it.
Host port(s)	Number of member ports.

display mld-snooping host

Syntax

Standalone mode:

display mld-snooping host vlan vlan-id group ipv6-group-address [ source ipv6-source-address ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

IRF mode:

display mld-snooping host vlan vlan-id group ipv6-group-address [ source ipv6-source-address ] [ chassis chassis-number slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

group ipv6-group-address: Specifies an IPv6 multicast group. The value range for the ipv6-group-address argument is FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16, and FF0y::), where "x" and "y" represent any hexadecimal numbers from 0 to F.

source ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If this option is specified, this command displays information about the hosts tracked by MLD snooping for the specified IPv6 multicast source. If this option is not specified, this commands displays information about the host tracked by MLD snooping for all IPv6 multicast sources.

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the MLD snooping host information on the MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument refers to the ID of the IRF member device, and the slot-number argument refers to the number of the slot where the card resides. If this option is not specified, this command displays information about the MLD snooping tracked hosts on all MPUs in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display mld-snooping host to display information about the hosts tracked by MLD snooping.

Examples

# Display information about the hosts tracked by MLD snooping in multicast group FF1E::101 in VLAN 2.

<Sysname> display mld-snooping host vlan 2 group ff1e::101

VLAN(ID) : 2

(::, FF1E::101)

Port : GigabitEthernet3/0/1

Host Uptime Expires

1::1 00:02:20 00:00:40

2::2 00:02:21 00:00:39

Port : GigabitEthernet3/0/2

Host Uptime Expires

3::3 00:02:20 00:00:40

Table 2 Command output

Field	Description
(::, FF1E::101)	(S, G) entry. If the IPv6 multicast source is not specified, the field in the S position displays the double colon (::).
Port	Member port.
Host	Host IPv6 address.
Uptime	Host running duration.
Expires	Host expiration time. If this host has expired, this field displays timeout.

display mld-snooping statistics

Syntax

display mld-snooping statistics [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display mld-snooping statistics to display statistics for the MLD messages learned through MLD snooping.

Examples

# Display statistics for the MLD messages learned through MLD snooping.

<Sysname> display mld-snooping statistics

Received MLD general queries:0.

Received MLDv1 specific queries:0.

Received MLDv1 reports:0.

Received MLD dones:0.

Sent MLDv1 specific queries:0.

Received MLDv2 reports:0.

Received MLDv2 reports with right and wrong records:0.

Received MLDv2 specific queries:0.

Received MLDv2 specific sg queries:0.

Sent MLDv2 specific queries:0.

Sent MLDv2 specific sg queries:0.

Received error MLD messages:0.

Table 3 Command output

Field	Description
general queries	General query messages.
specific queries	Multicast-address-specific query messages.
reports	Report messages.
dones	Done messages.
reports with right and wrong records	Reports containing correct and incorrect records.
specific sg queries	Multicast-address-and-source-specific queries.

entry-limit (MLD-snooping view)

Syntax

entry-limit limit

undo entry-limit

View

MLD-snooping view

Default level

2: System level

Parameters

limit: Specifies the maximum number of MLD snooping forwarding entries, in the range of 0 to 2000.

Description

Use entry-limit to set the global maximum number of MLD snooping forwarding entries.

Use undo entry-limit to restore the default.

By default, the upper limit is 2000.

Related commands: multicast-vlan ipv6 entry-limit.

Examples

# Set the global maximum number of MLD snooping forwarding entries to 512.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] entry-limit 512

fast-leave (MLD-snooping view)

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

MLD-snooping view

Default level

2: System level

Parameters

vlan vlan-list: Specifies one or multiple VLANs. You can provide up to 10 VLAN lists. For each list, you can specify an individual VLAN in the form of vlan-id, or a VLAN range in the form of start-vlan-id to end-vlan-id, where the end VLAN ID must be greater than the start VLAN ID. The value range of a VLAN ID is 1 to 4094. If you do not specify any VLAN, the command applies to all VLANs. If you specify one or multiple VLANs, the command applies to the specified VLANs.

Description

Use fast-leave to enable MLD snooping fast-leave processing globally. With this function enabled, when the switch receives an MLD done message on a port, it directly removes that port from the forwarding table entry for a specific group.

Use undo fast-leave to disable MLD snooping fast-leave processing globally.

By default, MLD snooping fast-leave processing is disabled.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

Related commands: mld-snooping fast-leave.

Examples

# Enable MLD snooping fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] fast-leave vlan 2

group-policy (MLD-snooping view)

Syntax

group-policy acl6-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

View

MLD-snooping view

Default level

2: System level

Parameters

Acl6-number: Specifies a basic or advanced IPv6 ACL number in the range of 2000 to 3999. A host can join only the IPv6 multicast groups that match the permit statement in the specified ACL. The source address or address range specified in the advanced IPv6 ACL rule matches the IPv6 multicast source address or addresses specified in MLDv2 reports, rather than the source address in the IPv6 packets. The system assumes that an MLDv1 report or an MLDv2 IS_EX or TO_EX report that does not carry an IPv6 multicast source address carries an IPv6 multicast source address of 0::0.

Description

Use group-policy to configure a global IPv6 multicast group filter to control the IPv6 multicast groups that a host can join.

Use undo group-policy to remove the configured global IPv6 multicast group filter.

By default, no IPv6 multicast group filter is configured globally, and a host can join any valid IPv6 multicast group.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

If the specified IPv6 ACL does not exist or the ACL rule is null, all IPv6 multicast groups will be filtered out.

You can configure different IPv6 ACL rules for each port in different VLANs. For a given VLAN, a newly configured IPv6 ACL rule will override the existing one.

Related commands: mld-snooping group-policy.

Examples

# Apply ACL 2000 as an IPv6 multicast group filter so that hosts in VLAN 2 can join FF03::101 only.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source ff03::101 16

[Sysname-acl6-basic-2000] quit

[Sysname] mld-snooping

[Sysname-mld-snooping] group-policy 2000 vlan 2

host-aging-time (MLD-snooping view)

Syntax

host-aging-time interval

undo host-aging-time

View

MLD-snooping view

Default level

2: System level

Parameters

interval: Specifies a dynamic member port aging time in seconds, in the range of 200 to 1000.

Description

Use host-aging-time to set the global aging timer for dynamic member ports.

Use undo host-aging-time to restore the default.

By default, the aging timer of a dynamic member port is 260 seconds.

Related commands: mld-snooping host-aging-time.

Examples

# Set the global aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] host-aging-time 300

host-tracking (MLD-snooping view)

Syntax

host-tracking

undo host-tracking

View

MLD-snooping view

Default level

2: System level

Parameters

None

Description

Use host-tracking to enable the MLD snooping host tracking function globally.

Use undo host-tracking to disable the MLD snooping host tracking function globally.

By default, this function is disabled.

Related commands: display mld-snooping host and mld-snooping host-tracking.

Examples

# Enable the MLD snooping host tracking function globally.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] host-tracking

last-listener-query-interval (MLD-snooping view)

Syntax

last-listener-query-interval interval

undo last-listener-query-interval

View

MLD-snooping view

Default level

2: System level

Parameters

interval: Specifies an MLD last listener query interval (length of time that the device waits between sending MLD multicast-address-specific queries) in the range of 1 to 5 seconds.

Description

Use last-listener-query-interval to set the global MLD last-listener query interval.

Use undo last-listener-query-interval to restore the default.

By default, the global MLD last-listener query interval is 1 second.

Related commands: mld-snooping last-listener-query-interval.

Examples

# Set the global MLD last-listener query interval to 3 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] last-listener-query-interval 3

max-response-time (MLD-snooping view)

Syntax

max-response-time interval

undo max-response-time

View

MLD-snooping view

Default level

2: System level

Parameters

interval: Specifies the maximum response time for MLD general queries, in the range of 1 to 25 seconds.

Description

Use max-response-time to set the global maximum response time for MLD general queries.

Use undo max-response-time to restore the default.

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

Related commands: mld-snooping max-response-time and mld-snooping query-interval.

Examples

# Set the global maximum response time for MLD general queries to 5 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] max-response-time 5

mld-snooping

Syntax

mld-snooping

undo mld-snooping

View

System view

Default level

2: System level

Parameters

None

Description

Use mld-snooping to enable MLD snooping globally and enter MLD-snooping view.

Use undo mld-snooping to disable MLD snooping globally.

By default, MLD snooping is disabled.

Related commands: mld-snooping enable.

Examples

# Enable MLD snooping globally and enter MLD-snooping view.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping]

mld-snooping done source-ip

Syntax

mld-snooping done source-ip { ipv6-address | current-interface }

undo mld-snooping done source-ip

View

VLAN view

Default level

2: System level

Parameters

ipv6-address: Specifies a source IPv6 address for the MLD done messages sent by the MLD snooping proxy, which can be any legal IPv6 link-local address.

current-interface: Specifies the IPv6 link-local address of the current VLAN interface as the source address of MLD done messages sent by the MLD snooping proxy. If no IPv6 address has been assigned to the current interface, the default IPv6 address FE80::02FF:FFFF:FE00:0001 is used.

Description

Use mld-snooping done source-ip to configure the source IPv6 address of the MLD done messages sent by the MLD snooping proxy.

Use undo mld-snooping done source-ip to restore the default.

By default, the source IPv6 address of the MLD done messages sent by the MLD snooping proxy is FE80::02FF:FFFF:FE00:0001.

Before you configure this command in a VLAN, enable MLD snooping for the VLAN.

The source IPv6 address configured in the mld-snooping done source-ip command also applies when the simulated host sends MLD done messages.

Related commands: mld-snooping enable.

Examples

# Enable MLD snooping in VLAN 2 and configure the source IPv6 address of MLD done messages sent by the MLD snooping proxy in VLAN 2 to FE80:0:0:1::1.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping done source-ip fe80:0:0:1::1

mld-snooping drop-unknown

Syntax

mld-snooping drop-unknown

undo mld-snooping drop-unknown

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use mld-snooping drop-unknown to enable dropping unknown IPv6 multicast data in the current VLAN.

Use undo mld-snooping drop-unknown to disable dropping unknown IPv6 multicast data in the current VLAN.

By default, this function is disabled, unknown IPv6 multicast data is flooded in the VLAN.

This command takes effect only if MLD snooping is enabled for the VLAN.

After you enable dropping unknown IPv6 multicast data, the switch does not drop the unknown IPv6 multicast data with the multicast MAC address of 3333-0000-00xx or 3333-FFxx-xxxx (where "x" represents any hexadecimal numbers from 0 to F). Instead, the device floods the IPv6 multicast data in the VLANs to which they belong.

Related commands: mld-snooping enable.

Examples

# Enable MLD snooping and the function for dropping unknown IPv6 multicast data in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping drop-unknown

mld-snooping enable

Syntax

mld-snooping enable

undo mld-snooping enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use mld-snooping enable to enable MLD snooping in the current VLAN.

Use undo mld-snooping enable to disable MLD snooping in the current VLAN.

By default, MLD snooping is disabled in a VLAN.

MLD snooping must be enabled globally before it can be enabled in a VLAN

Related commands: mld-snooping.

Examples

# Enable MLD snooping in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

mld-snooping fast-leave

Syntax

mld-snooping fast-leave [ vlan vlan-list ]

undo mld-snooping fast-leave [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use mld-snooping fast-leave to enable MLD snooping fast-leave processing on a port. With this function enabled, when the port receives an MLD done message, the switch directly removes the port from the forwarding table entry for a specific group.

Use undo mld-snooping fast-leave to disable MLD snooping fast-leave processing on a port.

By default, MLD snooping fast-leave processing is disabled.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

If you do not specify any VLAN when using this command in Layer 2 Ethernet interface view or Layer 2 aggregate interface view, the command takes effect on all VLANs to which the interface belongs. If you specify one or multiple VLANs, the command takes effect on the specified VLANs to which the interface belongs.

If you do not specify any VLAN when using this command in port group view, the command takes effect on all the ports in this group. If you specify one or multiple VLANs, the command takes effect only on those ports in this group that belong to the specified VLANs.

Related commands: fast-leave.

Examples

# Enable MLD snooping fast-leave processing on GigabitEthernet 3/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping fast-leave vlan 2

mld-snooping general-query source-ip

Syntax

mld-snooping general-query source-ip { ipv6-address | current-interface }

undo mld-snooping general-query source-ip

View

VLAN view

Default level

2: System level

Parameters

ipv6-address: Specifies the source IPv6 address of MLD general queries, which can be any legal IPv6 link-local address.

current-interface: Sets the source IPv6 link-local address of MLD general queries to the IPv6 address of the current VLAN interface. If the current VLAN interface does not have an IPv6 address, the default IPv6 address FE80::02FF:FFFF:FE00:0001 will be used as the source IPv6 address of MLD general queries.

Description

Use mld-snooping general-query source-ip to configure the source IPv6 address of MLD general queries.

Use undo mld-snooping general-query source-ip to restore the default.

By default, the source IPv6 address of MLD general queries is FE80::02FF:FFFF:FE00:0001.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: mld-snooping enable.

Examples

# In VLAN 2, enable MLD snooping and specify FE80:0:0:1::1 as the source IPv6 address of MLD general queries.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping general-query source-ip fe80:0:0:1::1

mld-snooping group-limit

Syntax

mld-snooping group-limit limit [ vlan vlan-list ]

undo mld-snooping group-limit [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

limit: Specifies the maximum number of IPv6 multicast groups that a port can join, in the range of 1 to 1024.

Description

Use mld-snooping group-limit to set the maximum number of IPv6 multicast groups that a port can join.

Use undo mld-snooping group-limit to restore the default.

By default, the upper limit is 1024.

For a switch that supports both MLD snooping and MLD, you can also use the mld group-limit command to limit the number of IPv6 multicast groups that an interface can join. However, if you configure the limit both on a VLAN and on a VLAN interface of this VLAN by using these two commands, inconsistencies might exist between Layer 2 and Layer 3 table entries. Therefore, H3C recommends that you configure the limit only on the VLAN interface.

Related commands: mld group-limit.

Examples

# Configure to allow GigabitEthernet 3/0/1 in VLAN 2 to join up to 10 IPv6 multicast groups.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping group-limit 10 vlan 2

mld-snooping group-policy

Syntax

mld-snooping group-policy acl6-number [ vlan vlan-list ]

undo mld-snooping group-policy [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

acl6-number: Specifies a basic or advanced IPv6 ACL number in the range of 2000 to 3999. A host can join only the IPv6 multicast groups that match the permit statement in the specified ACL. The IPv6 source address or address range specified in the advanced IPv6 ACL rule is the IPv6 multicast source address or addresses specified in MLDv2 reports, rather than the source address in the IPv6 packets. The system assumes that an MLDv1 report or an MLDv2 IS_EX or TO_EX report that does not carry an IPv6 multicast source address carries an IPv6 multicast source address of 0::0.

Description

Use mld-snooping group-policy to configure an IPv6 multicast group filter on a port to control the multicast groups that the port can join.

Use undo mld-snooping group-policy to remove the configured IPv6 multicast group filter on a port.

By default, no IPv6 multicast group filter is configured on a port and a host can join any valid IPv6 multicast group.

If the specified ACL does not exist or the ACL rule is null, all IPv6 multicast groups will be filtered out.

You can configure different IPv6 ACL rules for each port in different VLANs. For a given VLAN, a newly configured IPv6 ACL rule will override the existing one.

Related commands: group-policy.

Examples

# Apply ACL 2000 as an IPv6 multicast group filter so that hosts on GigabitEthernet 3/0/1 in VLAN 2 can join FF03::101 only.

<Sysname> system-view

[Sysname] acl ipv6 number 2000

[Sysname-acl6-basic-2000] rule permit source ff03::101 16

[Sysname-acl6-basic-2000] quit

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping group-policy 2000 vlan 2

mld-snooping host-aging-time

Syntax

mld-snooping host-aging-time interval

undo mld-snooping host-aging-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies a dynamic member port aging timer in seconds, in the range of 200 to 1000.

Description

Use mld-snooping host-aging-time to set the aging timer for the dynamic member ports in a VLAN.

Use undo mld-snooping host-aging-time to restore the default.

By default, the dynamic member port aging timer is 260 seconds.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: host-aging-time and mld-snooping enable.

Examples

# Enable MLD snooping and set the aging timer for the dynamic member ports in VLAN 2 to 300 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping host-aging-time 300

mld-snooping host-join

Syntax

mld-snooping host-join ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

undo mld-snooping host-join ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where "x" and "y" represent any hexadecimal numbers from 0 to F.

ipv6-source-address: Specifies an IPv6 multicast source address.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

Description

Use mld-snooping host-join to configure a port as a simulated member host for the specified IPv6 multicast group or source and group.

Use undo mld-snooping host-join to remove a simulated member host.

By default, no ports are configured as static member ports for any IPv6 multicast group or source and group.

The version of MLD on the simulated host is consistent with the version of MLD snooping running on the VLAN.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces. The version of MLD on the simulated host is consistent with the version of MLD running on the VLAN interfaces.

The source-ip ipv6-source-address option in the command is meaningful only for MLDv2 snooping. If MLDv1 snooping is running, the source-ip ipv6-source-address option does not take effect although you can include source-ip ipv6-source-address in the command.

In Layer 2 Ethernet interface view or Layer 2 aggregate interface view, this feature takes effect only if the interface belongs to the specified VLAN. In port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 3/0/1 in VLAN 2 to join (2002::22, FF3E::101) as a simulated host.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping host-join ff3e::101 source-ip 2002::22 vlan 2

mld-snooping host-tracking

Syntax

mld-snooping host-tracking

undo mld-snooping host-tracking

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use mld-snooping host-tracking to enable the MLD snooping host tracking function in a VLAN.

Use undo mld-snooping host-tracking to disable the MLD snooping host tracking function in a VLAN.

By default, this function is disabled.

Before you configure this command, enable MLD snooping for the VLAN first.

Related commands: display mld-snooping host, host-tracking, and mld-snooping enable.

Examples

# Enable MLD snooping and the MLD snooping host tracking function for VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping host-tracking

mld-snooping last-listener-query-interval

Syntax

mld-snooping last-listener-query-interval interval

undo mld-snooping last-listener-query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies an MLD last listener query interval (length of time that the device waits between sending MLD multicast-address-specific queries) in the range of 1 to 5 seconds.

Description

Use mld-snooping last-listener-query-interval to set the MLD last-listener query interval in the VLAN.

Use undo mld-snooping last-listener-query-interval to restore the default.

By default, the MLD last listener query interval is 1 second.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: last-listener-query-interval and mld-snooping enable.

Examples

# Enable MLD snooping and set the MLD last-listener query interval to 3 seconds in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping last-listener-query-interval 3

mld-snooping max-response-time

Syntax

mld-snooping max-response-time interval

undo mld-snooping max-response-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies the maximum response time for MLD general queries in seconds, in the range of 1 to 25.

Description

Use mld-snooping max-response-time to set the maximum response time for MLD general queries in the VLAN.

Use undo mld-snooping max-response-time to restore the default.

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

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: max-response-time, mld-snooping enable, and mld-snooping query-interval.

Examples

# Enable MLD snooping and set the maximum response time for MLD general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping max-response-time 5

mld-snooping overflow-replace

Syntax

mld-snooping overflow-replace [ vlan vlan-list ]

undo mld-snooping overflow-replace [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use mld-snooping overflow-replace to enable the IPv6 multicast group replacement function on a port.

Use undo mld-snooping overflow-replace to disable the IPv6 multicast group replacement function on a port.

By default, the IPv6 multicast group replacement function is disabled.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

Related commands: overflow-replace.

Examples

# Enable the IPv6 multicast group replacement function on GigabitEthernet 3/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping overflow-replace vlan 2

mld-snooping proxying enable

Syntax

mld-snooping proxying enable

undo mld-snooping proxying enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use mld-snooping proxying enable to enable the MLD snooping proxying function in a VLAN.

Use undo mld-snooping proxying enable to disable the MLD snooping proxying function in a VLAN.

By default, MLD snooping proxying is disabled in all VLANs.

Before you configure this command in a VLAN, enable MLD snooping for the VLAN.

Related commands: mld-snooping enable.

Examples

# Enable MLD snooping and then MLD snooping proxying in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping proxying enable

mld-snooping querier

Syntax

mld-snooping querier

undo mld-snooping querier

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use mld-snooping querier to enable the MLD snooping querier function.

Use undo mld-snooping querier to disable the MLD snooping querier function.

By default, the MLD snooping querier function is disabled.

This command takes effect only if MLD snooping is enabled for the VLAN, and it does not take effect in a sub-VLAN of an IPv6 multicast VLAN.

Related commands: mld-snooping enable and subvlan.

Examples

# Enable MLD snooping and the MLD snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping querier

mld-snooping query-interval

Syntax

mld-snooping query-interval interval

undo mld-snooping query-interval

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies an MLD query interval (length of time that the device waits between sending MLD general queries) in the range of 2 to 300 seconds.

Description

Use mld-snooping query-interval to set the MLD query interval.

Use undo mld-snooping query-interval to restore the default.

By default, the MLD query interval is 125 seconds.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: max-response-time, mld-snooping enable, mld-snooping max-response-time, and mld-snooping querier.

Examples

# Enable MLD snooping and set the MLD query interval to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping query-interval 20

mld-snooping report source-ip

Syntax

mld-snooping report source-ip { ipv6-address | current-interface }

undo mld-snooping report source-ip

View

VLAN view

Default level

2: System level

Parameters

ipv6-address: Specifies a source IPv6 address for the MLD reports sent by the MLD snooping proxy, which can be any legal IPv6 link-local address.

current-interface: Specifies the IPv6 link-local address of the current VLAN interface as the source address of MLD reports sent by the MLD snooping proxy. If no IPv6 address has been assigned to the current interface, the default IPv6 address FE80::02FF:FFFF:FE00:0001 is used.

Description

Use mld-snooping report source-ip to configure the source IPv6 address of the MLD reports sent by the MLD snooping proxy.

Use undo mld-snooping report source-ip to restore the default.

By default, the source IPv6 address of the MLD reports sent by the MLD snooping proxy is FE80::02FF:FFFF:FE00:0001.

Before you configure this command in a VLAN, enable MLD snooping for the VLAN.

The source IPv6 address configured in the mld-snooping report source-ip command also applies when the simulated host sends MLD reports.

Related commands: mld-snooping enable.

Examples

# Enable MLD snooping in VLAN 2 and configure the source IPv6 address of MLD reports sent by the MLD snooping proxy in VLAN 2 to FE80:0:0:1::1.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping report source-ip fe80:0:0:1::1

mld-snooping router-aging-time

Syntax

mld-snooping router-aging-time interval

undo mld-snooping router-aging-time

View

VLAN view

Default level

2: System level

Parameters

interval: Specifies a dynamic router port aging timer in seconds, in the range of 1 to 1000.

Description

Use mld-snooping router-aging-time to set the aging timer for the dynamic router ports in a VLAN.

Use undo mld-snooping router-aging-time to restore the default.

By default, the dynamic router port aging timer is 260 seconds.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: mld-snooping enable and router-aging-time.

Examples

# Enable MLD snooping and set the aging timer for the dynamic router ports in VLAN 2 to 100 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping router-aging-time 100

mld-snooping router-port-deny

Syntax

mld-snooping router-port-deny [ vlan vlan-list ]

undo mld-snooping router-port-deny [ vlan vlan-list ]

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

Description

Use mld-snooping router-port-deny to disable a port from becoming a dynamic router port.

Use undo mld-snooping router-port-deny to restore the default.

By default, a port can become a dynamic router port.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

Examples

# Disable GigabitEthernet 3/0/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping router-port-deny vlan 2

mld-snooping special-query source-ip

Syntax

mld-snooping special-query source-ip { ipv6-address | current-interface }

undo mld-snooping special-query source-ip

View

VLAN view

Default level

2: System level

Parameters

ipv6-address: Specifies an IPv6 link-local address as the source IPv6 address of MLD multicast-address-specific queries.

current-interface: Specifies the source IPv6 link-local address of the VLAN interface of the current VLAN as the source IPv6 address of MLD multicast-address-specific queries. If the current VLAN interface does not have an IPv6 address, the default IPv6 address FE80::02FF:FFFF:FE00:0001 will be used as the source IPv6 address of MLD multicast-address-specific queries.

Description

Use mld-snooping special-query source-ip to configure the source IPv6 address of MLD multicast-address-specific queries.

Use undo mld-snooping special-query source-ip to restore the default.

By default, the source IPv6 address of MLD multicast-address-specific queries is FE80::02FF:FFFF:FE00:0001.

This command takes effect only if MLD snooping is enabled for the VLAN.

Related commands: mld-snooping enable.

Examples

# In VLAN 2, enable MLD snooping and specify FE80:0:0:1::1 as the source IPv6 address of MLD multicast-address-specific queries.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping special-query source-ip fe80:0:0:1::1

mld-snooping static-group

Syntax

mld-snooping static-group ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

undo mld-snooping static-group ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

ipv6-source-address: Specifies an IPv6 source address.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

Description

Use mld-snooping static-group to configure a port as a static member port for an IPv6 multicast group or IPv6 multicast source and group.

Use undo mld-snooping static-group to restore the default.

By default, no ports are static member ports.

Examples

# Configure GigabitEthernet 3/0/1 in VLAN 2 as a static member port for the IPv6 multicast source and group (2002::22, FF3E::101).

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping static-group ff3e::101 source-ip 2002::22 vlan 2

mld-snooping static-router-port

Syntax

mld-snooping static-router-port vlan vlan-id

undo mld-snooping static-router-port vlan vlan-id

View

Layer 2 Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

Description

Use mld-snooping static-router-port to configure a port as a static router port.

Use undo mld-snooping static-router-port to restore the default.

By default, no ports are static router ports.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

This command does not take effect in a sub-VLAN of an IPv6 multicast VLAN.

Related commands: subvlan.

Examples

# Enable the static router port function on GigabitEthernet 3/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mld-snooping static-router-port vlan 2

mld-snooping version

Syntax

mld-snooping version version-number

undo mld-snooping version

View

VLAN view

Default level

2: System level

Parameters

version-number: Specifies an MLD snooping version, 1 or 2.

Description

Use mld-snooping version to specify the MLD snooping version.

Use undo mld-snooping version to restore the default.

By default, the MLDv1 snooping is used.

This command takes effect only if MLD snooping is enabled for the VLAN, and it does not take effect in a sub-VLAN of an IPv6 multicast VLAN.

Related commands: mld-snooping enable and subvlan.

Examples

# Enable MLD snooping in VLAN 2, and specify the MLD snooping version as MLDv2 snooping.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

overflow-replace (MLD-snooping view)

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

MLD-snooping view

Default level

2: System level

Parameters

Description

Use overflow-replace to enable the IPv6 multicast group replacement function globally.

Use undo overflow-replace to disable the IPv6 multicast group replacement function globally.

By default, the IPv6 multicast group replacement function is disabled globally.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

Related commands: mld-snooping overflow-replace.

Examples

# Enable the IPv6 multicast group replacement function globally in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] overflow-replace vlan 2

report-aggregation (MLD-snooping view)

Syntax

report-aggregation

undo report-aggregation

View

MLD-snooping view

Default level

2: System level

Parameters

None

Description

Use report-aggregation to enable MLD report suppression.

Use undo report-aggregation to disable MLD report suppression.

By default, MLD report suppression is enabled.

This command is also effective on VLANs with MLD enabled on their VLAN interfaces.

Examples

# Disable MLD report suppression.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] undo report-aggregation

reset mld-snooping group

Syntax

reset mld-snooping group { ipv6-group-address | all } [ vlan vlan-id ]

View

User view

Default level

2: System level

Parameters

all: Specifies all IPv6 multicast groups.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094.

Description

Use reset mld-snooping group to remove the dynamic group entries of an MLD snooping group or all MLD snooping groups.

This command cannot remove the static group entries of MLD snooping groups.

Examples

# Remove the dynamic group entries of all MLD snooping groups.

<Sysname> reset mld-snooping group all

reset mld-snooping statistics

Syntax

reset mld-snooping statistics

View

User view

Default level

2: System level

Parameters

None

Description

Use reset mld-snooping statistics to clear statistics for the MLD messages learned through MLD snooping.

Examples

# Clear statistics for all MLD messages learned through MLD snooping.

<Sysname> reset mld-snooping statistics

router-aging-time (MLD-snooping view)

Syntax

router-aging-time interval

undo router-aging-time

View

MLD-snooping view

Default level

2: System level

Parameters

interval: Specifies a dynamic router port aging timer in seconds, in the range of 1 to 1000.

Description

Use router-aging-time to set the aging timer for dynamic router ports globally.

Use undo router-aging-time to restore the default.

By default, the dynamic router port aging timer is 260 seconds.

Related commands: mld-snooping router-aging-time.

Examples

# Set the aging timer for dynamic router ports globally to 100 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] router-aging-time 100

08-IP Multicast Command Reference

entry-limit (MLD-snooping view)

group-policy (MLD-snooping view)

host-aging-time (MLD-snooping view)

host-tracking (MLD-snooping view)

max-response-time (MLD-snooping view)

mld-snooping

mld-snooping drop-unknown

mld-snooping enable

mld-snooping fast-leave

mld-snooping group-policy

mld-snooping host-aging-time

mld-snooping host-tracking

mld-snooping max-response-time

mld-snooping overflow-replace

mld-snooping querier

mld-snooping query-interval

mld-snooping router-port-deny

report-aggregation (MLD-snooping view)

router-aging-time (MLD-snooping view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us