MLD Configuration Command Reference

Command Hierarchies

MLD Configuration Commands

For more information about MLD commands, refer to the SR OS Triple Play Guide.

config
[no] router
[no] mld
[no] group-interface ip-int-name
import policy-name
— no import
max-groups value
— no max-groups
max-grp-sources [1..32000]
max-sources [1..1000]
query-src-ip ipv6-address
[no] shutdown
[no] subnet-check
version version
— no version
grp-if-query-src-ip ipv6-address
[no] interface ip-int-name
import policy-name
— no import
max-groups value
— no max-groups
max-grp-sources [1..32000]
max-sources [1..1000]
query-interval seconds
[no] shutdown
[no] grp-range start end
[no] source src-ipv6-address
static
[no] group grp-ipv6-address
[no] source src-ipv6-address
[no] starg
[no] group start grp-ipv6-address end grp-ipv6-address [step ipv6-address]
[no] source src-ipv6-address
[no] starg
version version
— no version
query-interval seconds
robust-count robust-count
[no] shutdown
[no] grp-range start end
[no] source src-ipv6-address

Command Descriptions

MLD Commands

mld

Syntax 
[no] mld
Context 
config>router
Description 

This command enables the context to configure Multicast Listener Discovery (MLD) parameters.

The no form of the command disables MLD.

Default 

no mld

group-interface

Syntax 
[no] group-interface ip-int-name
Context 
config>router>mld
Description 

This command creates and enables the context to configure MLD group interface parameters.

Parameters 
ip-int-name—
The IP interface name. Interface names must be unique within the group of defined IP interfaces for config router interface and config service ies interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

grp-if-query-src-ip

Syntax 
grp-if-query-src-ip ipv6-address
no grp-if-query-src-ip
Context 
config>router>mld
Description 

This command configures the query source IPv6 address for all group interfaces.

The no form of the command removes the IP address.

Default 

none

Parameters 
ipv6-address—
Sets the source IPv6 address for all group interfaces. The address can be up to 64 characters.

query-src-ip

Syntax 
query-src-ip ipv6-address
no query-src-ip
Context 
config>router>mld>group-interface
Description 

This command configures the query source IPv6 address for the group interface. This IP address overrides the source IP address configured at the router level.

The no form of the command removes the IPv6 address.

Default 

none

Parameters 
ipv6-address—
Sets the source IPv6 address for all subscriber’s IGMP queries.

sub-hosts-only

Syntax 
[no] sub-hosts-only
Context 
config>router>mld>group-interface
Description 

This command disables processing of MLD messages outside of the subscriber-host context. No other hosts outside of the subscriber-hosts can create MLD states.

Disabling this command will allow creation of the MLD states that correspond to the AN that operate in MLD proxy mode. In this mode the AN will hide source IP addresses of MLD messages and will source MLD messages with its own IP address. In this case an MLD state can be created under the sap context. This MLD state creation under the SAP is controlled via the import policy under the group-interface.

MLD state processing for regular subscriber-hosts is unaffected by this command.

The no form of the command disables the command.

Default 

sub-hosts-only

subnet-check

Syntax 
[no] subnet-check
Context 
config>router>mld>group-interface
Description 

This command enables subnet checking for MLD messages received on this interface. All MLD packets with a source address that is not in the local subnet are dropped.

Default 

enabled

version

Syntax 
version version
no version
Context 
config>router>mld>group-interface
Description 

This command specifies the MLD version. If routers run different versions of MLD, they will negotiate the lowest common version of MLD that is supported by hosts on their subnet and operate in that version. For MLD to function correctly, all routers on a LAN should be configured to run the same version of MLD on that LAN.

Default 

3

Parameters 
version—
Specifies the MLD version number.
Values—
1, 2, 3

Generic Commands

shutdown

Syntax 
[no] shutdown
Context 
config>router>mld
config>router>mld>group-interface>mcac>mc-constraints
config>router>mld>group-interface
config>router>mld>interface
Description 

The shutdown command administratively disables the entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics. Many entities must be explicitly enabled using the no shutdown command and must be shut down before they may be deleted.

Unlike other commands and parameters where the default state is not indicated in the configuration file, shutdown and no shutdown are always indicated in system generated configuration files.

The no form of the command puts an entity into the administratively enabled state.

Default 

no shutdown

interface

Syntax 
[no] interface ip-int-name
Context 
config>router>mld
Description 

This command enables the context to configure an Multicast Listener Discovery (MLD) interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is to be enabled or disabled.

The no form of the command deletes the MLD interface. The shutdown command in the config>router>mld>interface context can be used to disable an interface without removing the configuration for the interface.

Default 

no interface — No interfaces are defined.

Parameters 
ip-int-name—
The IP interface name. Interface names must be unique within the group of defined IP interfaces for config router interface and config service ies interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

If the IP interface name does not exist or does not have an IP address configured an error message will be returned.

If the IP interface exists in a different area it will be moved to this area.

disable-router-alert-check

Syntax 
[no] disable-router-alert-check
Context 
config>router>mld>interface
Description 

This command enables router alert checking for MLD messages received on this interface.

The no form of the command disables the router alert checking.

Default 

none

import

Syntax 
import policy-name
no import
Context 
config>router>mld>interface
Description 

This command specifies the import route policy to be used for determining which membership reports are accepted by the router. Route policies are configured in the config>router>policy-options context.

When an import policy is not specified, all the MLD reports are accepted.

The no form of the command removes the policy association from the MLD instance.

Default 

no import — No import policy specified.

Parameters 
policy-name—
The route policy name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.

max-groups

Syntax 
max-groups value
no max-groups
Context 
config>router>mld>group-interface
config>router>mld>interface
Description 

This command specifies the maximum number of groups for which MLD can have local receiver information based on received MLD reports on this interface. When this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed.

Default 

0, no limit to the number of groups.

Parameters 
value—
Specifies the maximum number of groups for this interface.
Values—
1 to 16000

max-grp-sources

Syntax 
max-grp-sources [1..32000]
no max-grp-sources
Context 
config>router>mld>group-interface
config>router>mlp>interface
Description 

This command configures the maximum number of group sources for which MLD can have local receiver information based on received IGMP reports on this interface. When this configuration is changed dynamically to a value lower than currently accepted number of group sources, the group sources that are already accepted are not deleted. Only new group sources will not be allowed.

The no form of the command reverts to the default.

Default 

0

Parameters 
1 to 32000—
Specifies the maximum number of group source.
Values—
1 to 32000

max-sources

Syntax 
max-sources [1..1000]
no max-sources
Context 
config>router>mld>group-interface
config>router>mlp>interface
Description 

This command configures the maximum number of group sources for this group-interface.

query-interval

Syntax 
query-interval seconds
no query-interval
Context 
config>router>mld
config>router>mld>interface
Description 

This command specifies the frequency that the querier router transmits general host-query messages. The host-query messages solicit group membership information and are sent to the all-systems multicast group address, 224.0.0.1.

Default 

125

Parameters 
seconds—
The time frequency, in seconds, that the router transmits general host-query messages.
Values—
2 to 1024

query-last-listener-interval

Syntax 
query-last-listener-interval seconds
Context 
config>router>mld
config>router>mld>interface
Description 

This command configures the frequency at which the querier sends group-specific query messages including messages sent in response to leave-group messages. The lower the interval, the faster the detection of the loss of the last member of a group.

Default 

1

Parameters 
seconds—
Specifies the frequency, in seconds, at which query messages are sent.
Values—
1 to 1024

query-response-interval

Syntax 
query-response-interval seconds
Context 
config>router>mld
config>router>mld>interface
Description 

This command specifies how long the querier router waits to receive a response to a host-query message from a host.

Default 

10

Parameters 
seconds—
Specifies the the length of time to wait to receive a response to the host-query message from the host.
Values—
1 to 1023

static

Syntax 
static
Context 
config>router>mld>interface
Description 

This command tests multicast forwarding on an interface without a receiver host. When enabled, data is forwarded to an interface without receiving membership reports from host members.

Default 

none

group

Syntax 
[no] group grp-ipv6-address
[no] group start grp-ipv6-address end grp-ipv6-address [step ipv6-address]
Context 
config>router>mld>interface>static
Description 

This command enables the context to add a static multicast group either as a (*,G) or one or more (S,G) records. Use MLD static group memberships to test multicast forwarding without a receiver host. When MLD static groups are enabled, data is forwarded to an interface without receiving membership reports from host members.

When static MLD group entries on point-to-point links that connect routers to a rendezvous point (RP) are configured, the static MLD group entries do not generate join messages toward the RP.

The no form of the command removes the IPv6 address from the configuration.

Default 

none

Parameters 
grp-ipv6-address—
Specifies an MLD multicast group address that receives data on an interface. The IP address must be unique for each static group.
Values—
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D
start grp-ipv6-address
Specifies the start multicast group address.
Values—
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D
end grp-ipv6-address
Specifies the end multicast group address.
Values—
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D
step ipv6-address
Specifies the step increment.

source

Syntax 
[no] source src-ipv6-address
Context 
config>router>mld>interface>static>group
Description 

This command specifies an IPv6 unicast address that sends data on an interface. This enables a multicast receiver host to signal a router the group to receive multicast traffic from, and from the source(s) that the traffic is expected.

The source command is mutually exclusive with the specification of individual sources for the same group.

The source command, in combination with the group, is used to create a specific (S,G) static group entry.

The no form of the command removes the source from the configuration.

Default 

none

Parameters 
src-ipv6-address—
Specifies the IPv6 unicast address.

starg

Syntax 
[no] starg
Context 
config>router>mld>interface>static>group
Description 

This command adds a static (*,G) entry. This command can only be enabled if no existing source addresses for this group are specified.

Use the no form of the command to remove the starg entry from the configuration.

Default 

none

subnet-check

Syntax 
[no] subnet-check
Context 
config>router>mld>interface
Description 

This command enables subnet checking for MLD messages received on this interface. All MLD packets with a source address that is not in the local subnet are dropped.

Default 

enabled

version

Syntax 
version version
no version
Context 
config>router>mld>interface
Description 

This command specifies the MLD version. If routers run different versions, they will negotiate the lowest common version of MLD that is supported by hosts on their subnet and operate in that version. For MLD to function correctly, all routers on a LAN should be configured to run the same version of MLD on that LAN.

Default 

1

Parameters 
version—
Specifies the MLD version number.
Values—
1 or 2

robust-count

Syntax 
robust-count robust-count
no robust-count
Context 
config>router>mld
Description 

This command configures the robust count. The robust-count variable allows tuning for the expected packet loss on a subnet. If a subnet anticipates losses, the robust-count variable can be increased.

Default 

2

Parameters 
robust-count—
Specify the robust count value.
Values—
2 to 10

ssm-translate

Syntax 
ssm-translate
Context 
config>router>mld
config>router>mld>interface
Description 

This command enables the context to configure group ranges which are translated to SSM (S,G) entries. If the static entry needs to be created, it has to be translated from a IGMPv1 IGMPv2 request to a Source Specific Multicast (SSM) join. An SSM translate source can only be added if the starg command is not enabled. An error message is generated if you try to configure the source command with starg command enabled.

grp-range

Syntax 
[no] grp-range start end
Context 
config>router>mld>ssm-translate
config>router>mld>interface>ssm-translate
Description 

This command is used to configure group ranges which are translated to SSM (S,G) entries.

Parameters 
start—
An IP address that specifies the start of the group range.
end—
An IP address that specifies the end of the group range. This value should always be greater than or equal to the value of the start value.

source

Syntax 
[no] source ip-address
Context 
config>router>mld>ssm-translate>grp-range
config>router>mld>interface>ssm-translate>grp-range
Description 

This command specifies the source IP address for the group range. Whenever a (*,G) report is received in the range specified by grp-range start and end parameters, it is translated to an (S,G) report with the value of this object as the source address.

Parameters 
ip-address—
Specifies the IP address that will be sending data.