OcNOS-RON : Multicast Guide : Multicast Routing Information Base Command Reference : MLD Multicast Commands
MLD Multicast Commands
This chapter describes the commands for Multicast Listener Discovery (MLD) which includes the MLD proxy service.
clear ipv6 mld
Use this command to clear MLD local memberships in an interface or group. This command applies to entities configured for MLD layer-3 multicast protocols, or MLD proxy.
Command Syntax
clear ipv6 mld
clear ipv6 mld group *
clear ipv6 mld group X:X::X:X
clear ipv6 mld group X:X::X:X IFNAME
clear ipv6 mld group [*|X:X::X:X (IFNAME)]
clear ipv6 mld interface IFNAME
clear ipv6 mld (vrf NAME|)
clear ipv6 mld (vrf NAME|) group *
clear ipv6 mld (vrf NAME|) group X:X::X:X
clear ipv6 mld (vrf NAME|) group X:X::X:X IFNAME
clear ipv6 mld (vrf NAME|) interface IFNAME
Parameter
vrf
Specify the VRF name.
groups
Clears groups from an interface.
*
Clears all groups from an interface.
X:X::X:X
Specify an IPv6 interface.
interface
Specify the interface parameter.
IFNAME
Specify the interface name.
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ipv6 mld group *
#clear ipv6 mld group 224.1.1.1
#clear ipv6 mld vrf VRF_A
debug ipv6 mld
Use this command to enable debugging of all MLD, or a specific component of MLD. This command applies to interfaces configured for MLD Layer-3 multicast protocols.
Use the no parameter with this command to disable all MLD debugging or debugging of a specific component of MLD.
Command Syntax
debug ipv6 mld all
debug ipv6 mld decode
debug ipv6 mld encode
debug ipv6 mld events
debug ipv6 mld fsm
debug ipv6 mld tib
debug ipv6 mld (vrf NAME|) all
debug ipv6 mld (vrf NAME|) decode
debug ipv6 mld (vrf NAME|) encode
debug ipv6 mld (vrf NAME|) events
debug ipv6 mld (vrf NAME|) fsm
debug ipv6 mld (vrf NAME|) tib
no debug ipv6 mld all
no debug ipv6 mld decode
no debug ipv6 mld encode
no debug ipv6 mld events
no debug ipv6 mld fsm
no debug ipv6 mld tib
no debug ipv6 mld (vrf NAME|) all
no debug ipv6 mld (vrf NAME|) decode
no debug ipv6 mld (vrf NAME|) encode
no debug ipv6 mld (vrf NAME|) events
no debug ipv6 mld (vrf NAME|) fsm
no debug ipv6 mld (vrf NAME|) tib
Parameters
all
Debug all MLD.
decode
Debug MLD decoding.
encode
Debug MLD encoding.
events
Debug MLD events.
fsm
Debug MLD finite state machine (FSM).
tib
Debug MLD tree information base (TIB).
vrf
Debug VPN Routing/Forwarding instance.
Command Mode
Privileged Exec mode and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug mld all
ipv6 mld
Use this command to enable the MLD protocol operation on an interface. This command enables MLD protocol operation in stand-alone mode, and can be used to learn local-membership information prior to enabling a multicast routing protocol on the interface. This command will has no effect on interfaces configured for MLD Proxy.
Note: This command can only be issued on VLAN interfaces.
Use the no parameter with this command to return all MLD related configuration to the default or MLD Proxy service.
Command Syntax
ipv6 mld
no ipv6 mld
Parameters
None
Default
Disabled
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface eth1
(config-if)#ipv6 mld
ipv6 mld access-group
Use this command to control the multicast local-membership groups learnt on an interface. This command applies to interfaces configured for MLD layer-3 multicast protocols, or MLD proxy.
Note: This command can only be issued on VLAN interfaces.
Use the no parameter with this command to disable this access control.
Command Syntax
ipv6 mld access-group WORD
no ipv6 mld access-group
Parameter
WORD
Standard IPv6 access-list name.
Default
No access list configured.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Examples
In the following example, hosts serviced by Ethernet interface 0 can join the group ff0e::1/128 only:
#configure terminal
(config)#ipv6 access-list Group1 permit ff0e::1/128
(config)#interface fxp0
(config-if)#ipv6 mld access-group Group1
ipv6 mld immediate-leave
Use this command to minimize the leave latency of MLD memberships. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy. Use this command when only one receiver host is connected to each interface.
Use the no parameter with this command to disable this feature.
Command Syntax
ipv6 mld immediate-leave group-list WORD
no ipv6 mld immediate-leave
Parameter
group-list
Standard IPv6 access-list name that defines multicast groups in which the immediate leave feature is enabled.
Default
Disabled
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example shows how to enable the immediate-leave feature on an interface for a specific range of multicast groups. In this example, the router assumes that the group access-list consists of groups that have only one node membership at a time per interface:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld immediate-leave v6grp
(config-if)#exit
ipv6 mld last-member-query-count
Use this command to set the last-member query-count value. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to return to the default value on an interface.
Command Syntax
ipv6 mld last-member-query-count <2-7>
no ipv6 mld last-member-query-count
Parameters
<2-7>
Specify a last-member query-count value.
Default
The default last-member query-count value is 2.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface 0
(config-if)#ipv6 mld last-member-query-count 3
ipv6 mld last-member-query-interval
Use this command to set the frequency at which the router sends MLD group-specific host query messages. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to set this frequency to the default value.
Command Syntax
ipv6 mld last-member-query-interval <1000-25500>
no ipv6 mld last-member-query-interval
Parameter
<1000-25500>
Specify a last member query interval value in milliseconds.
Default
The default last-member query-count value is 1000 milliseconds.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example changes the MLD group-specific host query message interval to 2 seconds:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld last-member-query-interval 2000
ipv6 mld limit
Use this command to set the limit on the maximum number of group membership states at either the router level, or for the specified interface. Once the specified number of group memberships is reached, all further local-memberships will be ignored. Optionally, an exception access-list can be configured to specify the group-address(es) to be excluded from being subject to the limit.
This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to unset the limit and any specified exception access-list.
Command Syntax
ipv6 mld limit <1-2097152> (except WORD |)
ipv6 mld (vrf NAME|) limit <1-2097152> (except WORD |)
no ipv6 mld limit
Parameters
vrf
Specify the VRF name.
<1-2097152>
Maximum number of group membership states.
except
Standard IPv6 access-list name that defines multicast groups which are exempted from being subject to the configured limit.
WORD
Specify the standard IPv6 access-list name.
Default
The default value is 0 (zero).
Command Mode
Configure mode and Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example configures an MLD limit of 100 group-membership states across all interfaces on which MLD is enabled, and excludes group 224.1.1.1 from this limitation:
#configure terminal
(config)#ipv6 mld limit 100 except v6grp
The following example configures an MLD limit of 100 group-membership states on eth0:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld limit 100
ipv6 mld mroute-proxy
Use this command to specify the MLD Proxy service (upstream host-side) interface with which to be associated. MLD router-side protocol operation is enabled only when the specified upstream proxy-service interface is functional. This command should not be configured on interfaces enabled for MLD in association with a multicast routing protocol; otherwise, the behavior will be undefined.
Use the no parameter with this command to remove the association with the proxy-service interface.
Command Syntax
ipv6 mld mroute-proxy IFNAME
no ipv6 mld mroute-proxy
Parameters
IFNAME
Specify the interface name.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures the eth0 interface as the upstream proxy-service interface for the downstream router-side interface, eth1.
#configure terminal
(config)#interface eth1
(config-if)#ipv6 mld mroute-proxy eth0
ipv6 mld proxy-service
Use this command to designate an interface to be the MLD proxy-service (upstream host-side) interface, thus enabling MLD host-side protocol operation on this interface. All associated downstream router-side interfaces will have their memberships consolidated on this interface, according to MLD host-side functionality.
This command should not be used when configuring interfaces enabled for MLD in association with a multicast-routing protocol, otherwise the behavior will be undefined.
Use the no parameter with this command to remove the designation of the interface as an upstream proxy-service interface.
Command Syntax
ipv6 mld proxy-service
no ipv6 mld proxy-service
Parameters
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example designates the eth0 interface as the upstream proxy-service interface.
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld proxy-service
ipv6 mld querier-timeout
Use this command to configure the timeout period before the router takes over as the querier for the interface after the previous querier has stopped querying. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to restore the default value.
Command Syntax
ipv6 mld querier-timeout <60-300>
no ipv6 mld querier-timeout
Parameter
<60-300>
Number of seconds that the router waits after the previous querier has stopped querying before it takes over as the querier.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures the router to wait 120 seconds from the time it received the last query before it takes over as the querier for the interface:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld querier-timeout 120
ipv6 mld query-interval
Use this command to set the frequency of sending MLD host query messages. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to return to the default frequency.
Command Syntax
ipv6 mld query-interval <1-18000>
no ipv6 mld query-interval
Parameter
<1-18000>
Frequency (in seconds) at which MLD host query messages are sent.
Default
125 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example changes the frequency of sending MLD host-query messages to 2 minutes:
#configure terminal
(config)#interface fxp0
(config-if)#ipv6 mld query-interval 120
ipv6 mld query-max-response-time
Use this command to set the maximum response time advertised in MLD queries. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to restore the default value.
Command Syntax
ipv6 mld query-max-response-time <1-240>
no ipv6 mld query-max-response-time
Parameter
<1-240>
Maximum response time (in seconds) advertised in MLD queries.
Default
10 seconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example configures a maximum response time of 8 seconds:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 mld query-max-response-time 8
ipv6 mld robustness-variable
Use this command to set the robustness variable value on an interface. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to return to the default value on an interface.
Command Syntax
ipv6 mld robustness-variable <2-7>
no ipv6 mld robustness-variable
Parameter
<2-7>
Specify a robustness variable value in seconds.
Default
Default robustness value is 2 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface 0
(config-if)#ipv6 mld robustness-variable 3
ipv6 mld ssm-map enable
Use this command to enable SSM mapping on the router. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to disable SSM mapping.
Command Syntax
ipv6 mld ssm-map enable
ipv6 mld (vrf NAME|) ssm-map enable
no ipv6 mld ssm-map enable
no ipv6 mld (vrf NAME|) ssm-map enable
Parameter
vrf
Specify the VRF name.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows how to enable MLD SSM mapping on the router.
#configure terminal
(config)#ipv6 mld ssm-map enable
ipv6 mld ssm-map static
Use this command to specify the static mode of defining SSM mapping. SSM mapping statically assigns sources to MLDv1 groups to translate such (*,G) groups’ memberships to (S,G) memberships for use with PIM-SSM. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to remove the SSM map association.
Command Syntax
ipv6 mld ssm-map static WORD X:X::X:X
ipv6 mld (vrf NAME|) ssm-map static WORD X:X::X:X
no ipv6 mld ssm-map static WORD X:X::X:X
no ipv6 mld (vrf NAME|) ssm-map static WORD X:X::X:X
Parameters
vrf
Specify the VRF name.
WORD
Specify IPv6 named standard access-list.
X:X::X:X
Specify IPv6 address.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows how to configure an SSM static mapping for group-address ff0e::1/128.
#configure terminal
(config)#ipv6 mld ssm-map static v6grp 2006::3
(config)#ipv6 access-list v6grp permit ff0e::1/128
ipv6 mld static-group
Use this command to statically configure IPv6 group membership entries on an interface. To statically add only a group membership, do not specify any parameters. This command applies to MLD operation on a specific interface to statically add group and/or source records.
Use the no parameter with this command to delete static group membership entries.
Command Syntax
ipv6 mld static-group X:X::X:X {(source (X:X::X:X|ssm-map)|) (interface IFNAME|)}
no ipv6 mld static-group X:X::X:X {(source (X:X::X:X|ssm-map)|) (interface IFNAME|)}
Parameters
X:X::X:X
Standard IPv6 Multicast group address to be configured as a static group member.
interface
Physical interface. If used, static configuration is applied to the physical interface. If not used, static configuration is applied on all VLAN constituent interfaces.
IFNAME
Physical interface name.
source
Static source to be joined.
X:X::X:X
Standard IPv6 source address to be configured as a static source from where multicast packets originate.
ssm-map
Mode of defining SSM mapping. SSM mapping statically assigns sources to MLDv1 groups to translate these (*,G) groups' memberships to (S,G) memberships for use with PIM-SSM.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following examples shows how to statically add group and/or source records:
#configure terminal
(config)#interface vlan1.1
(config-if)#ipv6 mld static-group ff1e::10
 
(config)#interface vlan1.1
(config-if)#ipv6 mld static-group ff1e::10 source fe80::2fd:6cff:fe1c:b
 
(config)#interface vlan1.1
(config-if)#ipv6 mld static-group ff1e::10 source ssm-map
(config)#interface vlan1.1
(config-if)#ipv6 mld static-group ff1e::10 interface eth0
 
ipv6 mld version
Use this command to set the current MLD protocol version on an interface. This command applies to interfaces configured for MLD Layer-3 multicast protocols, or MLD Proxy.
Use the no parameter with this command to return to the default version on an interface.
Command Syntax
ipv6 mld version <1-2>
no ipv6 mld version
Parameter
<1-2>
Specify a MLD protocol version number.
Default
Default MLD protocol version number is 2.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface 0
(config-if)#ipv6 mld version 1
show debugging ipv6 mld
Use this command to display debugging information for MLD.
Command Syntax
show debugging ipv6 mld
show debugging ipv6 mld (vrf NAME|)
Parameters
vrf
Indicates the vrf keyword.
NAME
Displays the VRF name.
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following is a sample output of the show debugging mld command:
#show debugging ipv6 mld
MLD Debugging status:
MLD Decoder debugging is off
MLD Encoder debugging is off
MLD Events debugging is off
MLD FSM debugging is off
MLD Tree-Info-Base (TIB) debugging is off
#
 
show ipv6 mld groups
Use this command to display the multicast groups with receivers directly connected to the router, and learned through MLD.
Command Syntax
show ipv6 mld groups (detail|)
show ipv6 mld groups IFNAME (detail|)
show ipv6 mld groups IFNAME X:X::X:X (detail|)
show ipv6 mld groups X:X::X:X (detail|)
show ipv6 mld (vrf NAME|) groups (detail|)
show ipv6 mld (vrf NAME|) groups IFNAME (detail|)
show ipv6 mld (vrf NAME|) groups IFNAME X:X::X:X (detail|)
show ipv6 mld (vrf NAME|) groups X:X::X:X (detail|)
Parameters
vrf
Indicates the vrf keyword.
NAME
Displays the VRF name.
X:X::X:X
Displays the multicast group address.
IFNAME
Interface name for which to display local information.
detail
MLDv2 source information.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following command displays local-membership information for all interfaces:
#show ipv6 mld groups
MLD Connected Group Membership
Group Address Interface Uptime Expires Last Reporter
ff1e::10 ge10 00:03:16 00:01:09 fe80::202:b3ff:fef0:79d8
 
Table 3-1: Show ipv6 mld groups 
Entry
Description
Group Address
As stated.
Interface
A directly connected interface to the router
Uptime
Up time for multicast group
Expires
Time before multicast group needs to send another uptime message to the directly connected router.
Last Reporter
IPv6 IP address of last reporte node in the group.
show ipv6 mld interface
Use this command to display the state of MLD, MLD Proxy service, and for a specified interface, or all interfaces.
Command Syntax
show ipv6 mld interface (IFNAME|)
show ipv6 mld (vrf NAME|) interface (IFNAME|)
Parameters
vrf
Indicates the vrf keyword.
NAME
Displays the VRF name..
IFNAME
Interface name for which to display local information.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following displays MLD interface status on all interfaces enabled for MLD.
#show ipv6 mld interface
Interface eth1 (Index 2)
MLD Enabled, Active, Querier, Version 2 (default)
Internet address is fe80::2fd:6cff:fe1c:b
MLD interface has 0 group-record states
MLD activity: 0 joins, 0 leaves
MLD query interval is 125 seconds
MLD querier timeout is 255 seconds
MLD max query response time is 10 seconds
Last member query response interval is 1000 milliseconds
Group Membership interval is 260 seconds
#
 
Table 3-2: Show ipv6 mld interface output 
Entry
Description
Interface
The type and name of the interface. (eth1, xe3/1, ge3, etc.).
MLD Enabled
Whether MLD is enabled on the interface.
Internet address
IPv6 internet address.
MLD interface
Number of group-record states.
MLD activity
MLD activity of the interface. In the example above, there is no activity.
MLD query interval
The amount of time between MLD queries.
MLD query timeout
The amount of time before the interface resends an MLD query.
MLD max query response time
The amount of time before the interface is considered no longer a multicast listener and is removed from the multicast.
Last member query response interval
The time in which if no query requests are received by the router, it assumes the multicast is over.
Group membership interval
The amount of time the router will wait for a group query before the group is considered gone.
show ipv6 mld ssm-map
Use this command to display MLD SSM (source-specific-multicast) mapping.
Command Syntax
show ipv6 mld ssm-map
show ipv6 mld ssm-map X:X::X:X
show ipv6 mld (vrf NAME|) ssm-map X:X::X:X
Parameters
vrf
Indicates the vrf keyword.
NAME
Displays the VRF name.
X:X::X:X
Displays the multicast group address.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following is an example of this command:
#show ipv6 mld ssm-map
SSM Mapping : Enabled
Database : None configured
 
#