vlan vlan-id: Displays the MLD snooping group information in the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command displays MLD snooping group information in all VLANs.

slot slot-number: Displays information about MLD snooping groups on the card specified by its slot number. If no slot is specified, the command displays the MLD snooping group information on the main processing unit (MPU).

verbose: Displays the 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 the display mld-snooping group command to view the MLD snooping group information, including both dynamic and static MLD snooping group entries.

Examples

# View the MLD snooping group information.

<Sysname> display mld-snooping group slot 5 verbose

Total 2 IP Group(s).

Total 4 IP Source(s).

Total 2 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):10.

Total 2 IP Group(s).

Total 4 IP Source(s).

Total 2 MAC Group(s).

Router port unit board: Mask(0x0)

Router port(s):total 1 port.

GE4/1/4 (A,D) ( 00:04:05 )

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

IP group address:FF0E::101:102

(::, FF0E::101:102):

Attribute: Host AggPort

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A,D) ( 00:04:06 )

(430::1, FF0E::101:102):

Attribute: Host AggPort

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A,D,C) ( 00:04:14 )

MAC group(s):

MAC group address:3333-0101-0102

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A)

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

IP group address:FF0E::101:101

(::, FF0E::101:101):

Attribute: Host AggPort

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A,D) ( 00:04:12 )

(430::1, FF0E::101:101):

Attribute: Host AggPort

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A,D,C) ( 00:04:11 )

MAC group(s):

MAC group address:3333-0101-0101

Host port unit board: Mask(0x0)

Host port(s):total 1 port.

GE4/1/4 (A)

Table 1 Output description

Field	Description
Total 2 IP Group(s).	Total number of IPv6 multicast groups
Total 4 IP Source(s).	Total number of IPv6 multicast sources
Total 2 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 for real egress sub-VLAN under the current entry, C for 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:04:05 )	Remaining time of the aging timer for the dynamic member port or router port. 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.
IP group address	Address of IPv6 multicast group
(::, FF0E::101:102)	(S, G) entry, :: represents all the multicast sources
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

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

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays information about the hosts tracked by MLD snooping in the specified VLAN, where vlan-id is in the range of 1 to 4094.

group ipv6-group-address: Displays information about the hosts tracked by MLD snooping that are in the specified IPv6 multicast group. The value of ipv6-group-address is in the range of FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16, and FF0y::), where x and y represent any hexadecimal number ranging from 0 to F.

source ipv6-source-address: Displays information about the hosts tracked by MLD snooping that are in the specified IPv6 multicast source.

slot slot-number: Displays information about the hosts tracked by MLD snooping on the card specified by its slot number. If no slot is specified, the command displays the MLD snooping host information on the MPU.

|: 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 the display mld-snooping host command 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/1/1

Host Uptime Expires

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

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

Port : GigabitEthernet3/1/2

Host Uptime Expires

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

Table 2 Output description

Field	Description
VLAN(ID)	VLAN ID
(::, FF1E::101)	(S, G) entry, where :: indicates all IPv6 multicast sources.
Port	Member port
Host	Host IPv6 address
Uptime	Host running duration
Expires	Host expiration time, where timeout means that the host has expired.

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 the display mld-snooping statistics command to display statistics for MLD messages learned by MLD snooping.

Examples

# Display statistics for all MLD messages learned by 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 Output description

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
error MLD messages	Error MLD messages

entry-limit (MLD-snooping view)

Syntax

entry-limit limit

undo entry-limit

View

MLD-snooping view

Default level

2: System level

Parameters

limit: Maximum number of entries in the MLD snooping forwarding table. The value ranges from 0 to 1024.

Description

Use the entry-limit command to configure the maximum number of entries in the MLD snooping forwarding table globally.

Use the undo entry-limit command to restore the default.

By default, the upper limit is 1024.

Related commands: multicast-vlan ipv6 entry-limit.

Examples

# Configure the MLD snooping forwarding table to contain at most 512 entries.

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

Description

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

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

By default, fast-leave processing is disabled.

This command works on both MLD snooping–enabled VLANs and VLANs with MLD enabled on their VLAN interfaces.

Related commands: mld-snooping fast-leave.

Examples

# Enable fast-leave processing in 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: Basic or advanced IPv6 ACL number, in the range of 2000 to 3999. With the IPv6 ACL number specified, a host can join only the IPv6 multicast groups that match the permit rule in the 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 the group-policy command to configure a global IPv6 multicast group filter, namely, to control the IPv6 multicast groups a host can join.

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

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

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: Dynamic member port aging time in seconds. The value ranges from 200 to 1000.

Description

Use the host-aging-time command to configure the aging time of dynamic member ports globally.

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

By default, the aging time of dynamic member ports is 260 seconds.

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

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

Examples

# Set the aging time of dynamic member ports to 300 seconds globally.

<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 the host-tracking command to enable the MLD snooping host tracking function globally.

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

By default, this function is disabled.

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

Related commands: 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: MLD last listener query interval in seconds, namely, the length of time that the device waits between sending MLD multicast-address-specific queries. The value ranges from 1 to 5.

Description

Use the last-listener-query-interval command to configure the MLD last listener query interval globally.

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

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

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

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

Examples

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

<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: Maximum response time for MLD general queries in seconds. The value ranges from 1 to 25.

Description

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

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

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

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

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

Examples

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

<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 the mld-snooping command to enable MLD snooping globally and enter MLD-snooping view.

Use the undo mld-snooping command 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 the mld-snooping done source-ip command to configure the source IPv6 address of the MLD done messages sent by the MLD snooping proxy.

Use the undo mld-snooping done source-ip command 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 the mld-snooping drop-unknown command to enable dropping unknown IPv6 multicast data in the current VLAN.

Use the undo mld-snooping drop-unknown command 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.

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 the mld-snooping enable command to enable MLD snooping in the current VLAN.

Use the undo mld-snooping enable command 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 the mld-snooping fast-leave command to enable fast-leave processing on the current port. With this function enabled, when the router receives an MLD done message on a port, it directly removes that port from the forwarding table entry for the specific group.

Use the undo mld-snooping fast-leave command to disable fast-leave processing on the current port.

By default, fast-leave processing is disabled.

This command works on both MLD snooping–enabled VLANs and 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 for all VLANs that the interface belongs to. If you specify one or multiple VLANs, the command takes effect for the specified VLANs that the interface belongs to.

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 fast-leave processing on GigabitEthernet 3/1/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/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 the mld-snooping general-query source-ip command to configure the source IPv6 address of MLD general queries.

Use the undo mld-snooping general-query source-ip command 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: Maximum number of IPv6 multicast groups that a port can join. The value ranges from 1 to 1024.

Description

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

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

By default, the upper limit is 1024.

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 you to configure the limit only on the VLAN interface.

Related commands: mld group-limit.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/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: Basic or advanced IPv6 ACL number, in the range of 2000 to 3999. With the IPv6 ACL number specified, a host can join only the IPv6 multicast groups that match the permit rule in the 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 the mld-snooping group-policy command to configure an IPv6 multicast group filter on the current port, namely, to control the multicast groups that the port can join.

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

By default, no IPv6 multicast group filter is configured on a port. Namely, 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/1/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/1/1

[Sysname-GigabitEthernet3/1/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: Dynamic member port aging time, in seconds. The value ranges from 200 to 1000.

Description

Use the mld-snooping host-aging-time command to configure the aging time of dynamic member ports in the current VLAN.

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

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

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

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

Examples

# Enable MLD snooping and set the aging time of dynamic member ports to 300 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 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: Address of IPv6 multicast group which the simulated host will join. The value ranges from FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

ipv6-source-address: Address of the IPv6 multicast source that the simulated host will join.

vlan vlan-id: Specifies a VLAN that comprises the port, where vlan-id is in the range of 1 to 4094.

Description

Use the mld-snooping host-join command to enable simulated joining on a port, namely, to configure the current port as member host for the specified IPv6 multicast group or source and group.

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

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

This command works on both MLD snooping–enabled VLANs and VLANs with MLD enabled on their VLAN interfaces, and the version of MLD on the simulated member host is consistent with the version of MLD snooping that is running in the VLAN or the version of MLD that is running on the VLAN interface.

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 command takes effect only if the interface belongs to the specified VLAN. In port group view, this command takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 3/1/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/1/1

[Sysname-GigabitEthernet3/1/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 the mld-snooping host-tracking command to enable the MLD snooping host tracking function in a VLAN.

Use the undo mld-snooping host-tracking command 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: mld-snooping enable and host-tracking.

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: MLD last listener query interval in seconds, namely, the length of time that the device waits between sending MLD multicast-address-specific queries. The value ranges from 1 to 5.

Description

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

Use the undo mld-snooping last-listener-query-interval command 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: mld-snooping enable and last-listener-query-interval.

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: Maximum response time for MLD general queries in seconds. The value ranges from 1 to 25.

Description

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

Use the undo mld-snooping max-response-time command 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: mld-snooping enable, max-response-time, 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 the mld-snooping overflow-replace command to enable the IPv6 multicast group replacement function on the current port.

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

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

This command works on both MLD snooping–enabled VLANs and VLANs with MLD enabled on their VLAN interfaces.

Related commands: overflow-replace.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/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 the mld-snooping proxying enable command to enable the MLD snooping proxying function in a VLAN.

Use the undo mld-snooping proxying enable command 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 the mld-snooping querier command to enable the MLD snooping querier function.

Use the undo mld-snooping querier command 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, 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: MLD query interval in seconds, namely, the length of time that the device waits between sending MLD general queries. The value ranges from 2 to 300.

Description

Use the mld-snooping query-interval command to configure the MLD query interval.

Use the undo mld-snooping query-interval command 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: mld-snooping enable, mld-snooping querier, mld-snooping max-response-time, and max-response-time.

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 the mld-snooping report source-ip command to configure the source IPv6 address of the MLD reports sent by the MLD snooping proxy.

Use the undo mld-snooping report source-ip command 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: Dynamic router port aging time, in seconds. The value ranges from 1 to 1000.

Description

Use the mld-snooping router-aging-time command to configure the aging time of dynamic router ports in the current VLAN.

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

By default, the dynamic router port aging time 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 time of dynamic router ports to 100 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 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 the mld-snooping router-port-deny command to disable a port from becoming a dynamic router port.

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

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

This command works on both MLD snooping–enabled VLANs and VLANs with MLD enabled on their VLAN interfaces.

Examples

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

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/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 the mld-snooping special-query source-ip command to configure the source IPv6 address of MLD multicast-address-specific queries.

Use the undo mld-snooping special-query source-ip command 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-group-address: Address of a IPv6 multicast group that the port will join as a static member port. The value ranges from FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

ipv6-source-address: Address of the IPv6 multicast source that the port will join as a static member port.

vlan vlan-id: Specifies the VLAN that comprises the Ethernet port, where vlan-id is in the range of 1 to 4094.

Description

Use the mld-snooping static-group command to configure the port as a static member port of the specified IPv6 multicast group or source and group.

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

By default, no ports are static member ports.

Examples

# Configure GigabitEthernet 3/1/1 in VLAN 2 to be a static member port for (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/1/1

[Sysname-GigabitEthernet3/1/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, where vlan-id is in the range of 1 to 4094.

Description

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

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

By default, no ports are static router ports.

This command works on both MLD snooping–enabled VLANs and 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/1/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/1/1

[Sysname-GigabitEthernet3/1/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: MLD snooping version, in the range of 1 to 2.

Description

Use the mld-snooping version command to configure the MLD snooping version.

Use the undo mld-snooping version command to restore the default.

By default, the MLDv1 snooping is used.

This command can take 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, subvlan.

Examples

# Enable MLD snooping in VLAN 2, and specify 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 the overflow-replace command to enable the IPv6 multicast group replacement function globally.

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

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

This command works on both MLD snooping–enabled VLANs and VLANs with MLD enabled on their VLAN interfaces.

Related commands: mld-snooping overflow-replace.

Examples

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

<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 the report-aggregation command to enable MLD report suppression.

Use the undo report-aggregation command to disable MLD report suppression.

By default, MLD report suppression is enabled.

This command works on both MLD snooping–enabled VLANs and 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

ipv6-group-address: Specifies an IPv6 multicast group. The value range of ipv6-group-address is FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

all: Specifies all IPv6 multicast groups.

vlan vlan-id: Specifies a VLAN. The value range of vlan-id is 1 to 4094.

Description

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

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

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 the reset mld-snooping statistics command to clear statistics for MLD messages learned by MLD snooping.

Examples

# Clear statistics for all MLD messages learned by 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: Dynamic router port aging time, in seconds. The value ranges from 1 to 1000.

Description

Use the router-aging-time command to configure the aging time of dynamic router ports globally.

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

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

This command works only on MLD snooping–enabled VLANs, but not on VLANs with MLD enabled on their VLAN interfaces.

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

Examples

# Set the aging time of dynamic router ports to 100 seconds globally.

<Sysname> system-view

[Sysname] mld-snooping

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

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

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us