No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S1720, S2700, S5700, and S6720 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
MLD Configuration Commands

MLD Configuration Commands

MLD Configuration Commands

Product Support
S1720 Not supported.
S2700 Not supported.
S5700 Supported by all models excluding the S5700S-LI, S5700LI, and S5710-X-LI.
S6720

Supported.

display default-parameter mld

Function

The display default-parameter mld command displays default MLD configurations.

Format

display default-parameter mld

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to check default MLD parameter settings even after MLD parameters are modified. This command helps you determine which MLD parameters have been modified.

Example

# Display default MLD configurations.

<HUAWEI> display default-parameter mld
  MLD View Default Configurations:
  --------------------------------
  Lastmember-queryinterval: 1 s
  Lastmember-query time: 2 s
  Max-response-time: 10 s
  Require-router-alert: disabled
  Robust-count: 2
  Send-router-alert: enabled
  Ssm-mapping: disabled
  Timer query: 125 s

  Interface View Default Configurations:
  --------------------------------------
  Group-policy: disabled
  Last listener query time: 2 s
  Lastlistener-query-interval: 1 s
  Max-response-time: 10 s
  Other-querier-present-timer-expiry: off
  Prompt-leave: disabled
  Require-router-alert: disabled
  Robust-count: 2
  Send-router-alert: enabled
  Ssm-mapping: disabled
  Startup-query-timer-expiry: off
  Static-group:  disabled
  Timer query: 125 s
  Version: 2
Table 8-19  Description of the display default-parameter mld command output

Item

Description

MLD View Default Configurations

Default configurations in the MLD view.

Lastmember-queryinterval

Interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages. This parameter is configured using the lastlistener-queryinterval (MLD view) command in the MLD view or the mld lastlistener-queryinterval command in the interface view.

Lastmember-query time

Last listener query time, equaling Lastmember-query-interval x Robust-count.

Max-response-time

Maximum response time for MLD Query messages. This parameter is configured using the max-response-time (MLD view) command in the MLD view or the mld max-response-time command in the interface view.

Require-router-alert

Whether the switch checks the Router-Alert option in received MLD messages. This function is configured using the require-router-alert (MLD view) command in the MLD view or the mld require-router-alert command in the interface view.

Robust-count

Robustness variable of the MLD querier. This parameter is configured using the robust-count (MLD view) command in the MLD view or the mld robust-count command in the interface view.

Send-router-alert

Whether the MLD messages sent from the switch carry the Router-Alert option. This function is configured using the send-router-alert (MLD view) command in the MLD view or the mld send-router-alert command in the interface view.

Ssm-mapping

Status of the MLD SSM mapping function. The value can be:
  • enabled: This function is enabled.
  • disabled: This function is disabled.

This function is configured using the mld ssm-mapping enable command in the interface view.

Timer query

Interval for sending MLD General Query messages. This parameter is configured using the timer query (MLD view) command in the MLD view or the mld timer query command in the interface view.

Interface View Default Configurations

Default configurations in the interface view.

Group-policy

Whether a multicast group policy is configured.
  • enabled: A multicast group policy is configured.
  • disabled: No multicast group policy is configured.

A multicast group policy is configured using the mld group-policy command.

Last listener query time

Last listener query time, equaling Lastlistener-query-interval x Robust-count.

Lastlistener-query-interval

Interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.

Other-querier-present-timer-expiry

Status of the other querier present timer.
  • off: The interface considers itself a querier and no other queriers exist.
  • on: The interface no longer considers itself a querier and another querier exists.

Prompt-leave

Whether the fast leave function is configured. This function is configured using the mld prompt-leave command.

Startup-query-timer-expiry

Status of the query timer on the interface that functions as the querier.
  • off: The interface has sent Query messages.
  • on: The interface has not finished sending Query messages.

Static-group

Whether static multicast groups are configured.
  • enabled: Static multicast groups are configured.
  • disabled: No static multicast groups are configured.

A static multicast group is configured on an interface using the mld static-group command.

Version

MLD version number. MLD has two versions: MLDv1 and MLDv2. This parameter is configured using the mld version command.

display mld control-message counters

Function

The display mld control-message counters command displays statistics about MLD control messages.

Format

display mld control-message counters [ interface interface-type interface-number ] [ message-type { query | report } ]

Parameters

Parameter Description Value
interface interface-type interface-number Displays statistics about MLD messages on a specified interface. If this parameter is not specified, the command displays statistics about MLD messages on all interfaces. -
message-type Displays statistics about MLD messages of a specified type. If this parameter is not specified, the command displays statistics about all types of MLD messages. -
query Displays statistics about Query messages received by the interface. Query messages are sent from a querier. -
report Displays statistics about Report messages received by the interface. Report messages are sent by hosts to join a multicast group. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check the number of MLD control messages sent and received on an interface.

Example

# Display statistics about the MLD messages sent and received by VLANIF100.

<HUAWEI> display mld control-message counters interface vlanif 100
Interface message counter information
 Vlanif100(FE80::219:74FF:FE59:3302):
 Message Type                Sent        Valid       Invalid     Ignore
 ------------------------------------------------------------------
 General Query               45          0           0           0 
 Group Query                 0           0           0           0 
 Source Group Query          0           0           0           0 
 ------------------------------------------------------------------
 MLDV1      
 Report ASM                  0           35679       0           0 
 Report SSM                  0           0           0           0 
 ------------------------------------------------------------------
 DONE  ASM                   0           0           0           0 
 DONE  SSM                   0           0           0           0 
 ------------------------------------------------------------------
 MLDV2      
 ISIN Report                 0           0           0           0 
 ISEX Report                 0           0           0           0 
 TOIN Report                 0           0           0           0 
 TOEX Report                 0           0           0           0 
 ALLOW Report                0           0           0           0 
 BLOCK Report                0           0           0           0 
 Source Records Total        0           0           0           0 
 ------------------------------------------------------------------
 Others                      -           -           0           0        
 ------------------------------------------------------------------     
Table 8-20  Description of the display mld control-message counters interface vlanif 100 command output

Item

Description

Interface message counter information

Statistics about MLD messages on an interface.

Vlanif100(FE80::219:74FF:FE59:3302)

Interface type and interface number (IPv6 link-local address).

Message Type

Type of the MLD messages.

Sent

Number of MLD messages sent from the interface.

Valid

Number of valid MLD messages received by the interface.

Invalid

Number of invalid MLD messages received by the interface.

Ignore

Number of received MLD messages ignored by the interface.

General Query

Number of MLD General Query messages.

Group Query

Number of MLD Multicast Address Specific Query messages.

Source Group Query

Number of MLD Multicast Address and Source Specific Query messages.

Report ASM

Number of MLDv1 Multicast Listener Report messages with multicast group addresses in the ASM group address range.

Report SSM

Number of MLDv1 Multicast Listener Report messages with multicast group addresses in the SSM group address range.

DONE ASM

Number of MLDv1 Multicast Listener Done messages with multicast group addresses in the ASM group address range.

DONE SSM

Number of MLDv1 Multicast Listener Done messages with multicast group addresses in the SSM group address range.

ISIN Report

Number of MLDv2 Multicast Listener ISIN Report messages.

ISEX Report

Number of MLDv2 Multicast Listener ISEX Report messages.

TOIN Report

Number of MLDv2 Multicast Listener TOIN Report messages.

TOEX Report

Number of MLDv2 Multicast Listener TOEX Report messages.

ALLOW Report

Number of MLDv2 Multicast Listener ALLOW Report messages.

BLOCK Report

Number of MLDv2 Multicast Listener BLOCK Report messages.

Source Records Total

Number of multicast sources carried in MLDv2 messages.

Others

Total number of ignored MLD messages and invalid MLD messages whose types cannot be identified.

display mld explicit-tracking

Function

The display mld explicit-tracking command displays information about the MLDv2 hosts that have joined the specific source/group in Include mode.

Format

display mld explicit-tracking [ interface interface-type interface-number [ host-address ipv6-host-address | group ipv6-group-address source ipv6-source-address ] ]

Parameters

Parameter Description Value
interface interface-type interface-number Displays information about MLDv2 hosts that join a specified multicast source in Include mode on a specified interface. If this parameter is not specified, the command displays information about MLDv2 hosts that join a specified multicast source in Include mode on all interfaces. -
host-address ipv6-host-address Specifies the link-local address of a host. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FE80:: to FE80:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
group ipv6-group-address Specifies the IPv6 address of a multicast group. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
source ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to view information about MLDv2 hosts that have dynamically joined specified sources/groups in Include mode.

Example

# Display information about the MLDv2 hosts that have joined the specific source/group in Include mode.

<HUAWEI> display mld explicit-tracking
Explicit-tracking information
 Total 2 hosts, 4 entries

 Vlanif100(FE80::2:4)
  0001.Host: FE80::224
        Uptime: 00:02:47
        Expires: 00:01:33
        (S, G) List:
          Group: FF44::1
              Source: FC00:0:0:1::1
                Uptime: 00:02:47
                Time since last refresh: 00:02:47
              Source: FC00:0:0:2222::3
                Uptime: 00:02:47
                Time since last refresh: 00:02:47
  0002.Host: FE80::225
        Uptime: 00:01:59
        Expires: 00:02:21
        (S, G) List:
          Group: FF44::1
              Source: FC00:0:0:1::1
                Uptime: 00:01:59
                Time since last refresh: 00:01:59
              Source: FC00:0:0:1::3
                Uptime: 00:01:59
                Time since last refresh: 00:01:59
Table 8-21  Description of the display mld explicit-tracking command output

Item

Description

Explicit-tracking information

Host information.

Total 2 hosts, 4 entries

Two hosts and four (S, G) entries in total.

Vlanif100(FE80::2:4)

Interface type and interface number (IPv6 link-local address).

Host

IPv6 host address.

Uptime

Running time after a host joins a multicast group. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Expires

Predicted timeout period of a host. After the host times out, the host is deleted from the MLD member list. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

(S, G) List

List of (S, G) entries.

Group

IPv6 multicast group address.

Source

IPv6 unicast address of a multicast source.

Time since last refresh

Time since the host joins a multicast group last time. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

display mld group

Function

The display mld group command displays information about MLD groups that hosts have dynamically joined by sending Report messages.

Format

display mld group [ ipv6-group-address | interface interface-type interface-number ]* [ verbose ]

display mld group [ interface interface-type interface-number ] entry-number

Parameters

Parameter Description Value
ipv6-group-address Specifies an IPv6 multicast group address. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
interface interface-type interface-number Specifies the type and number of an interface. If this parameter is not specified, the command displays MLD group membership information on all interfaces. -
verbose Displays detailed information about a multicast group. If this parameter is not specified, the command displays only the summary of the MLD group. -
entry-number Displays statistics about MLD multicast groups that hosts dynamically join. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check information about multicast groups that have established memberships.

Example

# Display detailed information about all multicast groups that the interface dynamically joins.

<HUAWEI> display mld group verbose
Total entry on this router: 1
Interface group report information of VPN-Instance: public net
 Limited entry of this VPN-Instance: -
 Vlanif100(FE80::2E0:49FF:FE29:1103):
  Total entry on this interface: 1
  Limited entry on this interface: - 
  Total 1 MLD Group reported
   Group: FF05::2
     Uptime: 00:01:07
     Expires: 00:03:45
     Last reporter: FE80::215:E9FF:FEAC:7666
     Last-listener-query-counter: 0
     Last-listener-query-timer-expiry: off
     Group mode: exclude 
     Version1-host-present-timer-expiry: 00:03:45

# Display statistics about MLD multicast groups that hosts dynamically join.

<HUAWEI> display mld group entry-number
Interface group report information of VPN-Instance: public net
  Total 100 MLD Groups reported
 Vlanif100(FE80:2300::4):
  Total 100 MLD Groups reported 
Table 8-22  Description of the display mld group command output

Item

Description

Interface group report information of VPN-Instance

VPN instance to which MLD groups on an interface belong. public net indicates the public network instance.

Total entry on this router

Total number of dynamic MLD multicast groups on the switch.

Limited entry of this VPN-Instance

Maximum number of MLD entries that can be created for this instance.

Vlanif100(FE80::2E0:49FF:FE29:1103)

Interface type and interface number (IPv6 link-local address).

Total entry on this interface

Total number of dynamic MLD multicast groups on the interface.

Limited entry on this interface

Maximum number of MLD entries that the current interface can create.

Total 1 MLD Group reported

One MLD Report message is received on the interface.

Group

IPv6 address of an IPv6 multicast group.

Uptime

Time since a multicast group is discovered. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Expires

Time left before a group will be deleted from the MLD group table. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

"off" indicates that the group will never be aged out.

Last reporter

Link-local address of the last host that sends a Multicast Listener Report message.

Last-listener-query-counter

Number of Multicast Address and Source Specific Query messages sent by the querier. After the querier receives an MLD done message sent from a host leaving a group, it sends the specified number of Multicast Address and Source Specific Query messages to check whether this group has other members on the network segment. The Last-listener-query-counter value reduces by 1 every time the querier sends a Multicast Address and Source Specific Query message. The number of times is configured using the mld robust-count command.

Last-listener-query-timer-expiry

The timeout time of the Multicast Address and Source Specific Query timer. The timer starts when the querier receives an MLD done message sent from a host leaving a group. The timer value is configured using the mld lastlistener-queryinterval command.

Group mode

Filter mode of multicast groups, that is, exclude or include.

Version1-host-present-timer-expiry

Timeout time of MLDv1 hosts. The timer value is calculated using the following formula: Timer value = General query interval x Robustness variable + Maximum response time for Query messages. The three parameters used in the formula are configured using the mld timer query, mld robust-count, and mld max-response-time commands respectively.

Related Topics

display mld group ssm-mapping

Function

The display mld group ssm-mapping command displays information about multicast group entries established with MLD SSM mapping.

Format

display mld group [ ipv6-group-address | interface interface-type interface-number ]* ssm-mapping [ verbose ]

display mld group ssm-mapping [ interface interface-type interface-number ] entry-number

Parameters

Parameter Description Value
ipv6-group-address Specifies an IPv6 multicast group address. If this parameter is not specified, the command displays information about all multicast group entries established with SSM mapping. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
interface interface-type interface-number Displays information about the multicast group entries established with SSM mapping on a specified interface. If this parameter is not specified, the command displays information about multicast group entries established with SSM mapping on all interfaces. -
verbose Displays detailed information about multicast group entries established with SSM mapping. If this parameter is not specified, the command displays only the summary of multicast groups mapped by SSM mapping. -
entry-number Displays statistics about MLD multicast groups established with SSM mapping. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the display mld group ssm-mapping command to view information about multicast group entries that are established with SSM mapping. SSM mapping entries can be configured using the ssm-mapping (MLD view) command.

Example

# Display detailed information about all multicast group entries established with SSM mapping.

<HUAWEI> display mld group ssm-mapping verbose
Total entry on this router: 1
Interface group report information of VPN-Instance: public net
 Limited entry of this VPN-Instance: -
 Vlanif100(FE80::DD:84):
  Total entry on this interface: 1
  Limited entry on this interface: -
  Total 1 MLD SSM-Mapping Group reported
   Group: FF36::1
     Uptime: 00:00:13
     Expires: 00:04:07
     Last reporter: FE80::10
     Last-listener-query-counter: 0
     Last-listener-query-timer-expiry: off
     Group mode: exclude
     Version1-host-present-timer-expiry: 00:04:07

# Display detailed information about MLD multicast groups established with SSM mapping .

<HUAWEI> display mld group ssm-mapping entry-number
Interface group report information of VPN-Instance: public net
  Total 100 MLD SSM-Mapping Groups reported
 Vlanif100(FE80:2300::4):
  Total 100 MLD SSM-Mapping Groups reported  
Table 8-23  Description of the display mld group ssm-mapping command output

Item

Description

Interface group report information of VPN-Instance

VPN instance to which MLD groups on an interface belong. public net indicates the public network instance.

Total entry on this router

Number of multicast group entries established with SSM mapping on the switch.

Limited entry of this VPN-Instance

Maximum number of multicast group entries that can be generated in the VPN instance.

Vlanif100(FE80::DD:84)

Interface type and interface number (IPv6 link-local address).

Total entry on this interface

Number of multicast group entries established with SSM mapping on the interface.

Limited entry on this interface

Maximum number of multicast group entries that can be generated on the interface.

Total 1 MLD SSM-Mapping Group reported

Total number of SSM mapping groups is 1.

Group

Multicast group address.

Uptime

Time since a multicast group is discovered. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Expires

Timeout period of a group. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Last reporter

Link-local address of the last host that sends a Multicast Listener Report message.

Last-listener-query-counter

Number of times for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.

Last-listener-query-timer-expiry

Interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.

Group mode

Filter mode of the multicast group, that is, include or exclude.

Version1-host-present-timer-expiry

Timeout period of an MLDv1 host.

display mld group static

Function

The display mld group static command displays information about static MLD multicast groups on interfaces.

Format

display mld group [ ipv6-group-address ] static [ up | down ] [ verbose ]

display mld group [ ipv6-group-address ] static interface-number

display mld group [ ipv6-group-address | interface interface-type interface-number ]* static [ verbose ]

display mld group static interface interface-type interface-number entry-number

Parameters

Parameter Description Value
ipv6-group-address Specifies an IPv6 multicast group address. If this parameter is not specified, the command displays information about all multicast groups with memberships. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
up | down Displays information about an Up or Down interface. If this parameter is not specified, the command displays information about all interfaces. -
verbose Displays detailed information about the interfaces that statically join MLD multicast groups or source-specific multicast groups. If this parameter is not specified, the command displays only the summary of the MLD group. -
interface-number Displays the number of the interfaces that statically join MLD multicast groups. -
interface interface-type interface-number Displays information about the MLD multicast groups that the specified interface statically joins. -
entry-number Displays the number of the MLD multicast groups that the interface statically joins. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display mld group static command to view information about the multicast groups and the interfaces that statically join MLD multicast groups or source-specific multicast groups. To configure a static multicast group on an interface, run the mld static-group command.

Example

# Display information about statically joined MLD groups.

<HUAWEI> display mld group static
Static join group information
 Total 2 entries, Total 2 active entries
  (*, FF25::1)
  Interface:Vlanif10
  State:UP
  Expires:Never

  (*, FF25:100::1)
  Interface:Vlanif10
  State:UP
  Expires:Never 
Table 8-24  Description of the display mld group static command output

Item

Description

Static join group information

Information about the MLD multicast groups that a switch statically joins.

Total 2 entries, Total 2 active entries

Total number of static multicast groups and active entries set on the switch.

(*, FF25::1)

(*, G) entry.

Interface:Vlanif10

Interface where the multicast group exists.

State

Status of an entry.

Expires

Timeout period of a multicast group.

# Display detailed information about all static MLD multicast groups on an interface.

<HUAWEI> display mld group static verbose
Static join group information 
 Total 1 entry
  00001.(*, FF25::1)
      Total List of 2 joined interfaces
      1.Vlanif10
          State:             UP
          Reference Count:   1
          Multicast Boundary:YES
          Outgoing Interface:YES
      2.Vlanif20
          State:             UP
          Reference Count:   1
          Multicast Boundary:YES
          Outgoing Interface:YES
Table 8-25  Description of the display mld group static verbose command output

Item

Description

Static join group information

Information about the multicast groups that an interface statically joins.

Total 1 entry

Number of static MLD group memberships on the device.

00001.(*, FF25::1)

(*, G) entry.

Total List of 2 joined interfaces

List of the interfaces that statically join multicast groups.

1.Vlanif10

Type and number of the interface.

State

Status of an interface, including:
  • UP: The interface is working properly.
  • DOWN: An error occurs on the physical link of the interface.

Reference Count

Number of times when a multicast group on the current interface is referenced.

Multicast Boundary

Whether the multicast forwarding boundary is configured.
  • YES
  • NO

This function is configured using the multicast boundary ipv6-group-address ipv6-group-mask-length command.

Outgoing Interface

Whether downstream interfaces are available.
  • YES
  • NO

# Display information about all the interfaces that statically join multicast groups and are in Up state.

<HUAWEI> display mld group static up
Static join group information
 Total 4 entries
  00001.(*,FF25::1)
      Total List of 2 joined interfaces
      Total Matched 2 interfaces
      1.Vlanif10                                
      2.Vlanif20           
  00002.(FC00:0:0:1::1,FF25::1)
      Total List of 2 joined interfaces
      Total Matched 2 interfaces
      1.Vlanif10                                
      2.Vlanif20           
Table 8-26  Description of the display mld group static up command output

Item

Description

Total List of 2 joined interfaces

Number of the interfaces that statically join multicast groups.

Total Matched 2 interfaces

List of the interfaces that statically join multicast groups and are in Up state.

# Display the number of interfaces that statically join all multicast groups.

<HUAWEI> display mld group static interface-number
Static join group information
 Total 2 entries
  (*, FF25::1)
  Interface-Number:24

  (*, FF25::2)
  Interface-Number:24
Table 8-27  Description of the display mld group static interface-number command output

Item

Description

Interface-Number

Number of the interfaces that statically join multicast groups.

Related Topics

display mld interface

Function

The display mld interface command displays MLD information on an interface.

Format

display mld interface [ interface-type interface-number | up | down ] [ verbose ]

Parameters

Parameter Description Value
interface-type interface-number Displays MLD information on a specified interface. If this parameter is not specified, the command displays MLD information on all interfaces. -
up Indicates that the status of the IPv6 protocol on the MLD interface is Up, that is, MLD is in Active state. -
down Indicates that the status of the IPv6 protocol on the MLD interface is Down, that is, MLD is in Inactive state. -
verbose Displays detailed information about MLD interfaces. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check the MLD configuration and running status on an interface, run the display mld interface command. This command displays MLD information only when MLD-enabled interfaces exist on the device.

Example

# Display the MLD configuration and running status on VLANIF100.

<HUAWEI> display mld interface vlanif 100 verbose
Interface information
 Vlanif100(FE80::2E0:B4FF:FE35:FF01):
   MLD is enabled
   Current MLD version is 2
   MLD state: up
   MLD group policy: none
   MLD limit: -  
   Value of query interval for MLD (negotiated): 125 s
   Value of query interval for MLD (configured): 125 s
   Value of other querier timeout for MLD: 0 s
   Value of maximum query response time for MLD: 10 s
   Value of last listener query time: 2 s
   Value of last listener query interval: 1 s
   Value of startup query interval: 31 s
   Value of startup query count: 2
   General query timer expiry (hours:minutes:seconds): 00:00:28
   Querier for MLD: FE80::2E0:B4FF:FE35:FF01 (this router)
   MLD activity: 2 joins, 0 dones
   Robustness (negotiated): 2
   Robustness (configured): 2
   Require-router-alert: disabled
   Send-router-alert: enabled
   Ip-source-policy: disabled
   Query Ip-source-policy: disabled
   Prompt-leave: disabled
   SSM-Mapping: enabled
   Startup-query-timer-expiry: off
   Other-querier-present-timer-expiry: off
    TTL-check: disabled
  Total 2 MLD Groups reported
Table 8-28  Description of the display mld interface command output

Item

Description

Vlanif100(FE80::2E0:B4FF:FE35:FF01)

Interface type and interface number (IPv6 link-local address).

MLD is enabled

MLD is enabled. To enable MLD, run the mld enable command.

Current MLD version is 2

MLD version is set to 2 on the interface. To set the MLD version, run the mld version command.

MLD state

Status of the MLD interface, that is, up or down.

MLD group policy

ACL6 number of the MLD group policy. To set ACL6 number of the MLD group policy, run the mld group-policy command.

MLD limit

Maximum number of MLD group members that the current interface can maintain. To set the maximum number of MLD group members that the current interface can maintain, run the mld limit command.

Value of query interval for MLD (negotiated)

Actual interval for sending MLD Query messages after negotiation, in seconds.

Value of query interval for MLD (configured)

Configured interval for sending MLD Query messages, in seconds. To set the interval for sending MLD Query messages, run the mld timer query command.

Value of other querier timeout for MLD

Timeout period of other MLD queriers, in seconds. To set the timeout period of an MLD querier, run the mld timer other-querier-present command.

Value of maximum query response time for MLD

Maximum response time for MLD Query messages, in seconds. To set the maximum response time for MLD Query messages, run the mld max-response-time command.

Value of last listener query time

Last listener query time, in seconds. The last listener query time is calculated by multiplying the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages by the robustness variable.

Value of last listener query interval

Interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages (Last listener query), in seconds. To set the interval for sending Last listener query, run the mld lastlistener-queryinterval command.

Value of startup query interval

Interval for sending Query messages when a querier starts, in seconds. The interval is 1/4 the query interval configured using the mld timer query command.

Value of startup query count

Number of times the querier sends Query messages when a querier starts. To set the number of times for sending Query messages when the querier starts, run the mld robust-count command.

General query timer expiry (hours:minutes:seconds)

Timeout period of the general query timer.

Querier for MLD

Link-local address of the MLD querier.

MLD activity

Statistics about MLD activities (join or leave).

Robustness (negotiated)

Robustness variable after negotiation by the non-querier device.

Robustness (configured)

Robustness variable set on the interface. To set the robustness variable on an interface, run the mld robust-count command.

Require-router-alert

Whether the switch discards MOD packets that do not contain the Router-Alert option in IP packet headers.
  • enable: The switch discards MLD packets that do not contain the Router-Alert option in IP packet headers.
  • disable: The switch does not discard MLD packets that do not contain the Router-Alert option in IP packet headers.

This function is configured using the mld require-router-alert command.

Send-router-alert

Whether the sent MLD packet carries the Router-Alert option. To configure whether the sent MLD packet carries the Router-Alert option, run the mld send-router-alert command.

Ip-source-policy

Whether to filter Multicast Listener Report/Done messages based on host addresses.
  • enabled: The switch filters MLD Report/Leave messages based on host addresses.
  • disabled The switch does not filter MLD Report/Leave messages based on host addresses.

This function is configured using the mld ip-source-policy command.

Query Ip-source-policy

Whether to filter MLD Query messages based on host addresses. To configure whether to filter MLD Query messages based on host addresses, run the mld query ip-source-policy command.

Prompt-leave

Whether fast leave is enabled.
  • enabled: Fast leave is enabled.
  • disabled: Fast leave is disabled.

This function is configured using the mld prompt-leave command.

SSM-Mapping

Whether SSM mapping is enabled.
  • enabled: SSM mapping is enabled.
  • disabled: SSM mapping is disabled.

This function is configured using the mld ssm-mapping enable command.

Startup-query-timer-expiry

Status of the timer for the interface functioning as the querier after startup to send Query messages.
  • off: The interface sends Query messages immediately after startup.
  • on: The interface delays sending Query messages after startup.

Other-querier-present-timer-expiry

Status of the timer identifying whether another querier is present.
  • off: The interface considers itself a querier and no other queriers exist.
  • on: The interface no longer considers itself a querier and another querier exists.

TTL-check

Whether the function to check the TTL values in received MLD Report, Leave, and Query messages is enabled:
  • enabled
  • disabled

Total 2 MLD Groups reported

Two Multicast Listener Report messages are received on the interface.

display mld invalid-packet

Function

The display mld invalid-packet command displays statistics and details about invalid MLD packets received by a device.

Format

display mld invalid-packet [ interface interface-type interface-number | message-type { done | query | report } ]*

display mld invalid-packet [ packet-number ] verbose

Parameters

Parameter Description Value
interface interface-type interface-number Displays statistics about invalid MLD messages received by a specified interface. If this parameter is not specified, the command displays statistics about invalid MLD messages on all interfaces. -
message-type Displays statistics about invalid MLD messages of a specified type. -
done Displays statistics about invalid Multicast Listener Done messages. -
query Displays statistics about invalid Query messages. -
report Displays statistics about invalid Multicast Listener Report messages. -
packet-number Displays details of a specified number of invalid MLD messages recently received. The value is an integer that ranges from 1 to 100.
verbose Displays details of invalid MLD messages. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display mld invalid-packet command to view statistics and details of invalid MLD messages for fault location and rectification.

If MLD entries fail to be generated on a multicast network, you can run the display mld invalid-packet command first to check whether devices have received invalid MLD messages. If the command output contains statistics about invalid MLD messages, you need to run the display mld invalid-packet [ packet-number ] verbose command to view details of invalid MLD messages to locate the fault.

You can run the following related commands to view information about specific invalid MLD messages:

  • Run the display mld invalid-packet command to view statistics about invalid MLD messages received by a device.

  • Run the display mld invalid-packet interface interface-type interface-number command to view statistics about invalid MLD messages received by a specified interface.

  • Run the display mld invalid-packet packet-number verbose command to view details of invalid MLD messages recently received. Currently, details of a maximum of 100 invalid MLD messages can be displayed.

Example

# Display statistics about invalid MLD messages received by the device.

<HUAWEI> display mld invalid-packet
         Statistics of invalid packets for public net:                      
--------------------------------------------------------------------            
MLD Query invalid packet:
Unwanted Source List    : 1000        Zero Max Resp Code      : 0
Fault Length            : 1000        Invalid Multicast Group : 0
Bad Checksum            : 0

MLD Report invalid packet:
Fault Length            : 0           Invalid Multicast Group : 0
Invalid Multicast Source: 0           Bad Checksum            : 0
Illegal Report Type     : 0

MLD Done invalid packet:
Invalid Multicast Group : 0           Bad Checksum            : 0            
--------------------------------------------------------------------  
Table 8-29  Description of the display mld invalid-packet command output

Item

Description

Statistics of invalid packets for public net

Invalid packets received in the public net.

MLD Query invalid packet

Invalid MLD Query messages.

Unwanted Source List

Messages with unwanted source lists.

Zero Max Resp Code

Messages with the Max Resp Code fields being 0.

Fault Length

Messages with invalid lengths.

Invalid Multicast Group

Messages with invalid multicast group addresses.

Bad Checksum

Messages with checksum errors.

MLD Report invalid packet

Invalid MLD Report messages.

Invalid Multicast Source

Messages with invalid multicast source addresses.

Illegal Report Type

Messages with the illegal Report message type.

MLD Done invalid packet

Invalid Multicast Listener Done messages.

# Display details of one invalid MLD message recently received by the device.

<HUAWEI> display mld invalid-packet 1 verbose
       Detailed information of invalid packets
-----------------------------------------------------
Packet information (Index 1):
-----------------------------------------------------
Interface           :  Vlanif100
Time                :  2012-06-09 11:03:51 UTC-08:00
Message Length      :  24
Invalid Type        :  Invalid Multicast Group
0000: 84 00 4c d7 00 00 00 00 11 17 00 00 00 00 00 00
0010: 00 00 00 00 00 01 00 01
-----------------------------------------------------
Table 8-30  Description of the display mld invalid-packet 1 verbose command output

Item

Description

Detailed information of invalid packets

Details of the invalid MLD message.

Packet information (Index 1)

Sequence number of the invalid MLD message (numbered in the opposite order that the message is received).

Interface

Interface receiving the invalid MLD message.

Time

Time when the invalid MLD message is received, in any of the following formats:
  • YYYY-MM-DD HH:MM:SS

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM DST

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM

  • YYYY-MM-DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is configured using the clock timezone command; DST indicates that the daylight saving time is configured using clock daylight-saving-time command.

Message Length

Length of the invalid MLD message.

Invalid Type

Type of the invalid MLD message:
  • Unwanted Source List

  • Zero Max Resp Code

  • Fault Length

  • Invalid Multicast Group

  • Bad Checksum

  • Invalid Multicast Source

  • Illegal Report Type

0000: 84 00 4c d7 00 00 00 00 11 17 00 00 00 00 00 00

0010: 00 00 00 00 00 01 00 01

Contents of the invalid MLD message.

display mld routing-table

Function

The display mld routing-table command displays information about the MLD routing table.

Format

display mld routing-table [ ipv6-source-address [ ipv6-source-mask-length ] | ipv6-group-address [ ipv6-group-mask-length ] ] * [ static ] [ outgoing-interface-number [ number ] ]

Parameters

Parameter Description Value
ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.
ipv6-source-mask-length Specifies the mask length of the IPv6 address of a multicast source. The value is an integer that ranges from 0 to 128.
ipv6-group-address Specifies an IPv6 multicast group address. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
ipv6-group-mask-length Specifies the mask length of the IPv6 multicast group address. The value is an integer that ranges from 8 to 128.
static Displays the MLD routing table of the static multicast group. -
outgoing-interface-number Displays the number of the outbound interfaces in MLD routing entries. -
number Specifies the number of outbound interfaces. After this parameter is specified, the command displays information about the specified number of outbound interfaces. The value is an integer that ranges from 1 to 2048.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view MLD routing entries, run the display mld routing-table command. You can specify parameters to view specified routing information, which facilitates fault location.

NOTE:

This command provides output information only when PIM (IPv6) is not enabled on the MLD-capable interface.

Example

# Display the MLD routing entry of the specified multicast group.

<HUAWEI> display mld routing-table
Routing table
 Total 2 entries

 00001. (FC00:0:0:1::3, FF44::)
       List of 1 downstream interface in include mode
        Vlanif100 (FE80::EE:53),
                   Protocol: STATIC

 00002. (*, FF55::)
       List of 1 downstream interface
        Vlanif100 (FE80::EE:53),
                   Protocol: MLD
Table 8-31  Description of the display mld routing-table command output

Item

Description

Routing table

MLD routing table.

Total 2 entries

Total number of MLD routing entries.

00001. (FC00:0:0:1::3, FF44::)

Entry 00001. (S, G) indicates that data is transmitted from S to G. (*, G) indicates that data is transmitted from any source to G.

List of 1 downstream interface in include mode

List of the downstream interfaces that join the multicast group in INCLUDE mode.

Vlanif100(FE80::EE:53)

Interface type and interface number (IPv6 link-local address).

Protocol

Protocol type.
  • SSM-MAP: Entries are generated using MLD SSM mapping.
  • MLD: Entries are generated using MLD.
  • STATIC: Entries are generated by the MLD static multicast group.

List of 1 downstream interface

Downstream interface list.

display mld ssm-mapping

Function

The display mld ssm-mapping command displays the configuration of MLD SSM mapping.

Format

display mld ssm-mapping { group [ ipv6-group-address ] | interface [ interface-type interface-number ] }

Parameters

Parameter Description Value
group ipv6-group-address Specifies the source IPv6 address of a specified multicast group. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
interface interface-type interface-number Displays whether a specified interface is enabled with SSM mapping. If this parameter is not specified, the command displays information about all Up interfaces enabled with SSM mapping. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view multicast sources mapped to a multicast group. SSM mapping entries can be configured using the ssm-mapping (MLD view) command. The display mld ssm-mapping command also allows you to view the SSM mapping status on an interface, which can be configured using the mld ssm-mapping enable command.

Example

# Display information about the interface configured with SSM mapping.

<HUAWEI> display mld ssm-mapping interface
Interface information
Vlanif100(FE80::1)
Table 8-32  Description of the display mld ssm-mapping interface command output

Item

Description

Vlanif100(FE80::1)

Interface type and interface number (IPv6 address).

# Display information about SSM mapping of all multicast sources and groups.

<HUAWEI> display mld ssm-mapping group
MLD SSM-Mapping conversion table
 Group: FF3E::/64
  Number of Source(s): 3
     FC00:0:0:1::1
     FC00:0:0:1::2
     FC00:0:0:1::3 
Table 8-33  Description of the display mld ssm-mapping group command output

Item

Description

MLD SSM-Mapping conversion table

MLD SSM mapping entries.

Group

Address of a multicast group.

Number of Source(s)

Number of multicast sources configured with SSM mapping.

FC00:0:0:1::1

Multicast source address.

# Check whether MLD SSM mapping is enabled on VLANIF100.

<HUAWEI> display mld ssm-mapping interface Vlanif 100
MLD SSM-Mapping is enabled
Table 8-34  Description of the display mld ssm-mapping interface Vlanif 100 command output

Item

Description

MLD SSM-Mapping is enabled

SSM mapping is enabled on the interface.

display mld ssm-mapping interface

Function

The display mld ssm-mapping interface command displays information about interfaces enabled with SSM mapping.

Format

display mld ssm-mapping interface [ interface-type interface-number [ group ipv6-group-address ] ]

Parameters

Parameter Description Value
interface-type interface-number Specifies an interface. -
group ipv6-group-address Displays the source address list associated with a specified group. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the display mld ssm-mapping interface command to view information about an interface enabled with SSM mapping.

Example

# Display information about the interface configured with SSM mapping.

<HUAWEI> display mld ssm-mapping interface
Interface information
 Vlanif100(FE80::1)
Table 8-35  Description of the display mld ssm-mapping interface command output

Item

Description

Vlanif100(FE80::1)

Interface type and interface number (IPv6 link-local address).

lastlistener-queryinterval (MLD view)

Function

The lastlistener-queryinterval command globally sets the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages after the MLD querier receives an MLD Done message from a host.

The undo lastlistener-queryinterval command restores the default value.

By default, the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages is 1 second.

Format

lastlistener-queryinterval interval

undo lastlistener-queryinterval

Parameters

Parameter Description Value
interval Specifies the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages after the MLD querier receives a Multicast Listener Done message. The value is an integer that ranges from 1 to 5, in seconds.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the MLD querier receives a Multicast Listener Done message of a multicast group, the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages continuously to check for other members in the multicast group. The lastlistener-queryinterval command sets the interval at which the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages. If the querier receives no Multicast Listener Report message for a specified period, the querier stops forwarding data to the multicast group. The period is calculated by multiplying interval by robust-value. To set robust-value, run the mld robust-count or robust-count (MLD view) command.

If the querier receives a Multicast Listener Report message from a host within the maximum response time, the querier maintains the membership of the multicast group. Otherwise, the querier considers that the last member has left the group and does not maintain the membership of the multicast group.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of this command is the same as that of the mld lastlistener-queryinterval command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# In the MLD view, set the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages to 3 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] lastlistener-queryinterval 3

limit (MLD view)

Function

The limit command sets the maximum number of MLD entries that can be created globally.

The undo limit command restores the maximum number of MLD entries that can be created globally to the default value.

By default, a maximum number of 496 MLD entries can be created on S5720LI and S5720S-LI, a maximum of 1024 MLD entries can be created on S5720SI and S5720S-SI, a maximum of 512 MLD entries can be created on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and a maximum of 4096 MLD entries can be created on S5720EI, S5720HI, S6720S-EI, and S6720EI.

Format

limit number

undo limit

Parameters

Parameter Description Value
number Specifies the maximum number of MLD entries that can be created globally.

The value is an integer that ranges from 1 to 496 on S5720LI and S5720S-LI, from 1 to 1024 on S5720SI and S5720S-SI, from 1 to 512 on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and from 1 to 4096 on S5720EI, S5720HI, S6720S-EI, and S6720EI.

NOTE:

The value range of S5720HI is expanded after the high specification mode is configured for multicast forwarding using the set multicast forwarding-table super-mode command. The actual value range depends on the specification of the device.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command sets the maximum number of MLD entries globally.

When the number of MLD entries reaches the limit, the system does not create any more. To enable the switch to allow new join requests, you can either delete useless entries or increase the limit. Alternatively, configure static multicast groups or source-group bindings on interfaces.

The number of MLD entries can be counted in the following methods:

  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry for SSM mapping is counted as one entry.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

You can also run the mld global limit number command in the system view to set the maximum number of global MLD group memberships. If both the limit and mld global limit number commands are run, the smaller value takes effect.

Example

# Set the maximum number of MLD entries to 1000 globally.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] limit 1000

max-response-time (MLD view)

Function

The max-response-time command sets a global maximum response time for MLD General Query messages.

The undo max-response-time command restores the default global maximum response time for MLD General Query messages.

By default, the global maximum response time for MLD General Query messages is 10 seconds.

Format

max-response-time interval

undo max-response-time

Parameters

Parameter Description Value
interval Specifies the maximum response time for MLD General Query messages. The value is an integer that ranges from 1 to 25, in seconds.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If hosts send Multicast Listener Report messages immediately after receiving MLD General Query messages, the querier on the local network segment may receive a large number of Multicast Listener Report messages from the hosts at the same time. This may cause congestion on the network.

To avoid such situations, MLD messages specify the maximum response time for MLD General Query messages. When a host receives an MLD Query message, the host starts a timer for the multicast group that it joins. The timer length is a random value between 0 and the maximum response time. When the timer times out, the host sends a Multicast Listener Report message to the querier.

The maximum response time specifies the deadline for the host to send a Multicast Listener Report message. A proper maximum response time allows hosts to respond to MLD Query messages and prevents hosts from sending Report messages at the same time.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • A shorter response time allows a multicast device to obtain multicast group member information more quickly, but consumes more bandwidth and system resources.
  • The function of this command is the same as that of the mld max-response-time command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# In the MLD view, set the maximum response time for MLD General Query messages to 8 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] max-response-time 8
Related Topics

mld

Function

The mld command displays the MLD view.

The undo mld command clears all configurations in the MLD view.

Format

mld

undo mld

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Global MLD parameters must be configured in the MLD view.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

In using the undo mld command, you need to enter Y or N to confirm the action. This command will clear global MLD configurations. So, use this command with caution.

Example

# Enter the MLD view.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld]

mld enable

Function

The mld enable command enables MLD on an interface.

The undo mld enable command disables MLD on an interface.

By default, MLD is disabled on an interface.

Format

mld enable

undo mld enable

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a shared IPv6 network segment, hosts and multicast devices must run MLD. A multicast device can process MLD messages sent from hosts only after MLD is enabled on the interfaces connected to user network segments.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • If MLD parameters are configured on an interface, the parameter settings take effect only after MLD is enabled.

  • If PIM (IPv6) and MLD need to be enabled on the same interface, enable PIM (IPv6) and MLD in sequence.

  • Running the mld enable command failed on the VLANIF interface because Layer 2 multicast querier or report-suppress is enabled for this VLAN.

  • If both Layer 2 and Layer 3 multicast services are required in a VLAN, enable MLD on the corresponding VLANIF interface first, and then enable MLD Snooping in the VLAN. If MLD Snooping is enabled in the VLAN first, MLD cannot be enabled on the VLANIF interface.

Example

# Enable MLD on VLANIF100 connected to a user network segment.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld enable
# Enable MLD on GE0/0/1 connected to a user network segment.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld enable

mld global limit

Function

The mld global limit command sets the maximum number of MLD entries that can be created on the entire switch.

The undo mld global limit command deletes the configured maximum number of MLD entries.

By default, a maximum number of 496 MLD entries can be created on S5720LI and S5720S-LI, a maximum of 1024 MLD entries can be created on S5720SI and S5720S-SI, a maximum of 512 MLD entries can be created on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and a maximum of 4096 MLD entries can be created on S5720EI, S5720HI, S6720S-EI, and S6720EI.

Format

mld global limit number

undo mld global limit

Parameters

Parameter Description Value
number Specifies the maximum number of MLD entries that can be created on the entire switch.

The value is an integer that ranges from 1 to 496 on S5720LI and S5720S-LI, from 1 to 1024 on S5720SI and S5720S-SI, from 1 to 512 on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and from 1 to 4096 on S5720EI, S5720HI, S6720S-EI, and S6720EI.

NOTE:

The value range of S5720HI is expanded after the high specification mode is configured for multicast forwarding using the set multicast forwarding-table super-mode command. The actual value range depends on the specification of the device.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the number of MLD entries reaches the limit, the system does not create any more. To enable the switch to allow new join requests, you can either delete useless entries or modify the limit. Alternatively, you can enable static addition on a multicast group or source group.

The number of MLD entries can be counted in the following methods:
  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry for SSM mapping is counted as one entry.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

You can also run the limit (MLD view) command in the MLD view to set the maximum number of global MLD group entries. If both the mld global limit and limit (MLD view) commands are run, the smaller value takes effect.

Example

# Set the maximum number of MLD entries that can be created on the switch to 1000.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld global limit 1000

mld group-policy

Function

The mld group-policy command configures an MLD group policy on an interface to limit the range of multicast groups that the hosts can join.

The undo mld group-policy command deletes the MLD group policy.

By default, no MLD group policy is configured on an interface, and the hosts can join any multicast groups.

Format

mld group-policy acl6-number [ 1 | 2 ]

undo mld group-policy

Parameters

Parameter Description Value
acl6-number Specifies the number of a basic or advanced IPv6 ACL6. This ACL6 defines the range of multicast groups. The number of a basic ACL6 is an integer that ranges from 2000 to 2999. The number of an advanced ACL6 is an integer that ranges from 3000 to 3999.
1 Limits the range of multicast groups that MLDv1 hosts can join. -
2 Limits the range of multicast groups that MLDv2 hosts can join. -

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To control the range of multicast groups that hosts on the network attached to an interface can join, specify an ACL6 in the mld group-policy command. This configuration improves security of the MLD application. You can also run this command to prevent the switch from receiving Multicast Listener Report messages for specified groups.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

An ACL6 defining the range of multicast groups has been created.

The mld group-policy command is used with the acl ipv6 command. To use a numbered ACL6 in the MLD group policy:
  • In the basic ACL6 view, set source in the rule (basic ACL6 view) command to the range of multicast groups that an interface can join.

  • In the advanced ACL6 view, set source in the rule (advanced ACL6 view) command to the source address that is allowed to send multicast data to the specified multicast groups, and set destination to the range of multicast groups that an interface can join.

After the mld group-policy command is executed on an interface:

  • The interface filters the received Report messages based on the ACL6 and maintains memberships only for the multicast groups permitted by the ACL6.

  • The interface discards the Report messages that are denied by the ACL6. If the entries of the multicast groups denied by the ACL6 exist on the switch, the switch deletes these entries when the aging time of the entries expires.

Example

# Create ACL6 2005, and configure a rule that allows hosts to receive data of multicast group FF13::101. Configure an MLD group policy on VLANIF100 and reference ACL6 2005 to allow hosts connected to the interface to join only multicast group FF13::101.

<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2005
[HUAWEI-acl6-basic-2005] rule permit source ff13::101 128
[HUAWEI-acl6-basic-2005] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld group-policy 2005
# Create ACL6 2005, and configure a rule that allows hosts to receive data of multicast group FF13::101. Configure an MLD group policy on GE0/0/1 and reference ACL6 2005 to allow hosts connected to the interface to join only multicast group FF13::101.
<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2005
[HUAWEI-acl6-basic-2005] rule permit source ff13::101 128
[HUAWEI-acl6-basic-2005] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld group-policy 2005

mld ip-source-policy

Function

The mld ip-source-policy command enables filtering of Multicast Listener Report/Done messages based on source addresses.

The undo mld ip-source-policy command disables filtering of MLD messages based on source addresses.

By default, a multicast device does not filter MLD messages based on source addresses.

Format

mld ip-source-policy basic-acl6-number

undo mld ip-source-policy

Parameters

Parameter Description Value
basic-acl6-number Specifies the number of a basic ACL6, which defines the range of source addresses. The value is an integer that ranges from 2000 to 2999.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

MLD runs on receiver hosts and their directly connected multicast devices. A multicast device processes all received Multicast Listener Report/Done messages. To improve security, you can configure the multicast device to filter Multicast Listener Report/Done messages received on an interface.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Example

# Configure VLANIF100 to accept only the Multicast Listener Report/Done messages with the source address FC00::1.
<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2001
[HUAWEI-acl6-basic-2001] rule permit source fc00::1 128
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld ip-source-policy 2001
# Configure GE0/0/1 to accept only the Multicast Listener Report/Done messages with the source address FC00::1.
<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2001
[HUAWEI-acl6-basic-2001] rule permit source fc00::1 128
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld ip-source-policy 2001

mld lastlistener-queryinterval

Function

The mld lastlistener-queryinterval command sets the interval at which the MLD querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages after receiving Multicast Listener Done messages from a host.

The undo mld lastlistener-queryinterval command restores the default value.

By default, the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages is 1 second.

Format

mld lastlistener-queryinterval interval

undo mld lastlistener-queryinterval

Parameters

Parameter Description Value
interval Specifies the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages. The value is an integer that ranges from 1 to 5, in seconds.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the MLD querier receives a Multicast Listener Done message of a multicast group, the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages continuously to check for other members in the multicast group. The mld lastlistener-queryinterval command sets the interval at which the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages. If the querier receives no Multicast Listener Report message for a specified period, the querier stops forwarding data to the multicast group. The period is calculated by multiplying interval by robust-value. To set robust-value, run the mld robust-count or robust-count (MLD view) command.

If the querier receives a Multicast Listener Report message from a host within the maximum response time, the querier maintains the membership of the multicast group. Otherwise, the querier considers that the last member has left the group and does not maintain the membership of the multicast group.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of the mld lastlistener-queryinterval command is the same as that of the lastlistener-queryinterval command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Set the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query message to 3 seconds on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld lastlistener-queryinterval 3
# Set the interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query message to 3 seconds on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld lastlistener-queryinterval 3

mld limit

Function

The mld limit command sets the maximum number of MLD group memberships that the current interface can maintain.

The undo mld limit command restores the maximum number of MLD group memberships that the current interface can maintain to the default value.

By default, the current interface can maintain a maximum number of 496 MLD group memberships on S5720LI and S5720S-LI, a maximum number of 1024 MLD group memberships on S5720SI and S5720S-SI, 512 MLD group memberships on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, 4096 MLD group memberships on S6720S-EI and S6720EI, and 2048 MLD group memberships on S5720EI and S5720HI.

Format

mld limit number [ except acl6-number ]

undo mld limit

Parameters

Parameter Description Value
number Specifies the maximum number of MLD entries that the current interface can create.

The value is an integer that ranges from 1 to 496 on S5720LI and S5720S-LI, from 1 to 1024 on S5720SI and S5720S-SI, from 1 to 512 on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, from 1 to 4096 on S6720S-EI and S6720EI, and from 1 to 2048 on S5720EI and S5720HI.

NOTE:

The value range of S5720HI is expanded after the high specification mode is configured for multicast forwarding using the set multicast forwarding-table super-mode command. The actual value range depends on the specification of the device.

except Specifies the range of multicast groups that are not limited by the set maximum number. -
acl6-number Specifies the basic or advanced ACL6. The value is an integer. The number of the basic ACL6 ranges from 2000 to 2999. The basic ACL6 filters group addresses only, without distinguishing (*, G) entries and (S, G) entries. The number of the advanced ACL6 ranges from 3000 to 3999. The advanced ACL6 filters (S, G) entries of the interface only.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the number of MLD entries reaches the limit, the system does not create any MLD entries. To allow more new join requests, delete unnecessary entries or increase the limit. Alternatively, configure static multicast groups or source-group bindings on interfaces.

The number of MLD entries can be counted in the following methods:
  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry for SSM mapping is counted as one entry.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

If except is not set in the command, the maximum number of MLD entries corresponding to all the groups or source/groups is limited.

Before setting except, configure the associated ACL6. The interface then filters the received MLD Join messages according to the ACL6. The maximum number of entries corresponding to the multicast groups that match the ACL6 is not limited.

The mld limit command must be used with ACL6 configuration commands. When configuring ACL6 rules, note that:
  • In the basic ACL6 view, specify the source parameter in the rule (basic ACL6 view) command for setting the range of multicast groups whose MLD entries do not need to be limited.
  • In the advanced ACL6 view, specify the source parameter in the rule (advanced ACL6 view) command for setting the range of sources that are allowed to send multicast data to the multicast groups. Specify the destination parameter in the rule (advanced ACL6 view) command for setting the range of multicast groups whose MLD entries do not need to be limited.

Example

# Set the maximum number of MLD entries that can be created on the VLANIF100 to 1024.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld limit 1024
# Create the advanced ACL6 with the number being 3100; set the maximum number of MLD entries that can be created on VLANIF100 to 1024; allow the hosts to receive messages from the specific-source multicast group (FC00:0:0:2001::1, FF3E::1). That is, the specific-source multicast group (FC00:0:0:2001::1, FF3E::1) is not limited by the maximum number of MLD entries.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] acl ipv6 3100
[HUAWEI-acl6-adv-3100] rule permit ipv6 source fc00:0:0:2001::1 64 destination ff3e::1 64
[HUAWEI-acl6-adv-3100] quit
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld limit 1024 except 3100
# Set the maximum number of MLD entries that can be created on the GE0/0/1 to 1024.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld limit 1024

mld max-response-time

Function

The mld max-response-time command sets the maximum response time for MLD General Query messages on an interface.

The undo mld max-response-time command restores the default maximum response time for General MLD Query messages.

By default, the maximum response time for MLD General Query messages is 10s on an interface.

Format

mld max-response-time interval

undo mld max-response-time

Parameters

Parameter Description Value
interval Specifies the maximum response time for MLD General Query messages. The value is an integer that ranges from 1 to 25, in seconds.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If hosts send Multicast Listener Report messages immediately after receiving MLD General Query messages, the querier on the local network segment may receive a large number of Multicast Listener Report messages from the hosts at the same time. This may cause congestion on the network.

To avoid such situations, MLD messages specify the maximum response time for MLD General Query messages. When a host receives an MLD Query message, the host starts a timer for the multicast group that it joins. The timer length is a random value between 0 and the maximum response time. When the timer times out, the host sends a Multicast Listener Report message to the querier.

The maximum response time specifies the deadline for the host to send a Multicast Listener Report message. A proper maximum response time allows hosts to respond to MLD Query messages and prevents hosts from sending Report messages at the same time.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • A shorter response time allows a multicast device to obtain multicast group member information more quickly, but consumes more bandwidth and system resources.
  • The function of the mld max-response-time command is the same as that of the max-response-time (MLD view) command used in the MLD view. The configuration in the MLD view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Set the maximum response time for MLD General Query messages to 8 seconds on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld max-response-time 8
# Set the maximum response time for MLD General Query messages to 8 seconds on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld max-response-time 8

mld on-demand

Function

The mld on-demand command enables the MLD on-demand function. This function enables a querier to maintain group memberships according to requirements of group members, without sending Query messages. After MLD on-demand is enabled on an interface, dynamic MLD entries on the interface will never age out.

The undo mld on-demand command restores the default configuration.

By default, a querier does not maintain group memberships according to requirements of group members, and dynamic entries are aged out when the aging time expires.

Format

mld on-demand

undo mld on-demand

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a standard MLD working process, a querier sends General Query messages periodically and collects group membership information based on received Multicast Listener Report and Done messages. Group members respond to every Query message they receive. The querier stops sending Query messages after MLD on-demand is configured, reducing MLD packets exchanged between the querier and receiver hosts.

The MLD on-demand function enables a querier to maintain group memberships based on Report messages sent from hosts, reducing traffic transmitted between the querier and receiver hosts.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • The mld on-demand command can be used on the querier only.

  • If dynamic MLD entries have been generated on the querier, run the reset mld group command to clear these dynamic MLD entries before running the mld on-demand command.
  • After the mld on-demand command is executed on an interface:
    • The interface no longer sends MLD Query messages.

    • MLD group entries are generated after the interface receives Multicast Listener Report messages and will never age out.

    • When the interface receives a Multicast Listener Done message, it deletes the corresponding MLD group entry.

  • The mld on-demand configuration of the VLANIF interface and the mld-snooping enable command in a VLAN are mutually exclusive.

Example

# Enable the MLD on-demand function on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld on-demand
# Enable the MLD on-demand function on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld on-demand

mld prompt-leave

Function

The mld prompt-leave command enables the fast leave function on an interface. This function enables an MLD querier to delete MLD entries immediately after receiving Multicast Listener Done messages from group members, without sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.

The undo mld prompt-leave command disables fast leave on an interface.

By default, an MLD querier sends a Multicast Address Specific Query message or Multicast Address and Source Specific Query message after receiving a Multicast Listener Done message for a specific multicast group.

Format

mld prompt-leave [ group-policy acl6-number ]

undo mld prompt-leave

Parameters

Parameter Description Value
group-policy
Specifies an MLD multicast group policy. If this parameter is specified, the fast leave function takes effect only for multicast groups specified in the policy. When specifying this parameter, ensure that the referenced ACL6 has been configured. The interface filters Multicast Listener Done messages on the interface based on the ACL6.
  • If a host leaves a multicast group in the range permitted by the ACL6, the device immediately deletes the multicast group entry without sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.
  • If a host leaves a multicast group out of the range permitted by the ACL6, the device sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages.

If this parameter is not specified, the fast leave function takes effect for all multicast groups.

-
acl6-number Specifies the number of a basic ACL6 or an advanced ACL6. This ACL6 defines the range of multicast groups. The number of a basic ACL6 is an integer that ranges from 2000 to 2999. The number of an advanced ACL6 is an integer that ranges from 3000 to 3999.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In some scenarios, an interface on the MLD querier connects to only one receiver host. If the host frequently switches between multiple multicast groups, you can configure fast leave on the interface of the querier so that the interface can quickly respond to Multicast Listener Done messages sent from the host. After fast leave is configured, the querier does not send a Multicast Address Specific Query message or Multicast Address and Source Specific Query message after receiving a Multicast Listener Done message. Instead, the querier directly notifies the upstream multicast device that the host has left the multicast group. The fast leave function reduces delay in response to Multicast Listener Done messages and saves network bandwidth.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • When an interface has more than one receiver connected, enabling fast leave interrupts multicast traffic of the other receivers in the multicast group. You are advised to enable this function on interfaces with only one receiver.
  • When configuring an ACL6 to specify the range of multicast groups, pay attention to the following points:
    • When you run the rule command in the view of a basic ACL6, set source to the address range of multicast groups that hosts can fast leave.

    • When you run the rule command in the view of an advanced ACL6, set source to the multicast source address and destination to the range of multicast groups that hosts can fast leave.

Example

# Configure fast leave on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld prompt-leave
# Configure fast leave on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld prompt-leave

mld query ip-source-policy

Function

The mld query ip-source-policy command configures MLD Query message filtering based on source addresses.

The undo mld query ip-source-policy command restores the default configuration.

By default, no source address-based MLD Query message filtering is configured.

Format

mld query ip-source-policy basic-acl6-number

undo mld query ip-source-policy

Parameters

Parameter Description Value
basic-acl6-number Specifies the number of a basic ACL6, which defines the range of source addresses. The value is an integer that ranges from 2000 to 2999.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If an attacker sends forged MLD Query messages with an IPv6 address smaller than the querier IPv6 address, the querier is replaced by the attacker. As a result, the real querier cannot respond to Multicast Listener Report messages from group members and bandwidth is wasted. Source address-based MLD Query message filtering can protect the querier from such attacks. With this function configured, the switch accepts only the MLD Query messages with source addresses permitted by the specified ACL6. This function controls querier election.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • MLD Query messages are encapsulated into IPv6 messages. This command is used to filter the source addresses in IPv6 headers.

  • After you configure source address-based MLD Query message filtering on an interface, the interface filters out the MLD Query messages whose source addresses do not match a specified ACL6 rule.

Example

# Configure VLANIF100 to receive the MLD Query messages with the source address FC00::1.
<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2001
[HUAWEI-acl6-basic-2001] rule permit source fc00::1 128
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld query ip-source-policy 2001
# Configure GE0/0/1 to receive the MLD Query messages with the source address FC00::1.
<HUAWEI> system-view
[HUAWEI] acl ipv6 number 2001
[HUAWEI-acl6-basic-2001] rule permit source fc00::1 128
[HUAWEI-acl6-basic-2001] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld query ip-source-policy 2001

mld require-router-alert

Function

The mld require-router-alert command configures an interface to discard MLD messages without the Router-Alert option.

The undo mld require-router-alert command disables an interface from checking for the Router-Alert option in MLD messages.

By default, all received MLD messages are processed, including the MLD messages without the Router-Alert option.

Format

mld require-router-alert

undo mld require-router-alert

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a network device sends a message to the routing protocol module for processing only when the destination address of the message is a local interface address. Destination addresses of MLD messages are multicast addresses but not addresses of interfaces on multicast devices. Therefore, multicast devices do not send MLD messages to the MLD module for processing, and the MLD module cannot maintain group memberships.

The Router-Alert option in the IPv6 header of an MLD message solves this problem. If an MLD message contains the Router-Alert option, the device sends the message to the MLD module.

You can configure the device to accept only MLD messages with the Router-Alert option to improve MLD security.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of the mld require-router-alert command is the same as that of the require-router-alert (MLD view) command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The system prefers the configuration in the interface view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Configure VLANIF100 to discard MLD messages without the Router-Alert option.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld require-router-alert
# Configure GE0/0/1 to discard MLD messages without the Router-Alert option.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld require-router-alert

mld robust-count

Function

The mld robust-count command sets a robustness variable of an MLD querier on an interface.

The undo mld robust-count command restores the default robustness variable of an MLD querier.

By default, the robustness variable of an MLD querier is 2.

Format

mld robust-count robust-value

undo mld robust-count

Parameters

Parameter Description Value
robust-value Specifies the robustness variable of an MLD querier. The value is an integer that ranges from 2 to 5.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The MLD querier robustness variable specifies the retransmission count of MLD packets to minimize the impact of packet loss on the network.

On a shared network segment, a querier maintains MLD group memberships. The robustness variable affects the timeout period of group memberships. The timeout period of the group membership is calculated using the formula:

Timeout period of the group memberships = Interval for sending MLD General Query messages x Robustness variable + Maximum response time

The robustness variable determines the following values:
  • Number of times the querier sends General Query messages when the querier starts

    When a querier starts, it sends General Query messages a certain number of times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The interval for sending General Query messages is configured using the mld timer query or timer query (MLD view) command.

  • Number of times the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages

    When receiving a Multicast Listener Done message of a multicast group, the querier sends Multicast Address Specific Query messages a certain number of times specified by the robustness variable to check whether the group has members. When the querier receives a Multicast Listener Report message indicating that source-group mapping changes, the querier sends Multicast Address and Source Specific Query messages a certain number of times specified by the robustness variable. The interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages is set using the mld lastlistener-queryinterval or lastlistener-queryinterval (MLD view) command.

A larger robustness variable makes an MLD querier more robust but increases the timeout period of group memberships.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of the mld robust-count command is the same as that of the robust-count (MLD view) command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Set the robustness variable of the querier on VLANIF100 to 3.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld robust-count 3
# Set the robustness variable of the querier on GE0/0/1 to 3.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld robust-count 3

mld send-router-alert

Function

The mld send-router-alert command configures an interface to send MLD messages containing the Router-Alert option in IPv6 headers.

The undo mld send-router-alert command disables an interface from sending MLD messages containing the Router-Alert option in IPv6 headers.

By default, the IPv6 headers of MLD messages sent by an interface contain the Router-Alert option.

Format

mld send-router-alert

undo mld send-router-alert

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the switch sends MLD messages that contain the Router-Alert option in IPv6 headers. If the switch needs to communicate with a device that does not support the Router-Alert option, run the undo mld send-router-alert command to configure the switch to send MLD messages without the Router-Alert option. The mld send-router-alert command is usually used together with the mld require-router-alert command.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of the mld send-router-alert command is the same as that of the send-router-alert (MLD view) command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Configure VLANIF100 to send MLD messages with the Router-Alert option in their IPv6 headers.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld send-router-alert
# Configure GE0/0/1 to send MLD messages with the Router-Alert option in their IPv6 headers.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld send-router-alert

mld ssm-mapping enable

Function

The mld ssm-mapping enable command enables MLD SSM mapping on an interface.

The undo mld ssm-mapping enable command disables MLD SSM mapping on an interface.

By default, MLD SSM mapping is disabled on an interface.

Format

mld ssm-mapping enable

undo mld ssm-mapping enable

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The SSM model allows MLDv2 hosts to specify the multicast sources from which they want to receive data. However, some hosts can only run MLDv1. To allow these hosts to use SSM, configure MLD SSM mapping on the switch. MLD SSM mapping is implemented based on static SSM mapping entries on the switch. The switch converts (*, G) information in MLDv1 Multicast Listener Report messages to (S, G) information according to static SSM mapping entries to provide the SSM service for MLDv1 hosts.

The mld ssm-mapping enable command enables MLD SSM mapping on an interface. The mappings between SSM sources and multicast group addresses take effect only when MLD SSM mapping is enabled on an interface. SSM mapping entries are configured using the ssm-mapping (MLD view) command.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Example

# Enable MLD SSM mapping on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld ssm-mapping enable
# Enable MLD SSM mapping on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld ssm-mapping enable

mld static-group

Function

The mld static-group command configures a static multicast group on an interface.

The undo mld static-group command deletes a static multicast group from an interface.

By default, no static multicast group is configured on an interface.

Format

mld static-group ipv6-group-address [ inc-step-mask ipv6-group-mask-length number group-number ] [ source ipv6-source-address ]

undo mld static-group { all | ipv6-group-address [ inc-step-mask ipv6-group-mask-length number group-number ] [ source ipv6-source-address ] }

Parameters

Parameter Description Value
ipv6-group-address Specifies the IPv6 address of the multicast group that an interface statically joins. In batch configuration mode, this parameter specifies the initial address of the multicast group addresses. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
inc-step-mask ipv6-group-mask-length Specifies the incremental length of the step mask in batch configuration mode. The value is an integer that ranges from 8 to 128.
number group-number Specifies the number of group addresses in batch configuration mode. The value is an integer that ranges from 2 to 512.
source ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.
all Specifies all the multicast groups that the interface statically joins. -

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The following are two scenarios in which you can configure static multicast groups on user-side interfaces of the switch:

  • There are long-term group members on a shared network segment, and the switch needs to forward multicast data to these group members quickly and steadily.

  • A network segment has no group member or hosts on the network segment cannot send Report messages, but multicast data needs to be sent to this network segment.

After a static multicast group is configured on an interface, the switch considers that the multicast group always has members on the network segment of the interface. Therefore, the switch always forwards multicast data of the multicast group.

The mld static-group command is used on an interface connected to user hosts. The command can configure a single group or source-group binding on an interface or configure multiple groups or source-group bindings in a batch.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • After multicast groups are configured in batches for the first time, if you only modify the value of group-number but not the value of ipv6-group-address or ipv6-group-mask-length to configure multicast groups in batches again, The new configurations overwrite the corresponding original configurations.

  • After you run the mld static-group command on an interface connected to user hosts, the entries matching the MLD groups that the interface statically joins never time out. The switch considers that this interface is always connected to group members, and keeps forwarding multicast packets of the specified multicast groups to the network segment where the interface resides.
  • You can configure overlapping multicast group addresses in different batch configurations. When you configure multiple static multicast groups in a batch on an interface, do not delete any static group configuration before the system completes the batch static group configuration.
  • If a user host no longer needs to receive multicast data of a static group, delete the static group configuration.
  • When the interface that connects a multicast device to the user network segment joins a multicast group in both dynamic and static modes, the interface preferentially joins the multicast group in static mode if a conflict occurs.

  • Running the mld static-group command failed on the VLANIF interface because Layer 2 multicast querier or report-suppress is enabled for this VLAN.

Example

# Configure static multicast group FF13::101 on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld static-group ff13::101

# Configure the switch to forward multicast packets from multicast source FC00::101 to multicast group FF14::202 through VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld static-group ff14::202 source fc00::101

# Add VLANIF100 statically to two multicast groups in a batch. Set the start multicast group address to FF25::1 and the step mask length to 24.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld static-group ff25::1 inc-step-mask 24 number 2

# Add VLANIF100 statically to two multicast source/groups in a batch. Set the start multicast group address to FF33::1, the source address to FC00::101, and the step mask length to 24.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld static-group ff33::1 inc-step-mask 24 number 2 source fc00::101
# Configure static multicast group FF13::101 on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld static-group ff13::101

mld timer other-querier-present

Function

The mld timer other-querier-present command sets the other querier present timer on an interface.

The undo mld timer other-querier-present command restores the default value of the other querier present timer on an interface.

By default, the Keepalive period of the other queriers is calculated as follows:

Other querier present timer = Robustness variable x Interval for sending MLD General Query messages + 1/2 x Maximum response time

If the default values of the robustness variable, interval for sending MLD General Query messages, and maximum response time are used, the other querier present timer value is 255 seconds.

Format

mld timer other-querier-present interval

undo mld timer other-querier-present

Parameters

Parameter Description Value
interval Specifies the other querier present timer. The value is an integer that ranges from 60 to 300, in seconds.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a user network segment connects to multiple Layer 3 multicast devices, only one Layer 3 multicast device is elected as the MLD querier to send Query messages to hosts on the network segment. To create and maintain normal group memberships, non-queriers running MLD start the other querier present timer after they fail in the querier election. If the non-queriers do not receive Query messages from the querier before the timer times out, they consider the querier failed and start a new querier election.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of the mld timer other-querier-present command is the same as that of the timer other-querier-present (MLD view) command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

If the other querier present timer is shorter than the interval for sending General Query messages, the querier election is triggered frequently.

Example

# On VLANIF100, set the other querier present timer to 200 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld timer other-querier-present 200
# On GE0/0/1, set the other querier present timer to 200 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld timer other-querier-present 200

mld timer query

Function

The mld timer query command sets the interval at which an interface sends MLD General Query messages.

The undo mld timer query command restores the default interval at which an interface sends MLD General Query messages.

By default, an interface sends MLD General Query messages at an interval of 125s.

Format

mld timer query interval

undo mld timer query

Parameters

Parameter Description Value
interval Specifies the interval at which an interface sends MLD General Query messages. The value is an integer that ranges from 1 to 18000, in seconds.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An MLD querier checks whether a local network segment has multicast group members by sending MLD General Query messages at an interval, known as the general query interval. You can set the general query interval based on needs of your network. The general query interval affects the following processes:
  • When a querier starts, it sends General Query messages a certain number of times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The message sending interval during this process is 1/4 of the interval for sending General Query messages. The robustness variable can be set using the mld robust-count or robust-count (MLD view) command.

  • After the startup process is complete, the querier sends General Query messages at intervals to maintain the group memberships on the interface.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • The querier is more sensitive when it sends General Query messages at a smaller interval. However, more bandwidth and switch resources are consumed in this case.
  • The function of the MLD timer query command is the same as that of the timer query (MLD view) command used in the MLD view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The system prefers the configuration in the interface view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Set the interval at which VLANIF100 sends General Query messages to 200 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld timer query 200
# Set the interval at which GE0/0/1 sends General Query messages to 200 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld timer query 200

mld ttl-check

Function

The mld ttl-check command enables the device to check the TTL values in received MLD Report, Done, and Query messages on a specific interface.

The undo mld ttl-check command restores the default configuration.

By default, the device does not check the TTL values in received MLD Report, Done, and Query messages on an interface.

Format

mld ttl-check

undo mld ttl-check

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command enables TTL check for MLD Report, Leave, and Query messages on an interface. This function protects the system against attacking MLD messages by dropping the messages of which the TTL value is not 1. By default, TTL values of MLD messages are not checked on an interface.

You can also configure TTL check for MLD Report, Leave, and Query messages by using the ttl-check command in the MLD view. This command takes effect for all MLD-enabled interfaces.

Precautions

If both the mld ttl-check and ttl-check commands are run, the mld ttl-check configuration in the interface view takes precedence over the ttl-check configuration in the MLD view.

Example

# Enable TTL check for MLDReport, Leave, and Query messages on a physical interface.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld ttl-check

# Enable TTL check for MLD Report, Leave, and Query messages on a VLANIF interface.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] vlan 2
[HUAWEI-vlan2] quit
[HUAWEI] interface vlanif 2
[HUAWEI-Vlanif2] mld ttl-check

mld version

Function

The mld version command specifies an MLD version on an interface.

The undo mld version command restores the default MLD version on an interface.

By default, an interface runs MLDv2.

Format

mld version version

undo mld version

Parameters

Parameter Description Value
version Specifies the MLD version running on the interface. The value is integer that ranges from 1 to 2.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A multicast switch can only identify MLD messages of a version earlier than its own MLD version. To ensure normal MLD operation, set on the switch an MLD version the same as or later than that running on user hosts.

If many switches exist on a shared network segment, configure the same MLD version on all switch interfaces connected to hosts. If multicast devices run MLD of different versions, errors may occur in MLD operation because interfaces running different MLD versions send messages in different formats.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Example

# Configure MLDv2 on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] mld version 2
# Configure MLDv2 on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] mld version 2

require-router-alert (MLD view)

Function

The require-router-alert command configures the switch to discard MLD messages without the Router-Alert option.

The undo require-router-alert command disables the switch from checking the Router-Alert option in MLD messages.

By default, the switch does not check whether the received MLD messages contain Router-Alert options in IPv6 headers, and it accepts all the received MLD messages.

Format

require-router-alert

undo require-router-alert

Parameters

None

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a network device sends a message to the routing protocol module for processing only when the destination address of the message is a local interface address. Destination addresses of MLD messages are multicast addresses but not addresses of interfaces on multicast devices. Therefore, multicast devices do not send MLD messages to the MLD module for processing, and the MLD module cannot maintain group memberships.

The Router-Alert option in the IPv6 header of an MLD message solves this problem. If an MLD message contains the Router-Alert option, the device sends the message to the MLD module.

You can configure the device to accept only MLD messages with the Router-Alert option to improve MLD security.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of this command is the same as that of the mld require-router-alert command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# In the MLD view, configure the switch to discard the MLD messages that do not contain Router-Alert options in IPv6 headers.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] require-router-alert

reset mld control-message counters

Function

The reset mld control-message counters command deletes statistics of MLD messages.

Format

reset mld control-message counters [ interface interface-type interface-number ] [ message-type { query | report } ]

Parameters

Parameter Description Value
interface interface-type interface-number Clears MLD packet statistics on a specified interface. If this parameter is not specified, MLD packets on all interfaces are deleted. -
message-type Clears statistics about MLD messages of a specified type. If this parameter is not specified, the command clears statistics about MLD messages of all types. -
query Clears the number of received Query messages. -
report Clears the number of received Multicast Listener Report messages. -

Views

User view

Default Level

3: Management level

Usage Guidelines

After statistics about MLD messages are deleted, MLD still operates properly.

Example

# Delete statistics about MLD messages from all interfaces.

<HUAWEI> reset mld control-message counters

# Delete statistics about MLD messages from VLANIF100.

<HUAWEI> reset mld control-message counters interface vlanif 100

reset mld explicit-tracking

Function

The reset mld explicit-tracking command deletes hosts that dynamically join a multicast group using MLD from an interface.

Format

reset mld explicit-tracking { all | interface interface-type interface-number [ host ipv6-host-address [ group ipv6-group-address [ source ipv6-source-address ] ] ] }

Parameters

Parameter Description Value
all Indicates information about all MLD hosts. -
interface interface-type interface-number Specifies the type and number of an interface. If this parameter is not specified, the command deletes hosts that dynamically join the host group using MLD from all interfaces. -
host ipv6-host-address Specifies the link-local address of a host. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF80:: to FF80:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
group ipv6-group-address Specifies an IPv6 multicast group address. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
source ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.

Views

User view

Default Level

3: Management level

Usage Guidelines

You can use this command to delete hosts that dynamically join a multicast group using MLD from an interface. A host can rejoin the multicast group after being deleted from this group.

Example

# Delete the host FE80::101 that joins multicast group FF23::101 through MLD on VLANIF100.

<HUAWEI> reset mld explicit-tracking interface vlanif 100 host fe80::101 group ff23::101

# Delete the host FE80::101 that joins the (FC00:0:0:1::12, FF23::101) forwarding entry from VLANIF100.

<HUAWEI> reset mld explicit-tracking interface vlanif 100 host fe80::101 group ff23::101 source fc00:0:0:1::12

reset mld group

Function

The reset mld group command deletes dynamic MLD entries on interfaces.

Format

reset mld group all

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

Parameters

Parameter Description Value
all

The first all deletes dynamic MLD entries on all interfaces.

The second all deletes all MLD entries on a specified interface.

-
interface interface-type interface-number Deletes dynamic MLD entries on a specified interface. -
ipv6-group-address Deletes dynamic MLD entries of a specified multicast group. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
ipv6-group-mask-length Specifies the mask length of the multicast group address. The value is an integer that ranges from 8 to 128.
ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.
ipv6-source-mask-length Specifies the mask length of the multicast source address. The value is an integer that ranges from 0 to 128.

Views

User view

Default Level

3: Management level

Usage Guidelines

This command deletes all the dynamic MLD group memberships on an interface, including common group memberships and group memberships established with SSM mapping. This command cannot delete statically configured MLD group memberships.

A host can rejoin the multicast group after being deleted from this group.

After dynamic MLD entries on an interface are deleted, the interface cannot receive multicast data. Exercise caution before running this command.

Example

# Delete dynamic MLD entries within the range of FF03::101:0 to FF03::101:FFFF on VLANIF100.
<HUAWEI> reset mld group interface vlanif 100 ff03::101:0 112

reset mld group ssm-mapping

Function

The reset mld group ssm-mapping command deletes multicast group entries established with MLD SSM mapping.

Format

reset mld group ssm-mapping all

reset mld group ssm-mapping interface interface-type interface-number { all | ipv6-group-address [ ipv6-group-mask-length ] }

Parameters

Parameter Description Value
all

The first all deletes multicast group entries established with MLD SSM mapping on all interfaces.

The second all deletes all multicast group entries established with MLD SSM mapping on a specified interface.

-
interface interface-type interface-number Deletes the multicast group entries established with MLD SSM mapping on a specified interface. -
ipv6-group-address Specifies an IPv6 multicast group address. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
ipv6-group-mask-length Specifies the mask length of the multicast group address. The value is an integer that ranges from 8 to 128.

Views

User view

Default Level

3: Management level

Usage Guidelines

This command is valid only on the multicast groups that an interface has dynamically joined, and deletes only the MLDv1 multicast group entries within the range of SSM group addresses.

SSM mapping can be re-configured after being deleted.

After the multicast group entries established with MLD SSM mapping on an interface are deleted, the interface cannot receive multicast data. Exercise caution before running this command.

Example

# Delete multicast group entries established with MLD SSM mapping within the range of FF13::101:0 to FF13::101:FFFF on VLANIF100.
<HUAWEI> reset mld group ssm-mapping interface vlanif 100 ff13::101:0 112

robust-count (MLD view)

Function

The robust-count command sets a global robustness variable for an MLD querier.

The undo robust-count command restores the default robustness variable.

By default, the robustness variable of an MLD querier is 2.

Format

robust-count robust-value

undo robust-count

Parameters

Parameter Description Value
robust-value Specifies the robustness variable of an MLD querier. The value is an integer that ranges from 2 to 5.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The MLD querier robustness variable specifies the retransmission count of MLD packets to minimize the impact of packet loss on the network.

On a shared network segment, a querier maintains MLD group memberships. The robustness variable affects the timeout period of group memberships. The timeout period of the group membership is calculated using the formula:

Timeout period of the group memberships = Interval for sending MLD General Query messages x Robustness variable + Maximum response time

The robustness variable determines the following values:
  • Number of times the querier sends General Query messages when the querier starts

    When a querier starts, it sends General Query messages a certain number of times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The interval for sending General Query messages is configured using the mld timer query or timer query (MLD view) command.

  • Number of times the querier sends Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages

    When receiving a Multicast Listener Done message of a multicast group, the querier sends Multicast Address Specific Query messages a certain number of times specified by the robustness variable to check whether the group has members. When the querier receives a Multicast Listener Report message indicating that source-group mapping changes, the querier sends Multicast Address and Source Specific Query messages a certain number of times specified by the robustness variable. The interval for sending Multicast Address Specific Query messages or Multicast Address and Source Specific Query messages is set using the mld lastlistener-queryinterval or lastlistener-queryinterval (MLD view) command.

A larger robustness variable makes an MLD querier more robust but increases the timeout period of group memberships.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of this command is the same as that of the mld robust-count command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the current interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# Set the robustness variable of an MLD querier to 3 in the MLD view.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] robust-count 3

send-router-alert (MLD view)

Function

The send-router-alert command configures the switch to send MLD messages containing the Router-Alert option in IPv6 headers.

The undo send-router-alert command disables the switch from sending MLD messages containing the Router-Alert option in IPv6 headers.

By default, MLD messages sent by the switch contain the Router-Alert option.

Format

send-router-alert

undo send-router-alert

Parameters

None

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, MLD messages sent by the switch contain the Router-Alert option in their IPv6 headers. If the switch needs to communicate with a device that does not support the Router-Alert option, run the undo send-router-alert command to configure the switch to send MLD messages without the Router-Alert option. The send-router-alert command is usually used together with the require-router-alert (MLD view) command.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of this command is the same as that of the mld send-router-alert command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# In the MLD view, configure the switch to send MLD packets with the Router-Alert option in IPv6 headers.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] send-router-alert

ssm-mapping (MLD view)

Function

The ssm-mapping command configures an SSM mapping entry to map a multicast source to a group address.

The undo ssm-mapping command deletes an SSM mapping entry.

By default, no SSM mapping entry is configured.

Format

ssm-mapping ipv6-group-address ipv6-group-mask-length ipv6-source-address

undo ssm-mapping { all | ipv6-group-address ipv6-group-mask-length [ ipv6-source-address ] }

Parameters

Parameter Description Value
ipv6-group-address Specifies the IPv6 address of a multicast group configured with SSM mapping. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format. The value ranges from FF00:: to FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF.
ipv6-group-mask-length Specifies the mask length of the IPv6 multicast group address. The value is an integer, which can be 16, 32, 64, or 128.
ipv6-source-address Specifies the IPv6 address of a multicast source. The value is a 32-digit hexadecimal number in X:X:X:X:X:X:X:X format.
all Deletes all the configured static SSM mapping entries. -

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hosts that support only MLDv1 cannot join SSM groups. To enable multicast devices to provide the SSM service for these hosts, configure SSM mapping on the multicast devices. An SSM mapping entry maps a multicast source to a multicast group. After SSM mapping entries are configured on a multicast device, the device can convert (*, G) information in Report messages of MLDv1 to (S, G) information.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • You can configure multiple static SSM mapping entries by running the ssm-mapping command several times.
  • To delete an SSM mapping entry, run the undo ssm-mapping ipv6-group-address ipv6-group-mask-length [ ipv6-source-address ] command. The undo ssm-mapping all command deletes all the SSM mapping entries. Exercise caution before running this command.

Example

# Configure an SSM mapping entry mapping the source address FC00::1 to group address FF35::1/128.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] ssm-mapping ff35::1 128 fc00::1

timer other-querier-present (MLD view)

Function

The timer other-querier-present command sets a global other querier present timer.

The undo timer other-querier-present command restores the default value of the other querier present timer.

By default, the Keepalive period of the other queriers is calculated as follows:

Other querier present timer = Robustness variable x Interval for sending MLD General Query messages + 1/2 x Maximum response time

If the default values of the robustness variable, interval for sending MLD General Query messages, and maximum response time are used, the other querier present timer value is 255 seconds.

Format

timer other-querier-present interval

undo timer other-querier-present

Parameters

Parameter Description Value
interval Specifies the other querier present timer. The value is an integer that ranges from 60 to 300, in seconds.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a user network segment connects to multiple Layer 3 multicast devices, only one Layer 3 multicast device is elected as the MLD querier to send Query messages to hosts on the network segment. To create and maintain normal group memberships, non-queriers running MLD start the other querier present timer after they fail in the querier election. If the non-queriers do not receive Query messages from the querier before the timer times out, they consider the querier failed and start a new querier election.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

The function of this command is the same as that of the mld timer other-querier-present command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

If the other querier present timer is shorter than the interval for sending General Query messages, the querier election is triggered frequently.

Example

# Set the other querier present timer to 200 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] timer other-querier-present 200

timer query (MLD view)

Function

The timer query command sets a global interval for sending MLD General Query messages.

The undo timer query command restores the default interval for sending MLD General Query messages.

By default, the interval for sending MLD General Query messages is 125 seconds.

Format

timer query interval

undo timer query

Parameters

Parameter Description Value
interval Interval for sending MLD General Query messages The value is an integer that ranges from 1 to 18000, in seconds.

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An MLD querier checks whether a local network segment has multicast group members by sending MLD General Query messages at an interval, known as the general query interval. You can set the general query interval based on needs of your network. The general query interval affects the following processes:
  • When a querier starts, it sends General Query messages a certain number of times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The message sending interval during this process is 1/4 of the interval for sending General Query messages. The robustness variable can be set using the mld robust-count or robust-count (MLD view) command.

  • After the startup process is complete, the querier sends General Query messages at intervals to maintain the group memberships on the interface.

Prerequisites

Layer 3 IPv6 multicast has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

  • The querier is more sensitive when it sends General Query messages at a smaller interval. However, more bandwidth and switch resources are consumed in this case.
  • The function of this command is the same as that of the mld timer query command used in the interface view. The configuration in the MLD view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the MLD view. The configuration in the MLD view is used only when no configuration is performed in the interface view.

Example

# In the MLD view, set the interval for sending MLD General Query messages to 200 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] timer query 200

ttl-check (MLD view)

Function

The ttl-check command enables the device to check the TTL values in received MLD Report, Done, and Query messages on all interfaces.

The undo ttl-check command restores the default configuration.

By default, the device does not check the TTL values in received MLD Report, Done, and Query messages.

Format

ttl-check

undo ttl-check

Parameters

None

Views

MLD view

Default Level

2: Configuration level

Usage Guidelines

To protect a device against MLD message attacks, run the ttl-check command to enable the device to check the TTL values in received MLD Report, Done, and Query messages on all interfaces and discard such a message if its TTL value is not 1.

Example

# Enable the device to check the TTL values in received MLD Report, Done, and Query messages on all interfaces.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] mld
[HUAWEI-mld] ttl-check
Translation
Download
Updated: 2019-10-09

Document ID: EDOC1000178165

Views: 48223

Downloads: 1163

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next