Professional Documents
Culture Documents
S6520-SI & S5560X-HI & S5000-EI & MS4600 Switch Series IP Multicast Command Reference
S6520-SI & S5560X-HI & S5000-EI & MS4600 Switch Series IP Multicast Command Reference
This command reference is applicable to the following switches and software versions:
H3C S6520X-HI switch series (Release 6510 and later)
H3C S6520X-EI switch series (Release 6510 and later)
H3C S6520X-SI switch series (Release 6510 and later)
H3C S6520-SI switch series (Release 6510 and later)
H3C S5560X-HI switch series (Release 6510 and later)
H3C S5000-EI switch series (Release 6510 and later)
H3C MS4600 switch series (Release 6515P06 and later)
Audience
This documentation is intended for:
• Network planners.
• Field technical support and servicing engineers.
• Network administrators.
Conventions
The following information describes the conventions used in the documentation.
Command conventions
Convention Description
Boldface Bold text represents commands and keywords that you enter literally as shown.
Italic Italic text represents arguments that you replace with actual values.
[] Square brackets enclose syntax choices (keywords or arguments) that are optional.
Braces enclose a set of required syntax choices separated by vertical bars, from which
{ x | y | ... }
you select one.
Square brackets enclose a set of optional syntax choices separated by vertical bars,
[ x | y | ... ]
from which you select one or none.
Asterisk marked braces enclose a set of required syntax choices separated by vertical
{ x | y | ... } *
bars, from which you select a minimum of one.
Asterisk marked square brackets enclose optional syntax choices separated by vertical
[ x | y | ... ] *
bars, from which you select one choice, multiple choices, or none.
The argument or keyword and argument combination before the ampersand (&) sign
&<1-n>
can be entered 1 to n times.
# A line that starts with a pound (#) sign is comments.
GUI conventions
Convention Description
Window names, button names, field names, and menu items are in Boldface. For
Boldface
example, the New User window opens; click OK.
> Multi-level menus are separated by angle brackets. For example, File > Create >
Convention Description
Folder.
Symbols
Convention Description
An alert that calls attention to important information that if not understood or followed
WARNING! can result in personal injury.
An alert that calls attention to important information that if not understood or followed
CAUTION: can result in data loss, data corruption, or damage to hardware or software.
Convention Description
Documentation feedback
You can e-mail your comments about product documentation to info@h3c.com.
We appreciate your comments.
Contents
IGMP snooping commands············································································ 1
display igmp-snooping ······························································································································· 1
display igmp-snooping group ····················································································································· 4
display igmp-snooping evpn-group ············································································································ 7
display igmp-snooping host-tracking ·········································································································· 8
display igmp-snooping router-port·············································································································· 9
display igmp-snooping static-group·········································································································· 11
display igmp-snooping static-router-port ·································································································· 12
display igmp-snooping statistics··············································································································· 13
display l2-multicast fast-forwarding cache ······························································································· 14
display l2-multicast ip ······························································································································· 16
display l2-multicast mac ··························································································································· 18
display l2-multicast mac forwarding ········································································································· 19
display mac-address [ multicast ] ············································································································· 20
dot1p-priority (IGMP-snooping view)········································································································ 21
dscp·························································································································································· 22
enable (IGMP-snooping view) ·················································································································· 22
entry-limit (IGMP-snooping view) ············································································································· 23
fast-leave (IGMP-snooping view) ············································································································· 24
global-enable (IGMP-snooping view) ······································································································· 25
group-policy (IGMP-snooping view) ········································································································· 25
host-aging-time (IGMP-snooping view) ···································································································· 26
host-tracking (IGMP-snooping view) ········································································································ 27
igmp-snooping·········································································································································· 28
igmp-snooping dot1p-priority···················································································································· 29
igmp-snooping drop-unknown ·················································································································· 29
igmp-snooping { disable | enable } ··········································································································· 30
igmp-snooping fast-leave ························································································································· 31
igmp-snooping forwarding-mode·············································································································· 32
igmp-snooping general-query source-ip··································································································· 33
igmp-snooping group-limit ························································································································ 34
igmp-snooping group-policy ····················································································································· 35
igmp-snooping host-aging-time ················································································································ 36
igmp-snooping host-join ··························································································································· 37
igmp-snooping host-tracking ···················································································································· 38
igmp-snooping last-member-query-interval······························································································ 39
igmp-snooping leave source-ip ················································································································ 40
igmp-snooping max-response-time ·········································································································· 41
igmp-snooping overflow-replace ·············································································································· 42
igmp-snooping proxy enable ···················································································································· 43
igmp-snooping querier ····························································································································· 44
igmp-snooping querier-election ················································································································ 45
igmp-snooping query-interval ··················································································································· 46
igmp-snooping report source-ip ··············································································································· 47
igmp-snooping router-aging-time ············································································································· 48
igmp-snooping router-port-deny ··············································································································· 49
igmp-snooping source-deny ····················································································································· 49
igmp-snooping special-query source-ip ··································································································· 50
igmp-snooping static-group ······················································································································ 51
igmp-snooping static-router-port ·············································································································· 52
igmp-snooping version ····························································································································· 53
last-member-query-interval (IGMP-snooping view)·················································································· 54
mac-address multicast ····························································································································· 54
mac-address multicast vsi ························································································································ 55
max-response-time (IGMP-snooping view) ······························································································ 57
overflow-replace (IGMP-snooping view) ·································································································· 58
report-aggregation (IGMP-snooping view) ······························································································· 59
i
reset igmp-snooping group ······················································································································ 59
reset igmp-snooping router-port ··············································································································· 60
reset igmp-snooping statistics ·················································································································· 60
reset l2-multicast fast-forwarding cache··································································································· 61
router-aging-time (IGMP-snooping view) ································································································· 61
send-query enable ··································································································································· 62
source-deny (IGMP-snooping view) ········································································································· 63
version (IGMP-snooping view) ················································································································· 63
ii
IGMP snooping commands
display igmp-snooping
Use display igmp-snooping to display IGMP snooping status.
Syntax
display igmp-snooping [ global | vlan vlan-id | vsi vsi-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
global: Displays the global IGMP snooping status.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
If you do not specify any parameters, this command displays the global IGMP snooping status and
the IGMP snooping status in all VLANs and VSIs.
Examples
# Display the global IGMP snooping status and the IGMP snooping status for all VLANs and VSIs.
<Sysname> display igmp-snooping
IGMP snooping information: Global
Global-enable: Enabled
Host-aging-time: 260s
Router-aging-time: 260s
Max-response-time: 10s
Last-member-query-interval: 1s
Report-aggregation: Enabled
Host-tracking: Disabled
Dot1p-priority: --
DRNI: Enabled (IPP: Bridge-Aggregation 1)
1
Querier-election: Enabled
Query-interval: 125s
General-query source IP: 1.1.1.1
Special-query source IP: 2.2.2.2
Report source IP: 3.0.0.3
Leave source IP: 1.0.0.1
Host-tracking: Disabled
Dot1p-priority: 2
Proxy: Disabled
IPP: Bridge-Aggregation 1
2
Table 1 Command output
Field Description
802.1p priority for IGMP messages. If the priority is not configured, this field
Dot1p-priority
displays two hyphens (--).
3
Field Description
• Disabled.
Status of DRNI:
DRNI • Enabled.
• Disabled
IPP DRNI IPP interface.
Link ID Link ID for the DRNI IPP interface in the VSI.
4
Examples
# Display brief information about dynamic IGMP snooping group entries for Ten-GigabitEthernet
1/0/1.
<Sysname> display igmp-snooping group interface ten-gigabitethernet 1/0/1
Total 1 entries.
XGE1/0/1:
VLAN 2: Total 1 entries.
(0.0.0.0, 224.1.1.1) (00:03:23)
# Display detailed information about dynamic IGMP snooping group entries for VLAN 2.
<Sysname> display igmp-snooping group vlan 2 verbose
Total 2 entries.
# Display brief information about dynamic IGMP snooping group entries for VSI aaa.
<Sysname> display igmp-snooping group vsi aaa
Total 2 entries.
# Display detailed information about dynamic IGMP snooping group entries for VSI bbb.
<Sysname> display igmp-snooping group vsi bbb verbose
Total 2 entries.
VSI bbb: Total 2 entries.
(0.0.0.0, 224.1.1.1)
Attribute: global port
FSM information: dummy
Host slots (0 in total):
Host ports (2 in total):
XGE1/0/3 (Link ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
5
Tun1 (VXLAN ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
(1.1.1.1, 224.1.1.1)
Attribute: global port
FSM information: dummy
Field Description
Member IDs and total number of the member devices that have member
Host slots (0 in total) ports, except for the specified member device or the master device when
no member device is specified.
Host ports (1 in total) Member ports, and the total number of member ports.
Remaining aging time for the dynamic member port.
Global ports include Layer 2 aggregate interfaces, ACs, N-PWs, and
U-PWs.
For a global port, this field is displayed when no member device is
(00:03:23) specified or the master device is specified.
For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
XGE1/0/3 (Link ID 0) AC and its link ID.
NPW (Link ID 8) N-PW and its link ID.
Tun1 (VXLAN ID 0) VXLAN tunnel and its VXLAN ID.
VLAN pairs (1 in total) VLAN pairs and total number of the VLAN pairs.
Outer VLAN 5 Inner VLAN 2 Outer VLAN ID and inner VLAN ID.
Related commands
reset igmp-snooping group
6
display igmp-snooping evpn-group
Use display igmp-snooping evpn-group to display multicast group information that IGMP
snooping learns from EVPN.
Syntax
display igmp-snooping evpn-group [ group-address | source-address ] * [ vsi
vsi-name ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to
239.255.255.255. If you do not specify a multicast group, this command displays information that
IGMP snooping learns from EVPN for all multicast groups.
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast
source, this command displays multicast group information that IGMP snooping learns from EVPN
for all multicast sources.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command displays multicast group information that IGMP snooping learns
from EVPN for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
card, this command displays multicast group information that IGMP snooping learns from EVPN on
the master device.
Examples
# Display multicast group information that IGMP snooping learns from EVPN in VSI aaa.
<Sysname> display igmp-snooping evpn-group vsi aaa
Total 2 entries.
Field Description
7
Field Description
(1.1.1.1, 224.1.1.1) (S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Host ports (1 in total) Member ports, and the total number of member ports.
XGE1/0/3 (Link ID 0) Member port and the link ID.
Related commands
display l2-multicast ip
Field Description
8
Field Description
Related commands
host-tracking (IGMP-snooping view)
igmp-snooping enable
igmp-snooping host-tracking
9
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/1 (00:01:30)
XGE1/0/2 (00:00:23)
# Display brief information about dynamic router ports for VSI aaa.
<Sysname> display igmp-snooping router-port vsi aaa
VSI aaa:
Router ports (3 in total):
XGE1/0/3 (Link ID 1) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
NPW (Link ID 8) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
UPW (Link ID 9) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
# Display detailed information about dynamic router ports for VSI bbb.
<Sysname> display igmp-snooping router-port vsi bbb verbose
VSI bbb:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/3 (Link ID 1) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
Tun1 (VXLAN ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
Field Description
10
Field Description
Related commands
reset igmp-snooping router-port
11
VLAN 2: Total 1 entries.
(0.0.0.0, 224.1.1.1)
Attribute: local port
FSM information: dummy
Host slots (0 in total):
Host ports (1 in total):
XGE1/0/2
Field Description
Member IDs and total number of the member devices that have member ports,
Host slots (0 in total) except for the specified member device or the master device when no member
device is specified.
Host ports (1 in total) Member ports and total number of member ports.
12
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays static router port information for the master device.
Examples
# Display brief information about static router ports for VLAN 2.
<Sysname> display igmp-snooping static-router-port vlan 2
VLAN 2:
Router ports (2 in total):
XGE1/0/1
XGE1/0/2
Field Description
Router ports (2 in total) Static router ports and total number of static router ports.
13
IGMPv3 specific queries: 0
DRNI: 0
IGMPv3 specific sg queries: 0
DRNI: 0
IGMPv1 reports: 0
DRNI: 0
IGMPv2 reports: 19
DRNI: 19
IGMPv3 reports: 0
DRNI: 0
IGMPv3 reports with right and wrong records: 0
DRNI: 0
IGMP leaves: 5
DRNI: 5
Error IGMP messages: 1
DRNI: 1
Sent IGMP messages:
IGMPv2 specific queries: 0
IGMPv3 specific queries: 0
IGMPv3 specific sg queries: 0
Field Description
Related commands
reset igmp-snooping statistics
14
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
source-address: Specifies a multicast source address. If you do not specify a multicast source,
this command displays Layer 2 multicast fast forwarding entries for all multicast sources.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to
239.255.255.255. If you do not specify a multicast group, this command displays Layer 2 multicast
fast forwarding entries for all multicast groups.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays Layer 2 multicast fast forwarding entries for the master
device.
Examples
# Display Layer 2 multicast fast forwarding entries.
<Sysname> display l2-multicast fast-forwarding cache
Total 1 entries, 1 matched
(10.1.1.2,225.1.1.1)
Status : Enable VLAN : 1
Source port : 9876 Destination port: 5432
Protocol : 17 Flag : 0x2
Ingress port: Ten-GigabitEthernet1/0/2
List of 1 egress ports:
Ten-GigabitEthernet1/0/3
Status: Enable Flag: 0x10
Field Description
Total number of (S, G) entries in the Layer 2 multicast fast forwarding table,
Total 1 entries, 1 matched
and the total number of matching entries.
(10.1.1.2, 225.1.1.1) (S, G) entry in the Layer 2 multicast fast forwarding table.
Protocol Protocol number.
VLAN VLAN ID.
Flag for the (S, G) entry or the outgoing port.
This field displays one flag or the sum of multiple flags. In this example, the
value 0x2 means that the entry has only one flag 0x2.
The following flags are available for an entry:
• 0x1—The entry is created because of packets passed through between
Flag
cards.
• 0x2—The entry is added by multicast forwarding.
The following flags are available for an outgoing interface:
• 0x1—The port is added to the entry because of packets passed through
between cards.
15
Field Description
• 0x2—The port is added to an existing entry.
• 0x10—The port is associated with the entry.
• 0x20—The port is to be deleted.
Related commands
reset l2-multicast fast-forwarding cache all
display l2-multicast ip
Use display l2-multicast ip to display information about Layer 2 IP multicast groups.
Syntax
display l2-multicast ip [ group group-address | source source-address ] *
[ vlan vlan-id | vsi vsi-name ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
group group-address: Specifies a multicast group by its IP address. If you do not specify a
multicast group, this command displays information about all Layer 2 IP multicast groups.
source source-address: Specifies a multicast source by its IP address. If you do not specify a
multicast source, this command displays information about Layer 2 IP multicast groups for all
multicast sources.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays information about Layer 2 IP multicast groups for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command displays information about Layer 2 IP multicast groups for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays information about Layer 2 IP multicast groups for the master
device.
Examples
# Display information about Layer 2 IP multicast groups for VLAN 2.
<Sysname> display l2-multicast ip vlan 2
Total 1 entries.
16
Attribute: static, success
Host ports (1 in total):
XGE1/0/1 (S, SUC)
Field Description
Host ports (1 in total) Member ports and total number of member ports.
Port attribute:
• D—Dynamic port.
• S—Static port.
• P—PIM port.
(S, SUC) • K—Port obtained from the kernel.
• R—Port learned from (*, *) entries.
• W—Port learned from (*, G) entries.
• SUC—Processing has succeeded.
• F—Processing has failed.
17
display l2-multicast mac
Use display l2-multicast mac to display information about Layer 2 MAC multicast groups.
Syntax
display l2-multicast mac [ mac-address ] [ vlan vlan-id | vsi vsi-name ]
[ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
mac-address: Specifies a MAC multicast group by its multicast MAC address. If you do not specify
a MAC multicast group, this command displays information about all Layer 2 MAC multicast groups.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays information about Layer 2 MAC multicast groups for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command displays information about Layer 2 MAC multicast groups for all
VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays information about Layer 2 MAC multicast groups for the
master device.
Examples
# Display information about Layer 2 MAC multicast groups for VLAN 2.
<Sysname> display l2-multicast mac vlan 2
Total 1 entries.
# Display information about Layer 2 MAC multicast groups for VSI aaa.
<Sysname> display l2-multicast mac vsi aaa
Total 1 entries.
# Display information about Layer 2 MAC multicast groups for VSI bbb.
<Sysname> display l2-multicast mac vsi bbb
18
Total 1 entries.
Field Description
Host ports (1 in total) Member ports and total number of member ports.
XGE1/0/3 (Link ID 0) AC and its link ID.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
Tun1 (VXLAN ID 0) VXLAN tunnel and its VXLAN ID.
19
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays Layer 2 multicast MAC group entries for the master device.
Examples
# Display Layer 2 multicast MAC forwarding entries for VLAN 2.
<Sysname> display l2-multicast mac forwarding vlan 2
Total 1 entries.
Field Description
20
count: Specifies the number of MAC address entries. If you specify this keyword, the command
displays the number of matching MAC address entries. If you do not specify this keyword, the
command displays the contents of the matching entries rather than the entry count.
Usage guidelines
If you do not specify any parameters, this command displays all MAC address table entries, including
unicast MAC address entries and static multicast MAC address entries.
Examples
# Display static multicast MAC address entries for VLAN 2.
<Sysname> display mac-address multicast vlan 2
MAC Address VLAN ID State Port/NickName Aging
0100-0001-0001 2 Multicast XGE1/0/1 N
Field Description
Status of the MAC address. If the multicast MAC address entry is static,
State
this field displays Multicast.
Related commands
mac-address multicast
21
Parameters
priority: Specifies an 802.1p priority for IGMP messages, in the range of 0 to 7. The greater the
value, the higher the priority.
Usage guidelines
You can set the 802.1p priority globally for all VLANs and VSIs in IGMP-snooping view or for a VLAN
in VLAN view. For a VLAN, the VLAN-specific configuration takes priority over the global
configuration.
Examples
# Set the 802.1p priority for IGMP messages to 3 globally.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] dot1p-priority 3
Related commands
igmp-snooping dot1p-priority
dscp
Use dscp to set the DSCP value for outgoing IGMP protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing IGMP protocol packets.
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the ToS field of an IP packet to determine the transmission priority of
the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value to 63 for outgoing IGMP protocol packets.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] dscp 63
22
Use undo enable to disable IGMP snooping for VLANs.
Syntax
enable vlan vlan-list
undo enable vlan vlan-list
Default
IGMP snooping status in a VLAN is consistent with the global IGMP snooping status.
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094.
Usage guidelines
You must enable the IGMP snooping feature by using the igmp-snooping command before you
enable IGMP snooping for VLANs.
You can enable IGMP snooping for multiple VLANs by using this command in IGMP-snooping view
or for a VLAN by using the igmp-snooping enable command in VLAN view. The configuration
in IGMP-snooping view has the same priority as the configuration in VLAN view, and the most recent
configuration takes effect.
Examples
# Enable the IGMP snooping feature, and then enable IGMP snooping for VLAN 2 through VLAN 10.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] enable vlan 2 to 10
Related commands
igmp-snooping
igmp-snooping enable
23
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of IGMP snooping forwarding entries, in the range of 0 to
4294967295.
Examples
# Set the global maximum number of IGMP snooping forwarding entries to 512.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] entry-limit 512
Related commands
igmp-snooping fast-leave
24
global-enable (IGMP-snooping view)
Use global-enable to enable IGMP snooping globally.
Use undo global-enable to disable IGMP snooping globally.
Syntax
global-enable
undo global-enable
Default
IGMP snooping is disabled globally.
Views
IGMP-snooping view
Predefined user roles
network-admin
Usage guidelines
To configure other IGMP snooping features for VLANs or VSIs, you must enable IGMP snooping for
the specific VLANs or VSIs even though IGMP snooping is enabled globally.
Examples
# Enable IGMP snooping globally.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] global-enable
Related commands
enable (IGMP-snooping view)
igmp-snooping
igmp-snooping disable
igmp-snooping enable
25
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000
to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or
does not have valid rules, hosts cannot join multicast groups.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs
and VSIs.
Usage guidelines
A multicast group policy filters IGMP reports to control the multicast groups that hosts can join.
This command does not take effect on static member ports, because static member ports do not
send IGMP reports.
You can configure a multicast group policy globally for all ports in IGMP-snooping view or for a port in
interface view. For a port, the port-specific configuration takes priority over the global configuration.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-wildcard option specifies a
multicast group address.
• In an advanced ACL, the source source-address source-wildcard option specifies a
multicast source address. The destination dest-address dest-wildcard option
specifies a multicast group address.
To match the following IGMP reports, set the source source-address
source-wildcard option to 0.0.0.0:
IGMPv1 and IGMPv2 reports.
IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
You can configure different ACLs for all ports in different VLANs. If you configure multiple ACLs for all
ports in the same VLAN, the most recent configuration takes effect.
Examples
# Configure a multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only multicast group
225.1.1.1.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.1.1 0
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] igmp-snooping
[Sysname-igmp-snooping] group-policy 2000 vlan 2
Related commands
igmp-snooping group-policy
26
Use undo host-aging-time to restore the default.
Syntax
host-aging-time seconds
undo host-aging-time
Default
The aging timer for dynamic member ports is 260 seconds.
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894
seconds.
Usage guidelines
You can set the timer globally for all VLANs and VSIs in IGMP-snooping view, for a VSI in VSI view,
or for a VLAN in VLAN view. For a VSI, the VSI-specific configuration takes priority over the global
configuration. For a VLAN, the VLAN-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member
ports to be greater than the value calculated by using the following formula:
[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]
As a best practice, set the aging timer of dynamic member ports to the value calculated by using the
following formula:
[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]
Examples
# Set the global aging timer for dynamic member ports to 300 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] host-aging-time 300
Related commands
igmp-snooping host-aging-time
27
Views
IGMP-snooping view
Predefined user roles
network-admin
Usage guidelines
You can enable host tracking globally for all VLANs in IGMP-snooping view or for a VLAN in VLAN
view. For a VLAN, the global configuration has the same priority as the VLAN-specific configuration.
Examples
# Enable host tracking globally.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] host-tracking
Related commands
display igmp-snooping host-tracking
igmp-snooping host-tracking
igmp-snooping
Use igmp-snooping to enable the IGMP snooping feature and enter IGMP-snooping view.
Use undo igmp-snooping to disable the IGMP snooping feature.
Syntax
igmp-snooping
undo igmp-snooping
Default
The IGMP snooping feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
If you disable the IGMP snooping feature, IGMP snooping is disabled in all VLANs and VSIs.
Examples
# Enable the IGMP snooping feature and enter IGMP-snooping view.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping]
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping disable
28
igmp-snooping dot1p-priority
Use igmp-snooping dot1p-priority to set the 802.1p priority for IGMP messages in a
VLAN.
Use undo igmp-snooping dot1p-priority to restore the default.
Syntax
igmp-snooping dot1p-priority priority
undo igmp-snooping dot1p-priority
Default
The 802.1p priority is 6 for IGMP messages in a VLAN.
Views
VLAN view
Predefined user roles
network-admin
Parameters
priority: Specifies an 802.1p priority for IGMP messages, in the range of 0 to 7. The greater the
value, the higher the priority.
Usage guidelines
You must enable IGMP snooping for a VLAN before you execute this command.
You can set the 802.1p priority for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping
view. The VLAN-specific configuration takes priority over the global configuration.
Examples
# In VLAN 2, enable IGMP snooping, and set the 802.1p priority for IGMP messages to 3.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping dot1p-priority 3
Related commands
dot1p-priority (IGMP-snooping view)
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping drop-unknown
Use igmp-snooping drop-unknown to enable dropping unknown multicast data packets for a
VLAN or VSI.
Use undo igmp-snooping drop-unknown to disable dropping unknown multicast data packets
for a VLAN or VSI.
Syntax
igmp-snooping drop-unknown
29
undo igmp-snooping drop-unknown
Default
Dropping unknown multicast data packets is disabled. Unknown multicast data packets are flooded.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
Examples
# In VLAN 2, enable IGMP snooping, and enable dropping unknown multicast data packets.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping drop-unknown
# In VSI aaa, enable IGMP snooping, and enable dropping unknown multicast data packets.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping drop-unknown
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
30
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable the IGMP snooping feature by using the igmp-snooping command before you
enable IGMP snooping for a VLAN or VSI.
You can enable IGMP snooping for a VLAN by using this command in VLAN view or for multiple
VLANs by using the enable command in IGMP-snooping view. The configuration in VLAN view has
the same priority as the configuration in IGMP-snooping view, and the most recent configuration
takes effect.
Examples
# Enable the IGMP snooping feature, and then enable IGMP snooping for VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
# Enable the IGMP snooping feature, and then enable IGMP snooping for VSI aaa.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
Related commands
enable (IGMP-snooping view)
igmp-snooping
igmp-snooping fast-leave
Use igmp-snooping fast-leave to enable fast-leave processing on a port.
Use undo igmp-snooping fast-leave to disable fast-leave processing on a port.
Syntax
igmp-snooping fast-leave [ vlan vlan-list ]
undo igmp-snooping fast-leave [ vlan vlan-list ]
Default
Fast-leave processing is disabled on a port.
31
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
The fast-leave processing feature enables the device to immediately remove a port from the
forwarding entry for a multicast group when the port receives a leave message.
You can enable fast-leave processing for a port in interface view or globally for all ports in
IGMP-snooping view. For a port, the port-specific configuration takes priority over the global
configuration.
Examples
# Enable fast-leave processing for VLAN 2 on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2
Related commands
fast-leave (IGMP-snooping view)
igmp-snooping forwarding-mode
Use igmp-snooping forwarding-mode to specify the Layer 2 multicast forwarding mode.
Use undo igmp-snooping forwarding-mode to restore the default.
Syntax
igmp-snooping forwarding-mode { ip | mac }
undo igmp-snooping forwarding-mode
Default
The device forwards Layer 2 multicast packets based on the multicast MAC addresses in the
packets.
Views
VLAN view
Predefined user roles
network-admin
Parameters
ip: Specifies IP-based forwarding mode. The device forwards Layer 2 multicast packets based on
the IP addresses (multicast source addresses and multicast group addresses) in the packets.
mac: Specifies MAC-based forwarding mode. The device forwards Layer 2 multicast packets based
on the multicast MAC addresses in the packets.
32
Usage guidelines
Before you execute this command for a VLAN, you must enable IGMP snooping in it.
Multiple multicast IP addresses might be mapped to the same multicast MAC address. This causes
that non-members of a multicast group receive the multicast data of this group if the device uses the
MAC-based forwarding mode. As a best practice, specify the IP-based Layer 2 multicast forwarding
mode on Layer 3 multicast devices.
Examples
# In VLAN 2, enable IGMP snooping, and then specify the MAC-based Layer 2 multicast forwarding
mode.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping forwarding-mode mac
# In VSI aaa, enable IGMP snooping, and then specify the MAC-based Layer 2 multicast forwarding
mode.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping forwarding-mode mac
Related commands
igmp-snooping enable
33
Parameters
ip-address: Specifies the source IP address for IGMP general queries.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
Examples
# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP general
queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1
# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP general
queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping general-query source-ip 10.1.1.1
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping group-limit
Use igmp-snooping group-limit to set the maximum number of multicast groups that a port
can join.
Use undo igmp-snooping group-limit to remove the limit on the maximum number of
multicast groups that a port can join.
Syntax
igmp-snooping group-limit limit [ vlan vlan-list ]
undo igmp-snooping group-limit [ vlan vlan-list ]
Default
No limit is placed on the maximum number of multicast groups that a port can join.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
34
Parameters
limit: Specifies the maximum number of multicast groups that a port can join, in the range of 0 to
4294967295.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
This command takes effect only on the multicast groups that a port joins dynamically.
Examples
# On Ten-GigabitEthernet 1/0/1, set the maximum number of multicast groups the port can join in
VLAN 2 to 10.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2
igmp-snooping group-policy
Use igmp-snooping group-policy to configure a multicast group policy on a port to control
the multicast groups that hosts attached to the port can join.
Use undo igmp-snooping group-policy to delete multicast group policies on a port.
Syntax
igmp-snooping group-policy ipv4-acl-number [ vlan vlan-list ]
undo igmp-snooping group-policy [ vlan vlan-list ]
Default
No multicast group polices exist on a port. Hosts attached to the port can join any multicast groups.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000
to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or
does not have valid rules, hosts cannot join multicast groups.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
A multicast group policy filters IGMP reports to control the multicast groups that hosts can join.
This command does not take effect on static member ports, because static member ports do not
send IGMP reports.
You can configure a multicast group policy for a port in interface view or globally for all ports in
IGMP-snooping view. For a port, the port-specific configuration takes priority over the global
configuration.
35
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-wildcard option specifies a
multicast group address.
• In an advanced ACL, the source source-address source-wildcard option specifies a
multicast source address. The destination dest-address dest-wildcard option
specifies a multicast group address.
To match the following IGMP reports, set the source source-address
source-wildcard option to 0.0.0.0:
IGMPv1 and IGMPv2 reports.
IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
You can configure different ACLs on a port for different VLANs. If you configure multiple ACLs on a
port for the same VLAN, the most recent configuration takes effect.
Examples
# On Ten-GigabitEthernet 1/0/1, configure a multicast group policy for VLAN 2 so that hosts in VLAN
2 can join only multicast group 225.1.1.1.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.1.1 0
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2
Related commands
group-policy (IGMP-snooping view)
igmp-snooping host-aging-time
Use igmp-snooping host-aging-time to set the aging timer for dynamic member ports in a
VLAN or VSI.
Use undo igmp-snooping host-aging-time to restore the default.
Syntax
igmp-snooping host-aging-time seconds
undo igmp-snooping host-aging-time
Default
The aging timer for dynamic member ports is 260 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894
seconds.
36
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
You can set the timer for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member
ports to be greater than the value calculated by using the following formula:
[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]
As a best practice, set the aging timer of dynamic member ports to the value calculated by using the
following formula:
[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]
Examples
# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic member ports to 300
seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping host-aging-time 300
# In VSI aaa, enable IGMP snooping, and set the aging timer for dynamic member ports to 300
seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping host-aging-time 300
Related commands
enable (IGMP-snooping view)
host-aging-time (IGMP-snooping view)
igmp-snooping enable
igmp-snooping host-join
Use igmp-snooping host-join to configure a port as a simulated member host for a multicast
group.
Use undo igmp-snooping host-join to remove the configuration of a simulated member host
for a multicast group.
Syntax
igmp-snooping host-join group-address [ source-ip source-address ] vlan
vlan-id
undo igmp-snooping host-join { group-address [ source-ip source-address ]
vlan vlan-id | all }
37
Default
A port is not configured as a simulated member host for multicast groups.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
group-address: Specifies a multicast group in the range of 224.0.1.0 to 239.255.255.255.
source-ip source-address: Specifies a multicast source by its IP address. If you specify a
multicast source, this command configures the port as a simulated member host for a multicast
source and group. If you do not specify a multicast source, this command configures the port as a
simulated member host for a multicast group. This option takes effect on IGMPv3 snooping devices.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
all: Specifies all multicast groups.
Usage guidelines
The version of IGMP running on a simulated member host is the same as the version of IGMP
snooping running on the port. The port ages out in the same way as a dynamic member port.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a simulated member host of the multicast source and
group (1.1.1.1, 232.1.1.1) in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
[Sysname-vlan2] quit
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping host-join 232.1.1.1 source-ip 1.1.1.1
vlan 2
igmp-snooping host-tracking
Use igmp-snooping host-tracking to enable host tracking for a VLAN.
Use undo igmp-snooping host-tracking to disable host tracking for a VLAN.
Syntax
igmp-snooping host-tracking
undo igmp-snooping host-tracking
Default
Host tracking is disabled.
Views
VLAN view
38
Predefined user roles
network-admin
Usage guidelines
You must enable IGMP snooping for a VLAN before you execute this command for the VLAN.
You can enable host tracking for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping
view. For a VLAN, the VLAN-specific configuration has the same priority as the global configuration.
Examples
# In VLAN 2, enable IGMP snooping, and then enable host tracking.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping host-tracking
Related commands
display igmp-snooping host-tracking
host-tracking (IGMP-snooping view)
igmp-snooping enable
igmp-snooping last-member-query-interval
Use igmp-snooping last-member-query-interval to set the IGMP last member query
interval for a VLAN or VSI.
Use undo igmp-snooping last-member-query-interval to restore the default.
Syntax
igmp-snooping last-member-query-interval interval
undo igmp-snooping last-member-query-interval
Default
The IGMP last member query interval is 1 second.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
You can set the interval for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
39
Examples
# In VLAN 2, enable IGMP snooping, and set the IGMP last member query interval to 3 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping last-member-query-interval 3
# In VSI aaa, enable IGMP snooping, and set the IGMP last member query interval to 3 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping last-member-query-interval 3
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
last-member-query-interval (IGMP-snooping view)
40
Examples
# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP leave
messages.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping leave source-ip 10.1.1.1
# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP leave
messages.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping leave source-ip 10.1.1.1
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping max-response-time
Use igmp-snooping max-response-time to set the maximum response time for IGMP
general queries in a VLAN or VSI.
Use undo igmp-snooping max-response-time to restore the default.
Syntax
igmp-snooping max-response-time seconds
undo igmp-snooping max-response-time
Default
The maximum response time for IGMP general queries is 10 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174
seconds.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
You can set the time for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
41
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP
general queries to be less than the IGMP general query interval.
Examples
# In VLAN 2, enable IGMP snooping, and set the maximum response time for IGMP general queries
to 5 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping max-response-time 5
# In VSI aaa, enable IGMP snooping, and set the maximum response time for IGMP general queries
to 5 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping max-response-time 5
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping query-interval
max-response-time (IGMP-snooping view)
igmp-snooping overflow-replace
Use igmp-snooping overflow-replace to enable multicast group replacement on a port.
Use undo igmp-snooping overflow-replace to disable multicast group replacement on a
port.
Syntax
igmp-snooping overflow-replace [ vlan vlan-list ]
undo igmp-snooping overflow-replace [ vlan vlan-list ]
Default
Multicast group replacement is disabled.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
42
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
This command takes effect only on the multicast groups that a port joins dynamically.
You can enable multicast group replacement for a port in interface view or globally for all ports in
IGMP-snooping view. For a port, the port-specific configuration takes priority over the global
configuration.
Examples
# On Ten-GigabitEthernet 1/0/1, enable multicast group replacement for VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2
Related commands
overflow-replace (IGMP-snooping view)
43
# In VSI aaa, enable IGMP snooping, and enable IGMP snooping proxying.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping proxy enable
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
subvlan (multicast-VLAN view)
igmp-snooping querier
Use igmp-snooping querier to enable the IGMP snooping querier.
Use undo igmp-snooping querier to disable the IGMP snooping querier.
Syntax
igmp-snooping querier
undo igmp-snooping querier
Default
The IGMP snooping querier is disabled.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
For a sub-VLAN of a multicast VLAN, this command takes effect only after you remove the
sub-VLAN from the multicast VLAN.
Examples
# In VLAN 2, enable IGMP snooping, and enable the IGMP snooping querier.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping querier
# In VSI aaa, enable IGMP snooping, and enable the IGMP snooping querier.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
44
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping querier
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
subvlan (multicast VLAN view)
igmp-snooping querier-election
Use igmp-snooping querier-election to enable IGMP snooping querier election for a VLAN or VSI.
Use undo igmp-snooping querier-election to disable IGMP snooping querier election for a VLAN
or VSI.
Syntax
igmp-snooping querier-election
undo igmp-snooping querier-election
Default
IGMP snooping querier election is disabled for a VLAN or VSI.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
For IGMP snooping querier election to take effect, you must enable the IGMP snooping querier.
Examples
# In VLAN 2, enable IGMP snooping, and enable IGMP snooping querier election.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping querier
[Sysname-vlan2] igmp-snooping querier-election
# In VSI aaa, enable IGMP snooping, and enable IGMP snooping querier election.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping querier
[Sysname-vsi-aaa] igmp-snooping querier-election
45
Related commands
igmp-snooping querier
igmp-snooping query-interval
Use igmp-snooping query-interval to set the IGMP general query interval for a VLAN or
VSI.
Use undo igmp-snooping query-interval to restore the default.
Syntax
igmp-snooping query-interval interval
undo igmp-snooping query-interval
Default
The IGMP general query interval is 125 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP general query interval in the range of 2 to 31744 seconds.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
To avoid mistakenly deleting multicast group members, set the IGMP general query interval to be
greater than the maximum response time for IGMP general queries.
Examples
# In VLAN 2, enable IGMP snooping, and set the IGMP general query interval to 20 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping query-interval 20
# In VSI aaa, enable IGMP snooping, and set the IGMP general query interval to 20 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping query-interval 20
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
46
igmp-snooping max-response-time
igmp-snooping querier
max-response-time
# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP reports.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping report source-ip 10.1.1.1
Related commands
enable (IGMP-snooping view)
47
igmp-snooping enable
igmp-snooping router-aging-time
Use igmp-snooping router-aging-time to set the aging timer for dynamic router ports in a
VLAN or VSI.
Use undo igmp-snooping router-aging-time to restore the default.
Syntax
igmp-snooping router-aging-time seconds
undo igmp-snooping router-aging-time
Default
The aging timer for dynamic router ports is 260 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
You can set the timer for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
Examples
# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic router ports to 100
seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping router-aging-time 100
# In VSI aaa, enable IGMP snooping, and set the aging timer for dynamic router ports to 100
seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping router-aging-time 100
Related commands
enable (IGMP-snooping view)
48
igmp-snooping enable
router-aging-time (IGMP-snooping view)
igmp-snooping router-port-deny
Use igmp-snooping router-port-deny to disable a port from becoming a dynamic router
port.
Use undo igmp-snooping router-port-deny to allow a port to become a dynamic router
port.
Syntax
igmp-snooping router-port-deny [ vlan vlan-list ]
undo igmp-snooping router-port-deny [ vlan vlan-list ]
Default
A port is allowed to become a dynamic router port.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you specify VLANs, this command takes effect only when the port
belongs to the specified VLANs. If you do not specify a VLAN, this command takes effect on all
VLANs to which the port belongs.
Examples
# Disable Ten-GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping router-port-deny vlan 2
igmp-snooping source-deny
Use igmp-snooping source-deny to enable multicast source port filtering on a port to discard
all multicast data packets.
Use undo igmp-snooping source-deny to disable multicast source port filtering on a port.
Syntax
igmp-snooping source-deny
undo igmp-snooping source-deny
Default
Multicast source port filtering is disabled.
Views
Layer 2 Ethernet interface view
49
Predefined user roles
network-admin
Usage guidelines
You can enable this feature for a port in interface view or for the specified ports in IGMP-snooping
view. For a port, the configuration in interface view has the same priority as the configuration in
IGMP-snooping view, and the most recent configuration takes effect.
Examples
# Enable source port filtering for multicast data on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping source-deny
Related commands
source-deny (IGMP-snooping view)
50
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
Examples
# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP
group-specific queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1
# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP
group-specific queries.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping special-query source-ip 10.1.1.1
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping static-group
Use igmp-snooping static-group to configure a port as a static member port of a multicast
group.
Use undo igmp-snooping static-group to remove the configuration of static member ports.
Syntax
igmp-snooping static-group group-address [ source-ip source-address ]
vlan vlan-id
undo igmp-snooping static-group { group-address [ source-ip
source-address ] vlan vlan-id | all }
Default
A port is not a static member port of a multicast group.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
group-address: Specifies a multicast group address in the range of 224.0.1.0 to
239.255.255.255.
51
source-ip source-address: Specifies a multicast source by its IP address. If you specify a
multicast source, this command configures the port as a static member port for a multicast source
and group. If you do not specify a multicast source, this command configures the port as a static
member port for a multicast group. This option takes effect on IGMPv3 snooping devices.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
all: Specifies all multicast groups.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a static member port of the multicast source and group
(1.1.1.1, 225.0.0.1) in VLAN 2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
[Sysname-vlan2] quit
[Sysname] interface Ten-GigabitEthernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping static-group 225.0.0.1 source-ip
1.1.1.1 vlan 2
igmp-snooping static-router-port
Use igmp-snooping static-router-port to configure a port as a static router port.
Use undo igmp-snooping static-router-port to remove the configuration of static router
ports.
Syntax
igmp-snooping static-router-port vlan vlan-id
undo igmp-snooping static-router-port { all | vlan vlan-id }
Default
A port is not a static router port.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
all: Specifies all VLANs.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a static router port in VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2
52
igmp-snooping version
Use igmp-snooping version to specify an IGMP snooping version for a VLAN or VSI.
Use undo igmp-snooping version to restore the default.
Syntax
igmp-snooping version version-number
undo igmp-snooping version
Default
The IGMP snooping version in a VLAN or VSI is 2.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
version-number: Specifies an IGMP snooping version, 2 or 3.
Usage guidelines
You must enable IGMP snooping for a VLAN or VSI before you execute this command.
You can specify the version for a VLAN in VLAN view or for the specified VLANs in IGMP-snooping
view. The VLAN-specific configuration has the same priority as the configuration in IGMP-snooping
view, and the most recent configuration takes effect.
Examples
# In VLAN 2, enable IGMP snooping, and specify IGMP snooping version 3.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] igmp-snooping version 3
# In VSI aaa, enable IGMP snooping, and specify IGMP snooping version 3.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] igmp-snooping enable
[Sysname-vsi-aaa] igmp-snooping version 3
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
version (IGMP-snooping view)
53
last-member-query-interval (IGMP-snooping view)
Use last-member-query-interval to set the IGMP last member query interval globally.
Use undo last-member-query-interval to restore the default.
Syntax
last-member-query-interval interval
undo last-member-query-interval
Default
The IGMP last member query interval is 1 second.
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.
Usage guidelines
You can set the interval for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
Examples
# Set the global IGMP last member query interval to 3 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] last-member-query-interval 3
Related commands
igmp-snooping last-member-query-interval
mac-address multicast
Use mac-address multicast to configure a static multicast MAC address entry.
Use undo mac-address multicast to delete a static multicast MAC address entry.
Syntax
In system view:
mac-address multicast mac-address interface interface-list vlan vlan-id
undo mac-address [ multicast ] [ [ mac-address [ interface interface-list ] ]
vlan vlan-id ]
In Layer 2 aggregate interface view or Layer 2 Ethernet interface view:
mac-address multicast mac-address vlan vlan-id
undo mac-address [ multicast ] mac-address vlan vlan-id
54
Default
No static multicast MAC address entries exist.
Views
System view
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a static multicast MAC address, in the format of H-H-H. You must specify
an unused multicast MAC address. A multicast MAC address is a MAC address in which the least
significant bit of the most significant octet is 1.
interface interface-list: Specifies a space-separated list of up to four interface items.
Each item specifies an interface or an interface list in the format of start-interface-type
interface-number to end-interface-type interface-number. The
interface-type interface-number argument specifies an interface by its type and number.
The available interface types include Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces.
vlan vlan-id: Specifies an existing VLAN by its VLAN ID in the range of 1 to 4094. The system
gives a prompt if the specified interface does not belong to the VLAN.
Usage guidelines
You do not need to enable IP multicast routing before you execute this command.
You can configure static multicast MAC address entries for the specified interfaces in system view or
for the current interface in interface view.
If you do not specify the multicast keyword in the undo mac-address command, all static
unicast MAC address entries and static multicast MAC entries are deleted.
Examples
# Configure a static multicast MAC address entry. In the entry, the multicast MAC address is
0100-5E00-0003 and the outgoing ports are Ten-GigabitEthernet 1/0/1 through Ten-GigabitEthernet
1/0/5 in VLAN 2.
<Sysname> system-view
[Sysname] mac-address multicast 0100-5e00-0003 interface ten-gigabitethernet 1/0/1 to
ten-gigabitethernet 1/0/5 vlan 2
# Configure a static multicast MAC address entry on Ten-GigabitEthernet 1/0/1. In the entry, the
multicast MAC address is 0100-5E00-0003 and the outgoing port is Ten-GigabitEthernet 1/0/1,
which belongs to VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mac-address multicast 0100-5e00-0003 vlan 2
Related commands
display mac-address multicast
55
Use undo mac-address multicast vsi to delete a static multicast MAC address entry for
VXLAN or delete outgoing interfaces for such an entry.
Syntax
For local static multicast MAC address entries:
mac-address multicast mac-address { interface { interface-type
interface-number service-instance instance-id }&<1-4> } vsi vsi-name
undo mac-address multicast [ mac-address [ interface { interface-type
interface-number service-instance instance-id }&<1-4> ] ] vsi vsi-name
For remote static multicast MAC address entries:
mac-address multicast mac-address { interface { tunnel tunnel-number1 [ to
tunnel tunnel-number2 ] }&<1-4> } vsi vsi-name
undo mac-address multicast [ mac-address [ interface { tunnel
tunnel-number1 [ to tunnel tunnel-number2 ] }&<1-4> ] ] vsi vsi-name
Default
No static multicast MAC address entries exist.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a multicast MAC address in the format of H-H-H, excluding the all-zero
MAC address. When entering a MAC address, you can omit the leading zeros in each H section. For
example, enter 100-5e00-3 for 0100-5e00-0003.
interface { interface-type interface-number service-instance
instance-id }&<1-4>: Specifies a space-separated list of up to four Ethernet service instances.
The interface-type interface-number argument specifies the interface that hosts an
Ethernet service instance by its type and number. The instance-id argument specifies the
Ethernet service instance by its ID in the range of 1 to 4096.
interface { tunnel tunnel-number1 [ to tunnel tunnel-number2 ] }&<1-4>:
Specifies a space-separated list of up to four VXLAN tunnel interface items. Each item specifies a
VXLAN tunnel interface number or a range of VXLAN tunnel interface numbers in the format of
tunnel tunnel-number1 to tunnel tunnel-number2. The value range for VXLAN tunnel
interface numbers varies by device model. The value of tunnel tunnel-number2 must be equal
to or larger than the value of tunnel tunnel-number1. The specified VXLAN tunnel interfaces
must exist.
vsi vsi-name: Specifies a VSI name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
To send packets with a specific destination MAC address out of multiple ports, use this command to
configure a static multicast MAC address entry. You can repeat this command to add outgoing
interfaces for an existing entry.
For successful configuration, follow these restrictions when you configure static multicast MAC
address entries:
• For a local static multicast MAC address entry, make sure the specified Ethernet service
instances have been mapped to the specified VSI.
• For a remote static multicast MAC address entry, make sure the specified VXLAN tunnel
interfaces have been associated with the specified VSI.
56
Follow these guidelines when you use the undo mac-address multicast vsi command:
• To delete all static multicast MAC address for a VSI, do not specify any optional parameters.
• To remove outgoing interfaces from a static multicast MAC address entry, specify the MAC
address and the interfaces.
Do not specify the tunnel interfaces automatically created by using ENDP or EVPN as outgoing
interfaces for a remote static multicast MAC address entry. If you do so, the numbers of these tunnel
interfaces might change during tunnel re-establishment, and the related entries cannot be restored
as a result.
In an EVPN network, you cannot configure the same multicast MAC address entry on multiple leaf
nodes or VTEPs. When configured with EVPN multihoming, a VTEP does not support
synchronization of multicast MAC address entries.
For more information about VXLAN, see VXLAN Configuration Guide. For more information about
EVPN, see EVPN Configuration Guide.
Examples
# Configure a local static multicast MAC address entry for VSI vsi1.
<Sysname> system-view
[Sysname] mac-address multicast 0100-5e00-0003 interface ten-gigabitethernet 1/0/1
service-instance 1 ten-gigabitethernet 1/0/2 service-instance 1 vsi vsi1
# Configure a remote static multicast MAC address entry for VSI vsi1.
<Sysname> system-view
[Sysname] mac-address multicast 0100-5e00-0003 interface tunnel 1 to tunnel 3 vsi vsi1
Related commands
display l2vpn mac-address (VXLAN Command Reference)
57
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP
general queries to be less than the IGMP general query interval.
Examples
# Set the global maximum response time for IGMP general queries to 5 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] max-response-time 5
Related commands
igmp-snooping max-response-time
igmp-snooping query-interval
Related commands
igmp-snooping overflow-replace
58
report-aggregation (IGMP-snooping view)
Use report-aggregation to enable IGMP report suppression.
Use undo report-aggregation to disable IGMP report suppression.
Syntax
report-aggregation
undo report-aggregation
Default
IGMP report suppression is enabled.
Views
IGMP-snooping view
Predefined user roles
network-admin
Examples
# Disable IGMP report suppression.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] undo report-aggregation
59
Examples
# Clear information about all dynamic IGMP snooping group entries.
<Sysname> reset igmp-snooping group all
Related commands
display igmp-snooping group
Related commands
display igmp-snooping router-port
60
Related commands
display igmp-snooping statistics
# Clear the Layer 2 multicast fast forwarding entry for the multicast source and group (20.0.0.2,
225.0.0.2).
<Sysname> reset l2-multicast fast-forwarding cache 20.0.0.2 225.0.0.2
Related commands
display l2-multicast fast-forwarding cache
61
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.
Usage guidelines
You can set the timer globally for all VLANs and VSIs in IGMP-snooping view, for a VSI in VSI view,
or for a VLAN in VLAN view. For a VSI, the VSI-specific configuration takes priority over the global
configuration. For a VLAN, the VLAN-specific configuration takes priority over the global
configuration.
Examples
# Set the global aging timer for dynamic router ports to 100 seconds.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] router-aging-time 100
Related commands
igmp-snooping router-aging-time
send-query enable
Use send-query enable to enable the device to send IGMP general queries upon a path
change.
Use undo send-query enable to restore the default.
Syntax
send-query enable
undo send-query enable
Default
The device does not send IGMP general queries upon a path change.
Views
IGMP-snooping view
Predefined user roles
network-admin
Usage guidelines
Use this command to enable the device to immediately send an IGMP general query to all ports in
the affected VLAN or VSI when the path changes. This feature ensures that the device can update
the member port information in multicast forwarding entries and switch multicast traffic to the new
path promptly.
Examples
# Enable the device to send IGMP general queries upon a path change.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] send-query enable
Related commands
igmp-snooping
62
source-deny (IGMP-snooping view)
Use source-deny to enable multicast source port filtering on ports to discard all multicast data
packets.
Use undo source-deny to disable multicast source port filtering on ports.
Syntax
source-deny port interface-list
undo source-deny port interface-list
Default
Multicast source port filtering is disabled.
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
port interface-list: Specifies a space-separated list of port items. Each item specifies a port
by its port type and number or a range of ports in the form of start-interface-type
interface-number to end-interface-type interface-number.
Usage guidelines
You can enable this feature for the specified ports in IGMP-snooping view or for a port in interface
view. For a port, the configuration in IGMP-snooping view has the same priority as the configuration
in interface view, and the most recent configuration takes effect.
Examples
# Enable multicast source port filtering on ports Ten-GigabitEthernet 1/0/1 through
Ten-GigabitEthernet 1/0/4.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] source-deny port ten-gigabitethernet 1/0/1 to
ten-gigabitethernet 1/0/4
Related commands
igmp-snooping source-deny
63
Views
IGMP-snooping view
Predefined user roles
network-admin
Parameters
version-number: Specifies an IGMP snooping version, 2 or 3.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094.
Usage guidelines
You must enable IGMP snooping for the specified VLANs before you execute this command.
You can specify the version for the specified VLANs in IGMP-snooping view or for a VLAN in VLAN
view. The configuration in IGMP-snooping view has the same priority as the VLAN-specific
configuration, and the most recent configuration takes effect.
Examples
# Enable IGMP snooping for VLAN 2 through VLAN 10, and specify IGMP snooping version 3 for
these VLANs.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] enable vlan 2 to 10
[Sysname-igmp-snooping] version 3 vlan 2 to 10
Related commands
enable (IGMP-snooping view)
igmp-snooping enable
igmp-snooping version
64
Contents
PIM snooping commands ·············································································· 1
display pim-snooping neighbor ·················································································································· 1
display pim-snooping router-port················································································································ 2
display pim-snooping routing-table ············································································································ 3
display pim-snooping statistics··················································································································· 5
pim-snooping enable ·································································································································· 6
pim-snooping graceful-restart join-aging-time ···························································································· 6
pim-snooping graceful-restart neighbor-aging-time ··················································································· 7
reset pim-snooping statistics ······················································································································ 8
i
PIM snooping commands
display pim-snooping neighbor
Use display pim-snooping neighbor to display PIM snooping neighbor information.
Syntax
display pim-snooping neighbor [ vlan vlan-id ] [ slot slot-number ]
[ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays PIM snooping neighbor information for all VLANs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays PIM snooping neighbor information for the master device.
verbose: Displays detailed information about PIM snooping neighbors. If you do not specify this
keyword, the command displays brief information about PIM snooping neighbors.
Examples
# Display detailed information about PIM snooping neighbors for VLAN 2.
<Sysname> display pim-snooping neighbor vlan 2 verbose
Total 2 neighbors.
Field Description
Slots (0 in total) Member IDs and total number of the member devices that have the
neighbor, except for the specified member device or the master device
1
Field Description
when no member device is specified.
Ports where the PIM snooping neighbors reside, and the total number of
Ports (1 in total)
the ports.
Remaining aging timer for a PIM snooping neighbor on the port.
This field is always displayed for global ports (such as Layer 2 aggregate
interfaces, ACs, N-PWs, and U-PWs).
(02:02:23) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
The PIM hello message sent by the PIM snooping neighbor has the
LAN Prune Delay
LAN_Prune_Delay option.
The join message suppression feature has been disabled for the PIM
(T)
snooping neighbor.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
# Display detailed information about PIM snooping router ports for VLAN 2.
2
<Sysname> display pim-snooping router-port vlan 2 verbose
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/1 (00:01:30)
XGE1/0/2 (00:01:32)
Field Description
Router ports (2 in total) Router ports and total number of router ports.
Remaining aging time for the router port.
For a global port, this field is always displayed.
(00:01:30) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
3
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
Field Description
VLAN 2: Total 1 entries Total number of (S, G) entries and (*, G) entries in VLAN 2.
(172.10.10.1, 225.1.1.1) (S, G) entry.
Finite state machine information of the entry:
• delete—The entry attributes have been deleted.
FSM information
• dummy—The entry is a new temporary entry.
• no info—The entry does not exist.
4
Field Description
Expires: 00:03:01, FSM: J For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is
specified.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
Field Description
5
Related commands
reset pim-snooping statistics
pim-snooping enable
Use pim-snooping enable to enable PIM snooping for a VLAN.
Use undo pim-snooping enable to disable PIM snooping for a VLAN.
Syntax
pim-snooping enable
undo pim-snooping enable
Default
PIM snooping is disabled for a VLAN.
Views
VLAN view
Predefined user roles
network-admin
Usage guidelines
You must enable the IGMP snooping feature and enable IGMP snooping for a VLAN before you
enable PIM snooping for the VLAN.
PIM snooping does not take effect on sub-VLANs of a multicast VLAN.
Examples
# Enable the IGMP snooping feature, and then enable IGMP snooping and PIM snooping for VLAN
2.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
Related commands
igmp-snooping
igmp-snooping enable
6
Default
The aging time is 210 seconds for global downstream ports and global router ports on the new
master device after a master/subordinate switchover.
Views
VLAN view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging time in the range of 210 to 18000 seconds.
Usage guidelines
You must enable PIM snooping for a VLAN before you execute this command.
Global ports include Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs. A global downstream
port or a global router port is a global port that acts as a downstream port or router port, respectively.
Examples
# In VLAN 2, set the aging time to 600 seconds for global downstream ports and global router ports
on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
[Sysname-vlan2] pim-snooping graceful-restart join-aging-time 600
Related commands
pim-snooping enable
7
Parameters
seconds: Specifies an aging time in the range of 105 to 18000 seconds.
Usage guidelines
You must enable PIM snooping in a VLAN before you execute this command.
Global ports include Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs. A global neighbor port
is a global port that acts as a neighbor port.
Examples
# In VLAN 2, set the aging time to 300 seconds for global neighbor ports on the new master device
after a master/subordinate switchover.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] igmp-snooping enable
[Sysname-vlan2] pim-snooping enable
[Sysname-vlan2] pim-snooping graceful-restart neighbor-aging-time 300
Related commands
pim-snooping enable
Related commands
display pim-snooping statistics
8
Contents
Multicast VLAN commands ············································································ 1
display multicast-vlan ································································································································· 1
display multicast-vlan forwarding-table ······································································································ 2
display multicast-vlan group ······················································································································· 3
multicast-vlan ············································································································································· 5
multicast-vlan entry-limit····························································································································· 6
port (multicast-VLAN view)························································································································· 6
port multicast-vlan ······································································································································ 7
reset multicast-vlan group ·························································································································· 8
subvlan (multicast-VLAN view) ·················································································································· 9
i
Multicast VLAN commands
display multicast-vlan
Use display multicast-vlan to display information about multicast VLANs.
Syntax
display multicast-vlan [ vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan-id: Specifies a multicast VLAN ID in the range of 1 to 4094. If you do not specify a multicast
VLAN ID, this command displays information about all multicast VLANs.
Examples
# Display information about all multicast VLANs.
<Sysname> display multicast-vlan
Total 2 multicast VLANs.
Field Description
1
display multicast-vlan forwarding-table
Use display multicast-vlan forwarding-table to display multicast VLAN forwarding
entries.
Syntax
display multicast-vlan forwarding-table [ group-address [ mask
{ mask-length | mask } ] | source-address [ mask { mask-length | mask } ] |
slot slot-number | subvlan vlan-id | vlan vlan-id ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to
239.255.255.255. If you do not specify a multicast group, this command displays multicast VLAN
forwarding entries for all multicast groups.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast group
address. The value range for the mask-length argument is 4 to 32 (default), and the default value
for the mask argument is 255.255.255.255.
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast
source, this command displays multicast VLAN forwarding entries for all multicast sources.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast source
address. The value range for the mask-length argument is 0 to 32 (default), and the default value
for the mask argument is 255.255.255.255.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays multicast VLAN forwarding entries for the master device.
subvlan vlan-id: Specifies a sub-VLAN by its VLAN ID. If you do not specify a sub-VLAN, this
command displays multicast VLAN forwarding entries for all sub-VLANs.
vlan vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not
specify a multicast VLAN, this command displays multicast VLAN forwarding entries for all multicast
VLANs.
Examples
# Display all multicast VLAN forwarding entries.
<Sysname> display multicast-vlan forwarding-table
Multicast VLAN 100 Forwarding Table
Total 1 entries, 1 matched
2
Table 2 Command output
Field Description
Multicast VLAN 100 Forwarding Table Forwarding entries for multicast VLAN 100.
Total 1 entries, 1 matched Total number of (S, G) entries, and the number of matching entries.
00001 Sequence number of the (S, G) entry.
(S, G) entry, where 0.0.0.0 in the S position means all multicast
(1.1.1.1, 255.0.0.1)
sources.
Entry flag.
This field displays one flag or the sum of multiple flags. In this
example, the value 0x10000 means that the entry has only one flag
0x10000.
The following flags are available for an entry:
Flags
• 0x1—The entry is in inactive state.
• 0x4—The entry fails to update.
• 0x8—The sub-VLAN information fails to update for the entry.
• 0x200—The entry is in GR state.
• 0x10000—The entry is a multicast VLAN forwarding entry.
Sub-VLAN list of the multicast VLAN, and the total number of the
List of sub-VLANs (3 in total)
sub-VLANs.
3
vlan vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not
specify a multicast VLAN, this command displays information about multicast groups for all multicast
VLANs.
Examples
# Display detailed information about all multicast groups in multicast VLANs.
<Sysname> display multicast-vlan group verbose
Total 6 entries.
Field Description
Entry flag.
This field displays one flag or the sum of multiple flags. For
example, the value 0x70000020 means that the entry has flags
0x20, 0x10000000, 0x20000000, and 0x40000000.
Flags The following flags are available for an entry:
• 0x10—The entry is created by the multicast VLAN.
• 0x20—The entry is created by the sub-VLAN of the
multicast VLAN.
• 0x40—The entry is to be deleted.
4
Field Description
• 0x10000000—This value represents one of the following
situations:
The entry is newly created.
The device receives an IGMP query that matches the
(S, G) entry but does not receive any matching
IGMPv1 reports within an IGMP general query interval.
• 0x20000000—The device does not receive IGMPv2 or
IGMPv3 reports that match the (S, G) entry within an IGMP
general query interval.
• 0x40000000—The device does not receive IGMPv3
IS_EX (NULL) reports that match the (S, G) entry within an
IGMP general query interval.
Sub-VLAN list of the multicast VLAN, and the total number of
Sub-VLANs (1 in total)
the sub-VLANs.
Related commands
reset multicast-vlan group
multicast-vlan
Use multicast-vlan to configure a multicast VLAN and enter its view, or enter the view of an
existing multicast VLAN.
Use undo multicast-vlan to remove the configuration of multicast VLANs.
Syntax
multicast-vlan vlan-id
undo multicast-vlan { all | vlan-id }
Default
No multicast VLANs exist.
Views
System view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies an existing VLAN by its ID in the range of 1 to 4094.
all: Specifies all multicast VLANs.
Usage guidelines
You can configure a maximum of five multicast VLANs.
You must enable IGMP snooping for the VLAN to be configured as a multicast VLAN.
As a best practice, do not configure a multicast VLAN on a device that is enabled with IP multicast
routing.
Examples
# Enable IGMP snooping for VLAN 100. Configure VLAN 100 as a multicast VLAN and enter its view.
<Sysname> system-view
[Sysname] igmp-snooping
5
[Sysname-igmp-snooping] quit
[Sysname] vlan 100
[Sysname-vlan100] igmp-snooping enable
[Sysname-vlan100] quit
[Sysname] multicast-vlan 100
[Sysname-mvlan-100]
Related commands
igmp-snooping enable
multicast routing
multicast-vlan entry-limit
Use multicast-vlan entry-limit to set the maximum number of multicast VLAN forwarding
entries.
Use undo multicast-vlan entry-limit to restore the default.
Syntax
multicast-vlan entry-limit limit
undo multicast-vlan entry-limit
Default
The maximum number of multicast VLAN forwarding entries is 4000.
Views
System view
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of multicast VLAN forwarding entries, in the range of 0 to
4000.
Usage guidelines
If the configured value is smaller than the current number of multicast VLAN forwarding entries, the
device cannot create new entries until some entries age out or are manually removed. To allow new
entries to be created immediately, use the reset multicast-vlan group command to remove
multicast VLAN forwarding entries.
Examples
# Set the maximum number of multicast VLAN forwarding entries to 128.
<Sysname> system-view
[Sysname] multicast-vlan entry-limit 128
Related commands
entry-limit (IGMP-snooping view)
6
Syntax
port interface-list
undo port { all | interface-list }
Default
A multicast VLAN does not have user ports.
Views
Multicast VLAN view
Predefined user roles
network-admin
Parameters
interface-list: Specifies a port in the form of interface-type interface-number, or a
port range in the form of interface-type interface-number to interface-type
interface-number.
all: Specifies all user ports in the current multicast VLAN.
Usage guidelines
You can assign only Layer 2 Ethernet ports or Layer 2 aggregate interfaces to multicast VLANs.
Additionally, you can assign a port to only one multicast VLAN.
For ports to be assigned to a multicast VLAN, you must enable IGMP snooping for the VLANs to
which the ports belong.
Examples
# Assign Ten-GigabitEthernet 1/0/1 through Ten-GigabitEthernet 1/0/3 as user ports to multicast
VLAN 100.
<Sysname> system-view
[Sysname] multicast-vlan 100
[Sysname-mvlan-100] port ten-gigabitethernet 1/0/1 to ten-gigabitethernet 1/0/3
port multicast-vlan
Use port multicast-vlan to assign a user port to a multicast VLAN.
Use undo port multicast-vlan to restore the default.
Syntax
port multicast-vlan vlan-id
undo port multicast-vlan
Default
A port does not belong to a multicast VLAN.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
7
Parameters
vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094.
Usage guidelines
You can assign a port to only one multicast VLAN.
For a port to be assigned to a multicast VLAN, you must enable IGMP snooping for the VLAN to
which the port belongs.
Examples
# Assign Ten-GigabitEthernet 1/0/1 as a user port to multicast VLAN 100.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] port multicast-vlan 100
Related commands
display multicast-vlan group
8
subvlan (multicast-VLAN view)
Use subvlan to assign VLANs as sub-VLANs to a multicast VLAN.
Use undo subvlan to delete sub-VLANs from a multicast VLAN.
Syntax
subvlan vlan-list
undo subvlan { all | vlan-list }
Default
A multicast VLAN does not have sub-VLANs.
Views
Multicast VLAN view
Predefined user roles
network-admin
Parameters
vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN
by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The value range
for the VLAN ID is 1 to 4094. The specified VLANs must exist and cannot be multicast VLANs or
sub-VLANs of other multicast VLANs.
all: Specifies all sub-VLANs of the current multicast VLAN.
Usage guidelines
You must enable IGMP snooping for VLANs to be configured as sub-VLANs.
Examples
# Assign VLAN 10 through VLAN 15 as sub-VLANs to multicast VLAN 100.
<Sysname> system-view
[Sysname] multicast-vlan 100
[Sysname-mvlan-100] subvlan 10 to 15
9
Contents
Multicast routing and forwarding commands ·················································· 1
delete ip rpf-route-static ····························································································································· 1
display mrib interface ································································································································· 1
display multicast boundary ························································································································· 3
display multicast fast-forwarding cache ····································································································· 3
display multicast forwarding df-info ············································································································ 5
display multicast forwarding event ············································································································· 6
display multicast forwarding-table ·············································································································· 8
display multicast forwarding-table df-list ·································································································· 10
display multicast routing-table ·················································································································· 11
display multicast routing-table static ········································································································ 12
display multicast rpf-info··························································································································· 13
ip rpf-route-static ······································································································································ 14
load-splitting (MRIB view) ························································································································ 15
longest-match (MRIB view) ······················································································································ 16
mtrace-service port ·································································································································· 17
mtrace v1 ················································································································································· 17
mtrace v2 ················································································································································· 21
multicast boundary ··································································································································· 24
multicast forwarding supervlan community ······························································································ 25
multicast routing ······································································································································· 26
reset multicast fast-forwarding cache······································································································· 26
reset multicast forwarding event ·············································································································· 27
reset multicast forwarding-table ··············································································································· 27
reset multicast routing-table ····················································································································· 28
i
Multicast routing and forwarding
commands
delete ip rpf-route-static
Use delete ip rpf-route-static to delete all static multicast routes.
Syntax
delete ip rpf-route-static
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command deletes all static multicast routes. To delete a specified static multicast route, use the
undo ip rpf-route-static command.
Examples
# Delete all static multicast routes.
<Sysname> system-view
[Sysname] delete ip rpf-route-static
This will erase all multicast static routes and their configurations, you must reconfigure
all static routes.
Are you sure?[Y/N]:y
Related commands
ip rpf-route-static
1
Examples
# Display information about interfaces maintained by the MRIB.
<Sysname> display mrib interface
Interface: Vlan-interface1
Index: 0x00004444
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : 8.12.0.2/16
Remote address: 0.0.0.0
Reference : 1
State : NORMAL
Flags : 0x2
Field Description
Interface Interface name.
Index Index number of the interface.
Current state Current status of the interface: up or down.
MTU MTU value.
Interface type:
• BROADCAST—Broadcast link interface.
• LOOP—Loopback interface.
Type
• REGISTER—Register interface.
• MTUNNEL—Multicast tunnel interface.
This field is empty if the interface is Null 0.
Protocol Protocol running on the interface: PIM-DM, PIM-SM, IGMP, PROXY, or MD.
PIM protocol state Whether PIM is enabled: Enabled or Disabled.
Address list Interface address list.
Local address Local IP address.
Remote end IP address. This field is displayed only when the interface is
Remote address
vlink type.
Reference Number of times that the address has been referenced.
State Status of the interface address: NORMAL or DEL.
Interface attribute. This field displays one flag or the sum of multiple flags.
For example, value 0x2 means that the interface has only one flag 0x2, and
value 0x14 means that the interface has flags 0x4 and 0x10.
The following flags are available for an interface:
Flags • 0x0—The interface is in normal status.
• 0x1—The interface address is being deleted.
• 0x2—The interface address is an IPv4 primary address.
• 0x4—The interface is a PMSI tunnel interface for RSVP-TE-based
MVPN.
2
Field Description
• 0x8—The interface is a multicast tunnel interface for a Layer 3 VXLAN.
• 0x10—The interface is a virtual multicast incoming interface for
tunneled traffic.
Field Description
Boundary Multicast group associated with the multicast boundary.
Interface Boundary interface associated with the multicast boundary.
Related commands
multicast boundary
3
Syntax
display multicast fast-forwarding cache [ source-address | group-address ]
* [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to
239.255.255.255.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays multicast fast forwarding entries for the master device.
Examples
# Display multicast fast forwarding entries.
<Sysname> display multicast fast-forwarding cache
Total 1 entries, 1 matched
(60.1.1.200, 225.0.0.2)
Status : Enabled
Source port: 2001 Destination port: 2002
Protocol : 2 Flag : 0x2
Incoming interface: Vlan-interface1
List of 1 outgoing interfaces:
Vlan-interface2
Status: Enabled Flag: 0x14
Field Description
Total number of (S, G) entries in the multicast fast forwarding table, and
Total 1 entries, 1 matched
the total number of matching (S, G) entries.
(60.1.1.200, 225.0.0.2) (S, G) entry.
Protocol Protocol number.
Flag of the (S, G) entry or the outgoing interface in the entry.
This field displays one flag or the sum of multiple flags. For example,
value 0x2 means that the entry has only one flag 0x2, and value 0x14
means that the interface has flags 0x4 and 0x10.
The following flags are available for an entry:
• 0x1—The entry is created because of packets passed through
Flag between cards.
• 0x2—The entry is added by multicast forwarding.
The following flags are available for an outgoing interface:
• 0x1—The interface is added to the entry because of packets
passed through between cards.
• 0x2—The interface is added to an existing entry.
4
Field Description
• 0x4—The MAC address of the interface is needed for fast
forwarding.
• 0x8—The interface is an outgoing interface associated with the
incoming VLAN or super VLAN interface.
• 0x10—The interface is associated with the entry.
• 0x20—The interface is to be deleted.
Related commands
reset multicast fast-forwarding cache all
5
Uptime: 04:14:40
RPF interface: Vlan-interface1
List of 1 DF interfaces:
1: Vlan-interface2
Field Description
Total 1 RPs, 1 matched Total number of RPs, and the total number of matching RPs.
00001 Sequence number of the entry to which the RP is designated.
RP address IP address of the RP.
ID of the entry to which the RP is designated. Each entry to which the RP is
MID
designated has a unique MID.
Entry flag.
This field displays one flag or the sum of multiple flags. For example, value
0x0 means that the entry has only one flag 0x0.
The following flags are available for an entry:
• 0x0—The entry is in correct state.
Flags
• 0x4—The entry fails to update.
• 0x8—DF interface information fails to update for the entry.
• 0x40—The entry is to be deleted.
• 0x100—The entry is being deleted.
• 0x200—The entry is in GR state.
Uptime Length of time for which the entry has been up.
RPF interface RPF interface to the RP.
List of 1 DF interfaces DF interface list.
6
Syntax
display multicast forwarding event [ slot slot-number]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays statistics of multicast forwarding events for the master
device.
Examples
# Display statistics of multicast forwarding events.
<Sysname> display multicast forwarding event
Total active events sent: 0
Total inactive events sent: 0
Total NoCache events sent: 2
Total NoCache events dropped: 0
Total WrongIF events sent: 0
Total WrongIF events dropped: 0
Total SPT switch events sent: 0
NoCache rate limit: 1024 packets/s
WrongIF rate limit: 1 packets/10s
Total timer of register suppress timeout: 0
Field Description
Total active events sent Number of times that entry-active events have been sent.
Total inactive events sent Number of times that entry-inactive events have been sent.
Total NoCache events sent Number of times that NoCache events have been sent.
Total NoCache events dropped Number of times that NoCache events have been dropped.
Total WrongIF events sent Number of times that WrongIF events have been sent.
Total WrongIF event dropped Number of times that WrongIF events have been dropped.
Total SPT switch events sent Number of times that SPT-switch events have been sent.
NoCache rate limit Rate limit for sending NoCache events, in pps.
WrongIF rate limit Rate limit for sending WrongIF events, in packets per 10 seconds.
Total timer of register suppress
Number of times that the registration suppression has timed out in total.
timeout
Related commands
reset multicast forwarding event
7
display multicast forwarding-table
Use display multicast forwarding-table to display multicast forwarding entries.
Syntax
display multicast forwarding-table [ source-address [ mask { mask-length |
mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface
interface-type interface-number | outgoing-interface { exclude | include
| match } interface-type interface-number | slot slot-number | statistics ]
*
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to
239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group
address, the value range for this argument is 4 to 32. For a multicast source address, the value range
for this argument is 0 to 32.
mask: Specifies an address mask. The default value is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified
incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
outgoing-interface: Specifies the multicast forwarding entries that contain the specified
outgoing interface.
exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the
outgoing interface list.
include: Specifies the multicast forwarding entries that contain the specified interface in the
outgoing interface list.
match: Specifies the forwarding entries that contain only the specified interface in the outgoing
interface list.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays multicast forwarding entries for the master device.
statistics: Displays statistics for the multicast forwarding table.
Examples
# Display multicast forwarding entries.
<Sysname> display multicast forwarding-table
Total 1 entries, 1 matched
8
Incoming interface: Vlan-interface10
Incoming sub-VLAN: VLAN 11
Outgoing sub-VLAN: VLAN 12
VLAN 13
List of 1 outgoing interfaces:
1: Vlan-interface20
Sub-VLAN: VLAN 21
VLAN 22
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
Field Description
Total number of (S, G) entries, and the total number of matching (S, G)
Total 1 entries, 1 matched
entries.
00001 Sequence number of the (S, G) entry.
(172.168.0.2,227.0.0.1) (S, G) entry.
Entry flag.
This field displays one flag or the sum of multiple flags. For example,
value 0x0 means that the entry has only one flag 0x0.
The following entries are available for an entry:
• 0x0—The entry is in correct state.
• 0x1—The entry is in inactive state.
• 0x2—The entry is null.
• 0x4—The entry fails to update.
• 0x8—Outgoing interface information fails to update for the entry.
• 0x10—Data-group information fails to update for the entry.
Flags
• 0x20—A register outgoing interface is available.
• 0x40—The entry is to be deleted.
• 0x80—The entry is in registration suppression state.
• 0x100—The entry is being deleted.
• 0x200—The entry is in GR state.
• 0x400—The entry has the VLAN interface of the super VLAN.
• 0x800—The entry has the associated ARP entry for the multicast
source address.
• 0x400000—The entry is created by the IGMP proxy.
• 0x2000000—The entry is a BIDIR-PIM forwarding entry.
Uptime Length of time for which the (S, G) entry has been up.
9
Field Description
packets(20512512 bytes), packets with incoming interface errors.
Wrong If 0 packet The numbers are displayed as 0 if an outgoing interface of the (S, G)
entry is on the specified slot.
Number of packets (bytes) that have been forwarded.
Forwarded 19648
packets(20512512 bytes) The numbers are displayed as 0 if an outgoing interface of the (S, G)
entry is on the specified slot.
Related commands
reset multicast forwarding-table
10
List of 1 DF interfaces:
1: Vlan-interface1
Product information: 0x347849f6, 0x14bd6837
Tunnel information: 0xc4857986, 0x128a9c8f
Field Description
Total 1 entries, 1 matched Total number of forwarding entries, and the total number of matching entries.
00001 Sequence number of the entry.
(0.0.0.0, 225.0.0.1) (*, G) entry.
List of 1 DF interfaces DF interface list.
11
match: Specifies the multicast routing entries that contain only the specified interface in the
outgoing interface list.
Usage guidelines
Multicast routing entries are the basis of multicast forwarding. You can use this command to view the
establishment state of (S, G) entries.
Examples
# Display multicast routing entries.
<Sysname> display multicast routing-table
Total 1 entries
Field Description
Total 1 entries Total number of (S, G) entries.
00001 Sequence number of the (S, G) entry.
(172.168.0.2, 227.0.0.1) (S, G) entry.
Uptime Length of time for which the (S, G) entry has been up.
Related commands
reset multicast routing-table
12
mask: Specifies an address mask.
Usage guidelines
This command displays only valid static multicast routing entries.
Examples
# Display static multicast routing entries.
<Sysname> display multicast routing-table static
Destinations: 3 Routes: 4
Field Description
Destinations Number of the multicast destination addresses.
Routes Number of routes.
Destination/Mask Destination address and its mask length.
Pre Route preference.
13
Referenced route/mask: 192.168.1.0/24
Referenced route type: igp
Route selection rule: preference-preferred
Load splitting rule: disable
Source AS: 0
C-multicast route target: 0x0000000000000000
Field Description
RPF neighbor IP address of the RPF neighbor.
Related commands
display multicast forwarding-table
display multicast routing-table
ip rpf-route-static
Use ip rpf-route-static to configure a static multicast route.
Use undo ip rpf-route-static to delete a static multicast route.
Syntax
ip rpf-route-static source-address { mask-length | mask }
{ rpf-nbr-address | interface-type interface-number } [ preference
preference ]
undo ip rpf-route-static source-address { mask-length | mask }
{ rpf-nbr-address | interface-type interface-number }
Default
No static multicast routes exist.
Views
System view
14
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source address.
mask-length: Specifies an address mask length in the range of 0 to 32.
mask: Specifies an address mask.
rpf-nbr-address: Specifies an RPF neighbor by its IP address.
interface-type interface-number: Specifies an interface by its type and number. The
interface connects the RPF neighbor.
preference: Sets a route preference in the range of 1 to 255. The default value is 1.
Usage guidelines
If the interface connected to an RPF neighbor is a point-to-point interface, you must specify the
interface by its type and number.
If the interface connected to an RPF neighbor is not a point-to-point interface, you must specify the
interface by its IP address. This type of interfaces includes Layer 3 Ethernet, Layer 3 aggregate,
Loopback, and VLAN interfaces.
The configured static multicast route might not take effect when one of the following conditions
exists:
• The outgoing interface iteration fails.
• The specified interface is not in the public network or the same VPN instance as the current
interface.
• The specified interface is not a point-to-point interface.
• The specified interface is down.
If multiple static multicast routes within the same multicast source address range are available, only
the one with the highest route preference can become active. You can use the display
multicast routing-table static command to verify that the configured static multicast
route has taken effect.
The undo ip rpf-route-static command deletes the specified static multicast route, but the
delete ip rpf-route-static command deletes all static multicast routes.
Examples
# Configure a static multicast route to multicast source 10.1.1.0/24 and specify the interface with IP
address 192.168.1.23 as the RPF neighbor.
<Sysname> system-view
[Sysname] ip rpf-route-static 10.1.1.0 24 192.168.1.23
Related commands
delete ip rpf-route-static
display multicast routing-table static
15
Syntax
load-splitting { source | source-group }
undo load-splitting
Default
Multicast load splitting is disabled.
Views
MRIB view
Predefined user roles
network-admin
Parameters
source: Enables multicast load splitting based on multicast source.
source-group: Enables multicast load splitting based on multicast source and group.
Usage guidelines
This command does not take effect on BIDIR-PIM.
Examples
# Enable multicast load splitting based on multicast source.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] load-splitting source
16
[Sysname-mrib] multicast longest-match
mtrace-service port
Use mtrace-service port to specify the UDP port number used by mtrace.
Use undo mtrace-service port to restore the default.
Syntax
mtrace-service port number
undo mtrace-service port
Default
Mtrace uses UDP port number 10240.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies a UDP port number to be used by mtrace, in the range of 1024 to 49151.
Usage guidelines
Execute this command only when mtrace2 is used.
For successful mtrace, do not specify a UDP port number used by other modules.
You must specify the same UDP port number on all devices on the traced path. Additionally, the
specified UDP port number must be the same as that specified in the mtrace v2 command.
Examples
# Specify 12345 as the UDP port number used by mtrace.
<Sysname> system-interview
[sysname] mtrace-service port 12345
Related commands
mtrace v2
mtrace v1
Use mtrace v1 to trace a multicast path through mtrace1.
Syntax
mtrace v1 { source-address | group-address } * [ destination address ]
[ verbose ]
Views
Any view
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source by its IP address.
17
group-address: Specifies a multicast group by its IP address, in the range of 224.0.1.0 to
239.255.255.255.
destination address: Specifies the destination address of mtrace. The default destination
address is 224.0.0.2.
verbose: Displays detailed information about mtrace. If you do not specify this keyword, the
command displays brief information about mtrace.
Usage guidelines
To perform a non-group-specific mtrace, specify a multicast source and a destination. The mtrace
starts from the destination and ends at the device directly connected to the multicast source.
To perform a non-source-specific mtrace, specify a multicast group and a destination. The mtrace
starts from the destination and ends at the RP associated with the multicast group.
To perform a source-and-group-specific mtrace, specify both a multicast source and a multicast
group. If you also specify a destination, the mtrace starts from the destination and ends at the device
directly connected to the multicast source. If you do not specify a destination, the mtrace starts from
the upstream device of the client and ends at the device directly connected to the multicast source.
An mtrace process stops if the number of traced hops reaches 255.
If the client does not receive a Reply message within 10 seconds, the client initiates a hop-by-hop
mtrace to determine which device on the path encountered an error. It sends a Query message with
the hops field set to 1 and waits for a Reply message. If it does not receive a Reply message within
10 seconds, the client determines that this hop encountered an error. If the client receives a Reply
message within 10 seconds, it sends a Query message with the hops field value increased by 1 and
waits for a Reply message. This process continues until the client does not receive a Reply message
within the waiting time any more.
Examples
# Use mtrace1 to trace the path along which multicast data of group 225.2.1.1 travels from source
10.11.5.24 to destination 192.168.2.2 and display brief mtrace information.
<Sysname> mtrace v1 10.11.5.24 225.2.1.1 destination 192.168.2.2
Mtrace from 10.11.5.24 to 192.168.2.2 via group 225.2.1.1, 255 hops at most, press
CTRL_C to break.
Querying full reverse path...
Field Description
Number of the hop. 0 represents the last hop, -1 represents the hop before the
Hop
last hop, and so on.
Incoming address Incoming interface of the multicast data.
Multicast routing protocol used between this device and the previous-hop
device:
Protocol
• PIM.
• PIM(STATIC)—PIM using a static multicast route.
18
Field Description
• PIM(MBGP)—PIM using an MBGP route.
• PIM(ASSERT)—PIM in a state created by Assert processing.
Length of time used to transmit an mtrace message between this device and
Time
the previous-hop device, in seconds.
Forwarding code or error code:
• NO_ERROR—No error.
• WRONG_IF—The interface on which the mtrace message arrives is not in
the outgoing interface list of the multicast data.
• PRUNE_SENT—This device has sent a prune message to the upstream
device.
• PRUNE_RCVD—This device has received a prune message from the
downstream device.
• SCOPED—A multicast border is configured on the incoming interface or
outgoing interface of the multicast data.
Fwd code
• NO_ROUTE—This device does not have any route for the source or the
RP.
• WRONG_LAST_HOP—This device is not the proper last-hop device.
• REACHED_RP—This device is the RP for the (*, G) multicast data.
• RPF_IF—The mtrace message arrived on the expected RPF interface for
the multicast data.
• NO_MULTICAST—The mtrace message arrived on an interface that is
not enabled with IP multicast.
• NO_SPACE—No space is available for inserting a response data block in
the packet.
# Use mtrace1 to trace the path along which multicast data of group 225.2.1.1 travels from source
10.11.5.24 to destination 192.168.2.2 and display detailed mtrace information.
<Sysname> mtrace v1 10.11.5.24 225.2.1.1 destination 192.168.2.2 verbose
Mtrace from 10.11.5.24 to 192.168.2.2 via group 225.2.1.1, 255 hops at most, use query
ID 12345, client port 50001, press CTRL_C to break.
Querying full reverse path..........
Switching to hop-by-hop mode, Current hops: 2
19
Multicast protocol in use: PIM
Multicast TTL threshold: 1
Forwarding code: NO_ERROR
Time used (s): 50
Field Description
Number of the hop. 0 represents the last hop, -1 represents the
n
hop before the last hop, and so on.
Incoming interface address Incoming interface of the multicast data.
Forwarded packets for the (S, G) pair Statistics for forwarded (S, G) packets.
20
mtrace v2
Use mtrace v2 to trace a multicast path through mtrace2.
Syntax
mtrace v2 { source-address | group-address } * [ destination address | port
number | wait-time time | max-hop count ] * [ verbose ]
Views
Any view
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source by its IP address.
group-address: Specifies a multicast group by its IP address, in the range of 224.0.1.0 to
239.255.255.255.
destination address: Specifies the destination address of mtrace. The default destination
address is 224.0.0.2.
port number: Specifies a UDP port number for mtrace2, in the range of 1024 to 49151. The default
value is 10240.
wait-time time: Specifies the length of time that the client waits for a Reply message. The value
range for the time argument is 1 to 65535 seconds and the default value is 10 seconds. If the client
does not receive a Reply message within the waiting time, the client initiates a hop-by-hop mtrace.
max-hop count: Specifies the maximum number of the hops to be traced. The value range for the
count argument is 1 to 255 and the default value is 255. If the maximum number of hops is reached
on a device, the device directly sends an mtrace2 Reply message to the client and the mtrace is
terminated.
verbose: Displays detailed information about mtrace. If you do not specify this keyword, the
command displays brief information about mtrace.
Usage guidelines
To perform a non-group-specific mtrace, specify a multicast source and a destination. The mtrace
starts from the destination and ends with the device directly connected to the multicast source.
To perform a non-source-specific mtrace, specify a multicast group and a destination. The mtrace
starts from the destination and ends at the RP associated with the multicast group.
To perform a source-and-group-specific mtrace, specify both a multicast source and a multicast
group. If you also specify a destination, the mtrace starts from the destination and ends at the device
directly connected to the multicast source. If you do not specify a destination, the mtrace starts from
the upstream device of the client and ends at the device directly connected to the multicast source.
An mtrace process stops if the maximum number of the hops to be traced is reached.
If the client does not receive a Reply message within the waiting time, the client initiates a
hop-by-hop mtrace to determine which device on the path encountered an error. It sends a Query
message with the hops field set to 1 and waits for a Reply message. If the client receives a Reply
message within the waiting time, it sends a Query message with the hops field value increased by 1
and waits for a Reply message. This process continues until the client does not receive a Reply
message within the waiting time any more.
21
Examples
# Use mtrace2 to trace the path along which multicast data of group 225.2.1.1 travels from source
10.11.5.24 to destination 192.168.2.2 and display brief mtrace information.
<Sysname> mtrace v2 10.11.5.24 225.2.1.1 destination 192.168.2.2
Mtrace from 10.11.5.24 to 192.168.2.2 via group 225.2.1.1, 255 hops at most, press
CTRL_C to break.
Querying full reverse path...
Field Description
Number of the hop. 0 represents the last hop, -1 represents the hop
Hop
before the last hop, and so on.
Incoming address Incoming interface of the multicast data.
22
Field Description
• RPF_IF—The mtrace message arrived on the expected RPF
interface for the multicast data.
• NO_MULTICAST—The mtrace message arrived on an interface
that is not enabled with IP multicast.
• NO_SPACE—No space is available for inserting a response
data block in the packet.
# Use mtrace2 to trace the path along which multicast data of group 225.2.1.1 travels from source
10.11.5.24 to destination 192.168.2.2 and display detailed mtrace information.
<Sysname> mtrace v2 10.11.5.24 225.2.1.1 destination 192.168.2.2 verbose
Mtrace from 10.11.5.24 to 192.168.2.2 via group 225.2.1.1, 255 hops at most, use query
ID 12345, client port 50001, press CTRL_C to break.
Querying full reverse path...
Field Description
Number of the hop. 0 represents the last hop, -1
n
represents the hop before the last hop, and so on.
Incoming interface address Incoming interface of the multicast data.
23
Field Description
Statistics of packets forwarded through the outgoing
Output multicast packets
interface of the multicast data.
Forwarded packets for the (S, G) pair Statistics of forwarded (S, G) packets.
Related commands
mtrace-service port
multicast boundary
Use multicast boundary to configure a multicast forwarding boundary.
Use undo multicast boundary to delete a multicast forwarding boundary.
Syntax
multicast boundary group-address { mask-length | mask }
undo multicast boundary { group-address { mask-length | mask } | all }
Default
No multicast forwarding boundaries are configured on an interface.
24
Views
Interface view
Predefined user roles
network-admin
Parameters
group-address: Specifies a multicast group address in the range of 224.0.0.0 to
239.255.255.255.
mask-length: Specifies an address mask length in the range of 4 to 32.
mask: Specifies an address mask.
all: Specifies all forwarding boundaries configured on the interface.
Usage guidelines
A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified
address range. If the destination address of a multicast packet matches the set boundary condition,
the packet is not forwarded.
You can configure an interface as a multicast forwarding boundary for different multicast group
ranges by executing this command multiple times on the interface.
You do not need to enable IP multicast routing before you execute this command.
Assume that Set A and Set B are multicast forwarding boundary sets with different address ranges,
and B is a subset of A. A takes effect on the interface no matter whether A is configured earlier or
later than B.
Examples
# Configure VLAN-interface 100 as the forwarding boundary of multicast groups in the range of
239.2.0.0/16.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] multicast boundary 239.2.0.0 16
Related commands
display multicast boundary
25
Predefined user roles
network-admin
Usage guidelines
For this command to take effect, you must clear all multicast forwarding entries with the super VLAN
interface as the incoming interface after executing this command. To clear multicast forwarding
entries, use the reset multicast forwarding-table command.
Examples
# Enable multicast forwarding between sub-VLANs that are associated with the super VLAN 2.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] multicast forwarding supervlan community
Related commands
reset multicast forwarding-table
multicast routing
Use multicast routing to enable IP multicast routing and enter MRIB view.
Use undo multicast routing to disable IP multicast routing.
Syntax
multicast routing
undo multicast routing
Default
IP multicast routing is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Other Layer 3 multicast commands take effect only when IP multicast routing is enabled.
The device does not forward multicast packets before IP multicast routing is enabled.
Examples
# Enable IP multicast routing, and enter MRIB view.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib]
26
Views
User view
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to
239.255.255.255.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command clears multicast fast forwarding entries for the master device.
all: Specifies all multicast fast forwarding entries.
Examples
# Clear all multicast fast forwarding entries.
<Sysname> reset multicast fast-forwarding cache all
# Clear the multicast fast forwarding entry for multicast source and group (20.0.0.2, 225.0.0.2).
<Sysname> reset multicast fast-forwarding cache 20.0.0.2 225.0.0.2
Related commands
display multicast fast-forwarding cache
Related commands
display multicast forwarding event
27
Views
User view
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to
239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group
address, the value range for this argument is 4 to 32. For a multicast source address, the value range
for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified
incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast forwarding entries.
Usage guidelines
When you clear a multicast forwarding entry, the associated multicast routing entry is also cleared.
Examples
# Clear multicast forwarding entries for multicast group 225.5.4.3.
<Sysname> reset multicast forwarding-table 225.5.4.3
Related commands
display multicast forwarding-table
28
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast routing entries.
Usage guidelines
When you clear a multicast routing entry, the associated multicast forwarding entry is also cleared.
Examples
# Clear multicast routing entries for multicast group 225.5.4.3.
<Sysname> reset multicast routing-table 225.5.4.3
Related commands
display multicast routing-table
29
Contents
IGMP commands ··························································································· 1
display igmp group ····································································································································· 1
display igmp interface ································································································································ 4
display igmp proxy group ··························································································································· 7
display igmp proxy routing-table ················································································································ 8
display igmp ssm-mapping······················································································································· 11
dscp·························································································································································· 11
igmp ························································································································································· 12
igmp enable·············································································································································· 12
igmp fast-leave ········································································································································· 13
igmp group-policy ····································································································································· 14
igmp last-member-query-count ················································································································ 15
igmp last-member-query-interval ············································································································· 16
igmp max-response-time·························································································································· 17
igmp non-stop-routing ······························································································································ 17
igmp other-querier-present-interval ·········································································································· 18
igmp proxy enable ···································································································································· 18
igmp proxy forwarding ······························································································································ 19
igmp query-interval··································································································································· 20
igmp robust-count ···································································································································· 20
igmp startup-query-count ························································································································· 21
igmp startup-query-interval ······················································································································ 22
igmp static-group······································································································································ 22
igmp version ············································································································································· 23
last-member-query-count (IGMP view) ···································································································· 24
last-member-query-interval (IGMP view) ································································································· 24
max-response-time (IGMP view)·············································································································· 25
other-querier-present-interval (IGMP view) ······························································································ 26
proxy multipath (IGMP view) ···················································································································· 26
query-interval (IGMP view)······················································································································· 27
reset igmp group ······································································································································ 28
robust-count (IGMP view) ························································································································ 28
ssm-mapping (IGMP view) ······················································································································· 29
startup-query-count (IGMP view) ············································································································· 30
startup-query-interval (IGMP view) ·········································································································· 31
i
IGMP commands
display igmp group
Use display igmp group to display information about IGMP multicast groups (multicast groups
that hosts have joined through IGMP).
Syntax
display igmp group [ group-address | interface interface-type
interface-number ] [ static | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to
239.255.255.255. If you do not specify a multicast group, this command displays information about
all IGMP multicast groups.
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays information about IGMP multicast
groups for all interfaces.
static: Specifies IGMP multicast groups that hosts have joined statically. If you do not specify this
keyword, the command displays information about IGMP multicast groups that hosts have joined
dynamically.
verbose: Displays detailed information.
Examples
# Display information about IGMP multicast groups that hosts have dynamically joined.
<Sysname> display igmp group
IGMP groups in total: 3
Vlan-interface1(10.10.1.20):
IGMP groups reported in total: 3
Group address Last reporter Uptime Expires
225.1.1.1 10.10.1.10 00:02:04 00:01:15
225.1.1.2 10.10.1.10 00:02:04 00:01:15
225.1.1.3 10.10.1.10 00:02:04 00:01:15
Field Description
IGMP groups in total Total number of IGMP multicast groups.
Total number of IGMP multicast groups that hosts attached to the
IGMP groups reported in total
interface have joined dynamically.
Group address Multicast group address.
Last reporter Address of the last host that reported its membership to the
1
Field Description
multicast group.
# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically
joined. In this example, the switch is configured with IGMPv3.
<Sysname> display igmp group 232.1.1.1 verbose
Vlan-interface1(10.10.1.20):
IGMP groups reported in total: 3
Group: 232.1.1.1
Uptime: 00:00:34
Exclude expires: 00:04:16
Mapping expires: 00:02:16
Last reporter: 10.10.1.10
Last-member-query-counter: 0
Last-member-query-timer-expiry: Off
Mapping last-member-query-counter: 0
Mapping last-member-query-timer-expiry: Off
Group mode: Exclude
Version1-host-present-timer-expiry: Off
Version2-host-present-timer-expiry: 00:02:11
Mapping version1-host-present-timer-expiry: Off
Source list (sources in total: 1):
Source: 10.1.1.1
Uptime: 00:00:03
V3 expires: 00:04:16
Mapping expires: 00:02:16
Last-member-query-counter: 0
Last-member-query-timer-expiry: Off
Field Description
Total number of IGMP multicast groups that hosts attached to the
IGMP groups reported in total
interface have joined dynamically.
2
Field Description
Remaining time for the last member query timer for the multicast
Last-member-query-timer-expiry
group. This field displays Off if the timer is disabled.
Remaining time for the IGMPv1 host present timer when the device
is configured with IGMP SSM mappings.
Mapping
This field displays Off if the timer is disabled.
version1-host-present-timer-expiry
This field is displayed only when the device is configured with IGMP
SSM mappings.
3
Field Description
Remaining time for the multicast source specified in IGMP SSM
mappings.
Mapping expires
This field is displayed only when the device is configured with IGMP
SSM mappings.
Number of IGMP group-specific queries or IGMP
group-and-source-specific queries sent for the multicast source
Last-member-query-counter and group.
This field is displayed only when the device runs IGMPv3 or is
configured with IGMP SSM mappings.
Remaining time for the last member query timer for the multicast
source and group.
Last-member-query-timer-expiry This field displays Off if the timer is disabled.
This field is displayed only when the device runs IGMPv3 or is
configured with IGMP SSM mappings.
# Display information about IGMP multicast groups that hosts have statically joined.
<Sysname> display igmp group static
Entries in total: 2
Group address Source address Interface Expires
225.1.1.1 0.0.0.0 Vlan1 Never
225.2.2.2 1.1.1.1 Vlan1 Never
Field Description
Total number of the multicast groups that hosts have joined
Entries in total
statically.
Group address Multicast group address.
Source address Multicast source address.
Interface Interface name.
Remaining lifetime for the multicast group. This field always
Expires
displays Never because the multicast group never expires.
Related commands
reset igmp group
4
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do
not specify an interface, this command displays IGMP information for all IGMP-enabled interfaces.
host: Displays information about the interfaces enabled with the IGMP host feature. If you do not
specify this keyword, the command displays IGMP information for interfaces enabled with IGMP and
those enabled with the IGMP host feature. For more information about the IGMP host feature, see
VXLAN Configuration Guide.
proxy: Displays the IGMP proxy interface information. If you do not specify this keyword, the
command displays IGMP information about all interfaces.
verbose: Displays detailed IGMP information.
Examples
# Display detailed IGMP information for VLAN-interface 1 (non-proxy interface).
<Sysname> display igmp interface vlan-interface 1 verbose
Vlan-interface1(10.10.1.20):
IGMP is enabled.
IGMP version: 2
Query interval for IGMP: 125s
Other querier present time for IGMP: 255s
Maximum query response time for IGMP: 10s
Last member query interval: 1s
Last member query count: 2
Startup query interval: 31s
Startup query count: 2
General query timer expiry (hh:mm:ss): 00:00:54
Querier for IGMP: 10.10.1.20 (This router)
IGMP activity: 1 join(s), 0 leave(s)
Multicast routing on this interface: Enabled
Robustness: 2
Require-router-alert: Disabled
Fast-leave: Disabled
Startup-query: Off
Other-querier-present-timer-expiry (hh:mm:ss): Off
IGMP groups reported in total: 1
# Display detailed IGMP information for all interfaces enabled with the IGMP host feature.
<Sysname> display igmp interface host verbose
Vlan-interface3(30.10.1.20):
IGMP host is enabled.
IGMP version: 2
5
Multicast routing on this interface: Enabled
Require-router-alert: Disabled
Version1-querier-present-timer-expiry (hh:mm:ss): Off
Field Description
Vlan-interface1(10.10.1.20) Interface and its IP address.
IGMP is enabled IGMP is enabled on the interface.
IGMP version Version of IGMP that the interface runs.
Query interval for IGMP IGMP general query interval, in seconds.
Other querier present time for IGMP IGMP other querier present interval, in seconds.
Maximum query response time for IGMP Maximum response time for IGMP general queries, in seconds.
Interval for sending IGMP group-specific queries or IGMP
Last member query interval
group-and-source-specific queries, in seconds.
Remaining time for the IGMP general query timer. This field
General query timer expiry
displays Off if the timer is disabled.
6
Field Description
Whether the IGMP querier sends IGMP general queries at the
startup query interval on startup:
Startup-query • On—The IGMP querier performs the above action.
• Off—The IGMP querier does not perform the above
action.
Remaining time for the other querier present timer. This field
Other-querier-present-timer-expiry
displays Off if the timer is disabled.
Total number of multicast groups that the interface has joined
dynamically.
IGMP groups reported in total
This field is not displayed if the interface does not join multicast
groups.
IGMP proxy is enabled IGMP proxying is enabled on the interface.
IGMP host is enabled The IGMP host feature is enabled on the interface.
Remaining time for the IGMPv1 querier present timer. This field
Version1-querier-present-timer-expiry
displays Off if the timer is disabled.
7
225.1.1.2 Idle Off
# Display detailed information about multicast group 225.1.1.1 maintained by the IGMP proxy.
<Sysname> display igmp proxy group 225.1.1.1 verbose
Vlan-interface1(1.1.1.20):
IGMP proxy group records in total: 2
Group: 225.1.1.1
Group mode: Include
Member state: Delay
Expires: 00:00:02
Source list (sources in total: 1):
1.1.1.1
Field Description
Total number of multicast groups maintained by the IGMP
IGMP groups records in total
proxy.
8
Parameters
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast
source, this command displays multicast routing entries for all multicast sources maintained by the
IGMP proxy.
group-address: Specifies a multicast group address by its IP address in the range of 224.0.1.0 to
239.255.255.255. If you do not specify a multicast group, this command displays multicast routing
entries for all multicast groups maintained by the IGMP proxy.
mask-length: Specifies a mask length of the multicast group address or multicast source address.
For a multicast source address, the value range for this argument is 0 to 32. For a multicast group
address, the value range for this argument is 4 to 32. The default value is 32 in both cases.
mask: Specifies a mask of the multicast group address or multicast source address. The default
value is 255.255.255.255.
verbose: Displays detailed information about multicast routing entries maintained by the IGMP
proxy.
Examples
# Display multicast routing entries maintained by the IGMP proxy.
<Sysname> display igmp proxy routing-table
Total 1 (*, G) entries, 2 (S, G) entries.
(172.168.0.12, 227.0.0.1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: IGMP
(*, 225.1.1.1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: STATIC
(2.2.2.2, 225.1.1.1)
Upstream interface: Vlan-interface1
Downstream interfaces (2 in total):
1: LoopBack1
Protocol: STATIC
2: Vlan-interface2
Protocol: PROXY
# Display detailed information about multicast routing entries maintained by the IGMP proxy.
<Sysname> display igmp proxy routing-table verbose
Total 1 (*, G) entries, 2 (S, G) entries.
(172.168.0.12, 227.0.0.1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: IGMP
9
Querier state: Querier
Join/Prune state:Join
(*, 225.1.1.1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: STATIC
Querier state: Querier
Join/Prune state:Join
(2.2.2.2, 225.1.1.1)
Upstream interface: Vlan-interface1
Downstream interfaces (2 in total):
1: LoopBack1
Protocol: STATIC
Querier state: Querier
Join/Prune state: Join
2: Vlan-interface2
Protocol: PROXY
Querier state: Querier
Join/Prune state: Join
Field Description
Total number of (*, G) entries, and the total number of (S, G)
Total 1 (*, G) entries, 2 (S, G) entries
entries.
10
Field Description
• STATIC—Static IGMP.
Querier state:
Querier state • Querier.
• Non-querier.
Joined or pruned state of the interface:
• NI—Default state.
Join/Prune state
• Join—Joined state.
• Prune—Pruned state.
Field Description
Group Multicast group address.
Source list List of multicast source addresses.
dscp
Use dscp to set the DSCP value for outgoing IGMP protocol packets.
Use undo dscp to restore the default.
11
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing IGMP protocol packets.
Views
IGMP view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the ToS field of an IP packet to determine the transmission priority of
the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value to 63 for outgoing IGMP protocol packets.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp] dscp 63
igmp
Use igmp to enter IGMP view.
Use undo igmp to delete the configurations in IGMP view.
Syntax
igmp
undo igmp
Views
System view
Predefined user roles
network-admin
Examples
# Enter IGMP view.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp]
igmp enable
Use igmp enable to enable IGMP on an interface.
Use undo igmp enable to disable IGMP on an interface.
12
Syntax
igmp enable
undo igmp enable
Default
IGMP is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IP multicast routing is enabled on the public network or for the
VPN instance to which the interface belongs.
Other IGMP configurations on the interface take effects only when IGMP is enabled on the interface.
Examples
# Enable IP multicast routing, and enable IGMP on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp enable
Related commands
multicast routing
igmp fast-leave
Use igmp fast-leave to enable fast-leave processing on an interface.
Use undo igmp fast-leave to disable fast-leave processing on an interface.
Syntax
igmp fast-leave [ group-policy ipv4-acl-number ]
undo igmp fast-leave
Default
Fast-leave processing is disabled. The IGMP querier sends IGMP group-specific or
group-and-source-specific queries after receiving a leave message.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. If you
specify an ACL, the fast-leave processing feature takes effect only on the multicast groups that the
ACL permits. The feature takes effect on all multicast groups when one of the following conditions
exists:
13
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
The fast-leave processing feature enables an IGMP querier to suppress IGMP group-specific or
group-and-source-specific queries upon receiving IGMP leave messages permitted by the ACL.
When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
Examples
# Enable fast-leave processing on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp fast-leave
igmp group-policy
Use igmp group-policy to configure a multicast group policy on an interface to control the
multicast groups that hosts attached to the interface can join.
Use undo igmp group-policy to delete the multicast group policy on an interface.
Syntax
igmp group-policy { ipv4-acl-number | name ipv4-acl-name }
[ version-number ]
undo igmp group-policy
Default
No multicast group policy exists on an interface. Hosts attached to the interface can join any
multicast groups.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000
to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL with the specified
number does not exist or does not have valid rules, hosts cannot join any multicast groups.
name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a case-insensitive
string of 1 to 63 characters. The ACL name must begin with letters and it cannot be all. Hosts can join
only the multicast groups that the ACL permits. If the ACL with the specified name does not exist or
does not have valid rules, hosts cannot join any multicast groups.
version-number: Specifies an IGMP version in the range of 1 to 3. By default, this command
takes effect on IGMP reports of all versions.
14
Usage guidelines
A multicast group policy filters IGMP reports to control the multicast groups that the hosts can join.
This command does not take effect on static member interfaces because static member interfaces
do not send IGMP reports.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-wildcard option specifies a
multicast group address.
• In an advanced ACL, the source source-address source-wildcard option specifies a
multicast source address. The destination dest-address dest-wildcard option
specifies a multicast group address.
To match the following IGMP reports, set the source source-address
source-wildcard option to 0.0.0.0:
IGMPv1 and IGMPv2 reports.
IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a multicast group policy on VLAN-interface 100 so that hosts attached to the interface
can join only multicast group 225.1.1.1.
<Sysname> system-view
[Sysname] acl basic 2005
[Sysname-acl-ipv4-basic-2005] rule permit source 225.1.1.1 0
[Sysname-acl-ipv4-basic-2005] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp group-policy 2005
igmp last-member-query-count
Use igmp last-member-query-count to set the IGMP last member query count on an
interface.
Use undo igmp last-member-query-count to restore the default.
Syntax
igmp last-member-query-count count
undo igmp last-member-query-count
Default
The IGMP last member query count equals the IGMP querier's robustness variable.
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an IGMP last member query count in the range of 1 to 255.
15
Usage guidelines
You can set the IGMP last member query count for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP last member query count to 6 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp last-member-query-count 6
Related commands
last-member-query-count (IGMP view)
igmp last-member-query-interval
Use igmp last-member-query-interval to set the IGMP last member query interval on an
interface.
Use undo igmp last-member-query-interval to restore the default.
Syntax
igmp last-member-query-interval interval
undo igmp last-member-query-interval
Default
The IGMP last member query interval is 1 second.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.
Usage guidelines
You can set the IGMP last member query interval for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP last member query interval to 6 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp last-member-query-interval 6
Related commands
last-member-query-interval (IGMP view)
16
igmp max-response-time
Use igmp max-response-time to set the maximum response time for IGMP general queries on
an interface.
Use undo igmp max-response-time to restore the default.
Syntax
igmp max-response-time time
undo igmp max-response-time
Default
The maximum response time for IGMP general queries is 10 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
time: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174
seconds.
Usage guidelines
You can set the maximum response time for an interface in interface view or globally for all interfaces
in IGMP view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the maximum response time for IGMP general queries to 25 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp max-response-time 25
Related commands
max-response-time (IGMP view)
igmp non-stop-routing
Use igmp non-stop-routing to enable IGMP NSR.
Use undo igmp non-stop-routing to disable IGMP NSR.
Syntax
igmp non-stop-routing
undo igmp non-stop-routing
Default
IGMP NSR is disabled.
Views
System view
17
Predefined user roles
network-admin
Examples
# Enable IGMP NSR.
<Sysname> system-view
[Sysname] igmp non-stop-routing
igmp other-querier-present-interval
Use igmp other-querier-present-interval to set the IGMP other querier present timer on
an interface.
Use undo igmp other-querier-present-interval to restore the default.
Syntax
igmp other-querier-present-interval interval
undo igmp other-querier-present-interval
Default
The IGMP other querier present timer is calculated by using the following formula:
[ IGMP general query interval ] × [ IGMP querier's robustness variable ] + [ maximum response
time for IGMP general queries ] / 2.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP other querier present timer in the range of 1 to 31744 seconds.
Usage guidelines
You can set the IGMP other querier present timer for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP other querier present timer to 125 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp other-querier-present-interval 125
Related commands
other-querier-present-interval (IGMP view)
18
Syntax
igmp proxy enable
undo igmp proxy enable
Default
IGMP proxying is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IP multicast routing is enabled on the public network or for the
VPN instance to which the interface belongs.
Examples
# Enable IP multicast routing, and enable IGMP proxying on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp proxy enable
Related commands
multicast routing
19
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp proxy forwarding
igmp query-interval
Use igmp query-interval to set the IGMP general query interval on an interface.
Use undo igmp query-interval to restore the default.
Syntax
igmp query-interval interval
undo igmp query-interval
Default
The IGMP general query interval is 125 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP general query interval in the range of 1 to 31744 seconds.
Usage guidelines
You can set the IGMP general query interval for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP general query interval to 60 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp query-interval 60
Related commands
query-interval (IGMP view)
igmp robust-count
Use igmp robust-count to set the IGMP querier's robustness variable on an interface.
Use undo igmp robust-count to restore the default.
Syntax
igmp robust-count count
undo igmp robust-count
Default
The IGMP querier's robustness variable is 2.
20
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.
Usage guidelines
The IGMP querier's robustness variable defines the number of times to retransmit queries if packet
loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases
timeout time for multicast groups.
You can set the IGMP querier's robustness variable for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP querier's robustness variable to 5 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp robust-count 5
Related commands
robust-count (IGMP view)
igmp startup-query-count
Use igmp startup-query-count to set the IGMP startup query count on an interface.
Use undo igmp startup-query-count to restore the default.
Syntax
igmp startup-query-count count
undo igmp startup-query-count
Default
The IGMP startup query count equals the IGMP querier's robustness variable.
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an IGMP startup query count in the range of 1 to 255.
Usage guidelines
You can set the IGMP startup query count for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP startup query count to 5 on VLAN-interface 100.
21
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp startup-query-count 5
Related commands
startup-query-count (IGMP view)
igmp startup-query-interval
Use igmp startup-query-interval to set the IGMP startup query interval on an interface.
Use undo igmp startup-query-interval to restore the default.
Syntax
igmp startup-query-interval interval
undo igmp startup-query-interval
Default
The IGMP startup query interval equals one quarter of the IGMP general query interval.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP startup query interval in the range of 1 to 31744 seconds.
Usage guidelines
You can set the IGMP startup query interval for an interface in interface view or globally for all
interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the IGMP startup query interval to 100 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp startup-query-interval 100
Related commands
startup-query-interval (IGMP view)
igmp static-group
Use igmp static-group to configure an interface as a static group member of a multicast group.
Use undo igmp static-group to restore the default.
Syntax
igmp static-group group-address [ source source-address ]
undo igmp static-group { all | group-address [ source source-address ]
22
Default
An interface is not a static group member of multicast groups.
Views
Interface view
Predefined user roles
network-admin
Parameters
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to
239.255.255.255.
source source-address: Specifies a multicast source by its IP address. If you do not specify a
multicast source, this command configures an interface as a static member of the multicast groups
with all multicast source addresses.
all: Specifies all multicast groups that the interface has statically joined.
Usage guidelines
For multicast routing entries to be created, you must specify a multicast source if the specified
multicast group is in the SSM group range.
Examples
# Configure VLAN-interface 100 as a static group member of multicast group 224.1.1.1.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp static-group 224.1.1.1
# Configure VLAN-interface 100 as a static group member of multicast source and group
(192.168.1.1, 232.1.1.1).
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp static-group 232.1.1.1 source 192.168.1.1
igmp version
Use igmp version to specify an IGMP version on an interface.
Use undo igmp version to restore the default.
Syntax
igmp version version-number
undo igmp version
Default
The IGMP version on an interface is 2.
Views
Interface view
Predefined user roles
network-admin
Parameters
version-number: Specifies an IGMP version in the range of 1 to 3.
23
Examples
# Specify IGMP version 1 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp version 1
Related commands
igmp last-member-query-count
24
Views
IGMP view
Predefined user roles
network-admin
Parameters
interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.
Usage guidelines
You can set the IGMP last member query interval globally for all interfaces in IGMP view or for an
interface in interface view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the global IGMP last member query interval to 6 seconds.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp] last-member-query-interval 6
Related commands
igmp last-member-query-interval
25
[Sysname-igmp] max-response-time 25
Related commands
igmp max-response-time
Related commands
igmp other-querier-present-interval
26
Default
The load splitting feature is disabled on the IGMP proxy device.
Views
IGMP view
Predefined user roles
network-admin
Usage guidelines
Use this feature when the IGMP proxy device has multiple proxy interfaces. All proxy interfaces on
the IGMP proxy device share multicast traffic on a per-group basis. If you do not enable this feature,
only the proxy interface with the highest IP address forwards multicast data.
Examples
# Enable load splitting on the IGMP proxy device.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp] proxy multipath
Related commands
igmp query-interval
27
reset igmp group
Use reset igmp group to clear dynamic IGMP multicast group entries.
Syntax
reset igmp group { all | interface interface-type interface-number { all |
group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask |
mask-length } ] ] } }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all interfaces (the first all), or all IGMP multicast groups (the second all).
interface-type interface-number: Specifies an interface by its type and number.
group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to
239.255.255.255.
source-address: Specifies a multicast source address. If you do not specify a multicast source,
this command clears dynamic IGMP multicast group entries for all multicast source addresses.
mask: Specifies an address mask. The default is 255.255.255.255.
mask-length: Specifies an address mask length. The default is 32. For a multicast group address,
the value range for this argument is 4 to 32. For a multicast source address, the value range for this
argument is 0 to 32.
Usage guidelines
This command might interrupt the multicast information transmission.
Examples
# Clear dynamic IGMP multicast group entries for all interfaces.
<Sysname> reset igmp group all
# Clear all dynamic IGMP multicast group entries for VLAN-interface 100.
<Sysname> reset igmp group interface vlan-interface 100 all
# Clear the dynamic IGMP multicast group entry of group 225.0.0.1 for VLAN-interface 100.
<Sysname> reset igmp group interface vlan-interface 100 225.0.0.1
Related commands
display igmp group
28
Default
The IGMP querier's robustness variable is 2.
Views
IGMP view
Predefined user roles
network-admin
Parameters
count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.
Usage guidelines
The IGMP querier's robustness variable defines the number of times to retransmit queries if packet
loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases the
timeout time for multicast groups.
You can set the IGMP querier's robustness variable globally for all interfaces in IGMP view or for an
interface in interface view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the global IGMP querier's robustness variable to 5.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp] robust-count 5
Related commands
igmp robust-count
29
name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a case-insensitive
string of 1 to 63 characters. The ACL name must begin with letters and it cannot be all. Multicast
groups in IGMP reports permitted by the ACL are mapped to the specified multicast source. If the
ACL with the specified name does not exist or does not have valid rules, no multicast groups are
mapped to the specified multicast source.
all: Specifies all IGMP SSM mappings.
Usage guidelines
When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you repeat this command to configure IGMP SSM mappings with the same multicast source, only
the most recent configuration takes effect.
Examples
# Configure an IGMP SSM mapping with multicast source 125.1.1.1 and multicast group range
232.1.1.0/24.
<Sysname> system-view
[Sysname] acl basic 2001
[Sysname-acl-ipv4-basic-2001] rule permit source 232.1.1.1 0.0.0.255
[Sysname-acl-ipv4-basic-2001] quit
[Sysname] igmp
[Sysname-igmp] ssm-mapping 125.1.1.1 2001
Related commands
display igmp ssm-mapping
30
Usage guidelines
You can set the IGMP startup query count globally for all interfaces in IGMP view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the global IGMP startup query count to 5.
<Sysname> system-view
[Sysname] igmp
[Sysname-igmp] startup-query-count 5
Related commands
igmp startup-query-count
Related commands
igmp startup-query-interval
31
Contents
PIM commands ······························································································ 1
anycast-rp (PIM view) ································································································································ 1
auto-rp enable (PIM view) ·························································································································· 1
bidir-pim enable (PIM view)························································································································ 2
bidir-rp-limit (PIM view) ······························································································································ 2
bsm-fragment enable (PIM view) ··············································································································· 3
bsm-reflection enable (PIM view) ··············································································································· 4
bsr-policy (PIM view) ·································································································································· 4
c-bsr (PIM view) ········································································································································· 5
c-rp (PIM view) ··········································································································································· 6
crp-policy (PIM view) ·································································································································· 7
display interface register-tunnel ················································································································· 8
display pim bsr-info ·································································································································· 10
display pim claimed-route ························································································································ 12
display pim c-rp ········································································································································ 13
display pim df-info ···································································································································· 14
display pim interface ································································································································ 15
display pim neighbor ································································································································ 17
display pim routing-table ·························································································································· 19
display pim rp-info ···································································································································· 22
display pim statistics ································································································································ 24
dscp·························································································································································· 25
hello-option dr-priority (PIM view) ············································································································ 26
hello-option holdtime (PIM view) ·············································································································· 26
hello-option lan-delay (PIM view) ············································································································· 27
hello-option neighbor-tracking (PIM view) ································································································ 28
hello-option override-interval (PIM view) ·································································································· 28
holdtime join-prune (PIM view)················································································································· 29
jp-pkt-size (PIM view) ······························································································································· 30
pim ··························································································································································· 30
pim bfd enable·········································································································································· 31
pim bsr-boundary ····································································································································· 32
pim dm ····················································································································································· 32
pim hello-option dr-priority························································································································ 33
pim hello-option holdtime ························································································································· 33
pim hello-option lan-delay ························································································································ 34
pim hello-option neighbor-tracking ··········································································································· 35
pim hello-option override-interval ············································································································· 36
pim holdtime join-prune ···························································································································· 36
pim join-policy ·········································································································································· 37
pim neighbor-policy ·································································································································· 39
pim non-stop-routing ································································································································ 40
pim passive ·············································································································································· 40
pim require-genid ····································································································································· 41
pim sm······················································································································································ 41
pim state-refresh-capable ························································································································ 42
pim timer graft-retry ·································································································································· 42
pim timer hello ·········································································································································· 43
pim timer join-prune ································································································································· 43
pim triggered-hello-delay·························································································································· 44
register-policy (PIM view) ························································································································· 45
register-suppression-timeout (PIM view)·································································································· 46
register-whole-checksum (PIM view) ······································································································· 46
snmp-agent trap enable pim ···················································································································· 47
source-lifetime (PIM view) ························································································································ 48
source-policy (PIM view) ·························································································································· 48
spt-switch-threshold (PIM view) ··············································································································· 49
i
ssm-policy (PIM view) ······························································································································ 50
state-refresh-interval (PIM view) ·············································································································· 51
state-refresh-rate-limit (PIM view) ············································································································ 52
state-refresh-ttl (PIM view) ······················································································································· 52
static-rp (PIM view) ·································································································································· 53
timer hello (PIM view)······························································································································· 54
timer join-prune (PIM view) ······················································································································ 55
ii
PIM commands
anycast-rp (PIM view)
Use anycast-rp to add an anycast RP member to an Anycast RP set.
Use undo anycast-rp to remove an anycast RP member from an Anycast RP set.
Syntax
anycast-rp anycast-rp-address member-address
undo anycast-rp anycast-rp-address member-address
Default
No Anycast RP sets exist.
Views
PIM view
Predefined user roles
network-admin
Parameters
anycast-rp-address: Specifies an Anycast RP address. It must be a legal unicast IP address
that is not in the range of 127.0.0.0/8.
member-address: Specifies an Anycast RP member address. It must be a legal unicast IP
address that is not in the range of 127.0.0.0/8 and must be different from the Anycast RP address.
Usage guidelines
To add multiple RP member addresses to an Anycast RP set, execute this command multiple times
with the same Anycast RP address but different RP member addresses.
To configure multiple Anycast RP sets, execute this command multiple times with different Anycast
RP addresses.
Examples
# Add Anycast RP members 1.1.0.1 and 1.2.0.1 to Anycast RP set 1.1.0.0.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] anycast-rp 1.1.0.0 1.1.0.1
[Sysname-pim] anycast-rp 1.1.0.0 1.2.0.1
Related commands
display pim rp-info
1
undo auto-rp enable
Default
Auto-RP listening is disabled.
Views
PIM view
Predefined user roles
network-admin
Examples
# Enable Auto-RP listening.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] auto-rp enable
Related commands
multicast routing
2
Use undo bidir-rp-limit to restore the default.
Syntax
bidir-rp-limit limit
undo bidir-rp-limit
Default
The maximum number of BIDIR-PIM RPs is 6.
Views
PIM view
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of BIDIR-PIM RPs, in the range of 1 to 32.
Usage guidelines
In a BIDIR-PIM domain, one DF election per RP is implemented on all PIM interfaces. To avoid
unnecessary DF elections, do not configure multiple BIDIR-PIM RPs.
This command sets a limit on the number of BIDIR-PIM RPs. If the number of RPs exceeds the limit,
excess RPs can be used only for DF election rather than multicast data forwarding.
Examples
# Set the maximum number of BIDIR-PIM RPs to 3.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] bidir-rp-limit 3
3
<Sysname> system-view
[Sysname] pim
[Sysname-pim] undo bsm-fragment enable
4
Parameters
ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999.
Usage guidelines
A BSR policy filters bootstrap messages to guard against BSR spoofing.
When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a BSR address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a BSR policy so that only the devices on subnet 10.1.1.0/24 can act as the BSR.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 10.1.1.0 0.0.0.255
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] pim
[Sysname-pim] bsr-policy 2000
Related commands
c-bsr (PIM view)
5
hash-length hash-length: Specifies a hash mask length in the range of 0 to 32. The default
setting is 30.
priority priority: Specifies a C-BSR priority in the range of 0 to 255. The default setting is 64.
The greater the value, the higher the priority.
Usage guidelines
If you execute this command for a zone multiple times, the most recent configuration takes effect.
You can configure the same C-BSR for different zones.
Examples
# Configure the interface with IP address 1.1.1.1 as a C-BSR for the global-scoped zone.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] c-bsr 1.1.1.1
6
advertisement messages that the ACL permits. The C-RP is designated to all IPv4 multicast groups
when one of the following conditions exists:
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
holdtime hold-time: Specifies a C-RP lifetime in the range of 1 to 65535 seconds. The default
value is 150 seconds.
priority priority: Specifies a C-RP priority in the range of 0 to 255. The default setting is 192.
The greater the value, the lower the priority.
bidir: Specifies BIDIR-PIM to which the C-RP is designated. If you do not specify this keyword, the
C-RP provides services for PIM-SM.
Usage guidelines
To designate a C-RP to multiple multicast group ranges, create multiple rules that specify different
multicast group ranges in the ACL.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• For the rule to take effect, do not specify the vpn-instance vpn-instance option.
• The source source-address source-wildcard option specifies a multicast group
range. A-CRP advertisement message is permitted if the multicast group address in the
message matches the source option.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command by using the same C-RP address multiple times, the most recent
configuration takes effect.
Examples
# Configure the interface with IP address 1.1.1.1 as a C-RP for multicast group ranges 225.1.0.0/16
and 226.2.0.0/16 and set its priority to 10.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.0.0 0.0.255.255
[Sysname-acl-ipv4-basic-2000] rule permit source 226.2.0.0 0.0.255.255
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] pim
[Sysname-pim] c-rp 1.1.1.1 group-policy 2000 priority 10
7
Views
PIM view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 advanced ACL number in the range of 3000 to 3999.
Usage guidelines
A C-RP policy filters C-RP advertisement messages to guard against C-RP spoofing.
The device uses only the prefixes of the multicast group ranges in advertisement messages to match
the destination field in ACL rules. For example, the multicast group range in an advertisement
message is 224.1.0.0/16. If the prefix 224.1.0.0 is in the range specified by the destination field of an
ACL rule, the specified C-RPs are designated to this multicast group range.
When you configure a rule in the IPv4 advanced ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies an RP address.
• The destination dest-address dest-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a C-RP policy so that only devices in the range of 1.1.1.1/24 can be C-RPs for the
groups in the range of 225.1.1.0/24.
<Sysname> system-view
[Sysname] acl advanced 3000
[Sysname-acl-ipv4-adv-3000] rule permit ip source 1.1.1.1 0.0.0.255 destination 225.1.1.0
0.0.0.255
[Sysname-acl-ipv4-adv-3000] quit
[Sysname] pim
[Sysname-pim] crp-policy 3000
Related commands
c-rp (PIM view)
8
Parameters
register-tunnel [ interface-number ]: Specifies a register-tunnel interface by its number.
The device has only one register-tunnel interface, Register-Tunnel 0. If you specify the
register-tunnel keyword, this command displays information about Register-Tunnel 0
regardless of whether you specify an interface number. If you do not specify the
register-tunnel keyword, this command displays information about all interfaces.
brief: Displays brief information. If you do not specify this keyword, the command displays detailed
information.
description: Displays the full interface description. If you do not specify this keyword, the
command displays only the first 27 characters of the interface description.
down: Displays information about the interfaces in down state and the reasons why the interfaces
are down. If you do not specify this keyword, the command displays information about interfaces in
all states.
Usage guidelines
The register-tunnel interface is a virtual interface that is automatically created by the system. You
cannot configure it or delete it, but you can display the interface information by using this command.
In the initial stage of multicast source registration, the register-tunnel interface is used to establish a
channel between the source-side DR and the RP to transmit multicast register messages. The
process of initial source registration is as follows:
1. After receiving the first multicast data from the source, the source-side DR encapsulates the
multicast data into a register message. Then, it forwards the message to the RP through the
register-tunnel interface.
2. The register message reaches RP on the register-tunnel interface on the RP. The RP
decapsulates the register message and forwards the multicast data to the receiver hosts. At the
same time, the RP learns the IP address of the multicast source.
3. The RP sends a join message toward the multicast source to build an SPT.
4. After the SPT is built, the multicast data travels to the RP along the SPT rather than through the
register-tunnel interface.
Examples
# Display detailed information about Register-Tunnel 0.
<Sysname> display interface register-tunnel 0
Register-Tunnel0
Current state: UP
Line protocol state: DOWN
Description: Register-Tunnel0 Interface
Maximum transmission unit: 1536
Internet protocol processing: Disabled
Physical: Unknown
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops
Output: 0 packets, 0 bytes, 0 drops
9
REG0 UP -- --
Field Description
Current state Physical link state of the interface. This field always displays UP.
Line protocol state Data link layer state of interface. This field always displays DOWN.
Description Description of the interface. It is not configurable.
Maximum transmission unit MTU of the register-tunnel interface. It is not configurable.
Internet protocol processing: The interface is not assigned an IP address and cannot process IP
Disabled packets.
Physical type of the interface. This field always displays Unknown,
Physical
because the physical type of the interface is unknown.
Average incoming rate in the last 300 seconds. This field always displays
Last 300 seconds input rate
0.
Last 300 seconds output rate Average outgoing rate in the last 300 seconds. This field always displays 0.
Related command
reset counters interface register-tunnel
10
Examples
# Display BSR information.
<Sysname> display pim bsr-info
Scope: non-scoped
State: Accept Preferred
Bootstrap timer: 00:01:44
Elected BSR address: 12.12.12.1
Priority: 64
Hash mask length: 30
Uptime: 00:21:56
Scope: 239.4.0.0/16
State: Accept Any
Scope-zone expiry timer: 00:21:12
Scope: 239.1.0.0/16
State: Elected
Bootstrap timer: 00:00:26
Elected BSR address: 17.1.11.1
Priority: 64
Hash mask length: 30
Uptime: 02:53:37
Candidate BSR address: 17.1.11.1
Priority: 64
Hash mask length: 30
Scope: 239.2.2.0/24
State: Candidate
Bootstrap timer: 00:01:56
Elected BSR address: 61.2.37.1
Priority: 64
Hash mask length: 30
Uptime: 02:53:32
Candidate BSR address: 17.1.12.1
Priority: 64
Hash mask length: 30
Scope: 239.3.3.0/24
State: Pending
Bootstrap timer: 00:00:07
Candidate BSR address: 17.1.13.1
Priority: 64
Hash mask length: 30
Field Description
11
Field Description
Field Description
12
Field Description
• igp—IGP unicast route.
• egp—EGP unicast route.
• unicast (direct)—Direct unicast route.
• unicast—Other unicast route, such as static unicast
route.
• mbgp—MBGP route.
• multicast static—Static multicast route.
Total number of (S,G) or (*,G) dependent on Total number of (S, G) or (*, G) entries associated with the
this route entry RPF route and the entry list.
13
# Display information about the locally configured C-RPs.
<Sysname> display pim c-rp local
Candidate RP: 12.12.12.9(Loop1)
Priority: 192
HoldTime: 150
Advertisement interval: 60
Next advertisement scheduled at: 00:00:48
Field Description
Expires Remaining lifetime for the C-RP and the multicast group.
Candidate RP IP address of the locally configured C-RP.
Interval between two advertisement messages sent by the locally
Advertisement interval
configured C-RP.
Remaining time for the locally configured C-RP to send the next
Next advertisement scheduled at
advertisement message.
14
RP address: 12.12.12.12
Interface: Vlan-interface1
State : Win DF preference: 10
DF metric : 1562 DF uptime : 00:06:59
DF address: 30.1.1.11 (local)
Interface: Tunnel2, 100.1.1.12
State : Lose DF preference: 0
DF metric : 0 DF uptime : 00:06:59
DF address: 100.1.1.12
Field Description
15
Examples
# Display brief PIM information for all interfaces.
<Sysname> display pim interface
Interface NbrCnt HelloInt DR-Pri DR-Address
Vlan1 1 30 1 10.1.1.2
Vlan2 0 30 1 172.168.0.2 (local)
Vlan3 1 30 1 20.1.1.2
Field Description
16
Table 7 Command output
Field Description
17
Predefined user roles
network-admin
network-operator
Parameters
neighbor-address: Specifies a PIM neighbor by its IP address. If you do not specify a PIM
neighbor, this command displays information about all PIM neighbors.
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays PIM neighbor information on all
interfaces.
verbose: Displays detailed PIM neighbor information. If you do not specify this keyword, the
command displays brief PIM neighbor information.
Examples
# Display brief information about all PIM neighbors.
<Sysname> display pim neighbor
Total Number of Neighbors = 2
# Display detailed information about the PIM neighbor with IP address 11.110.0.20.
<Sysname> display pim neighbor 11.110.0.20 verbose
Neighbor: 11.110.0.20
Interface: Vlan-interface3
Uptime: 00:00:10
Expiry time: 00:00:30
DR Priority: 1
Generation ID: 0x2ACEFE15
Holdtime: 105 s
LAN delay: 500 ms
Override interval: 2500 ms
State refresh interval: 60 s
Neighbor tracking: Disabled
Bidirectional PIM: Enabled
Secondary address(es):
22.1.1.2
22.1.1.3
22.1.1.4
22.1.1.5
22.1.1.6
22.1.1.7
22.1.1.8
Field Description
18
Field Description
19
source-address: Specifies a multicast source by its IP address.
mask-length: Specifies an address mask length in the range of 0 to 32. The default value is 32.
mask: Specifies an address mask. The default value is 255.255.255.255.
flags flag-value: Specifies a flag. If you do not specify a flag, this command displays PIM
routing entries that contain all flags. The following lists the values for the flag-value argument
and their meanings:
• 2msdp: Specifies PIM routing entries to be contained in the next SA message to notify an
MSDP peer.
• act: Specifies PIM routing entries that have been used for routing data.
• del: Specifies PIM routing entries to be deleted.
• exprune: Specifies PIM routing entries containing outgoing interfaces pruned by other
multicast routing protocols.
• ext: Specifies PIM routing entries containing outgoing interfaces provided by other multicast
routing protocols.
• loc: Specifies PIM routing entries on the devices that reside on the same subnet as the
multicast source.
• msdp: Specifies PIM routing entries learned from MSDP SA messages.
• niif: Specifies PIM routing entries containing unknown incoming interfaces.
• nonbr: Specifies PIM routing entries with PIM neighbor lookup failure.
• rc: Specifies PIM routing entries that have received C-Multicast route information.
• rpt: Specifies PIM routing entries on the RPT branches where (S, G) prunes have been sent to
the RP.
• rq: Specifies PIM routing entries of the receiving side of the data-MDT switchover.
• spt: Specifies PIM routing entries on the SPT.
• sq: Specifies PIM routing entries of the originator side of data-MDT switchover.
• src-act: Specifies PIM routing entries that have received Source Active A-D route
information.
• swt: Specifies PIM routing entries in the process of RPT-to-SPT switchover.
• vxlan: Specifies VXLAN overlay entries maintained by PIM.
• wc: Specifies PIM routing entries with wildcards.
fsm: Displays detailed information about the finite state machine.
incoming-interface interface-type interface-number: Specifies an incoming
interface. If you do not specify an incoming interface, this command displays PIM routing entries that
contain all incoming interfaces.
mode mode-type: Specifies a PIM mode. If you do not specify a PIM mode, this command displays
PIM routing entries in all PIM modes. The available PIM modes include:
• bidir: Specifies BIDIR-PIM.
• dm: Specifies PIM-DM.
• sm: Specifies PIM-SM.
• ssm: Specifies PIM-SSM.
outgoing-interface { exclude | include | match } interface-type
interface-number: Specifies an outgoing interface. If you do not specify an outgoing interface,
20
this command displays PIM routing entries that contain all outgoing interfaces. Whether an outgoing
interface is contained in the PIM routing table depends on the following conditions:
• If you specify an excluded interface, this command displays PIM routing entries that do not
contain the specified outgoing interface.
• If you specify an included interface, this command displays PIM routing entries that contain the
specified outgoing interface.
• If you specify a matching interface, this command displays PIM routing entries that contain only
the specified outgoing interface.
Examples
# Display PIM routing entries.
<Sysname> display pim routing-table
Total 0 (*, G) entries; 1 (S, G) entries
(172.168.0.12, 227.0.0.1)
RP: 2.2.2.2
Protocol: pim-sm, Flag: SPT LOC ACT
UpTime: 02:54:43
Upstream interface: Vlan-interface1
Upstream neighbor: NULL
RPF prime neighbor: NULL
Downstream interface information:
Total number of downstream interfaces: 1
1: Vlan-interface2
Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47
Field Description
21
Field Description
• SQ—The entry triggers the default-MDT to data-MDT switchover.
• SRC-ACT—The entry has received Source Active A-D route
information.
• SWT—The entry is in the process of RPT-to-SPT switchover.
• VXLAN—The entry is a VXLAN overlay entry.
• WC—The entry contains a wildcard.
Uptime Length of time for which the (S, G) entry or (*, G) entry has been up.
Upstream interface Upstream (incoming) interface of the (S, G) entry or (*, G) entry.
Upstream neighbor Upstream neighbor of the (S, G) entry or (*, G) entry.
RPF neighbor of the (S, G) or (*, G) entry:
• For a (*, G) entry, if the RPF neighbor is the RP, the field displays
RPF prime neighbor NULL.
• For an (S, G) entry, if the RPF neighbor is a router that directly
connects to the multicast source, this field displays NULL.
22
Static RP address is: 3.3.3.5
Preferred: Yes
Configured ACL: 2003
Static RP information:
RP address ACL Mode Preferred
3.3.3.1 2000 pim-sm No
3.3.3.2 2001 pim-sm Yes
3.3.3.3 2002 pim-sm No
3.3.3.4 pim-sm No
3.3.3.5 2002 pim-sm Yes
Anycast-RP information:
RP address Member address State
3.3.3.5 1.1.0.1 Active
3.3.3.5 1.1.0.2 Local
3.3.3.5 1.2.0.1 Remote
Field Description
23
Field Description
24
SRM : 0 0 0 0
DF : 0 0 0 0
AutoRP : 0 0 0 0
Field Description
dscp
Use dscp to set the DSCP value for outgoing PIM protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value for outgoing PIM protocol packets is 48.
Views
PIM view
Predefined user roles
network-admin
25
Parameters
dscp-value: Specifies the DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the ToS field of an IP packet to determine the transmission priority of
the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value for outgoing PIM protocol packets to 63.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] dscp 63
Related commands
pim hello-option dr-priority
26
Syntax
hello-option holdtime time
undo hello-option holdtime
Default
The PIM neighbor lifetime is 105 seconds.
Views
PIM view
Predefined user roles
network-admin
Parameters
time: Specifies a PIM neighbor lifetime in the range of 1 to 65535 seconds. If you set the value to
65535 seconds, PIM neighbors are always reachable.
Usage guidelines
You can set the PIM neighbor lifetime globally for all interfaces in PIM view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the global PIM neighbor lifetime to 120 seconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] hello-option holdtime 120
Related commands
pim hello-option holdtime
27
Usage guidelines
You can set the PIM message propagation delay globally for all interfaces in PIM view or for an
interface in interface view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the global PIM message propagation delay on a shared-media LAN to 200 milliseconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] hello-option lan-delay 200
Related commands
hello-option override-interval (PIM view)
pim hello-option lan-delay
pim hello-option override-interval
Related commands
pim hello-option neighbor-tracking
28
Syntax
hello-option override-interval interval
undo hello-option override-interval
Default
The override interval is 2500 milliseconds.
Views
PIM view
Predefined user roles
network-admin
Parameters
interval: Specifies an override interval in the range of 1 to 65535 milliseconds.
Usage guidelines
You can set the override interval globally for all interfaces in PIM view or for an interface in interface
view. For an interface, the interface-specific configuration takes priority over the global configuration.
Examples
# Set the global override interval to 2000 milliseconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] hello-option override-interval 2000
Related commands
hello-option lan-delay (PIM view)
pim hello-option lan-delay
pim hello-option override-interval
29
Usage guidelines
You can set the joined/pruned state holdtime globally for all interfaces in PIM view or for an interface
in interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
To prevent the upstream neighbors from aging out, you must set the join/prune interval to be less
than the joined/pruned state holdtime.
Examples
# Set the global joined/pruned state holdtime to 280 seconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] holdtime join-prune 280
Related commands
pim holdtime join-prune
timer join-prune (PIM view)
pim
Use pim to enter PIM view.
Use undo pim to remove all configurations in PIM view.
Syntax
pim
30
undo pim
Views
System view
Predefined user roles
network-admin
Examples
# Enable IP multicast routing and enter PIM view.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] pim
[Sysname-pim]
Related commands
multicast routing-enable
Related commands
pim dm
pim sm
31
pim bsr-boundary
Use pim bsr-boundary to configure a PIM-SM domain border (a bootstrap message boundary).
Use undo pim bsr-boundary to restore the default.
Syntax
pim bsr-boundary
undo pim bsr-boundary
Default
An interface is not a PIM-SM domain border.
Views
Interface view
Predefined user roles
network-admin
Examples
# Configure VLAN-interface 100 as a PIM-SM domain border.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim bsr-boundary
Related commands
c-bsr (PIM view)
multicast boundary
pim dm
Use pim dm to enable PIM-DM.
Use undo pim dm to disable PIM-DM.
Syntax
pim dm
undo pim dm
Default
PIM-DM is disabled.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IP multicast routing is enabled on the public network or for the
VPN instance to which the interface belongs.
Examples
# Enable IP multicast routing, and enable PIM-DM on VLAN-interface 100.
32
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim dm
Related commands
multicast routing
Related commands
hello-option dr-priority (PIM view)
33
Default
The PIM neighbor lifetime is 105 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
time: Specifies a PIM neighbor lifetime in the range of 1 to 65535 seconds. If you set the value to
65535 seconds, the PIM neighbor is always reachable.
Usage guidelines
You can set the PIM neighbor lifetime for an interface in interface view or globally for all interfaces in
PIM view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the PIM neighbor lifetime to 120 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim hello-option holdtime 120
Related commands
hello-option holdtime (PIM view)
34
Examples
# Set the PIM message propagation delay on a shared-media LAN to 200 milliseconds on
VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim hello-option lan-delay 200
Related commands
hello-option lan-delay (PIM view)
hello-option override-interval (PIM view)
pim hello-option override-interval
# Disable neighbor tracking on VLAN-interface 100 when neighbor tracking is enabled globally.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] hello-option neighbor-tracking
[Sysname-pim] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim hello-option neighbor-tracking disable
35
Related commands
hello-option neighbor-tracking (PIM view)
Related commands
hello-option lan-delay (PIM view)
hello-option override-interval (PIM view)
pim hello-option lan-delay
36
Views
Interface view
Predefined user roles
network-admin
Parameters
time: Specifies a joined/pruned state holdtime in the range of 1 to 65535 seconds.
Usage guidelines
You can set the joined/pruned state holdtime for an interface in interface view or globally for all
interfaces in PIM view. For an interface, the interface-specific configuration takes priority over the
global configuration.
To prevent the upstream neighbors from aging out, you must configure the join/prune interval to be
less than the joined/pruned state holdtime.
Examples
# Set the joined/pruned state holdtime to 280 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim holdtime join-prune 280
Related commands
holdtime join-prune (PIM view)
pim timer join-prune
pim join-policy
Use pim join-policy to configure a PIM join policy to filter joined multicast sources and groups
in PIM join or prune messages on an interface.
Use undo pim join-policy to restore the default.
Syntax
pim join-policy { { ipv4-acl-number | name ipv4-acl-name } | [ asm
{ ipv4-acl-number | name ipv4-acl-name } | ssm { ipv4-acl-number | name
ipv4-acl-name } ] * }
undo pim join-policy
Default
No PIM join policy is configured and joined multicast sources and groups in PIM join or prune
messages are not filtered.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number. The value range is
2000 to 2999 for an IPv4 basic ACL and 3000 to 3999 for an IPv4 advanced ACL. If the ACL does not
37
exist or does not have valid rules, all joined multicast sources and groups in PIM join or prune
messages are filtered out.
name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a case-insensitive
string of 1 to 63 characters. The ACL name must begin with a letter and it cannot be all. If the ACL
does not exist or does not have valid rules, all joined multicast sources and groups in PIM join or
prune messages are filtered out.
asm { ipv4-acl-number | name ipv4-acl-name }: Specifies an ACL for filtering joined
multicast groups in the ASM range. If you do not specify an ACL, or the specified ACL does not exist
or does not have valid rules, all multicast groups in the ASM range are filtered out.
• ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of
2000 to 3999.
• name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a
case-insensitive string of 1 to 63 characters. The ACL name must begin with a letter and it
cannot be all.
ssm { ipv4-acl-number | name ipv4-acl-name }: Specifies an ACL for filtering joined
multicast groups in the SSM range. If you do not specify an ACL, or the specified ACL does not exist
or does not have valid rules, all multicast groups in the SSM range are filtered out.
• ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of
2000 to 3999.
• name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a
case-insensitive string of 1 to 63 characters. The ACL name must begin with a letter and it
cannot be all.
Usage guidelines
This command does not take effect on PIM-DM.
The PIM join policy filters joined multicast sources and groups in PIM join or prune messages to
protect the device against invalid PIM join or prune message attacks. The policy identifies valid
joined multicast source and groups in PIM join or prune messages and filters out invalid joined
multicast source and groups. The device creates (*, G) or (S, G) entries only for valid joined multicast
sources and groups.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• For the rule to take effect, do not specify the vpn-instance vpn-instance option.
• In a basic ACL, the source source-address source-wildcard option specifies the
multicast group address range in the PIM join or prune messages.
• In an advanced ACL, the source source-address source-wildcard option specifies a
multicast source address range. To match join information of (*, G) entries, set the source IP
address to 0.0.0.0. The destination dest-address dest-wildcard option specifies a
multicast group range.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# On VLAN-interface 100, configure a PIM join policy to permit join information only for source
addresses in the range of 10.10.0.0/16 and multicast group addresses in the range of 225.1.1.1/16.
<Sysname> system-view
[Sysname] acl advanced 3005
[Sysname-acl-ipv4-adv-3005] rule permit ip source 10.10.0.0 0.0.255.255 destination
225.1.0.0 0.0.255.255
[Sysname-acl-ipv4-adv-3005] quit
38
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim join-policy ssm 3005
pim neighbor-policy
Use pim neighbor-policy to configure a PIM hello policy.
Use undo pim neighbor-policy to restore the default.
Syntax
pim neighbor-policy { ipv4-acl-number | name ipv4-acl-name }
undo pim neighbor-policy
Default
No PIM hello policy exists on an interface, and all PIM hello messages are regarded as legal.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999. If the ACL
with the specified number does not exist or does not have valid rules, all PIM hello messages are
filtered out.
name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name, a case-insensitive
string of 1 to 63 characters. The ACL name must begin with a letter and it cannot be all. If the ACL
with the specified name does not exist or does not have valid rules, all PIM hello messages are
filtered out.
Usage guidelines
A PIM hello policy filters PIM hello messages to guard against hello message spoofing.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• For the rule to take effect, do not specify the vpn-instance vpn-instance option.
• The source source-address source-wildcard option specifies a source IP address.
A PIM hello message is permitted if the source IP address of the message matches the
source option.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a PIM hello policy on VLAN-interface 100 so that only the devices on subnet 10.1.1.0/24
can become PIM neighbors of this switch.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 10.1.1.0 0.0.0.255
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim neighbor-policy 2000
39
pim non-stop-routing
Use pim non-stop-routing to enable PIM NSR.
Use undo pim non-stop-routing to disable PIM NSR.
Syntax
pim non-stop-routing
undo pim non-stop-routing
Default
PIM NSR is disabled.
Views
System view
Predefined user roles
network-admin
Examples
# Enable PIM NSR.
<Sysname> system-view
[Sysname] pim non-stop-routing
pim passive
Use pim passive to enable PIM passive mode on an interface.
Use undo pim passive to disable PIM passive mode on an interface.
Syntax
pim passive
undo pim passive
Default
PIM passive mode is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when PIM-DM or PIM-SM is enabled on the interface.
Examples
# Enable IP multicast routing. Then, enable PIM-DM and PIM passive mode on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim dm
[Sysname-Vlan-interface100] pim passive
40
pim require-genid
Use pim require-genid to enable dropping hello messages without the generation ID options.
Use undo pim require-genid to restore the default.
Syntax
pim require-genid
undo pim require-genid
Default
Hello messages without the generation ID options are accepted.
Views
Interface view
Predefined user roles
network-admin
Examples
# Enable VLAN-interface 100 to drop hello messages without the generation ID options.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim require-genid
pim sm
Use pim sm to enable PIM-SM.
Use undo pim sm to disable PIM-SM.
Syntax
pim sm
undo pim sm
Default
PIM-SM is disabled.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IP multicast routing is enabled on the public network or for the
VPN instance to which the interface belongs.
When PIM-SM and BIDIR-PIM work together, do no configure PIM-SM in Layer 3 Ethernet interface
view.
Examples
# Enable IP multicast routing, and enable PIM-SM on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast routing
41
[Sysname-mrib] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim sm
Related commands
multicast routing
pim state-refresh-capable
Use pim state-refresh-capable to enable the state refresh feature on an interface.
Use undo pim state-refresh-capable to disable the state refresh feature.
Syntax
pim state-refresh-capable
undo pim state-refresh-capable
Default
The state refresh feature is enabled.
Views
Interface view
Predefined user roles
network-admin
Examples
# Disable the state refresh feature on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] undo pim state-refresh-capable
Related commands
state-refresh-interval (PIM view)
state-refresh-rate-limit (PIM view)
state-refresh-ttl (PIM view)
42
Predefined user roles
network-admin
Parameters
interval: Specifies a graft retry timer in the range of 1 to 65535 seconds.
Examples
# Set the graft retry timer to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim timer graft-retry 80
Related commands
timer hello (PIM view)
43
Syntax
pim timer join-prune interval
undo pim timer join-prune
Default
The join/prune interval is 60 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies a join/prune interval in the range of 0 to 18000 seconds. If you set the value to
0 seconds, the interface does not send join or prune messages.
Usage guidelines
You can set the join/prune interval for an interface in interface view or globally for all interfaces in PIM
view. For an interface, the interface-specific configuration takes priority over the global configuration.
The configuration takes effect after the current interval ends.
To prevent the upstream neighbors from aging out, you must set the join/prune interval to be less
than the joined/pruned state holdtime.
Examples
# Set the join/prune interval to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim timer join-prune 80
Related commands
pim holdtime join-prune
timer join-prune (PIM view)
pim triggered-hello-delay
Use pim triggered-hello-delay to set the triggered hello delay (maximum delay for sending
a hello message).
Use undo pim triggered-hello-delay to restore the default.
Syntax
pim triggered-hello-delay delay
undo pim triggered-hello-delay
Default
The triggered hello delay is 5 seconds.
Views
Interface view
Predefined user roles
network-admin
44
Parameters
delay: Specifies a triggered hello delay in the range of 1 to 60 seconds.
Examples
# Set the triggered hello delay to 3 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim triggered-hello-delay 3
45
Examples
# Configure a PIM register policy. Then, the device accepts only register messages from the sources
on the subnet 10.10.0.0/16 to the groups on the subnet 225.1.0.0/16.
<Sysname> system-view
[Sysname] acl advanced 3000
[Sysname-acl-ipv4-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination
225.1.0.0 0.0.255.255
[Sysname-acl-ipv4-adv-3000] quit
[Sysname] pim
[Sysname-pim] register-policy 3000
46
Views
PIM view
Predefined user roles
network-admin
Examples
# Configure the device to calculate the checksum based on an entire register message.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] register-whole-checksum
47
source-lifetime (PIM view)
Use source-lifetime to set the multicast source lifetime.
Use undo source-lifetime to restore the default.
Syntax
source-lifetime time
undo source-lifetime
Default
The multicast source lifetime is 210 seconds.
Views
PIM view
Predefined user roles
network-admin
Parameters
time: Specifies a multicast source lifetime in the range of 0 to 31536000 seconds. If you set the
value to 0 seconds, multicast sources never age out.
Examples
# Set the multicast source lifetime to 200 seconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] source-lifetime 200
48
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-wildcard option specifies a
source IP address.
• In an advanced ACL, the source source-address source-wildcard option specifies a
source IP address. The destination dest-address dest-wildcard option specifies a
multicast group address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a multicast source policy to accept multicast data from source 10.10.1.2 and to deny
multicast data from source 10.10.1.1.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 10.10.1.2 0
[Sysname-acl-ipv4-basic-2000] rule deny source 10.10.1.1 0
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] pim
[Sysname-pim] source-policy 2000
49
Usage guidelines
When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
Some devices cannot encapsulate multicast data in register messages destined to the RP. As a best
practice to avoid multicast data forwarding failures, do not disable the switchover to SPT on C-RPs
that might become the RP.
Examples
# Disable RPT-to-STP switchover on a receiver-side DR.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] spt-switch-threshold infinity
50
• The source source-address source-wildcard option specifies a multicast group
range. A multicast packet is permitted if the multicast source address of the message matches
the source option.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure the SSM group range as 232.1.0.0/16.
<Sysname> system-view
[Sysname] acl basic 2000
[Sysname-acl-ipv4-basic-2000] rule permit source 232.1.0.0 0.0.255.255
[Sysname-acl-ipv4-basic-2000] quit
[Sysname] pim
[Sysname-pim] ssm-policy 2000
Related commands
pim state-refresh-capable
state-refresh-rate-limit (PIM view)
state-refresh-ttl (PIM view)
51
state-refresh-rate-limit (PIM view)
Use state-refresh-rate-limit to set the waiting time to accept a new state refresh
message.
Use undo state-refresh-rate-limit to restore the default.
Syntax
state-refresh-rate-limit time
undo state-refresh-rate-limit
Default
The device waits 30 seconds before it accepts a new state refresh message.
Views
PIM view
Predefined user roles
network-admin
Parameters
time: Specifies the waiting time to accept a new refresh message, in the range of 1 to 65535
seconds.
Examples
# Set the waiting time to 45 seconds to accept a new state refresh message.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] state-refresh-rate-limit 45
Related commands
pim state-refresh-capable
state-refresh-interval (PIM view)
state-refresh-ttl (PIM view)
52
Parameters
ttl-value: Specifies the TTL value for state refresh messages, in the range of 1 to 255.
Examples
# Set the TTL value to 45 for state refresh messages.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] state-refresh-ttl 45
Related commands
pim state-refresh-capable (PIM view)
state-refresh-interval (PIM view)
state-refresh-rate-limit (PIM view)
53
bidir: Configures the static RP as a BIDIR-PIM RP. If you do not specify this keyword, this
command configures the static RP as a PIM-SM RP.
preferred: Gives priority to the static RP if a dynamic RP also exists on the network. The dynamic
RP takes effect only when the static RP fails. If you do not specify this keyword, the dynamic RP has
priority, and the static RP takes effect only when the dynamic RP fails.
Usage guidelines
You do not need to enable PIM on an interface that acts as a static RP.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• For the rule to take effect, do not specify the vpn-instance vpn-instance option.
• The source source-address source-wildcard option specifies a multicast group
address. A multicast packet is permitted if the multicast source address of the message
matches the source option.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
When rules in the ACL used by a static RP change, new RPs are dynamically elected for all multicast
groups.
You can configure multiple static RPs by using this command multiple times. However, if you specify
the same static RP address or use the same ACL in the command, the most recent configuration
takes effect. If you configure multiple static RPs for the same multicast group, the static RP with the
highest IP address is used.
Examples
# Configure the interface with IP address 11.110.0.6 as a static RP for multicast group range
225.1.1.0/24 and give priority to this static RP.
<Sysname> system-view
[Sysname] acl basic 2001
[Sysname-acl-ipv4-basic-2001] rule permit source 225.1.1.0 0.0.0.255
[Sysname-acl-ipv4-basic-2001] quit
[Sysname] pim
[Sysname-pim] static-rp 11.110.0.6 2001 preferred
Related commands
display pim rp-info
54
Predefined user roles
network-admin
Parameters
interval: Specifies a hello interval in the range of 0 to 18000 seconds. If you set the value to 0
seconds, the device does not send hello messages.
Usage guidelines
You can set the hello interval globally for all interfaces in PIM view or for an interface in interface view.
For an interface, the interface-specific configuration takes priority over the global configuration.
Examples
# Set the global hello interval to 40 seconds.
<Sysname> system-view
[Sysname] pim
[Sysname-pim] timer hello 40
Related commands
pim timer hello
55
[Sysname-pim] timer join-prune 80
Related commands
holdtime join-prune (PIM view)
pim timer join-prune
56
Contents
MSDP commands ·························································································· 1
cache-sa-enable········································································································································· 1
display msdp brief ······································································································································ 1
display msdp non-stop-routing status ········································································································ 2
display msdp peer-status ··························································································································· 3
display msdp sa-cache······························································································································· 6
display msdp sa-count ······························································································································· 8
dscp···························································································································································· 9
encap-data-enable ····································································································································· 9
import-source ··········································································································································· 10
msdp ························································································································································ 11
msdp non-stop-routing ····························································································································· 11
originating-rp ············································································································································ 12
peer ·························································································································································· 12
peer description········································································································································ 13
peer mesh-group ······································································································································ 14
peer minimum-ttl ······································································································································ 14
peer password·········································································································································· 15
peer request-sa-enable ···························································································································· 16
peer sa-cache-maximum·························································································································· 16
peer sa-policy ··········································································································································· 17
peer sa-request-policy······························································································································ 18
reset msdp peer ······································································································································· 19
reset msdp sa-cache ································································································································ 20
reset msdp statistics································································································································· 20
shutdown (MSDP view) ···························································································································· 20
static-rpf-peer ··········································································································································· 21
timer keepalive ········································································································································· 22
timer retry ················································································································································· 23
i
MSDP commands
cache-sa-enable
Use cache-sa-enable to enable the SA message cache mechanism to cache the (S, G) entries
contained in SA messages.
Use undo cache-sa-enable to disable the SA message cache mechanism.
Syntax
cache-sa-enable
undo cache-sa-enable
Default
The SA message cache mechanism is enabled, and the device caches the (S, G) entries contained
in received SA messages.
Views
MSDP view
Predefined user roles
network-admin
Examples
# Enable the SA message cache mechanism, so that the device caches the (S, G) entries contained
in the received SA messages.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] cache-sa-enable
Related commands
display msdp sa-cache
display msdp sa-count
1
connect: Specifies the connecting state.
disabled: Specifies the connection failure state.
established: Specifies the session state.
listen: Specifies the listening state.
shutdown: Specifies the shutdown state.
Examples
# Display brief information about MSDP peers in all states.
<Sysname> display msdp brief
Configured Established Listen Connect Shutdown Disabled
1 1 0 0 0 0
Field Description
Configured Number of MSDP peers that have been configured.
Established Number of MSDP peers in established state.
Listen Number of MSDP peers in listening state.
Connect Number of MSDP peers in connecting state.
Shutdown Number of MSDP peers in shutdown state.
Disabled Number of MSDP peers in connection failure state.
Peer address MSDP peer address.
MSDP peer status:
• Established—A session has been established and the MSDP
peer is in session.
• Listen—A session has been established and the local device
State acts as the server in listening state.
• Connect—A session is not established and the local device
acts as a client in connecting state.
• Shutdown—The session has been torn down.
• Down—The connection failed.
2
Syntax
display msdp non-stop-routing status
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display MSDP NSR status information.
<Sysname> display msdp non-stop-routing status
MSDP NSR status: Ready
Location of preferred standby process: Slot 1
TCP NSR status: Ready
Field Description
MSDP NSR status:
• Ready—MSDP NSR has backed up MSDP peer and remote
source information from the active process to standby processes.
In this state, MSDP NSR can ensure continuous routing when an
active/standby process switchover occurs.
MSDP NSR status
• Not ready—MSDP NSR is backing up MSDP peer and remote
multicast source information from the active process to the
standby process. If an active/standby process switchover occurs
in this state, traffic is interrupted.
• Not configured—MSDP NSR is disabled.
Location of preferred standby ID of the IRF member device where the preferred standby process
process resides.
TCP NSR status:
• Ready—TCP NSR has backed up TCP connection information
TCP NSR status from the active process to standby processes.
• Not ready—TCP NSR is backing up TCP connection information
from the active process to standby processes.
Related commands
msdp non-stop-routing
3
network-operator
Parameters
peer-address: Specifies an MSDP peer by its address. If you do not specify an MSDP peer, this
command displays detailed status information for all MSDP peers.
Examples
# Display detailed status information for MSDP peer 20.20.20.20.
<Sysname> display msdp peer-status 20.20.20.20
MSDP peer 20.20.20.20; AS 100
Description:
Information about connection status:
State: Disabled
Up/down time: 14:41:08
Resets: 0
Connection interface: LoopBack0 (20.20.20.30)
Received/sent messages: 867/867
Discarded input messages: 0
Discarded output messages: 0
Elapsed time since last connection or counters clear: 14:42:40
Mesh group peer joined: momo
Last disconnect reason: Hold timer expired with truncated message
Truncated packet: 5 bytes in buffer, type: 1, length: 20, without packet time: 75s
Information about (Source, Group)-based SA filtering policy:
Import policy: None
Export policy: None
Information about SA-Requests:
Policy to accept SA-Requests: None
Sending SA-Requests status: Disable
Minimum TTL to forward SA with encapsulated data: 0
SAs learned from this peer: 0, SA cache maximum for the peer: 4294967295
Input queue size: 0, Output queue size: 0
Counters for MSDP messages:
RPF check failure: 0
Incoming/outgoing SA: 0/0
Incoming/outgoing SA-Request: 0/0
Incoming/outgoing SA-Response: 0/0
Incoming/outgoing Keepalive: 867/867
Incoming/outgoing Notification: 0/0
Incoming/outgoing Traceroutes in progress: 0/0
Incoming/outgoing Traceroute reply: 0/0
Incoming/outgoing Unknown: 0/0
Incoming/outgoing data packet: 0/0
Field Description
MSDP peer MSDP peer address.
Number of the AS where the MSDP peer is located. If the system could
AS
not obtain the AS number, this field displays a question mark (?).
4
Field Description
MSDP peer status:
• Established—A session has been established and the MSDP
peer is in session.
• Listen—A session has been established and the local device acts
State as the server in listening state.
• Connect—A session is not established and the local device acts
as a client in connecting state.
• Shutdown—The session has been torn down.
• Disabled—The connection failed.
5
Field Description
Group)-based SA filtering policy • Import policy—Filter list for receiving SA messages from the
specified MSDP peer.
• Export policy—Filter list for forwarding SA messages from the
specified MSDP peer.
SA request information:
• Policy to accept SA request messages—Filtering rule for
receiving or forwarding SA request messages from the specified
MSDP peer. If SA request messages are not filtered, this field
Information about SA-Requests
displays None.
• Sending SA requests status—Whether the MSDP peer is
enabled to send an SA request message to the designated MSDP
peer after receiving a new join message.
Minimum TTL to forward SA with Lower TTL threshold for the multicast packets encapsulated in SA
encapsulated data messages.
Number of cached (S, G) entries learned from the specified MSDP
SAs learned from this peer
peer.
Maximum number of (S, G) entries learned from the specified MSDP
SA-cache maximum for the peer
peer that the device can cache.
Input queue size Data size cached in the input queue.
Output queue size Data size cached in the output queue.
MSDP peer statistics:
• RPF check failure—Number of SA messages discarded because
of RPF check failure.
• Incoming/outgoing SA—Number of received and sent SA
messages.
• Incoming/outgoing SA-Request—Number of received and sent
SA requests.
• Incoming/outgoing SA-Response—Number of received and
sent SA responses.
• Incoming/outgoing Keepalive—Number of received and sent
Counters for MSDP message keepalive messages.
• Incoming/outgoing Notification—Number of received and sent
notification messages.
• Incoming/outgoing Traceroutes in progress—Number of
received and sent traceroute-in-progress messages.
• Incoming/outgoing Traceroute reply—Number of received and
sent traceroute replies.
• Incoming/outgoing Unknown—Number of received and sent
unknown messages.
• Incoming/outgoing data packet—Number of received and sent
SA messages encapsulated with multicast data.
6
Predefined user roles
network-admin
network-operator
Parameters
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to
239.255.255.255. If you do not specify a multicast group, this command displays (S, G) entries in the
SA cache for all multicast groups.
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast
source, this command displays (S, G) entries in the SA cache for all sources.
as-number: Specifies an AS number in the range of 1 to 4294967295. If you do not specify an AS
number, this command displays (S, G) entries in the SA cache for all ASs.
Usage guidelines
For this command to display output, you must first execute the cache-sa-enable command
before you execute this command.
Examples
# Display (S, G) entries in the SA cache.
<Sysname> display msdp sa-cache
Total Source-Active Cache - 5 entries
Matched 5 entries
Field Description
Total Source-Active Cache Total number of multicast sources in the SA cache.
Matched Total number of (S, G) entries that match a multicast sources.
Source Multicast source address.
Group Multicast group address.
Origin RP Address of the RP that generated the (S, G) entry.
Type of protocol from which the AS number of the origin RP
Pro originates. If the system could not obtain the AS number, this field
displays a question mark (?).
AS number of the origin RP. If the system could not obtain the AS
AS
number, this field displays a question mark (?).
Uptime Length of time for which the cached (S, G) entry has existed.
Expires Length of time in which the cached (S, G) entry will expire.
Related commands
cache-sa-enable
7
display msdp sa-count
Use display msdp sa-count to display the number of (S, G) entries in the SA cache.
Syntax
display msdp sa-count [ as-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
as-number: Specifies an AS number in the range of 1 to 4294967295. If you do not specify an AS
number, this command displays the number of (S, G) entries in the SA cache for all ASs.
Usage guidelines
For this command to display output, you must first execute the cache-sa-enable command
before you execute this command.
Examples
# Display the number of (S, G) entries in the SA cache.
<Sysname> display msdp sa-count
(S, G) entries statistics, counted by peer
Peer address SA count
10.10.10.10 5
Field Description
(S, G) entries statistics, counted by peer Number of (S, G) entries on an MSDP peer basis.
Peer address Address of the MSDP peer that sent SA messages.
SA count Number of (S, G) entries from the MSDP peer.
(S, G) entries statistics, counted by AS Number of cached (S, G) entries on an AS basis.
AS number. If the system could not obtain the AS number, this
AS
field displays a question mark (?).
Source count Number of multicast sources in the AS.
Group count Number of multicast groups in the AS.
(S, G) entries in total Total number of (S, G) entries.
Related commands
cache-sa-enable
8
dscp
Use dscp to set the DSCP value for outgoing MSDP protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing MSDP protocol packets.
Views
MSDP view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the ToS field of an IP packet to determine the transmission priority of
the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value to 63 for outgoing MSDP protocol packets.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] dscp 63
encap-data-enable
Use encap-data-enable to enable multicast data encapsulation in SA messages.
Use undo encap-data-enable to restore the default.
Syntax
encap-data-enable
undo encap-data-enable
Default
An SA message contains only (S, G) entries. Multicast data is not encapsulated in an SA message.
Views
MSDP view
Predefined user roles
network-admin
Examples
# Enable multicast data encapsulation in SA messages.
<Sysname> system-view
9
[Sysname] msdp
[Sysname-msdp] encap-data-enable
import-source
Use import-source to configure an SA message creation policy.
Use undo import-source to restore the default.
Syntax
import-source [ acl ipv4-acl-number ]
undo import-source
Default
When an SA message is created, all the (S, G) entries within the domain are advertised in the SA
message.
Views
MSDP view
Predefined user roles
network-admin
Parameters
ipv4-acl-number: Specifies an IPv4 basic or advanced ACL number in the range of 2000 to
3999. If you specify an ACL, this command advertises only the (S, G) entries that the ACL permits.
This command does not advertise (S, G) entries when one of the following conditions exists:
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
This command controls the creation of SA messages. To control forwarding or acceptance of SA
messages, use the peer sa-policy command.
When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-wildcard option specifies a
multicast group address.
• In an advanced ACL, the source source-address source-wildcard option specifies a
multicast source address. The destination dest-address dest-wildcard option
specifies a multicast group address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Configure an SA creation policy to advertise only (10.10.0.0/16, 225.1.0.0/16) entries in SA
messages.
<Sysname> system-view
[Sysname] acl advanced 3101
[Sysname-acl-ipv4-adv-3101] rule permit ip source 10.10.0.0 0.0.255.255 destination
225.1.0.0 0.0.255.255
[Sysname-acl-ipv4-adv-3101] quit
10
[Sysname] msdp
[Sysname-msdp] import-source acl 3101
Related commands
peer sa-policy
msdp
Use msdp to enable MSDP and enter MSDP view.
Use undo msdp to disable MSDP and delete the configurations in MSDP view.
Syntax
msdp
undo msdp
Default
MSDP is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IP multicast routing is enabled on the public network or for the
VPN instance to which the device belongs.
Examples
# Enable IP multicast routing. Then, enable MSDP and enter MSDP view.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] msdp
[Sysname-msdp]
Related commands
multicast routing
msdp non-stop-routing
Use msdp non-stop-routing to enable MSDP NSR.
Use undo msdp non-stop-routing to disable MSDP NSR.
Syntax
msdp non-stop-routing
undo msdp non-stop-routing
Default
MSDP NSR is disabled.
11
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command enables MSDP to back up protocol state information and data, such as MSDP peer
and remote multicast source information, from the active process to standby processes. A standby
process seamlessly takes over when the active process fails. Use this feature to avoid forwarding
interruption for MSDP when an active/standby switchover occurs.
Examples
# Enable MSDP NSR.
<Sysname> system-view
[Sysname] msdp non-stop-routing
Related commands
display msdp non-stop-routing status
originating-rp
Use originating-rp to configure the originating RP of SA messages.
Use undo originating-rp to restore the default.
Syntax
originating-rp interface-type interface-number
undo originating-rp
Default
SA messages are originated by real RPs.
Views
MSDP view
Predefined user roles
network-admin
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Examples
# Configure VLAN-interface 100 as the originating RP of SA messages.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] originating-rp vlan-interface 100
peer
Use peer to specify an MSDP peer.
Use undo peer to remove an MSDP peer.
12
Syntax
peer peer-address connect-interface interface-type interface-number
undo peer peer-address
Default
No MSDP peers exist.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
connect-interface interface-type interface-number: Specifies an interface by its
type and number. The local device uses the primary IP address of the specified interface to establish
a TCP connection with the remote MSDP peer.
Usage guidelines
You must execute this command before you use any other peer commands.
Examples
# Specify the router with IP address 125.10.7.6 as an MSDP peer and VLAN-interface 100 as the
local connection port.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface vlan-interface 100
peer description
Use peer description to configure a description for an MSDP peer.
Use undo peer description to delete the description for an MSDP peer.
Syntax
peer peer-address description text
undo peer peer-address description
Default
No description exists.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
text: Specifies a description, a case-sensitive string of 1 to 80 characters.
13
Examples
# Configure the description CustomerA for the MSDP peer with IP address 125.10.7.6.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 description CustomerA
peer mesh-group
Use peer mesh-group to assign an MSDP peer to a mesh group.
Use undo peer mesh-group to remove an MSDP peer from a mesh group.
Syntax
peer peer-address mesh-group name
undo peer peer-address mesh-group
Default
An MSDP peer does not belong to a mesh group.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
name: Specifies a mesh group, a case-sensitive string of 1 to 32 characters. A mesh group name
must not contain spaces.
Examples
# Assign the MSDP peer with IP address 125.10.7.6 to mesh group Group1.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 mesh-group Group1
peer minimum-ttl
Use peer minimum-ttl to set the lower TTL threshold for multicast data packets to be
encapsulated in SA messages.
Use undo peer minimum-ttl to restore the default.
Syntax
peer peer-address minimum-ttl ttl-value
undo peer peer-address minimum-ttl
Default
The lower TTL threshold is 0 for multicast data packets to be encapsulated in SA messages.
Views
MSDP view
14
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
ttl-value: Specifies the lower TTL threshold in the range of 0 to 255.
Examples
# Set the lower TTL threshold to 10 for multicast data packets to be encapsulated in SA messages
and forwarded to MSDP peer 110.10.10.1.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 110.10.10.1 minimum-ttl 10
peer password
Use peer password to configure the device to perform MD5 authentication when establishing a
TCP connection with an MSDP peer.
Use undo peer password to configure the device not to perform MD5 authentication when
establishing a TCP connection with an MSDP peer.
Syntax
peer peer-address password { cipher | simple } string
undo peer peer-address password
Default
The device does not perform MD5 authentication when establishing a TCP connection with an
MSDP peer.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
cipher: Specifies a key in encrypted form.
simple: Specifies a key in plaintext form. For security purposes, the key specified in plaintext form
will be stored in encrypted form.
string: Specifies the key. Its plaintext form is a case-sensitive string of 33 to 137 characters. Its
encrypted form is a case-sensitive string of 1 to 80 characters.
Usage guidelines
For the TCP connection to be successfully established, you must configure the same key for MD5
authentication on both MSDP peers.
Examples
# Configure the router to perform MD5 authentication when establishing a TCP connection with
MSDP peer 10.1.100.1 and set the key to aabbcc in plaintext.
<Sysname> system-view
[Sysname] msdp
15
[Sysname-msdp] peer 10.1.100.1 password simple aabbcc
peer request-sa-enable
Use peer request-sa-enable to enable the device to send an SA request message to an
MSDP peer after receiving a new join message.
Use undo peer request-sa-enable to disable the device from sending an SA request
message to an MSDP peer.
Syntax
peer peer-address request-sa-enable
undo peer peer-address request-sa-enable
Default
After receiving a new join message, the device does not send an SA request message to MSDP
peers. Instead, it waits for an SA message.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
Usage guidelines
For the device to send out SA request messages, you must disable the SA message cache
mechanism before you execute this command.
Examples
# Disable the SA message cache mechanism.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] undo cache-sa-enable
# Enable the device to send an SA request message to MSDP peer 125.10.7.6 after it receives a new
join message.
[Sysname-msdp] peer 125.10.7.6 request-sa-enable
Related commands
cache-sa-enable
display msdp peer-status
peer sa-cache-maximum
Use peer sa-cache-maximum to set the maximum number of (S, G) entries in the SA cache
learned from an MSDP peer.
Use undo peer sa-cache-maximum to restore the default.
Syntax
peer peer-address sa-cache-maximum sa-limit
undo peer peer-address sa-cache-maximum
16
Default
The device can cache a maximum of 4294967295 (S, G) entries learned from an MSDP peer.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
sa-limit: Specifies the maximum number of (S, G) entries in the SA cache, in the range of 1 to
4294967295.
Examples
# Set the maximum number to 100 for (S, G) entries in the SA cache learned from MSDP peer
125.10.7.6.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 sa-cache-maximum 100
Related commands
display msdp brief
display msdp peer-status
display msdp sa-count
peer sa-policy
Use peer sa-policy to configure an SA incoming or outgoing policy for an MSDP peer.
Use undo peer sa-policy to delete the SA incoming or outgoing policy for an MSDP peer.
Syntax
peer peer-address sa-policy { export | import } [ acl ipv4-acl-number ]
undo peer peer-address sa-policy { export | import }
Default
No SA incoming or outgoing policy exists, and all SA messages from an MSDP peer are accepted or
forwarded.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
export: Specifies the outgoing direction.
import: Specifies the incoming direction.
17
ipv4-acl-number: Specifies an IPv4 advanced ACL number in the range of 3000 to 3999. If you
specify an ACL, the device accepts and forwards only SA messages that the ACL permits. The
device discards all SA messages when one of the following conditions exists:
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
This command filters SA messages from a specified MSDP peer to control the acceptance or
forwarding of SA messages. To control the creation of SA messages, use the import-source
command.
When you configure a rule in the IPv4 advanced ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a multicast source
address.
• The destination dest-address dest-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Configure an SA outgoing policy to forward only SA messages that ACL 3100 permits to MSDP
peer 125.10.7.6.
<Sysname> system-view
[Sysname] acl advanced 3100
[Sysname-acl-ipv4-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination
225.1.0.0 0.0.255.255
[Sysname-acl-ipv4-adv-3100] quit
[Sysname] msdp
[Sysname-msdp] peer 125.10.7.6 connect-interface vlan-interface 100
[Sysname-msdp] peer 125.10.7.6 sa-policy export acl 3100
Related commands
display msdp peer-status
import-source
peer sa-request-policy
Use peer sa-request-policy to configure an SA request policy for an MSDP peer.
Use undo peer sa-request-policy to delete the SA request policy for an MSDP peer.
Syntax
peer peer-address sa-request-policy [ acl ipv4-acl-number ]
undo peer peer-address sa-request-policy
Default
No SA request policy exists, and all SA request messages from an MSDP peer are accepted.
Views
MSDP view
18
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
ipv4-acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999. If you
specify an ACL, the device accepts only SA requests that the ACL permits. The device discards all
SA requests when one of the following conditions exists:
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:
• The source source-address source-wildcard option specifies a multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Configure an SA request policy. Then, the device accepts only SA requests that are from MSDP
peer 175.58.6.5 and for multicast groups in the range 225.1.1.0/24.
<Sysname> system-view
[Sysname] acl basic 2001
[Sysname-acl-ipv4-basic-2001] rule permit source 225.1.1.0 0.0.0.255
[Sysname-acl-ipv4-basic-2001] quit
[Sysname] msdp
[Sysname-msdp] peer 175.58.6.5 sa-request-policy acl 2001
19
<Sysname> reset msdp peer 125.10.7.6
Related commands
cache-sa-enable
display msdp sa-cache
20
Use undo shutdown to re-establish the connection with an MSDP peer.
Syntax
shutdown peer-address
undo shutdown peer-address
Default
The connection with an MSDP peer is active.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
Examples
# Tear down the connection with the MSDP peer 125.10.7.6.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] shutdown 125.10.7.6
Related commands
display msdp brief
display msdp peer-status
static-rpf-peer
Use static-rpf-peer to configure a static RPF peer.
Use undo static-rpf-peer to remove a static RPF peer.
Syntax
static-rpf-peer peer-address [ rp-policy ip-prefix-name ]
undo static-rpf-peer peer-address
Default
No static RPF peers exist.
Views
MSDP view
Predefined user roles
network-admin
Parameters
peer-address: Specifies an MSDP peer by its IP address.
rp-policy ip-prefix-name: Specifies a filtering policy based on RP addresses in SA
messages by its name, a case-sensitive string of 1 to 63 characters. If you specify a filtering policy,
the device does not perform RPF checks on SA messages permitted by the policy. If you do not
specify a filtering policy, the device performs RPF checks on all SA messages.
21
Usage guidelines
This feature exempts SA messages forwarded by the static RPF peer from RPF checks.
Examples
# Specify 130.10.7.6 as the static RPF peer to exempt SA messages originated by RPs on subnet
130.10.0.0/16 from RPF checks.
<Sysname> system-view
[Sysname] ip prefix-list list1 permit 130.10.0.0 16 greater-equal 16 less-equal 32
[Sysname] msdp
[Sysname-msdp] peer 130.10.7.6 connect-interface vlan-interface 100
[Sysname-msdp] static-rpf-peer 130.10.7.6 rp-policy list1
Related commands
display msdp peer-status
ip prefix-list
timer keepalive
Use timer keepalive to set the keepalive timer and the peer hold timer for MSDP sessions.
Use undo timer keepalive to restore the default.
Syntax
timer keepalive keepalive holdtime
undo timer keepalive
Default
The keepalive timer is 60 seconds, and the peer hold timer is 75 seconds.
Views
MSDP view
Predefined user roles
network-admin
Parameters
keepalive: Specifies a keepalive timer in the range of 1 to 21845 seconds.
holdtime: Specifies a peer hold timer in the range of 1 to 65535 seconds.
Usage guidelines
MSDP peers periodically send keepalive messages to each other to keep a session alive. When a
session is established, an MSDP peer sends a keepalive message to its peer and starts a keepalive
timer and a peer hold timer. When the keepalive timer expires, the MSDP peer sends a new
keepalive message. If the MSDP peer receives an MSDP message from its peer before the peer hold
timer expires, it resets the peer hold timer. If the MSDP peer does not receive an MSDP message
when the hold timer expires, the MSDP peer closes the session.
When you configure this command, follow these guidelines:
No mechanism is available for MSDP peers to negotiate the two values. You must set the same
keepalive timer and the peer hold timer for the MSDP peers of a session.
The keepalive timer must be less than the peer hold timer.
This command takes effect on the established MSDP session.
22
Examples
# Set the keepalive timer to 60 seconds and the peer hold timer to 180 seconds for MSDP sessions.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] timer keepalive 60 180
timer retry
Use timer retry to set the MSDP connection retry interval.
Use undo timer retry to restore the default.
Syntax
timer retry interval
undo timer retry
Default
The MSDP connection retry interval is 30 seconds.
Views
MSDP view
Predefined user roles
network-admin
Parameters
interval: Specifies an MSDP connection retry interval in the range of 1 to 60 seconds.
Examples
# Set the MSDP connection retry interval to 60 seconds.
<Sysname> system-view
[Sysname] msdp
[Sysname-msdp] timer retry 60
23
Contents
MLD snooping commands ············································································· 1
display ipv6 l2-multicast fast-forwarding cache ·························································································· 1
display ipv6 l2-multicast ip ························································································································· 2
display ipv6 l2-multicast ip forwarding········································································································ 4
display ipv6 l2-multicast mac ····················································································································· 6
display ipv6 l2-multicast mac forwarding···································································································· 7
display mld-snooping ································································································································· 9
display mld-snooping group ····················································································································· 12
display mld-snooping host-tracking ·········································································································· 15
display mld-snooping router-port·············································································································· 16
display mld-snooping static-group············································································································ 18
display mld-snooping static-router-port ···································································································· 19
display mld-snooping statistics················································································································· 20
dot1p-priority (MLD-snooping view) ········································································································· 21
dscp·························································································································································· 22
enable (MLD-snooping view) ··················································································································· 23
entry-limit (MLD-snooping view)··············································································································· 23
fast-leave (MLD-snooping view)··············································································································· 24
global-enable (MLD-snooping view)········································································································· 25
group-policy (MLD-snooping view)··········································································································· 25
host-aging-time (MLD-snooping view) ····································································································· 27
host-tracking (MLD-snooping view)·········································································································· 27
last-listener-query-interval (MLD-snooping view) ····················································································· 28
max-response-time (MLD-snooping view) ······························································································· 29
mld-snooping············································································································································ 29
mld-snooping done source-ip ··················································································································· 30
mld-snooping dot1p-priority······················································································································ 31
mld-snooping drop-unknown ···················································································································· 32
mld-snooping { disable | enable } ············································································································· 33
mld-snooping fast-leave ··························································································································· 34
mld-snooping general-query source-ip····································································································· 35
mld-snooping group-limit ·························································································································· 36
mld-snooping group-policy ······················································································································· 36
mld-snooping host-aging-time ·················································································································· 38
mld-snooping host-join ····························································································································· 39
mld-snooping host-tracking ······················································································································ 40
mld-snooping last-listener-query-interval ································································································· 41
mld-snooping max-response-time ············································································································ 42
mld-snooping overflow-replace ················································································································ 43
mld-snooping proxy enable ······················································································································ 44
mld-snooping querier ······························································································································· 44
mld-snooping querier-election ·················································································································· 45
mld-snooping query-interval ····················································································································· 46
mld-snooping report source-ip ················································································································· 47
mld-snooping router-aging-time ··············································································································· 48
mld-snooping router-port-deny ················································································································· 49
mld-snooping source-deny ······················································································································· 50
mld-snooping special-query source-ip ····································································································· 51
mld-snooping static-group ························································································································ 52
mld-snooping static-router-port ················································································································ 53
mld-snooping version ······························································································································· 53
overflow-replace (MLD-snooping view) ···································································································· 54
report-aggregation (MLD-snooping view)································································································· 55
reset ipv6 l2-multicast fast-forwarding cache ··························································································· 55
reset mld-snooping group ························································································································ 56
reset mld-snooping router-port ················································································································· 57
reset mld-snooping statistics ···················································································································· 57
i
router-aging-time (MLD-snooping view) ··································································································· 58
send-query enable ··································································································································· 58
source-deny (MLD-snooping view) ·········································································································· 59
version (MLD-snooping view)··················································································································· 60
ii
MLD snooping commands
display ipv6 l2-multicast fast-forwarding cache
Use display ipv6 l2-multicast fast-forwarding cache to display Layer 2 IPv6
multicast fast forwarding entries.
Syntax
display ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ]
[ ipv6-source-address | ipv6-group-address ] * [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
ipv6-source-address: Specifies an IPv6 multicast source address. If you do not specify an
IPv6 multicast source, this command displays Layer 2 IPv6 multicast forwarding entries for all IPv6
multicast sources.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this
command displays Layer 2 IPv6 multicast forwarding entries for all IPv6 multicast groups.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays Layer 2 IPv6 multicast fast forwarding entries for the master
device.
Examples
# Display Layer 2 IPv6 multicast fast forwarding entries.
<Sysname> display ipv6 l2-multicast fast-forwarding cache
Total 1 entries, 1 matched
(1::6, FF1E::2)
Status : Enable VLAN : 1
Source port : 9876 Destination port: 5432
Protocol : 17 Flag : 0x2
Ingress port: Ten-GigabitEthernet1/0/2
List of 1 egress ports:
Ten-GigabitEthernet1/0/3
Status: Enable Flag: 0x10
Field Description
Total number of (S, G) entries in the Layer 2 IPv6 multicast fast forwarding
Total 1 entries, 1 matched
table, and the total number of matching entries.
1
Field Description
(1::6, FF1E::2) (S, G) entry in the Layer 2 IPv6 multicast fast forwarding table.
Protocol Protocol number.
VLAN VLAN ID.
Flag for the (S, G) entry or the outgoing port.
This field displays one flag or the sum of multiple flags. In this example, the
value 0x2 means that the entry has only one flag 0x2.
The following flags are available for an entry:
• 0x1—The entry is created because of packets passed through
between cards.
Flag • 0x2—The entry is added by multicast forwarding.
The following flags are available for an outgoing interface:
• 0x1—The port is added to the entry because of packets passed
through between cards.
• 0x2—The port is added to an existing entry.
• 0x10—The port is associated with the entry.
• 0x20—The port is to be deleted.
Related commands
reset ipv6 l2-multicast fast-forwarding cache all
2
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays information about Layer 2 IPv6 multicast groups for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command displays information about Layer 2 IPv6 multicast groups for all
VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays information about Layer 2 IP multicast groups for the master
device.
Examples
# Display information about Layer 2 IPv6 multicast groups for VLAN 2.
<Sysname> display ipv6 l2-multicast ip vlan 2
Total 1 entries.
# Display information about Layer 2 IPv6 multicast groups for VSI aaa.
<Sysname> display ipv6 l2-multicast ip vsi aaa
Total 1 entries.
# Display information about Layer 2 IPv6 multicast groups for VSI bbb.
<Sysname> display ipv6 l2-multicast ip vsi bbb
Total 2 entries.
Field Description
(S, G) entry, where a double colon (::) in the S position means all IPv6
(::, FF1E::101)
multicast sources.
Entry attribute:
Attribute • dynamic—The entry is created by a dynamic protocol.
• static—The entry is created by a static protocol.
3
Field Description
• pim—The entry is created by IPv6 PIM.
• kernel—The entry is obtained from the kernel.
• success—Processing has succeeded.
• fail—Processing has failed.
Host ports (1 in total) Member ports and total number of member ports.
Port attribute:
• D—Dynamic port.
• S—Static port.
• P—IPv6 PIM port.
(S, SUC) • K—Port obtained from the kernel.
• R—Port learned from (*, *) entries.
• W—Port learned from (*, G) entries.
• SUC—Processing has succeeded.
• F—Processing has failed.
4
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays Layer 2 IPv6 multicast IP forwarding entries for the master
device.
Examples
# Display Layer 2 IPv6 multicast IP forwarding entries for VLAN 2.
<Sysname> display ipv6 l2-multicast ip forwarding vlan 2
Total 1 entries.
Field Description
5
Field Description
# Display information about Layer 2 IPv6 MAC multicast groups for VSI aaa.
<Sysname> display ipv6 l2-multicast mac vsi aaa
Total 1 MAC entries.
6
Attribute: success
Host ports (3 in total):
XGE1/0/3 ( Link ID 0)
NPW (Link ID 8)
UPW (Link ID 9)
# Display information about Layer 2 IPv6 MAC multicast groups for VSI bbb.
<Sysname> display ipv6 l2-multicast mac vsi bbb
Total 1 entries.
Field Description
Host ports (1 in total) Member ports and total number of member ports.
XGE1/0/3 ( Link ID 0) AC and its link ID.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
Tun1 (VXLAN ID 0) VXLAN tunnel and its VXLAN ID.
7
Parameters
mac-address: Specifies an IPv6 MAC multicast group by its IPv6 MAC address. If you do not
specify an IPv6 MAC multicast group, this command displays Layer 2 IPv6 multicast MAC forwarding
entries for all IPv6 MAC multicast groups.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays Layer 2 IPv6 multicast MAC forwarding entries for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command displays Layer 2 IPv6 multicast MAC forwarding entries for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays Layer 2 IPv6 multicast MAC forwarding entries for the
master device.
Examples
# Display Layer 2 IPv6 multicast MAC forwarding entries for VLAN 2.
<Sysname> display ipv6 l2-multicast mac forwarding vlan 2
Total 1 entries.
# Display Layer 2 IPv6 multicast MAC forwarding entries for VSI aaa.
<Sysname> display ipv6 l2-multicast mac forwarding vsi aaa
Total 1 entries.
# Display Layer 2 IPv6 multicast MAC forwarding entries for VSI bbb.
<Sysname> display ipv6 l2-multicast mac forwarding vsi bbb
Total 1 entries.
Field Description
Total 1 MAC entries Total number of Layer 2 IPv6 multicast MAC forwarding entries.
Total number of Layer 2 IPv6 multicast MAC forwarding entries in
VLAN 2: Total 1 entries
VLAN 2.
8
Field Description
display mld-snooping
Use display mld-snooping to display MLD snooping status.
Syntax
display mld-snooping [ global | vlan vlan-id | vsi vsi-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
global: Displays the global MLD snooping status.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
If you do not specify any parameters, this command displays the global MLD snooping status and the
MLD snooping status in all VLANs and VSIs.
Examples
# Display the global MLD snooping status and the MLD snooping status for all VLANs and VSIs.
<Sysname> display mld-snooping
MLD snooping information: Global
Global-enable: Enabled
Host-aging-time: 260s
Router-aging-time: 260s
Max-response-time: 10s
Last-listener-query-interval: 1s
Report-aggregation: Enabled
Host-tracking: Disabled
Dot1p-priority: --
DRNI: Enabled (IPP: Bridge-Aggregation 1)
9
MLD snooping information: VLAN 1
MLD snooping: Enabled
Drop-unknown: Disabled
Version: 1
Host-aging-time: 260s
Router-aging-time: 260s
Max-response-time: 10s
Last-listener-query-interval: 1s
Querier: Enabled (IP: FE80::2FF:FFFF:FE00:1, Expires: 00:02:05)
Querier-election: Enabled
Query-interval: 125s
General-query source IP: FE80::2FF:FFFF:FE00:1
Special-query source IP: FE80::2FF:FFFF:FE00:1
Report source IP: FE80::2FF:FFFF:FE00:2
Done source IP: FE80::2FF:FFFF:FE00:3
Host-tracking: Disabled
Dot1p-priority: 2
Proxy: Disabled
IPP: Bridge-Aggregation 1
10
Querier: Disabled
Querier-election: Disabled
Query-interval: 125s
General-query source IP: FE80::2FF:FFFF:FE00:1
Special-query source IP: FE80::2FF:FFFF:FE00:1
Report source IP: FE80::2FF:FFFF:FE00:2
Done source IP: FE80::2FF:FFFF:FE00:3
Proxy: Disabled
IPP: Bridge-Aggregation 1 (Link ID: 0x1001)
Field Description
802.1p priority for MLD messages. This field displays two hyphens (--) if the
Dot1p-priority
802.1p priority is not configured.
Status of MLD snooping querier:
Querier • Enabled.
• Disabled.
MLD snooping querier information:
(IP: • IP—IP address of the MLD snooping querier.
FE80::2FF:FFFF:FE00:1,
• Expire—Remaining aging time for the MLD snooping querier.
Expires: 00:02:05)
This field is not displayed if MLD snooping querier election is disabled.
Status of MLD snooping querier election:
Querier-election • Enabled.
• Disabled.
Query-interval Interval for sending MLD general queries.
General-query source IP Source IPv6 address of MLD general queries.
11
Field Description
12
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays brief information about dynamic
MLD snooping group entries for all interfaces.
verbose: Displays detailed information about dynamic MLD snooping group entries. If you do not
specify this keyword, the command displays brief information about dynamic MLD snooping group
entries.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays information about dynamic MLD snooping group entries for
the master device.
Examples
# Display brief information about dynamic MLD snooping group entries for Ten-GigabitEthernet
1/0/1.
<Sysname> display mld-snooping group interface
Total 1 entries.
XGE1/0/1:
VLAN 2: Total 1 entries.
(::,FF1E::101) (00:03:23)
# Display detailed information about dynamic MLD snooping group entries for VLAN 2.
<Sysname> display mld-snooping group vlan 2 verbose
Total 2 entries.
# Display brief information about dynamic MLD snooping group entries for VSI aaa.
<Sysname> display mld-snooping group vsi aaa
Total 2 entries.
# Display detailed information about dynamic MLD snooping group entries for VSI bbb.
<Sysname> display mld-snooping group vsi bbb verbose
Total 2 entries.
13
VSI bbb: Total 2 entries.
(::,FF1E::101)
Attribute: global port
FSM information: dummy
Host slots (0 in total):
Host ports (2 in total):
XGE1/0/3 (Link ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
Tun1 (VXLAN ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
(1::1,FF1E::101)
Field Description
Member IDs and total number of the member devices that have member
Host slots (0 in total) ports, except for the specified member device or the master device when
no member device is specified.
Host ports (1 in total) Member ports and total number of member ports.
Remaining aging time for the dynamic member port.
This field is always displayed for a global port (such as Layer 2 aggregate
interfaces, ACs, N-PWs, and U-PWs).
(00:03:23) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
XGE1/0/3 (Link ID 0) AC and its link ID.
NPW (Link ID 8) N-PW and its link ID.
UPW (Link ID 9) U-PW and its link ID.
Tun1 (VXLAN ID 0) VXLAN tunnel and its VXLAN ID.
14
Field Description
VLAN pairs (1 in total) VLAN pairs and total number of VLAN pairs.
Outer VLAN 5 Inner VLAN 2 Outer VLAN ID and inner VLAN ID.
Related commands
reset mld-snooping group
Field Description
15
Field Description
Related commands
host-tracking (MLD-snooping view)
mld-snooping enable
mld-snooping host-tracking
16
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/1 (00:01:30)
XGE1/0/2 (00:00:23)
# Display brief information about dynamic router ports for VSI aaa.
<Sysname> display mld-snooping router-port vsi aaa
VSI aaa:
Router ports (3 in total):
XGE1/0/3 (Link ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
NPW (Link ID 8) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
UPW (Link ID 9) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
# Display detailed information about dynamic router ports for VSI bbb.
<Sysname> display mld-snooping router-port vsi bbb verbose
VSI bbb:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/3 (Link ID 0) (00:03:35)
VLAN pairs (1 in total):
Outer VLAN 5 Inner VLAN 2 (00:03:35)
Tun1 (VXLAN ID 0) (00:03:35)
VLAN pairs (1 in total)
Outer VLAN 5 Inner VLAN 2 (00:03:35)
Field Description
(00:01:30) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
17
Field Description
Related commands
reset mld-snooping router-port
18
Attribute: local port
FSM information: dummy
Host slots (0 in total):
Host ports (1 in total):
XGE1/0/2
Field Description
Member IDs and total number of the member devices that have member ports,
Host slots (0 in total) except for the specified member device or the master device when no member
device is specified.
Host ports (1 in total) Member ports and total number of member ports.
19
Examples
# Display brief information about static router ports for VLAN 2.
<Sysname> display mld-snooping static-router-port vlan 2
VLAN 2:
Router ports (2 in total):
XGE1/0/1
XGE1/0/2
Field Description
20
MLDv2 specific sg queries: 0
DRNI: 0
MLDv1 reports: 19
DRNI: 19
MLDv2 reports: 0
DRNI: 0
MLDv2 reports with right and wrong records: 0
DRNI: 0
MLD dones: 5
DRNI: 5
Error MLD messages: 1
DRNI: 1
Sent MLD messages:
MLDv1 specific queries: 0
MLDv2 specific queries: 0
MLDv2 specific sg queries: 0
Field Description
Related commands
reset mld-snooping statistics
21
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
priority: Specifies an 802.1p priority for MLD messages, in the range of 0 to 7. The greater the
value, the higher the priority.
Usage guidelines
You can set the 802.1p priority globally for all VLANs and VSIs in MLD-snooping view or for a VLAN
in VLAN view. For a VLAN, the VLAN-specific configuration takes priority over the global
configuration.
Examples
# Set the 802.1p priority for MLD messages to 3 globally.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] dot1p-priority 3
Related commands
mld-snooping dot1p-priority
dscp
Use dscp to set the DSCP value for outgoing MLD protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing MLD protocol packets.
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the Traffic Class field of an IPv6 packet to determine the transmission
priority of the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value to 63 for outgoing MLD protocol packets.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] dscp 63
22
enable (MLD-snooping view)
Use enable to enable MLD snooping for VLANs.
Use undo enable to disable MLD snooping for VLANs.
Syntax
enable vlan vlan-list
undo enable vlan vlan-list
Default
The MLD snooping status in a VLAN is consistent with the global MLD snooping status.
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094.
Usage guidelines
You must enable the MLD snooping feature by using the mld-snooping command before you
enable MLD snooping for VLANs.
You can enable MLD snooping for multiple VLANs by using this command in MLD-snooping view or
for a VLAN by using the mld-snooping enable command in VLAN view. The configuration in
VLAN view has the same priority as the configuration in MLD-snooping view, and the most recent
configuration takes effect.
Examples
# Enable the MLD snooping feature, and then enable MLD snooping for VLAN 2 through VLAN 10.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] enable vlan 2 to 10
Related commands
mld-snooping
mld-snooping enable
23
Default
The maximum number of MLD snooping forwarding entries is 4294967295.
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of MLD snooping forwarding entries, in the range of 0 to
4294967295.
Examples
# Set the global maximum number of MLD snooping forwarding entries to 512.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] entry-limit 512
24
[Sysname-mld-snooping] fast-leave vlan 2
Related commands
mld-snooping fast-leave
Related commands
enable (MLD-snooping view)
mld-snooping
mld-snooping disable
mld-snooping enable
25
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic or advanced ACL by its number in the range of 2000
to 3999. Hosts can join only IPv6 multicast groups that the ACL permits. If the ACL does not exist or
does not have valid rules, hosts cannot join IPv6 multicast groups.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect for all VLANs
and VSIs.
Usage guidelines
An IPv6 multicast group policy filters MLD reports to control the IPv6 multicast groups that hosts can
join.
This command does not take effect on static member ports, because static member ports do not
send MLD reports.
You can configure an IPv6 multicast group policy globally for all ports in MLD-snooping view or for a
port in interface view. For a port, the port-specific configuration takes priority over the global
configuration.
When you configure a rule in the IPv6 ACL, follow these restrictions and guidelines:
• For the rule to take effect, do not specify the vpn-instance vpn-instance option.
• In a basic ACL, the source source-address source-prefix option specifies an IPv6
multicast group address.
• In an advanced ACL, the source source-address source-prefix option specifies an
IPv6 multicast source address. The destination dest-address dest-prefix option
specifies an IPv6 multicast group address.
To match MLDv1 reports, set the source source-address source-prefix option to
0::0.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
You can configure different ACLs for all ports in different VLANs. If you configure multiple ACLs for all
ports in the same VLAN, the most recent configuration takes effect.
Examples
# Configure an IPv6 multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only IPv6
multicast group FF03::101.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff03::101 128
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] mld-snooping
[Sysname-mld-snooping] group-policy 2000 vlan 2
Related commands
mld-snooping group-policy
26
host-aging-time (MLD-snooping view)
Use host-aging-time to set the aging timer for dynamic member ports globally.
Use undo host-aging-time to restore the default.
Syntax
host-aging-time seconds
undo host-aging-time
Default
The aging timer for dynamic member ports is 260 seconds.
Views
MLD-snooping view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894
seconds.
Usage guidelines
You can set the timer globally for all VLANs and VSIs in MLD-snooping view, for a VSI in VSI view, or
for a VLAN in VLAN view. For a VSI, the VSI-specific configuration takes priority over the global
configuration. For a VLAN, the VLAN-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting IPv6 multicast group members, set the aging timer for dynamic member
ports to be greater than the value calculated by using the following formula:
[ MLD general query interval ] + [ maximum response time for MLD general queries ]
As a best practice, set the aging timer of dynamic member ports to the value calculated by using the
following formula:
[ MLD general query interval ] × 2 + [ maximum response time for MLD general queries ]
Examples
# Set the global aging timer for dynamic member ports to 300 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] host-aging-time 300
Related commands
mld-snooping host-aging-time
27
Default
Host tracking is disabled.
Views
MLD-snooping view
Predefined user roles
network-admin
Usage guidelines
You can enable host tracking globally for all VLANs in MLD-snooping view or for a VLAN in VLAN
view. For a VLAN, the global configuration has the same priority as the VLAN-specific configuration.
Examples
# Enable host tracking globally.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] host-tracking
Related commands
display mld-snooping host-tracking
mld-snooping host-tracking
28
[Sysname] mld-snooping
[Sysname-mld-snooping] last-listener-query-interval 3
Related commands
mld-snooping last-listener-query-interval
Related commands
mld-snooping max-response-time
mld-snooping query-interval
mld-snooping
Use mld-snooping to enable the MLD snooping feature and enter MLD-snooping view.
Use undo mld-snooping to disable the MLD snooping feature.
29
Syntax
mld-snooping
undo mld-snooping
Default
The MLD snooping feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
If you disable the MLD snooping feature, MLD snooping is disabled in all VLANs and VSIs.
Examples
# Enable the MLD snooping feature and enter MLD-snooping view.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping]
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping disable
30
Parameters
ipv6-address: Specifies the source IPv6 address for MLD done messages.
Usage guidelines
You must enable MLD snooping for a VLAN before you execute this command.
Examples
# In VLAN 2, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address of MLD
done messages.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping done source-ip fe80:0:0:1::1
# In VSI aaa, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address of MLD
done messages.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping done source-ip fe80:0:0:1::1
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping dot1p-priority
Use mld-snooping dot1p-priority to set the 802.1p priority for MLD messages in a VLAN.
Use undo mld-snooping dot1p-priority to restore the default.
Syntax
mld-snooping dot1p-priority priority
undo mld-snooping dot1p-priority
Default
The 802.1p priority is 6 for MLD messages in a VLAN.
Views
VLAN view
Predefined user roles
network-admin
Parameters
priority: Specifies an 802.1p priority for MLD messages, in the range of 0 to 7. The greater the
value, the higher the priority.
31
Usage guidelines
You must enable MLD snooping for a VLAN before you execute this command.
You can set the 802.1p priority for a VLAN in VLAN view or globally for all VLANs in MLD-snooping
view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.
Examples
# In VLAN 2, enable MLD snooping, and set the 802.1p priority for MLD messages to 3.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping dot1p-priority 3
Related commands
dot1p-priority (MLD-snooping view)
enable (MLD-snooping view)
mld-snooping enable
mld-snooping drop-unknown
Use mld-snooping drop-unknown to enable dropping unknown IPv6 multicast data packets for
a VLAN or VSI.
Use undo mld-snooping drop-unknown to disable dropping unknown IPv6 multicast data
packets for a VLAN or VSI.
Syntax
mld-snooping drop-unknown
undo mld-snooping drop-unknown
Default
Dropping unknown IPv6 multicast data packets is disabled. Unknown IPv6 multicast data packets
are flooded.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
Examples
# In VLAN 2, enable MLD snooping, and enable dropping unknown IPv6 multicast data packets.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
32
[Sysname-vlan2] mld-snooping drop-unknown
# In VSI aaa, enable MLD snooping, and enable dropping unknown IPv6 multicast data packets.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping drop-unknown
Related commands
enable (MLD-snooping view)
mld-snooping enable
33
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping disable
# Enable the MLD snooping feature, and then enable MLD snooping for VSI aaa.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
Related commands
enable (MLD-snooping view)
mld-snooping
mld-snooping fast-leave
Use mld-snooping fast-leave to enable fast-leave processing on a port.
Use undo mld-snooping fast-leave to disable fast-leave processing on a port.
Syntax
mld-snooping fast-leave [ vlan vlan-list ]
undo mld-snooping fast-leave [ vlan vlan-list ]
Default
Fast-leave processing is disabled on a port.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
The fast-leave processing feature enables the device to immediately remove a port from the
forwarding entry for an IPv6 multicast group when the port receives a done message.
You can enable fast-leave processing for a port in interface view or globally for all ports in
MLD-snooping view. For a port, the port-specific configuration takes priority over the global
configuration.
Examples
# Enable fast-leave processing for VLAN 2 on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
34
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping fast-leave vlan 2
Related commands
fast-leave (MLD-snooping view)
# In VSI aaa, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address for MLD
general queries.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
35
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping general-query source-ip fe80:0:0:1::1
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping group-limit
Use mld-snooping group-limit to set the maximum number of IPv6 multicast groups that a
port can join.
Use undo mld-snooping group-limit to remove the limit on the maximum number of IPv6
multicast groups that a port can join.
Syntax
mld-snooping group-limit limit [ vlan vlan-list ]
undo mld-snooping group-limit [ vlan vlan-list ]
Default
No limit is placed on the maximum number of IPv6 multicast groups that a port can join.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of multicast groups that a port can join, in the range of 0 to
4294967295.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect for all VLANs.
Usage guidelines
This command takes effect only on the IPv6 multicast groups that a port joins dynamically.
Examples
# On Ten-GigabitEthernet 1/0/1, set the maximum number to 10 for IPv6 multicast groups that the
port can join in VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping group-limit 10 vlan 2
mld-snooping group-policy
Use mld-snooping group-policy to configure an IPv6 multicast group policy on a port to
control the IPv6 multicast groups that hosts attached to the port can join.
Use undo mld-snooping group-policy to delete IPv6 multicast group policies on a port.
36
Syntax
mld-snooping group-policy ipv6-acl-number [ vlan vlan-list ]
undo mld-snooping group-policy [ vlan vlan-list ]
Default
No IPv6 multicast group policies exist. Hosts attached to the port can join any IPv6 multicast groups.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic or advanced ACL number in the range of 2000 to
3999. Hosts can join only the IPv6 multicast groups that the ACL permits. If the ACL does not exist or
does not have valid rules, hosts cannot join IPv6 multicast groups.
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
An IPv6 multicast group policy filters MLD reports to control the IPv6 multicast groups that hosts can
join.
This command does not take effect on static member ports, because static member ports do not
send MLD reports.
You can configure an IPv6 multicast group policy for a port in interface view or globally for all ports in
MLD-snooping view. For a port, the port-specific configuration takes priority over the global
configuration.
When you configure a rule in the IPv6 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-prefix option specifies an IPv6
multicast group address.
• In an advanced ACL, the source source-address source-prefix option specifies an
IPv6 multicast source address. The destination dest-address dest-prefix option
specifies an IPv6 multicast group address.
To match MLDv1 reports and MLD IS_EX and MLDv2 TO_EX reports that do not carry IPv6
multicast source addresses, set the source source-address source-prefix option to
0::0.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
You can configure different ACLs for different VLANs on a port. If you configure multiple ACLs for the
same VLANs on a port, the most recent configuration takes effect.
Examples
# On Ten-GigabitEthernet 1/0/1, configure an IPv6 multicast group policy for VLAN 2 so that hosts
attached to the port in VLAN 2 can join only the group FF03::101.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff03::101 128
[Sysname-acl-ipv6-basic-2000] quit
37
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping group-policy 2000 vlan 2
Related commands
group-policy (MLD-snooping view)
mld-snooping host-aging-time
Use mld-snooping host-aging-time to set the aging timer for dynamic member ports in a
VLAN or VSI.
Use undo mld-snooping host-aging-time to restore the default.
Syntax
mld-snooping host-aging-time seconds
undo mld-snooping host-aging-time
Default
The aging timer for dynamic member ports is 260 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894
seconds.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
You can set the timer for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in MLD-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting IPv6 multicast group members, set the aging timer for dynamic member
ports to be greater than the value calculated by using the following formula:
[ MLD general query interval ] + [ maximum response time for MLD general queries ]
As a best practice, set the aging timer of dynamic member ports to the value calculated by using the
following formula:
[ MLD general query interval ] × 2 + [ maximum response time for MLD general queries ]
Examples
# In VLAN 2, enable MLD snooping, and set the aging timer for dynamic member ports in the VLAN
to 300 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
38
[Sysname-vlan2] mld-snooping host-aging-time 300
# In VSI aaa, enable MLD snooping, and set the aging timer for dynamic member ports in the VSI to
300 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping host-aging-time 300
Related commands
enable (MLD-snooping view)
host-aging-time (MLD-snooping view)
mld-snooping enable
mld-snooping host-join
Use mld-snooping host-join to configure a port as a simulated member host for an IPv6
multicast group or an IPv6 multicast source and group.
Use undo mld-snooping host-join to remove the configuration of a simulated member host
for an IPv6 multicast group.
Syntax
mld-snooping host-join ipv6-group-address [ source-ip
ipv6-source-address ] vlan vlan-id
undo mld-snooping host-join { ipv6-group-address [ source-ip
ipv6-source-address ] vlan vlan-id | all }
Default
A port is not a simulated member host of any IPv6 multicast groups or any IPv6 multicast sources
and groups.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F.
source-ip ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If
you specify an IPv6 multicast source, this command configures the port as a simulated member host
for an IPv6 multicast source and group. If you do not specify an IPv6 multicast source, this command
configures the port as a simulated member host for an IPv6 multicast group. This option takes effect
on MLDv2 snooping devices.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
all: Specifies all IPv6 multicast groups and all IPv6 multicast sources and groups.
39
Usage guidelines
The version of MLD running on a simulated member host is the same as the version of MLD
snooping running on the port. The port ages out in the same way as a dynamic member port.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a simulated member host for the IPv6 multicast group (*,
FF3E::101) in VLAN 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] quit
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping host-join ff3e::101 vlan 2
mld-snooping host-tracking
Use mld-snooping host-tracking to enable host tracking for a VLAN.
Use undo mld-snooping host-tracking to disable host tracking for a VLAN.
Syntax
mld-snooping host-tracking
undo mld-snooping host-tracking
Default
Host tracking is disabled.
Views
VLAN view
Predefined user roles
network-admin
Usage guidelines
You must enable MLD snooping for a VLAN before you execute this command for the VLAN.
You can enable host tracking for a VLAN in VLAN view or globally for all VLANs in MLD-snooping
view. For a VLAN, the VLAN-specific configuration has the same priority as the global configuration.
Examples
# In VLAN 2, enable MLD snooping, and then enable host tracking.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping host-tracking
Related commands
display mld-snooping host-tracking
host-tracking (MLD-snooping view)
40
mld-snooping enable
mld-snooping last-listener-query-interval
Use mld-snooping last-listener-query-interval to set the MLD last listener query
interval for a VLAN or VSI.
Use undo mld-snooping last-listener-query-interval to restore the default.
Syntax
mld-snooping last-listener-query-interval interval
undo mld-snooping last-listener-query-interval
Default
The MLD last listener query interval is 1 second.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
interval: Specifies an MLD last listener query interval in the range of 1 to 25 seconds.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
You can set the interval for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in MLD-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
Examples
# In VLAN 2, enable MLD snooping, and set the MLD last listener query interval to 3 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping last-listener-query-interval 3
# In VSI aaa, enable MLD snooping, and set the MLD last listener query interval to 3 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping last-listener-query-interval 3
Related commands
enable (MLD-snooping view)
last-listener-query-interval (MLD-snooping view)
41
mld-snooping enable
mld-snooping max-response-time
Use mld-snooping max-response-time to set the maximum response time for MLD general
queries in a VLAN or VSI.
Use undo mld-snooping max-response-time to restore the default.
Syntax
mld-snooping max-response-time seconds
undo mld-snooping max-response-time
Default
The maximum response time for MLD general queries is 10 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies the maximum response time for MLD general queries, in the range of 1 to 3174
seconds.
Usage guidelines
You must enable MLD snooping for a VLAN before you execute this command.
You can set the time for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in MLD-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
To avoid mistakenly deleting IPv6 multicast group members, set the maximum response time for
MLD general queries to be less than the MLD general query interval.
Examples
# In VLAN 2, enable MLD snooping, and set the maximum response time for MLD general queries to
5 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping max-response-time 5
# In VSI aaa, enable MLD snooping, and set the maximum response time for MLD general queries to
5 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
42
[Sysname-vsi-aaa] mld-snooping max-response-time 5
Related commands
enable (MLD-snooping view)
max-response-time (MLD-snooping view)
mld-snooping enable
mld-snooping query-interval
mld-snooping overflow-replace
Use mld-snooping overflow-replace to enable the IPv6 multicast group replacement
feature on a port.
Use undo mld-snooping overflow-replace to disable the multicast group replacement
feature on a port.
Syntax
mld-snooping overflow-replace [ vlan vlan-list ]
undo mld-snooping overflow-replace [ vlan vlan-list ]
Default
The IPv6 multicast group replacement feature is disabled.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
This command takes effect only on the IPv6 multicast groups that a port joins dynamically.
You can enable the IPv6 multicast group replacement feature for a port in interface view or globally
for all ports in MLD-snooping view. For a port, the port-specific configuration takes priority over the
global configuration.
Examples
# On Ten-GigabitEthernet 1/0/1, enable the IPv6 multicast group replacement feature for VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping overflow-replace vlan 2
Related commands
overflow-replace (MLD-snooping view)
43
mld-snooping proxy enable
Use mld-snooping proxy enable to enable MLD snooping proxying for a VLAN or VSI.
Use undo mld-snooping proxy enable to disable MLD snooping proxying for a VLAN or VSI.
Syntax
mld-snooping proxy enable
undo mld-snooping proxy enable
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
This command does not take effect on a VLAN that is a sub-VLAN of an IPv6 multicast VLAN.
Examples
# In VLAN 2, enable MLD snooping, and enable MLD snooping proxying.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping proxy enable
# In VSI aaa, enable MLD snooping, and enable MLD snooping proxying.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping proxy enable
Related commands
enable (MLD-snooping view)
mld-snooping enable
subvlan (IPv6 multicast-VLAN view)
mld-snooping querier
Use mld-snooping querier to enable the MLD snooping querier.
Use undo mld-snooping querier to disable the MLD snooping querier.
Syntax
mld-snooping querier
undo mld-snooping querier
44
Default
The MLD snooping querier is disabled.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
For a sub-VLAN of an IPv6 multicast VLAN, this command takes effect only after you remove the
VLAN from the IPv6 multicast VLAN.
Examples
# In VLAN 2, enable MLD snooping, and enable the MLD snooping querier.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping querier
# In VSI aaa, enable MLD snooping, and enable the MLD snooping querier.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping querier
Related commands
enable (MLD-snooping view)
mld-snooping enable
subvlan (IPv6 multicast-VLAN view)
mld-snooping querier-election
Use mld-snooping querier-election to enable MLD snooping querier election for a VLAN
or VSI.
Use undo mld-snooping querier-election to disable MLD snooping querier election for a
VLAN or VSI.
Syntax
mld-snooping querier-election
undo mld-snooping querier-election
Default
MLD snooping querier election is disabled.
45
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
For MLD snooping querier election to take effect, you must enable the MLD snooping querier.
Examples
# In VLAN 2, enable MLD snooping, and enable MLD snooping querier election.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping querier
[Sysname-vlan2] mld-snooping querier-election
# In VSI aaa, enable MLD snooping, and enable MLD snooping querier election.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping querier
[Sysname-vsi-aaa] mld-snooping querier-election
Related commands
mld-snooping querier
mld-snooping query-interval
Use mld-snooping query-interval to set the MLD general query interval for a VLAN or VSI.
Use undo mld-snooping query-interval to restore the default.
Syntax
mld-snooping query-interval interval
undo mld-snooping query-interval
Default
The MLD general query interval is 125 seconds.
Views
VLAN view
VSI view
Predefined user roles
network-admin
46
Parameters
interval: Specifies an MLD general query interval, in the range of 2 to 31744 seconds.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command for the VLAN.
To avoid mistakenly deleting IPv6 multicast group members, set the MLD general query interval to be
greater than the maximum response time for MLD general queries.
Examples
# In VLAN 2, enable MLD snooping, and set the MLD general query interval to 20 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping query-interval 20
# In VSI aaa, enable MLD snooping, and set the MLD general query interval to 20 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping query-interval 20
Related commands
enable (MLD-snooping view)
max-response-time
mld-snooping enable
mld-snooping max-response-time
mld-snooping querier
47
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies the source IPv6 address for MLD reports.
Usage guidelines
You must enable MLD snooping for a VLAN before you execute this command.
Examples
# In VLAN 2, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address for MLD
reports.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping report source-ip fe80:0:0:1::1
# In VSI aaa, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address for MLD
reports.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping report source-ip fe80:0:0:1::1
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping router-aging-time
Use mld-snooping router-aging-time to set the aging timer for dynamic router ports in a
VLAN or VSI.
Use undo mld-snooping router-aging-time to restore the default.
Syntax
mld-snooping router-aging-time seconds
undo mld-snooping router-aging-time
Default
The aging timer for dynamic router ports is 260 seconds.
Views
VLAN view
VSI view
48
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
You can set the timer for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and
VSIs in MLD-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the
global configuration. For a VSI, the VSI-specific configuration takes priority over the global
configuration.
Examples
# In VLAN 2, enable MLD snooping, and set the aging timer for dynamic router ports in the VLAN to
100 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping router-aging-time 100
# In VSI aaa, enable MLD snooping, and set the aging timer for dynamic router ports in the VSI to
100 seconds.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping router-aging-time 100
Related commands
enable (MLD-snooping view)
mld-snooping enable
router-aging-time (MLD-snooping view)
mld-snooping router-port-deny
Use mld-snooping router-port-deny to disable a port from becoming a dynamic router port.
Use undo mld-snooping router-port-deny to allow a port to become a dynamic router port.
Syntax
mld-snooping router-port-deny [ vlan vlan-list ]
undo mld-snooping router-port-deny [ vlan vlan-list ]
Default
A port is allowed to become a dynamic router port.
Views
Layer 2 Ethernet interface view
49
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you specify VLANs, this command takes effect only when the port
belongs to the specified VLANs. If you do not specify a VLAN, this command takes effect on all
VLANs.
Examples
# Disable Ten-GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping router-port-deny vlan 2
mld-snooping source-deny
Use mld-snooping source-deny to enable IPv6 multicast source port filtering on a port to
discard all IPv6 multicast data packets.
Use undo mld-snooping source-deny to disable IPv6 multicast source port filtering on a port.
Syntax
mld-snooping source-deny
undo mld-snooping source-deny
Default
IPv6 multicast source port filtering is disabled.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
You can enable this feature for a port in interface view or for the specified ports in MLD-snooping
view. For a port, the configuration in interface view has the same priority as the configuration in
MLD-snooping view, and the most recent configuration takes effect.
Examples
# Enable source port filtering for IPv6 multicast data on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping source-deny
Related commands
source-deny (MLD-snooping view)
50
mld-snooping special-query source-ip
Use mld-snooping special-query source-ip to configure the source IPv6 address for
MLD multicast-address-specific queries.
Use undo mld-snooping special-query source-ip to restore the default.
Syntax
mld-snooping special-query source-ip ipv6-address
undo mld-snooping special-query source-ip
Default
In a VLAN, the source IPv6 address of MLD multicast-address-specific queries is one of the
following:
• The source address of MLD general queries if the MLD snooping querier of the VLAN has
received MLD general queries.
• The IPv6 link-local address of the current VLAN interface if the MLD snooping querier does not
receive an MLD general query.
• FE80::02FF:FFFF:FE00:0001 if the MLD snooping querier does not receive an MLD general
query and the current VLAN interface does not have an IPv6 link-local address.
In a VSI, the source IPv6 address of MLD multicast-address-specific queries is one of the following:
• The source address of MLD general queries if the MLD snooping querier of the VSI has
received MLD general queries.
• The IPv6 link-local address of the gateway interface for the VSI if the MLD snooping querier
does not receive an MLD general query.
• FE80::02FF:FFFF:FE00:0001 if the gateway interface does not have an IPv6 link-local
address.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies the source IPv6 address for MLD multicast-address-specific queries.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you execute this command.
Examples
# In VLAN 2, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address of MLD
multicast-address-specific queries.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping special-query source-ip fe80:0:0:1::1
# In VSI aaa, enable MLD snooping, and specify FE80:0:0:1::1 as the source IPv6 address of MLD
multicast-address-specific queries.
51
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping special-query source-ip fe80:0:0:1::1
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping static-group
Use mld-snooping static-group to configure a port as a static member port of an IPv6
multicast group or an IPv6 multicast source and group.
Use undo mld-snooping static-group to delete the configuration of static member ports.
Syntax
mld-snooping static-group ipv6-group-address [ source-ip
ipv6-source-address ] vlan vlan-id
undo mld-snooping static-group { ipv6-group-address [ source-ip
ipv6-source-address ] vlan vlan-id | all }
Default
A port is not a static member port of IPv6 multicast groups.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F.
source-ip ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If
you specify an IPv6 multicast source, this command configures the port as a static member port of an
IPv6 multicast source and group. If you do not specify an IPv6 multicast source, this command
configures the port as a static member port of an IPv6 multicast group. This option takes effect on
MLDv2 snooping devices.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
all: Specifies all IPv6 multicast groups and all IPv6 multicast sources and groups.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a static member port for the IPv6 multicast group (*,
FF3E::101) in VLAN 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
52
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] quit
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping static-group ff3e::101 vlan 2
mld-snooping static-router-port
Use mld-snooping static-router-port to configure a port as a static router port.
Use undo mld-snooping static-router-port to remove the configuration of static router
ports.
Syntax
mld-snooping static-router-port vlan vlan-id
undo mld-snooping static-router-port { all | vlan vlan-id }
Default
A port is not a static router port.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
all: Specifies all VLANs.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
Examples
# Configure Ten-GigabitEthernet 1/0/1 as a static router port in VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mld-snooping static-router-port vlan 2
mld-snooping version
Use mld-snooping version to specify an MLD snooping version for a VLAN or VSI.
Use undo mld-snooping version to restore the default.
Syntax
mld-snooping version version-number
undo mld-snooping version
Default
The MLD snooping version in a VLAN or VSI is 1.
Views
VLAN view
53
VSI view
Predefined user roles
network-admin
Parameters
version-number: Specifies an MLD snooping version, 1 or 2.
Usage guidelines
You must enable MLD snooping for a VLAN or VSI before you configure this command.
You can specify the version for a VLAN in VLAN view or for the specified VLANs in MLD-snooping
view. The VLAN-specific configuration has the same priority as the configuration in MLD-snooping
view, and the most recent configuration takes effect.
Examples
# In VLAN 2, enable MLD snooping, and specify MLD snooping version 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] mld-snooping version 2
# In VSI aaa, enable MLD snooping, and specify MLD snooping version 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] mld-snooping version 2
Related commands
enable (MLD-snooping view)
mld-snooping enable
version (MLD-snooping view)
54
Predefined user roles
network-admin
Parameters
vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a
VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN
ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.
Usage guidelines
This command takes effect only on the IPv6 multicast groups that a port joins dynamically.
You can enable IPv6 multicast group replacement globally for all ports in MLD-snooping view or for a
port in interface view. For a port, the port-specific configuration takes priority over the global
configuration.
Examples
# Globally enable the IPv6 multicast group replacement feature for VLAN 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] overflow-replace vlan 2
Related commands
mld-snooping overflow-replace
55
Syntax
reset ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ]
{ { ipv6-source-address | ipv6-group-address } * | all } [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command clears Layer 2 IPv6 multicast fast forwarding entries for the master
device.
all: Specifies all Layer 2 IPv6 multicast fast forwarding entries.
Examples
# Clear all Layer 2 IPv6 multicast fast forwarding entries.
<Sysname> reset ipv6 l2-multicast fast-forwarding cache all
# Clear the Layer 2 IPv6 multicast fast forwarding entry for the IPv6 group (*, FF1E::2).
<Sysname> reset ipv6 l2-multicast fast-forwarding cache FF1E::2
Related commands
display ipv6 l2-multicast fast-forwarding cache
56
all: Specifies all IPv6 multicast groups.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command clears information about dynamic MLD snooping group entries for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do
not specify a VSI, this command clears information about dynamic MLD snooping group entries for
all VSIs.
Examples
# Clear information about all dynamic MLD snooping group entries.
<Sysname> reset mld-snooping group all
Related commands
display mld-snooping group
Related commands
display mld-snooping router-port
57
Predefined user roles
network-admin
Examples
# Clear statistics for all MLD messages and IPv6 PIM hello messages learned through MLD
snooping.
<Sysname> reset mld-snooping statistics
Related commands
display mld-snooping statistics
Related commands
mld-snooping router-aging-time
send-query enable
Use send-query enable to enable the device to send MLD general queries upon a path change.
Use undo send-query enable to restore the default.
58
Syntax
send-query enable
undo send-query enable
Default
The device does not send MLD general queries upon a path change.
Views
MLD-snooping view
Predefined user roles
network-admin
Usage guidelines
Use this command to enable the device to immediately send an MLD general query to all ports in the
affected VLAN or VSI when the path changes. This feature ensures that the device can update the
member port information in IPv6 multicast forwarding entries and switch IPv6 multicast traffic to the
new path promptly.
Examples
# Enable the device to send MLD general queries upon a path change.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] send-query enable
Related commands
mld-snooping
59
Usage guidelines
You can enable this feature for the specified ports in MLD-snooping view or for a port in interface
view. For a port, the configuration in MLD-snooping view has the same priority as the configuration in
interface view, and the most recent configuration takes effect.
Examples
# Enable source port filtering for IPv6 multicast data on ports Ten-GigabitEthernet 1/0/1 through
Ten-GigabitEthernet 1/0/4.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] source-deny port ten-gigabitethernet 1/0/1 to ten-gigabitethernet
1/0/4
Related commands
mld-snooping source-deny
60
[Sysname-mld-snooping] version 2 vlan 2 to 10
Related commands
enable (MLD-snooping view)
mld-snooping enable
mld-snooping version
61
Contents
IPv6 PIM snooping commands ······································································ 1
display ipv6 pim-snooping neighbor ··········································································································· 1
display ipv6 pim-snooping router-port ········································································································ 2
display ipv6 pim-snooping routing-table ····································································································· 3
display ipv6 pim-snooping statistics ··········································································································· 5
ipv6 pim-snooping enable ·························································································································· 5
ipv6 pim-snooping graceful-restart join-aging-time ···················································································· 6
ipv6 pim-snooping graceful-restart neighbor-aging-time ············································································ 7
reset ipv6 pim-snooping statistics ·············································································································· 8
i
IPv6 PIM snooping commands
display ipv6 pim-snooping neighbor
Use display ipv6 pim-snooping neighbor to display IPv6 PIM snooping neighbor
information.
Syntax
display ipv6 pim-snooping neighbor [ vlan vlan-id ] [ slot slot-number ]
[ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a
VLAN, this command displays IPv6 PIM snooping neighbor information for all VLANs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays IPv6 PIM snooping neighbor information for the master
device.
verbose: Displays detailed information about IPv6 PIM snooping neighbors. If you do not specify
this keyword, the command displays brief information about IPv6 PIM snooping neighbors.
Examples
# Display detailed information about IPv6 PIM snooping neighbors for VLAN 2.
<Sysname> display ipv6 pim-snooping neighbor vlan 2 verbose
Total 2 neighbors.
Field Description
Total 2 neighbors Total number of IPv6 PIM snooping neighbors.
VLAN 2: Total 2 neighbors Total number of IPv6 PIM snooping neighbors in VLAN 2.
Slots (0 in total) Member IDs and total number of the member devices that have the
1
Field Description
neighbor, except for the specified member device or the master device
when no member device is specified.
Ports where IPv6 PIM snooping neighbors reside, and the total number
Ports (1 in total)
of the ports.
Remaining aging time for an IPv6 PIM snooping neighbor on the port.
This field is always displayed for a global port (such as Layer 2
aggregate interfaces).
(02:02:23) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is
specified.
IPv6 PIM hello message sent by the IPv6 PIM snooping neighbor has
LAN Prune Delay
the LAN_Prune_Delay option.
The join report suppression feature has been disabled for the IPv6 PIM
(T)
snooping neighbor.
2
# Display detailed information about IPv6 PIM snooping router ports for VLAN 2.
<Sysname> display ipv6 pim-snooping router-port vlan 2 verbose
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
XGE1/0/1 (00:01:30)
XGE1/0/2 (00:01:32)
Field Description
VLAN 2 VLAN ID.
Member IDs and total number of the member devices that have router
Router slots (0 in total) ports, except for the specified member device or the master device when
no member device is specified.
Router ports (2 in total) Router ports and total number of router ports.
Remaining aging time for the router port.
For a global port, this field is always displayed.
(00:01:30) For a non-global port, this field is displayed when one of the following
conditions exists:
• The port is on the specified member device.
• The port is on the master device and no member device is specified.
3
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
Field Description
Total 1 entries Total number of (S, G) and (*, G) entries.
State machine flag of the downstream port:
FSM Flag: NI-no info, J-join, • NI—Initial state.
PP-prune pending • J—Join.
• PP—Prune pending.
4
Field Description
ports.
Downstream Neighbors (2 in Downstream neighbors of the downstream port, and the total number of the
total) neighbors.
Field Description
Received IPv6 PIM hello Number of received IPv6 PIM hello messages.
Received IPv6 PIM join/prune Number of received IPv6 PIM join/prune messages.
Received IPv6 PIM error Number of received IPv6 PIM messages with errors.
Received IPv6 PIM messages in total Total number of received IPv6 PIM messages.
Related commands
reset ipv6 pim-snooping statistics
5
Use undo ipv6 pim-snooping enable to disable IPv6 PIM snooping for a VLAN.
Syntax
ipv6 pim-snooping enable
undo ipv6 pim-snooping enable
Default
IPv6 PIM snooping is disabled for a VLAN.
Views
VLAN view
Predefined user roles
network-admin
Usage guidelines
IPv6 PIM snooping does not take effect on sub-VLANs of IPv6 multicast VLANs.
You must enable the MLD snooping feature and enable MLD snooping for a VLAN before you
execute this command.
Examples
# Enable the MLD snooping feature, and then enable MLD snooping and IPv6 PIM snooping for
VLAN 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
Related commands
mld-snooping
mld-snooping enable
6
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging time in the range of 210 to 18000 seconds.
Usage guidelines
You must enable IPv6 PIM snooping for a VLAN before you execute this command.
Global ports include Layer 2 aggregate interfaces. A global downstream port or a global router port is
a global port that acts as a downstream port or router port, respectively.
Examples
# In VLAN 2, set the aging time to 300 seconds for global downstream ports and global router ports
on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
[Sysname-vlan2] ipv6 pim-snooping graceful-restart join-aging-time 300
Related commands
ipv6 pim-snooping enable
7
Examples
# In VLAN 2, set the aging time to 300 seconds for global neighbor ports on the new master device
after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
[Sysname-vlan2] ipv6 pim-snooping graceful-restart neighbor-aging-time 300
Related commands
ipv6 pim-snooping enable
Related commands
display ipv6 pim-snooping statistics
8
Contents
IPv6 multicast VLAN commands ···································································· 1
display ipv6 multicast-vlan ························································································································· 1
display ipv6 multicast-vlan forwarding-table······························································································· 2
display ipv6 multicast-vlan group ··············································································································· 3
ipv6 multicast-vlan······································································································································ 5
ipv6 multicast-vlan entry-limit ····················································································································· 6
ipv6 port multicast-vlan ······························································································································ 7
port (IPv6 multicast VLAN view)················································································································· 7
reset ipv6 multicast-vlan group ·················································································································· 8
subvlan (IPv6 multicast VLAN view) ·········································································································· 9
i
IPv6 multicast VLAN commands
display ipv6 multicast-vlan
Use display ipv6 multicast-vlan to display information about IPv6 multicast VLANs.
Syntax
display ipv6 multicast-vlan [ vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan-id: Specifies an IPv6 multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not
specify an IPv6 multicast VLAN, this command displays information about all IPv6 multicast VLANs.
Examples
# Display information about all IPv6 multicast VLANs.
<Sysname> display ipv6 multicast-vlan
Total 2 IPv6 multicast VLANs.
Field Description
1
display ipv6 multicast-vlan forwarding-table
Use display ipv6 multicast-vlan forwarding-table to display IPv6 multicast VLAN
forwarding entries.
Syntax
display ipv6 multicast-vlan forwarding-table [ ipv6-source-address
[ prefix-length ] | ipv6-group-address [ prefix-length ] | slot slot-number
| subvlan vlan-id | vlan vlan-id ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not
specify an IPv6 multicast source, this command displays IPv6 multicast VLAN forwarding entries for
all IPv6 multicast sources.
prefix-length: Specifies a prefix length of the IPv6 multicast source address. The value range is
0 to 128 and the default value is 128.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
If you do not specify an IPv6 multicast group, this command displays IPv6 multicast VLAN forwarding
entries for all IPv6 multicast groups.
prefix-length: Specifies a prefix length of the IPv6 multicast group address. The value range is
8 to 128 and the default value is 128.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays IPv6 multicast VLAN forwarding entries for the master
device.
subvlan vlan-id: Specifies a sub-VLAN by its VLAN ID. If you do not specify a sub-VLAN, this
command displays IPv6 multicast VLAN forwarding entries for all sub-VLANs.
vlan vlan-id: Specifies an IPv6 multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do
not specify an IPv6 multicast VLAN, this command displays IPv6 multicast VLAN forwarding entries
for all VLANs.
Examples
# Display all IPv6 multicast VLAN forwarding entries.
<Sysname> display ipv6 multicast-vlan forwarding-table
IPv6 multicast VLAN 100 Forwarding Table
Total 1 entries, 1 matched
2
Table 2 Command output
Field Description
3
verbose: Displays detailed information. If you do not specify the keyword, this command displays
brief information.
vlan vlan-id: Specifies an IPv6 multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do
not specify an IPv6 multicast VLAN, this command displays information about IPv6 multicast groups
for all IPv6 multicast VLANs.
Examples
# Display detailed information about all IPv6 multicast groups in IPv6 multicast VLANs.
<Sysname> display ipv6 multicast-vlan group verbose
Total 6 entries.
Field Description
4
Field Description
multicast VLAN.
• 0x40—The entry is to be deleted.
• 0x10000000—This value represents one of the following
situations:
The entry is newly created.
The device receives an MLD query within an MLD
general query interval.
• 0x20000000—The device does not receive MLDv1 or
MLDv2 reports that match the entry within an MLD
general query interval.
• 0x40000000—The device does not receive MLDv2 IS_EX
(NULL) reports that match the entry within an MLD
general query interval.
Sub-VLAN list of the IPv6 multicast VLAN, and the total number
Sub-VLANs (1 in total)
of the sub-VLANs.
Related commands
reset ipv6 multicast-vlan group
ipv6 multicast-vlan
Use ipv6 multicast-vlan to configure an IPv6 multicast VLAN and enter its view, or enter the
view of an existing IPv6 multicast VLAN.
Use undo ipv6 multicast-vlan to remove the configuration of IPv6 multicast VLANs.
Syntax
ipv6 multicast-vlan vlan-id
undo ipv6 multicast-vlan { all | vlan-id }
Default
No IPv6 multicast VLANs exist.
Views
System view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies an existing VLAN ID in the range of 1 to 4094.
all: Specifies all IPv6 multicast VLANs.
Usage guidelines
The total number of IPv6 multicast VLANs on the device cannot exceed 5.
You must enable MLD snooping for the VLAN to be configured as an IPv6 multicast VLAN.
As a best practice, do not configure an IPv6 multicast VLAN on a device that is enabled with IPv6
multicast routing.
Examples
# Enable MLD snooping for VLAN 100. Configure VLAN 100 as an IPv6 multicast VLAN and enter its
view.
5
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 100
[Sysname-vlan100] mld-snooping enable
[Sysname-vlan100] quit
[Sysname] ipv6 multicast-vlan 100
[Sysname-ipv6-mvlan-100]
Related commands
ipv6 multicast routing
mld-snooping enable
Related commands
entry-limit (MLD-snooping view)
6
ipv6 port multicast-vlan
Use ipv6 port multicast-vlan to assign a user port to an IPv6 multicast VLAN.
Use undo ipv6 port multicast-vlan to restore the default.
Syntax
ipv6 port multicast-vlan vlan-id
undo ipv6 port multicast-vlan
Default
A port does not belong to an IPv6 multicast VLAN.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies an IPv6 multicast VLAN by its VLAN ID in the range of 1 to 4094.
Usage guidelines
You can assign a port to only one IPv6 multicast VLAN.
For the port to be assigned to an IPv6 multicast VLAN, you must enable MLD snooping for the VLAN
to which the port belongs.
Examples
# Assign Ten-GigabitEthernet 1/0/1 to IPv6 multicast VLAN 100.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ipv6 port multicast-vlan 100
7
Parameters
interface-list: Specifies a port in the form of interface-type interface-number, or a
port range in the form of interface-type interface-number to interface-type
interface-number.
all: Specifies all user ports in the current IPv6 multicast VLAN.
Usage guidelines
You can assign only Layer 2 Ethernet interfaces or Layer 2 aggregate interfaces as user ports to an
IPv6 multicast VLAN. Additionally, you can assign a port to only one IPv6 multicast VLAN.
For ports to be assigned to an IPv6 multicast VLAN, you must enable MLD snooping for the VLANs
to which the ports belong.
Examples
# Assign Ten-GigabitEthernet 1/0/1 through Ten-GigabitEthernet 1/0/5 as user ports to IPv6
multicast VLAN 100.
<Sysname> system-view
[Sysname] ipv6 multicast-vlan 100
[Sysname-ipv6-mvlan-100] port ten-gigabitethernet 1/0/1 to ten-gigabitethernet 1/0/5
8
<Sysname> reset ipv6 multicast-vlan group
Related commands
display ipv6 multicast-vlan group
9
Contents
IPv6 multicast routing and forwarding commands ·········································· 1
display ipv6 mrib interface·························································································································· 1
display ipv6 multicast boundary ················································································································· 2
display ipv6 multicast fast-forwarding cache ······························································································ 3
display ipv6 multicast forwarding event······································································································ 4
display ipv6 multicast forwarding-table ······································································································ 6
display ipv6 multicast routing-table ············································································································ 8
display ipv6 multicast rpf-info ····················································································································· 9
ipv6 mtrace-service port ··························································································································· 10
ipv6 multicast boundary ··························································································································· 11
ipv6 multicast forwarding supervlan community······················································································· 12
ipv6 multicast routing ······························································································································· 13
load-splitting (IPv6 MRIB view) ················································································································ 13
longest-match (IPv6 MRIB view) ·············································································································· 14
mtrace v2 ipv6 ·········································································································································· 14
reset ipv6 multicast fast-forwarding cache ······························································································· 18
reset ipv6 multicast forwarding event ······································································································· 19
reset ipv6 multicast forwarding-table········································································································ 19
reset ipv6 multicast routing-table ············································································································· 20
i
IPv6 multicast routing and forwarding
commands
display ipv6 mrib interface
Use display ipv6 mrib interface to display information about interfaces maintained by the
IPv6 MRIB.
Syntax
display ipv6 mrib interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do
not specify an interface, this command displays information about all interfaces maintained by the
IPv6 MRIB.
Examples
# Display information about interfaces maintained by the IPv6 MRIB.
<Sysname> display ipv6 mrib interface
Interface: Vlan-interface1
Index: 0x00004444
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : FE80:7:11::1/10
Remote address: ::
Reference : 1
State : NORMAL
Flags : 0x0
Field Description
Interface Interface name.
Index Index number of the interface.
Current state Current status of the interface: up or down.
MTU MTU value.
Type Interface type:
1
Field Description
• BROADCAST—Broadcast link interface.
• LOOP—Loopback interface.
• REGISTER—Register interface.
• MTUNNEL—Multicast tunnel interface.
This field is empty if the interface is Null 0.
Protocol Protocol running on the interface: PIM-DM, PIM-SM, MLD, or PROXY.
PIM protocol state Whether IPv6 PIM is enabled: Enabled or Disabled.
Address list Interface address list.
Local address Local IP address.
Remote end IP address. This field is displayed only when the interface is vlink
Remote address
type.
Reference Number of times that the address has been used.
State Status of the interface address: NORMAL or DEL.
Interface attribute:
Flags • 0x0—The interface is in normal status.
• 0x1—The interface address is being deleted.
2
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays IPv6 multicast boundary
information for all interfaces.
Examples
# Display IPv6 multicast boundary information of all IPv6 multicast groups for all interfaces.
<Sysname> display ipv6 multicast boundary group
Boundary Interface
FF1E::/64 Vlan1
# Display IPv6 multicast boundary information in all IPv6 admin-scope zones for all interfaces.
<Sysname> display ipv6 multicast boundary scope
Boundary Interface
3 Vlan-interface1
Field Description
IPv6 multicast group or IPv6 admin-scoped zone associated with the IPv6 multicast
Boundary
boundary.
Related commands
ipv6 multicast boundary
3
(FE1F:60::200, FF0E::1)
Status : Enabled
Source port: 2001 Destination port: 2002
Protocol : 2 Flag : 0x2
Incoming interface: Vlan-interface1
List of 1 outgoing interfaces:
Vlan-interface2
Status: Enabled Flag: 0x14
Field Description
Total number of (S, G) entries, and the total number of matching (S, G)
Total 1 entries, 1 matched
entries.
(FE1F:60::200, FF0E::1) (S, G) entry.
Protocol Protocol number.
Flag for the (S, G) entry or the outgoing interface of the entry.
This field displays one flag or the sum of multiple flags. In this example,
the value 0x2 means that the entry has only one flag 0x2. The value
0x14 means that the outgoing interface has flags 0x10 and 0x4.
The following flags are available for an entry:
• 0x1—The entry is created because of packets passed through
between cards.
• 0x2—The entry is added by IPv6 multicast forwarding.
Related commands
reset ipv6 multicast fast-forwarding cache all
4
Syntax
display ipv6 multicast forwarding event [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays statistics of IPv6 multicast forwarding events for the master
device.
Examples
# Display statistics of IPv6 multicast forwarding events.
<Sysname> display ipv6 multicast forwarding event
Total active events sent: 0
Total inactive events sent: 0
Total NoCache events sent: 2
Total NoCache events dropped: 0
Total WrongIF events sent: 0
Total WrongIF events dropped: 0
Total SPT switch events sent: 0
NoCache rate limit: 1024 packets/s
WrongIF rate limit: 1 packets/10s
Total timer of register suppress timeout: 0
Field Description
Total active events sent Number of times that entry-active events have been sent.
Total inactive events sent Number of times that entry-inactive events have been sent.
Total NoCache events sent Number of times that NoCache events have been sent.
Total NoCache events dropped Number of times that NoCache events have been dropped.
Total WrongIF events sent Number of times that WrongIF events have been sent.
Total WrongIF events dropped Number of times that WrongIF events have been dropped.
Total SPT switch events sent Number of times that SPT-switch events have been sent.
NoCache rate limit Rate limit for sending NoCache events, in pps.
Rate limit for sending WrongIF events, in packets per 10
WrongIF rate limit
seconds.
Related commands
reset ipv6 multicast forwarding event
5
display ipv6 multicast forwarding-table
Use display ipv6 multicast forwarding-table to display IPv6 multicast forwarding
entries.
Syntax
display ipv6 multicast forwarding-table [ ipv6-source-address
[ prefix-length ] | ipv6-group-address [ prefix-length ] |
incoming-interface interface-type interface-number | outgoing-interface
{ exclude | include | match } interface-type interface-number | slot
slot-number | statistics ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16,
where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. The default value is 128. For an IPv6
multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source
address, the value range for this argument is 0 to 128.
incoming-interface: Specifies the IPv6 forwarding entries that contain the specified incoming
interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Specifies the IPv6 forwarding entries that contain the specified outgoing
interface.
exclude: Specifies the IPv6 forwarding entries that do not contain the specified interface in the
outgoing interface list.
include: Specifies the IPv6 forwarding entries that contain the specified interface in the outgoing
interface list.
match: Specifies the IPv6 forwarding entries that contain only the specified interface in the outgoing
interface list.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command displays IPv6 multicast forwarding entries for the master device.
statistics: Displays statistics for the IPv6 multicast forwarding table.
Examples
# Display IPv6 multicast forwarding entries.
<Sysname> display ipv6 multicast forwarding-table
Total 1 entries, 1 matched
6
Incoming interface: Vlan-interface10
Incoming sub-VLAN: VLAN 11
Outgoing sub-VLAN: VLAN 12
VLAN 13
List of 1 outgoing interface:
1: Vlan-interface20
Sub-VLAN: VLAN 21
VLAN 22
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
Field Description
Total number of (S, G) entries, and the total number of matching
Total 1 entries, 1 matched
(S, G) entries.
00001 Sequence number of the (S, G) entry.
(1::1, ff0e::1) (S, G) entry.
Entry flag.
This field displays one flag or the sum of multiple flags. In this
example, the value 0x0 means that the entry has only one flag
0x0.
The following flags are available for an entry:
• 0x0—The entry is in correct state.
• 0x1—The entry is in inactive state.
• 0x2—The entry is null.
• 0x4—The entry fails to update.
• 0x8—The outgoing interface information fails to update for
Flags the entry.
• 0x20—A register outgoing interface is available.
• 0x40—The entry is to be deleted.
• 0x80—The entry is in registration suppression state.
• 0x100—The entry is being deleted.
• 0x200—The entry is in GR state.
• 0x400—The entry has the VLAN interface of the super
VLAN.
• 0x800—The entry has the associated ND entry for the IPv6
multicast source address.
• 0x4000000—The entry is created by the MLD proxy.
Uptime Length of time for which the (S, G) entry has been up.
Timeout in Length of time in which the (S, G) entry will time out.
Incoming interface Incoming interface of the (S, G) entry.
Incoming sub-VLAN of the super VLAN when the incoming
Incoming sub-VLAN interface of the (S, G) entry is the VLAN interface of this super
VLAN.
7
Field Description
interface of the (S, G) entry is the VLAN interface of this super
VLAN.
Number of packets (bytes) that match the (S, G) entry, and
Matched 19648 packets (20512512 number of packets with incoming interface errors.
bytes), Wrong If 0 packet The numbers are displayed as 0 if an outgoing interface of the (S,
G) entry is on the specified slot.
Related commands
reset ipv6 multicast forwarding-table
8
Usage guidelines
IPv6 multicast routing entries are the basis of IPv6 multicast forwarding. You can use this command
to view the establishment state of (S, G) entries.
Examples
# Display IPv6 multicast routing entries.
<Sysname> display ipv6 multicast routing-table
Total 1 entries
Field Description
Total 1 entries Total number of (S, G) entries.
00001 Sequence number of the (S, G) entry.
(2001::2, FFE3::101) (S, G) entry.
Uptime Length of time for which the (S, G) entry has been up.
Upstream Interface Upstream interface at which the (S, G) packets should arrive.
List of 2 downstream interfaces List of downstream interfaces that forward (S, G) packets.
Related commands
reset ipv6 multicast routing-table
9
Examples
# Display RPF information for IPv6 multicast source 2001::101 on the public network.
<Sysname> display ipv6 multicast rpf-info 2001::101
RPF information about source 2001::101:
RPF interface: Vlan-interface1, RPF neighbor: FE80::A01:101:1
Referenced prefix/prefix length: 2001::/64
Referenced route type: igp
Route selection rule: preference-preferred
Load splitting rule: disable
Source AS: 0
C-multicast route target: 0x0000000000000000
Field Description
RPF information about source 2001::101 RPF information of the IPv6 multicast source 2001::101.
RPF interface Type and number of the RPF interface.
RPF neighbor IPv6 address (link-local address) of the RPF neighbor.
Referenced prefix/prefix length Referenced route and its prefix length.
Type of the referenced route:
• igp—IPv6 IGP unicast route.
• egp—IPv6 EGP unicast route.
Referenced route type • unicast (direct) —IPv6 directly connected unicast
route.
• unicast—Other IPv6 unicast route, such as IPv6
unicast static route.
• mbgp—IPv6 MBGP route.
Related commands
display ipv6 multicast forwarding-table
display ipv6 multicast routing-table
10
Default
IPv6 mtrace uses UDP port number 10240.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies a UDP port number to be used by IPv6 mtrace, in the range of 1024 to 49151.
Usage guidelines
For successful IPv6 mtrace, do not specify a UDP port number used by other modules.
You must specify the same UDP port number on all devices on the traced path. Additionally, the
specified UDP port number must be the same as that specified in the mtrace v2 command.
Examples
# Specify 12345 as the UDP port number used by IPv6 mtrace.
<Sysname> system-interview
[sysname] ipv6 mtrace-service port 12345
Related commands
mtrace v2 ipv6
11
admin-local: Specifies the scoped zone as admin-local, which has a scope ID of 4.
global: Specifies the scoped zone as global, which has a scope ID of 14.
organization-local: Specifies the scoped zone as organization-local, which has a scope ID of
8.
site-local: Specifies the scoped zone as site-local, which has a scope ID of 5.
Usage guidelines
A multicast forwarding boundary sets the boundary condition for the IPv6 multicast groups in the
specified address range. If the destination address of an IPv6 multicast packet matches the set
boundary condition, the packet is not forwarded.
An interface can act as a forwarding boundary for multiple IPv6 multicast groups in different address
ranges. You can implement this by using this command on the interface for each multicast address
range. These multicast groups must be in the same scope. The latest configuration of a scope
overwrites the previous one.
You do not need to enable IPv6 multicast routing before you execute this command.
Assume that Set A and Set B are both IPv6 multicast forwarding boundary sets with different address
ranges, and that B is a subset of A. A takes effect on the interface no matter whether A is configured
earlier or later than B.
Examples
# Configure VLAN-interface 100 as the forwarding boundary of IPv6 multicast groups in the range of
FF03::/16.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 multicast boundary ff03:: 16
# Configure VLAN-interface 100 as the forwarding boundary of IPv6 multicast groups in the
admin-local scope.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 multicast boundary scope 4
Related commands
display ipv6 multicast boundary
12
Predefined user roles
network-admin
Usage guidelines
For this command to take effect, you must clear all IPv6 multicast forwarding entries with the super
VLAN interface as the incoming interface after executing this command. To clear IPv6 multicast
forwarding entries, use the reset ipv6 multicast forwarding-table command.
Examples
# Enable IPv6 multicast forwarding between sub-VLANs that are associated with the super VLAN 2.
<Sysname> system-view
[Sysname] interface vlan-interface 2
[Sysname-Vlan-interface2] ipv6 multicast forwarding supervlan community
Related commands
reset ipv6 multicast forwarding-table
13
undo load-splitting
Default
IPv6 multicast load splitting is disabled.
Views
IPv6 MRIB view
Predefined user roles
network-admin
Parameters
source: Enables IPv6 multicast load splitting based on IPv6 multicast source.
source-group: Enables IPv6 multicast load splitting based on IPv6 multicast source and group.
Examples
# Enable IPv6 multicast load splitting based on IPv6 multicast source.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] load-splitting source
mtrace v2 ipv6
Use mtrace v2 ipv6 to trace an IPv6 multicast path through mtrace2.
14
Syntax
mtrace v2 ipv6 { source-address | group-address } * [ destination address |
port number | wait-time time | max-hop count ] * [ verbose ]
Views
Any view
Predefined user roles
network-admin
Parameters
source-address: Specifies an IPv6 multicast source by its IPv6 address.
group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers from 0 to F.
destination address: Specifies the destination address of IPv6 mtrace. The default destination
address is FF02::2.
port number: Specifies a UDP port number for IPv6 mtrace, in the range of 1024 to 49151. The
default value is 10240.
wait-time time: Specifies the length of time that the client waits for a Reply message. The value
range for the time argument is 1 to 65535 seconds and the default value is 10 seconds. If the client
does not receive a Reply message within the waiting time, the client initiates a hop-by-hop IPv6
mtrace.
max-hop count: Specifies the maximum number of the hops to be traced. The value range for the
count argument is 1 to 255 and the default value is 255. If the maximum number of hops is reached
on a device, the device directly sends a Reply message to the client and the mtrace is terminated.
verbose: Displays detailed information about IPv6 mtrace. If you do not specify this keyword, the
command displays brief information about IPv6 mtrace.
Usage guidelines
To perform a non-group-specific mtrace, specify an IPv6 multicast source and a destination. The
mtrace starts from the destination and ends at the device directly connected to the source.
To perform a non-source-specific mtrace, specify an IPv6 multicast group and a destination. The
mtrace starts from the destination and ends at the RP associated with the group.
To perform a source-and-group-specific mtrace, specify both an IPv6 multicast source and an IPv6
multicast group. If you also specify a destination, the mtrace starts from the destination and ends at
the device directly connected to the source. If you do not specify a destination, the mtrace starts from
the upstream device of the client and ends at the device directly connected to the source.
An IPv6 mtrace process stops if the maximum number of the hops to be traced is reached.
If the client does not receive a Reply message within the waiting time, the client initiates a
hop-by-hop mtrace to determine which device on the path encountered an error. It sends a Query
message with the hops field set to 1 and waits for a Reply message. If the client receives a Reply
message within the waiting time, it sends a Query message with the hops field value increased by 1
and waits for a Reply message. This process continues until the client does not receive a Reply
message within the waiting time any more.
Examples
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from
source 10::7 to destination 50::5 and display brief mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5
Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, press
15
CTRL_C to break.
Querying full reverse path...
Field Description
Number of the hop. 0 represents the last hop, -1 represents the hop
Hop
before the last hop, and so on.
Local address IPv6 address of this hop on the traced path.
Multicast routing protocol used between this device and the previous-hop
device:
• PIM-SM.
• PIM-DM.
Unicast routing protocol used between this device and the previous-hop
device:
Protocol • LOCAL—Direct route.
• STATIC ROUTE—Static route.
• RIP.
• ISIS.
• OSPF.
• BGP.
16
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from
source 10::7 to destination 50::5 and display detailed mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5 verbose
Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, use query
ID 12345, client port 50001, press CTRL_C to break.
Querying full reverse path...
Field Description
Number of the hop. 0 represents the last hop, -1
n
represents the hop before the last hop, and so on.
Index of the incoming interface of the IPv6 multicast
Incoming interface ID
data.
Outgoing interface ID Index of the outgoing interface of the IPv6 multicast data.
Forwarded packets for the (S, G) pair Statistics of forwarded (S, G) packets.
17
Field Description
Unicast routing protocol running on the incoming
Unicast protocol in use
interface of the multicast data.
Forwarding code or error code:
• NO_ERROR—No error.
• WRONG_IF—The interface on which the mtrace
message arrives is not in the outgoing interface list
of the multicast data.
• PRUNE_SENT—This device has sent a prune
message to the upstream device.
• PRUNE_RCVD—This device has received a prune
message from the downstream device.
• SCOPED—A multicast border is configured on the
incoming interface or outgoing interface of the
multicast data.
Forwarding code
• NO_ROUTE—This device does not have any route
for the source or the RP.
• WRONG_LAST_HOP—This device is not the
expected last-hop device.
• REACHED_RP—This device is the RP for the (*, G)
multicast data.
• RPF_IF—The mtrace message arrived on the RPF
interface for the multicast data.
• NO_MULTICAST—The mtrace message arrived
on an interface that is not enabled with IP multicast.
• NO_SPACE—No space is available for inserting a
response data block in the packet.
Length of time for transmitting the mtrace message from
Time used (s)
the previous-hop device to this device.
Related commands
ipv6 mtrace-service port
18
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, this command clears IPv6 multicast fast forwarding entries for the master device.
all: Specifies all IPv6 multicast fast forwarding entries.
Examples
# Clear all IPv6 multicast fast forwarding entries.
<Sysname> reset ipv6 multicast fast-forwarding cache all
# Clear the IPv6 multicast fast forwarding entry for IPv6 multicast source and group (FE1F:20::2,
FF0E::1).
<Sysname> reset ipv6 multicast fast-forwarding cache fe1f:20::2 ff0e::1
Related commands
display ipv6 multicast fast-forwarding cache
Related commands
display ipv6 multicast forwarding event
19
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16,
where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies the address prefix length. The default value is 128. For an IPv6
multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source
address, the value range for this argument is 0 to 128.
incoming-interface: Specifies the IPv6 multicast forwarding entries that contain the specified
incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
all: Specifies all IPv6 multicast forwarding entries.
Usage guidelines
When you clear an IPv6 multicast forwarding entry, the associated IPv6 multicast routing entry is
also cleared.
Examples
# Clear IPv6 multicast forwarding entries for IPv6 multicast group FF0E::1.
<Sysname> reset ipv6 multicast forwarding-table ff0e::1
Related commands
display ipv6 multicast forwarding-table
20
Examples
# Clear IPv6 multicast routing entries for IPv6 multicast group FF03::101.
<Sysname> reset ipv6 multicast routing-table ff03::101
Related commands
display ipv6 multicast routing-table
21
Contents
MLD commands ···························································································· 1
display mld group ······································································································································· 1
display mld interface ·································································································································· 4
display mld proxy group ····························································································································· 6
display mld proxy routing-table ·················································································································· 8
display mld ssm-mapping························································································································· 10
dscp·························································································································································· 11
last-listener-query-count (MLD view) ······································································································· 12
last-listener-query-interval (MLD view)····································································································· 12
max-response-time (MLD view) ··············································································································· 13
mld ··························································································································································· 14
mld enable················································································································································ 14
mld fast-leave ··········································································································································· 15
mld group-policy ······································································································································· 16
mld last-listener-query-count ···················································································································· 17
mld last-listener-query-interval ················································································································· 17
mld max-response-time···························································································································· 18
mld non-stop-routing ································································································································ 19
mld other-querier-present-timeout············································································································ 19
mld proxy enable ······································································································································ 20
mld proxy forwarding ································································································································ 21
mld query-interval····································································································································· 21
mld robust-count ······································································································································ 22
mld startup-query-count ··························································································································· 23
mld startup-query-interval ························································································································ 23
mld static-group········································································································································ 24
mld version ··············································································································································· 25
other-querier-present-timeout (MLD view) ······························································································· 25
proxy multipath (MLD view)······················································································································ 26
query-interval (MLD view) ························································································································ 26
reset mld group ········································································································································ 27
robust-count (MLD view) ·························································································································· 28
ssm-mapping (MLD view) ························································································································ 29
startup-query-count (MLD view) ··············································································································· 30
startup-query-interval (MLD view) ············································································································ 30
i
MLD commands
display mld group
Use display mld group to display information about MLD multicast groups (IPv6 multicast
groups that hosts have joined through MLD).
Syntax
display mld group [ ipv6-group-address | interface interface-type
interface-number ] [ static | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this
command displays information about all MLD multicast groups.
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays information about MLD multicast
groups for all interfaces.
static: Specifies MLD multicast groups that hosts have joined statically. If you do not specify this
keyword, the command displays information about MLD multicast groups that hosts have joined
dynamically.
verbose: Displays detailed information about MLD multicast groups.
Examples
# Display information about MLD multicast groups that hosts have dynamically joined.
<Sysname> display mld group
MLD groups in total: 1
Vlan-interface1(FE80::101):
MLD groups reported in total: 1
Group address: FF03::101
Last reporter: FE80::10
Uptime: 00:02:04
Expires: 00:01:15
Field Description
1
Field Description
# Display detailed information about MLD multicast group FF3E::101 that hosts have statically joined.
In this example, the switch is configured with MLDv2.
<Sysname> display mld group ff3e::101 verbose
Vlan-interface1(FE80::101):
MLD groups reported in total: 1
Group: FF3E::101
Uptime: 00:01:46
Exclude expires: 00:04:16
Mapping expires: 00:02:16
Last reporter: FE80::10
Last-listener-query-counter: 0
Last-listener-query-timer-expiry: Off
Mapping last-listener-query-counter: 0
Mapping last-listener-query-timer-expiry: Off
Group mode: Exclude
Version1-host-present-timer-expiry: Off
Source list (sources in total: 1):
Source: 10::10
Uptime: 00:00:09
V2 expires: 00:04:11
Mapping expires: 00:02:16
Last-listener-query-counter: 0
Last-listener-query-timer-expiry: Off
Field Description
2
Field Description
Remaining time for the MLD last listener query timer for the
Last-listener-query-timer-expiry
multicast group. This field displays Off if the timer is disabled.
3
Field Description
Remaining time for the last listener query timer for the IPv6
multicast source and group.
Last-listener-query-timer-expiry This field displays Off if the timer is disabled.
This field is displayed only when the device runs MLDv2 or is
configured with MLD SSM mappings.
# Display information about the MLD multicast groups that hosts have statically joined.
<Sysname> display mld group static
Entries in total: 2
(*, FF03::101)
Interface: Vlan1
Expires: Never
(2001::101, FF3E::202)
Interface: Vlan1
Expires: Never
Field Description
Total number of the IPv6 multicast groups that hosts have joined
Entries in total
statically.
(*, FF03::101) (*, G) entry.
(2001::101, FF3E::202) (S, G) entry.
Remaining lifetime for the IPv6 multicast group.
Expires This field always displays Never, which means that the IPv6
multicast group never expires.
Related commands
reset mld group
4
proxy: Displays the MLD proxy interface information. If you do not specify this keyword, the
command displays MLD information for all interfaces.
verbose: Displays detailed MLD information.
Examples
# Display detailed MLD information for VLAN-interface 1 (non-proxy interface).
<Sysname> display mld interface vlan-interface 1 verbose
Vlan-interface1(FE80::200:AFF:FE01:101):
MLD is enabled.
MLD version: 1
Query interval for MLD: 125s
Other querier present time for MLD: 255s
Maximum query response time for MLD: 10s
Last listener query interval: 1s
Last listener query count: 2
Startup query interval: 31s
Startup query count: 2
General query timer expiry (hh:mm:ss): 00:00:23
Querier for MLD: FE80::200:AFF:FE01:101 (This router)
MLD activity: 1 join(s), 0 done(s)
IPv6 multicast routing on this interface: Enabled
Robustness: 2
Require-router-alert: Disabled
Fast-leave: Disabled
Startup-query: Off
Other-querier-present-timer-expiry (hh:mm:ss): Off
MLD groups reported in total: 1
Field Description
5
Field Description
multicast-address-and-source-specific queries, in
seconds.
Number of MLD multicast-address-specific queries or
Last listener query count MLD multicast-address-and-source-specific queries
sent for the group.
Startup query interval MLD startup query interval, in seconds.
Startup query count Number of MLD general queries sent on startup.
Remaining time for the MLD general query timer. This
General query timer expiry
field displays Off if the timer is disabled.
6
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range
for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this
command displays IPv6 multicast group membership entries for all IPv6 multicast groups.
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, this command displays information about IPv6 multicast
groups maintained by the MLD proxy for all interfaces.
verbose: Displays detailed information.
Examples
# Display information about IPv6 multicast groups maintained by the MLD proxy.
<Sysname> display mld proxy group
MLD proxy group records in total: 2
Vlan-interface1(FE80::16:1):
MLD proxy group records in total: 2
Group address: FF1E::1
Member state: Idle
Expires: Off
# Display detailed information about IPv6 multicast group FF1E::1 maintained by the MLD proxy.
<Sysname> display mld proxy group ff1e::1 verbose
Vlan-interface1(FE80::16:1):
MLD proxy group records in total: 2
Group: FF1E::1
Group mode: Include
Member state: Idle
Expires: Off
Source list (sources in total: 1):
100::1
Field Description
7
Field Description
8
Total 1 (*, G) entries, 2 (S, G) entries.
(100::1, FF1E::1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: MLD
(*, FF1E::2)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: STATIC
(2::2, FF1E::2)
Upstream interface: Vlan-interface1
Downstream interfaces (2 in total):
1: LoopBack1
Protocol: STATIC
2: Vlan-interface2
Protocol: PROXY
# Display detailed information about IPv6 multicast routing entries maintained by the MLD proxy.
<Sysname> display mld proxy routing-table verbose
Total 1 (*, G) entries, 2 (S, G) entries.
(100::1, FF1E::1)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: MLD
Querier state: Querier
Join/Prune state:Join
(*, FF1E::2)
Upstream interface: Vlan-interface1
Downstream interfaces (1 in total):
1: Vlan-interface2
Protocol: STATIC
Querier state: Querier
Join/Prune state:Join
9
(2::2, FF1E::2)
Upstream interface: Vlan-interface1
Downstream interfaces (2 in total):
1: LoopBack1
Protocol: STATIC
Querier state: Querier
Join/Prune state: Join
2: Vlan-interface2
Protocol: PROXY
Querier state: Querier
Join/Prune state: Join
Field Description
Total 1 (*, G) entries, 2 (S, G) entries Total number of (*, G ), and the total number of (S, G) entries.
(100::1, FF1E::1) (S, G) entry.
Upstream interface Incoming interface of a forwarding entry.
Downstream interfaces (1 in total) Outgoing interfaces, and the total number of outgoing interfaces.
Non-outgoing interfaces, and the total number of non-outgoing
Non-downstream interfaces (1 in total)
interfaces.
1: Vlan-interface2 Index of an outgoing interface and the outgoing interface.
Protocol type:
• MLD—Dynamic MLD.
Protocol
• PROXY—MLD proxy.
• STATIC—Static MLD.
Querier state:
Querier state • Querier.
• Non-querier.
Joined or pruned state of the interface:
• NI—Default state.
Join/Prune state
• Join—Joined state.
• Prune—Pruned state.
10
Predefined user roles
network-admin
network-operator
Parameters
ipv6-group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range
for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F.
Examples
# Display MLD SSM mappings for IPv6 multicast group FF3E::101.
<Sysname> display mld ssm-mapping ff3e::101
Group: FF3E::101
Source list:
1::1
1::2
10::1
100::10
Field Description
dscp
Use dscp to set the DSCP value for outgoing MLD protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing MLD protocol packets.
Views
MLD view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the Traffic Class field of an IPv6 packet to determine the transmission
priority of the packet. A greater DSCP value represents a higher priority.
11
Examples
# Set the DSCP value to 63 for outgoing MLD protocol packets.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] dscp 63
Related commands
mld last-listener-query-count
12
Views
MLD view
Predefined user roles
network-admin
Parameters
interval: Specifies an MLD last listener query interval in the range of 1 to 25 seconds.
Usage guidelines
You can set the MLD last listener query interval globally for all interfaces in MLD view or for an
interface in interface view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the global MLD last listener query interval to 6 seconds.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] last-listener-query-interval 6
Related commands
mld last-listener-query-interval
13
[Sysname-mld] max-response-time 25
Related commands
mld max-response-time
mld
Use mld to enter MLD view.
Use undo mld to delete the configurations in MLD view.
Syntax
mld
undo mld
Views
System view
Predefined user roles
network-admin
Examples
# Enter MLD view.
<Sysname> system-view
[Sysname] mld
[Sysname-mld]
mld enable
Use mld enable to enable MLD on an interface.
Use undo mld enable to disable MLD on an interface.
Syntax
mld enable
undo mld enable
Default
MLD is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IPv6 multicast routing is enabled on the public network or for
the VPN instance to which the interface belongs.
Other MLD configurations on the interface take effect only when MLD is enabled on the interface.
Examples
# Enable IPv6 multicast routing, and enable MLD for VLAN-interface 100.
<Sysname> system-view
14
[Sysname] ipv6 multicast routing
[Sysname-mrib6] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld enable
Related commands
ipv6 multicast routing
mld fast-leave
Use mld fast-leave to enable fast-leave processing on an interface.
Use undo mld fast-leave to disable fast-leave processing on an interface.
Syntax
mld fast-leave [ group-policy ipv6-acl-number ]
undo mld fast-leave
Default
Fast-leave processing is disabled. The MLD querier sends MLD multicast-address-specific or
multicast-address-and-source-specific queries after receiving a done message.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic ACL by its number in the range of 2000 to 2999. If you
specify an ACL, the fast-leave processing feature takes effect only on the IPv6 multicast groups that
the ACL permits. The feature takes effect on all IPv6 multicast groups when one of the following
conditions exists:
• You do not specify an ACL.
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
The fast-leave processing feature enables an MLD querier to suppress MLD
multicast-address-specific or multicast-address-and-source-specific queries upon receiving MLD
done messages permitted by the ACL.
When you configure a rule in the IPv6 basic ACL, follow these restrictions and guidelines:
• The source source-address source-prefix option specifies an IPv6 multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
Examples
# Enable fast-leave processing on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld fast-leave
15
mld group-policy
Use mld group-policy to configure an IPv6 multicast group policy on an interface to control the
IPv6 multicast groups that hosts attached to the interface can join.
Use undo mld group-policy to delete the IPv6 multicast group policy on an interface.
Syntax
mld group-policy ipv6-acl-number [ version-number ]
undo mld group-policy
Default
No IPv6 multicast group policy exists. Hosts attached to the interface can join any IPv6 multicast
groups.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic or advanced ACL by its number in the range of 2000
to 3999. Receiver hosts can join only the IPv6 multicast groups that the ACL permits. If the ACL does
not exist or have valid rules, receiver hosts cannot join IPv6 multicast groups.
version-number: Specifies an MLD version number, 1 or 2. By default, this command takes
effect on both MLDv1 reports and MLDv2 reports.
Usage guidelines
An IPv6 multicast group policy filters MLD reports to control the IPv6 multicast groups that hosts can
join.
This command does not take effect on static member interfaces because static member interfaces
do not send MLD reports.
When you configure a rule in the IPv6 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-prefix option specifies an IPv6
multicast group address.
• In an advanced ACL, the source source-address source-prefix option specifies an
IPv6 multicast source address. The destination dest-address dest-prefix option
specifies an IPv6 multicast group address.
Set the source source-address source-prefix option to 0::0 to match the following
MLD reports:
MLDv1 reports.
MLDv2 IS_EX and MLDv2 TO_EX reports that do not carry multicast source addresses.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure an IPv6 multicast group policy on VLAN-interface 100 so that hosts attached to the
interface can join only IPv6 multicast group FF03::101.
<Sysname> system-view
[Sysname] acl ipv6 basic 2005
16
[Sysname-acl-ipv6-basic-2005] rule permit source ff03::101 128
[Sysname-acl-ipv6-basic-2005] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld group-policy 2005
mld last-listener-query-count
Use mld last-listener-query-count to set the MLD last member query count on an
interface.
Use undo mld last-listener-query-count to restore the default.
Syntax
mld last-listener-query-count count
undo mld last-listener-query-count
Default
The MLD last listener query count equals the MLD querier's robustness variable.
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an MLD last listener query count in the range of 1 to 255.
Usage guidelines
You can set the MLD last listener query count for an interface in interface view or globally for all
interfaces in MLD view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the MLD last listener query count to 6 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld last-listener-query-count 6
Related commands
last-listener-query-count (MLD view)
mld last-listener-query-interval
Use mld last-listener-query-interval to set the MLD last listener query interval on an
interface.
Use undo mld last-listener-query-interval to restore the default.
Syntax
mld last-listener-query-interval interval
undo mld last-listener-query-interval
17
Default
The MLD last listener query interval is 1 second.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an MLD last listener query interval in the range of 1 to 25 seconds.
Usage guidelines
You can set the MLD last listener query interval for an interface in interface view or globally for all
interfaces in MLD view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the MLD last listener query interval to 6 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld last-listener-query-interval 6
Related commands
last-listener-query-interval (MLD view)
mld max-response-time
Use mld max-response-time to set the maximum response time for MLD general queries on an
interface.
Use undo mld max-response-time to restore the default.
Syntax
mld max-response-time time
undo mld max-response-time
Default
The maximum response time for MLD general queries is 10 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
time: Specifies the maximum response time for MLD general queries, in the range of 1 to 3174
seconds.
Usage guidelines
You can set the maximum response time for an interface in interface view or globally for all interfaces
in MLD view. For an interface, the interface-specific configuration takes priority over the global
configuration.
18
Examples
# Set the maximum response time for MLD general queries to 25 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld max-response-time 25
Related commands
max-response-time (MLD view)
mld non-stop-routing
Use mld non-stop-routing to enable MLD NSR.
Use undo mld non-stop-routing to disable MLD NSR.
Syntax
mld non-stop-routing
undo mld non-stop-routing
Default
MLD NSR is disabled.
Views
System view
Predefined user roles
network-admin
Examples
# Enable MLD NSR.
<Sysname> system-view
[Sysname] mld non-stop-routing
mld other-querier-present-timeout
Use mld other-querier-present-timeout to set the MLD other querier present timer on an
interface.
Use undo mld other-querier-present-timeout to restore the default.
Syntax
mld other-querier-present-timeout time
undo mld other-querier-present-timeout
Default
The MLD other querier present timer is calculated by using the following formula:
[ MLD general query interval ] × [ MLD querier's robustness variable ] + [ maximum response
time for MLD general queries ] / 2.
Views
Interface view
19
Predefined user roles
network-admin
Parameters
time: Specifies an MLD other querier present timer in the range of 1 to 31744 seconds.
Usage guidelines
You can set the MLD other querier present timer for an interface in interface view or globally for all
interfaces in MLD view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the MLD other querier present timer to 125 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld other-querier-present-timeout 125
Related commands
other-querier-present-timeout (MLD view)
Related commands
ipv6 multicast routing
20
mld proxy forwarding
Use mld proxy forwarding to enable IPv6 multicast forwarding on a non-querier interface.
Use undo mld proxy forwarding to disable IPv6 multicast forwarding on a non-querier
interface.
Syntax
mld proxy forwarding
undo mld proxy forwarding
Default
IPv6 multicast forwarding is disabled for a non-querier interface.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
Typically, only MLD queriers can forward IPv6 multicast traffic and non-queriers cannot. This
prevents IPv6 multicast data from being repeatedly forwarded. If a router interface on the MLD proxy
device failed the querier election, enable multicast forwarding capability on this interface to forward
multicast data to attached receivers.
Examples
# Enable IPv6 multicast forwarding on VLAN-interface 100 (non-querier interface).
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld proxy forwarding
mld query-interval
Use mld query-interval to set the MLD general query interval on an interface.
Use undo mld query-interval to restore the default.
Syntax
mld query-interval interval
undo mld query-interval
Default
The MLD general query interval is 125 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an MLD general interval in the range of 1 to 31744 seconds.
21
Usage guidelines
You can set the MLD general interval for an interface in interface view or globally for all interfaces in
MLD view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the MLD general query interval to 60 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld query-interval 60
Related commands
query-interval (MLD view)
mld robust-count
Use mld robust-count to set the MLD querier's robustness variable on an interface.
Use undo mld robust-count to restore the default.
Syntax
mld robust-count count
undo mld robust-count
Default
The MLD querier's robustness variable is 2.
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an MLD querier's robustness variable in the range of 1 to 255.
Usage guidelines
The MLD querier's robustness variable defines the number of times to retransmit MLD queries if
packet loss occurs. A higher robustness variable makes the MLD querier more robust, but it
increases the timeout time for IPv6 multicast groups.
You can set the MLD querier's robustness variable for an interface in interface view or globally for all
interfaces in MLD view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the MLD querier's robustness variable to 5 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld robust-count 5
Related commands
robust-count (MLD view)
22
mld startup-query-count
Use mld startup-query-count to set the MLD startup query count on an interface.
Use undo mld startup-query-count to restore the default.
Syntax
mld startup-query-count count
undo mld startup-query-count
Default
The MLD startup query count equals the MLD querier's robustness variable.
Views
Interface view
Predefined user roles
network-admin
Parameters
count: Specifies an MLD startup query count in the range of 1 to 255.
Usage guidelines
You can set the MLD startup query count for an interface in interface view or globally for all interfaces
in MLD view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the MLD startup query count to 5 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld startup-query-count 5
Related commands
startup-query-count (MLD view)
mld startup-query-interval
Use mld startup-query-interval to set the MLD startup query interval on an interface.
Use undo mld startup-query-interval to restore the default.
Syntax
mld startup-query-interval interval
undo mld startup-query-interval
Default
The MLD startup query interval equals one quarter of the MLD general query interval.
Views
Interface view
Predefined user roles
network-admin
23
Parameters
interval: Specifies an MLD startup query interval in the range of 1 to 31744 seconds.
Usage guidelines
You can set the MLD startup query interval for an interface in interface view or globally for all
interfaces in MLD view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the MLD startup query interval to 100 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld startup-query-interval 100
Related commands
startup-query-interval (MLD view)
mld static-group
Use mld static-group to configure an interface as a static group member of an IPv6 multicast
group.
Use undo mld static-group to restore the default.
Syntax
mld static-group ipv6-group-address [ source ipv6-source-address ]
undo mld static-group { all | ipv6-group-address [ source
ipv6-source-address ] }
Default
An interface is not a static member of IPv6 multicast groups.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv6-group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range
for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F.
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not
specify an IPv6 multicast source, this command configures an interface as a static group member of
the multicast groups with all IPv6 multicast source addresses.
all: Specifies all IPv6 multicast groups that the interface has statically joined.
Usage guidelines
For IPv6 multicast routing entries to be created, specify an IPv6 multicast source address if the
specified IPv6 multicast group address is in the SSM group range.
Examples
# Configure VLAN-interface 100 as a static group member of IPv6 multicast group FF03::101.
<Sysname> system-view
24
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld static-group ff03::101
# Configure VLAN-interface 100 as a static group member of IPv6 multicast source and group
(2001::101, FF3E::202).
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld static-group ff3e::202 source 2001::101
mld version
Use mld version to specify an MLD version for an interface.
Use undo mld version to restore the default.
Syntax
mld version version-number
undo mld version
Default
The MLD version is 1.
Views
Interface view
Predefined user roles
network-admin
Parameters
version-number: Specifies an MLD version, 1 or 2.
Examples
# Specify MLD version 2 for VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] mld version 2
25
Predefined user roles
network-admin
Parameters
time: Specifies an MLD other querier present timer in the range of 1 to 31744 seconds.
Usage guidelines
You can set the MLD other querier present timer globally for all interfaces in MLD view or for an
interface in interface view. For an interface, the interface-specific configuration takes priority over the
global configuration.
Examples
# Set the global MLD other querier present timer to 125 seconds.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] other-querier-present-timeout 125
Related commands
mld other-querier-present-timeout
26
Use undo query-interval to restore the default.
Syntax
query-interval interval
undo query-interval
Default
The MLD general query interval is 125 seconds.
Views
MLD view
Predefined user roles
network-admin
Parameters
interval: Specifies an MLD general query interval in the range of 1 to 31744 seconds.
Usage guidelines
You can set the MLD general query interval globally for all interfaces in MLD view or for an interface
in interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the global MLD general query interval to 60 seconds.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] query-interval 60
Related commands
mld query-interval
27
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not
specify an IPv6 multicast source, this command clears dynamic MLD multicast group entries for all
IPv6 multicast sources.
prefix-length: Specifies an address prefix length. The default is 128. For a multicast source
address, the value range for this argument is 0 to 128. For a multicast group address, the value
range for this argument is 8 to 128.
Usage guidelines
This command might interrupt the IPv6 multicast information transmission.
Examples
# Clear dynamic MLD multicast group entries for all interfaces.
<Sysname> reset mld group all
# Clear all dynamic MLD multicast group entries for VLAN-interface 100.
<Sysname> reset mld group interface vlan-interface 100 all
# Clear the dynamic entry of MLD multicast group FF03::101:10 for VLAN-interface 100.
<Sysname> reset mld group interface vlan-interface 100 ff03::101:10
Related commands
display mld group
28
[Sysname] mld
[Sysname-mld] robust-count 5
Related commands
mld robust-count
Related commands
display mld ssm-mapping
29
startup-query-count (MLD view)
Use startup-query-count to set the MLD startup query count globally.
Use undo startup-query-count to restore the default.
Syntax
startup-query-count count
undo startup-query-count
Default
The MLD startup query count equals the MLD querier's robustness variable.
Views
MLD view
Predefined user roles
network-admin
Parameters
count: Specifies an MLD startup query count in the range of 1 to 255.
Usage guidelines
You can set the MLD startup query count globally for all interfaces in MLD view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the global MLD startup query count to 5.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] startup-query-count 5
Related commands
mld startup-query-count
30
Parameters
interval: Specifies an MLD startup query interval in the range of 1 to 31744 seconds.
Usage guidelines
You can set the MLD startup query interval globally for all interfaces in MLD view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Set the global MLD startup query interval to 100 seconds.
<Sysname> system-view
[Sysname] mld
[Sysname-mld] startup-query-interval 100
Related commands
mld startup-query-interval
31
Contents
IPv6 PIM commands······················································································ 1
anycast-rp (IPv6 PIM view) ························································································································ 1
bsm-fragment enable (IPv6 PIM view) ······································································································· 1
bsm-reflection enable (IPv6 PIM view)······································································································· 2
bsr-policy (IPv6 PIM view)·························································································································· 2
bsr-rp-mapping rfc2362 (IPv6 PIM view)···································································································· 3
c-bsr (IPv6 PIM view) ································································································································· 4
c-rp (IPv6 PIM view) ··································································································································· 5
crp-policy (IPv6 PIM view)·························································································································· 6
display ipv6 pim bsr-info····························································································································· 7
display ipv6 pim claimed-route ··················································································································· 8
display ipv6 pim c-rp ·································································································································· 9
display ipv6 pim interface ························································································································· 11
display ipv6 pim neighbor························································································································· 13
display ipv6 pim routing-table··················································································································· 14
display ipv6 pim rp-info ···························································································································· 18
display ipv6 pim statistics ························································································································· 20
dscp·························································································································································· 21
embedded-rp ············································································································································ 22
hello-option dr-priority (IPv6 PIM view) ···································································································· 22
hello-option holdtime (IPv6 PIM view) ······································································································ 23
hello-option lan-delay (IPv6 PIM view) ····································································································· 24
hello-option neighbor-tracking (IPv6 PIM view)························································································ 24
hello-option override-interval (IPv6 PIM view)·························································································· 25
holdtime join-prune (IPv6 PIM view) ········································································································ 26
ipv6 pim ···················································································································································· 27
ipv6 pim bfd enable ·································································································································· 27
ipv6 pim bsr-boundary······························································································································ 28
ipv6 pim dm ·············································································································································· 28
ipv6 pim hello-option dr-priority ················································································································ 29
ipv6 pim hello-option holdtime·················································································································· 30
ipv6 pim hello-option lan-delay················································································································· 30
ipv6 pim hello-option neighbor-tracking ··································································································· 31
ipv6 pim hello-option override-interval ····································································································· 32
ipv6 pim holdtime join-prune ···················································································································· 33
ipv6 pim neighbor-policy ·························································································································· 33
ipv6 pim non-stop-routing························································································································· 34
ipv6 pim passive······································································································································· 35
ipv6 pim require-genid······························································································································ 35
ipv6 pim sm ·············································································································································· 36
ipv6 pim state-refresh-capable ················································································································· 36
ipv6 pim timer graft-retry ·························································································································· 37
ipv6 pim timer hello ·································································································································· 37
ipv6 pim timer join-prune ·························································································································· 38
ipv6 pim triggered-hello-delay ·················································································································· 39
jp-pkt-size (IPv6 PIM view)······················································································································· 39
register-policy (IPv6 PIM view)················································································································· 40
register-suppression-timeout (IPv6 PIM view) ························································································· 41
register-whole-checksum (IPv6 PIM view) ······························································································· 41
snmp-agent trap enable pim6 ·················································································································· 42
source-lifetime (IPv6 PIM view)················································································································ 43
source-policy (IPv6 PIM view) ·················································································································· 43
spt-switch-threshold (IPv6 PIM view) ······································································································· 44
ssm-policy (IPv6 PIM view) ······················································································································ 45
state-refresh-hoplimit (IPv6 PIM view) ····································································································· 46
state-refresh-interval (IPv6 PIM view) ······································································································ 46
state-refresh-rate-limit (IPv6 PIM view) ···································································································· 47
i
static-rp (IPv6 PIM view) ·························································································································· 48
timer hello (IPv6 PIM view) ······················································································································ 49
timer join-prune (IPv6 PIM view) ·············································································································· 50
ii
IPv6 PIM commands
anycast-rp (IPv6 PIM view)
Use anycast-rp to add an anycast RP member to an Anycast RP set.
Use undo anycast-rp to remove an anycast RP member from an Anycast RP set.
Syntax
anycast-rp ipv6-anycast-rp-address ipv6-member-address
undo anycast-rp ipv6-anycast-rp-address ipv6-member-address
Default
No Anycast RP sets exist.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
ipv6-anycast-rp-address: Specifies an Anycast RP address. It must be a legal IPv6 global
unicast address.
ipv6-member-address: Specifies an Anycast RP member address. It must be a legal IPv6
global unicast address and must be different from the Anycast RP address.
Usage guidelines
To add multiple RP member addresses to an Anycast RP set, execute this command multiple times
with the same Anycast RP address but different RP member addresses.
To configure multiple Anycast RP sets, execute this command multiple times with different Anycast
RP addresses.
Examples
# Add Anycast RP members 1:1::1 and 1:2::1 to Anycast RP set 1:1::0.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] anycast-rp 1:1::0 1:1::1
[Sysname-pim6] anycast-rp 1:1::0 1:2::1
Related commands
display ipv6 pim rp-info
1
undo bsm-fragment enable
Default
BSM semantic fragmentation is enabled.
Views
IPv6 PIM view
Predefined user roles
network-admin
Usage guidelines
Disable BSM semantic fragmentation if the IPv6 PIM-SM contains a device that does not support
BSM semantic fragmentation.
Examples
# Disable BSM semantic fragmentation.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] undo bsm-fragment enable
2
Use undo bsr-policy to restore the default.
Syntax
bsr-policy ipv6-acl-number
undo bsr-policy
Default
No BSR policy exists, and all bootstrap messages are regarded as legal.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic ACL by its number in the range of 2000 to 2999.
Usage guidelines
A BSR policy filters bootstrap messages to guard against BSR spoofing.
When you configure a rule in the IPv6 basic ACL, follow these restrictions and guidelines:
• The source source-address source-prefix option specifies a BSR address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure a BSR policy so that only the devices on subnet 2001::2/64 can act as the BSR.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source 2001::2 64
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 pim
[Sysname-pim6] bsr-policy 2000
Related commands
c-bsr (IPv6 PIM view)
3
Views
IPv6 PIM view
Predefined user roles
network-admin
Usage guidelines
To ensure consistent group-to-RP mappings on all routers in the PIM domain, configure all the
routers to use the same BSR RP hash algorithm.
Examples
# Configure the router to use the BSR RP hash algorithm described in RFC 2362.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] bsr-rp-mapping rfc2362
4
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] c-bsr 1101::1
5
If you execute this command by using the same IPv6 address of a C-RP multiple times, the most
recent configuration takes effect.
Examples
# Configure the interface with IPv6 address 2001::1 as the C-RP for IPv6 multicast group range
FF0E:0:1391::/96, and set its priority to 10.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff0e:0:1391:: 96
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 pim
[Sysname-pim6] c-rp 2001::1 group-policy 2000 priority 10
6
Examples
# Configure a C-RP policy so that only devices in the address range of 2001::2/64 can be C-RPs for
the groups in the range of FF03::101/64.
<Sysname> system-view
[Sysname] acl ipv6 advanced 3000
[Sysname-acl-ipv6-adv-3000] rule permit ipv6 source 2001::2 64 destination ff03::101 64
[Sysname-acl-ipv6-adv-3000] quit
[Sysname] ipv6 pim
[Sysname-pim6] crp-policy 3000
Related commands
c-rp (IPv6 PIM view)
Scope: 5
State: Accept Any
Scope-zone expiry timer: 00:21:12
Scope: 6
State: Elected
Bootstrap timer: 00:00:26
Elected BSR address: 17:11::1
Priority: 64
Hash mask length: 126
Uptime: 02:53:37
Candidate BSR address: 17:11::1
7
Priority: 64
Hash mask length: 126
Scope: 7
State: Candidate
Bootstrap timer: 00:01:56
Elected BSR address: 61:37::1
Priority: 64
Hash mask length: 126
Uptime: 02:53:32
Candidate BSR address: 17:12::1
Priority: 64
Hash mask length: 126
Scope: 8
State: Pending
Bootstrap timer: 00:00:07
Candidate BSR address: 17:13::1
Priority: 64
Hash mask length: 126
Field Description
8
Parameters
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not
specify an IPv6 multicast source, this command displays information about all routes that IPv6 PIM
uses.
Examples
# Display information about all routes that IPv6 PIM uses.
<Sysname> display ipv6 pim claimed-route
RPF-route selecting rule: longest-match
Field Description
9
network-operator
Parameters
local: Specifies local C-RPs. If you do not specify this keyword, the command displays information
about all C-RPs.
Usage guidelines
You can display information about learned C-RPs only on the BSR. On other devices, you can
display information about the locally configured C-RPs.
Examples
# Display information about learned C-RPs.
<Sysname> display ipv6 pim c-rp
Scope: non-scoped
Group/MaskLen: FF00::/8 [B]
C-RP address Priority HoldTime Uptime Expires
8:12::2 (local) 192 150 00:27:48 00:01:43
Group/MaskLen: FF23::/92 Expires: 00:02:07
Field Description
Expires Remaining lifetime for the C-RP and the IPv6 multicast group.
Candidate RP IPv6 address of the locally configured C-RP.
Interval between two advertisement messages sent by the locally
Advertisement interval
configured C-RP.
Remaining time for the locally configured C-RP to send the next
Next advertisement scheduled at
advertisement message.
10
display ipv6 pim interface
Use display ipv6 pim interface to display IPv6 PIM information for interfaces.
Syntax
display ipv6 pim interface [ interface-type interface-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do
not specify an interface, this command displays IPv6 PIM information for all interfaces.
verbose: Displays detailed IPv6 PIM information. If you do not specify this keyword, the command
displays brief IPv6 PIM information.
Examples
# Display brief IPv6 PIM information for all interfaces.
<Sysname> display ipv6 pim interface
Interface NbrCnt HelloInt DR-Pri DR-Address
Vlan1 1 30 1 FE80::200:5EFF:FE04:8700
Field Description
11
PIM generation ID: 0xF5712241
PIM require generation ID: disabled
PIM hello hold interval: 105 s
PIM assert hold interval: 180 s
PIM triggered hello delay: 5 s
PIM J/P interval: 60 s
PIM J/P hold interval: 210 s
PIM BSR domain border: disabled
PIM BFD: disabled
PIM passive: disabled
Number of routers on network not using DR priority: 0
Number of routers on network not using LAN delay: 0
Number of routers on network not using neighbor tracking: 2
Field Description
12
Field Description
Number of routers on network not using Number of routers that do not use the LAN delay field on the
LAN delay subnet where the interface resides.
Number of routers on network not using Number of routers that are not enabled with neighbor tracking
neighbor tracking on the subnet where the interface resides.
# Display detailed information about the IPv6 PIM neighbor with IPv6 address FE80::A01:101:1.
<Sysname> display ipv6 pim neighbor fe80::a01:101:1 verbose
Neighbor: FE80::A01:101:1
Interface: Vlan-interface3
Uptime: 00:00:10
Expiry time: 00:00:30
DR Priority: 1
Generation ID: 0x2ACEFE15
Holdtime: 105 s
LAN delay: 500 ms
Override interval: 2500 ms
13
State refresh interval: 60 s
Neighbor tracking: Disabled
Bidirectional PIM: Disabled
Secondary address(es):
1::1
Field Description
LAN delay IPv6 PIM message propagation delay on the shared-media LAN.
Override interval Interval for overriding prune messages.
Interval for refreshing state.
State refresh interval This field is displayed only when the IPv6 PIM neighbor is operating in
IPv6 PIM-DM mode and the state refresh feature is enabled.
Neighbor tracking Neighbor tracking status: enabled or disabled.
IPv6 BIDIR-PIM is not supported in the current software version.
Bidirectional PIM
Whether IPv6 BIDIR-PIM is enabled.
Secondary IPv6 address (non-link-local address) of the IPv6 PIM
Secondary address(es)
neighbor.
14
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
If you do not specify an IPv6 multicast group, this command displays IPv6 PIM routing entries for all
IPv6 multicast groups.
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address.
prefix-length: Specifies a prefix length of the IPv6 multicast group or IPv6 multicast source
address. The default is 128. For an IPv6 multicast group address, the value range for this argument
is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.
flags flag-value: Specifies a flag. If you do not specify a flag, this command displays IPv6 PIM
routing entries that contain all flags.
The following lists the values for the flag-value argument and their meanings:
• act: Specifies IPv6 PIM routing entries that have been used for routing data.
• del: Specifies IPv6 PIM routing entries to be deleted.
• exprune: Specifies IPv6 PIM routing entries that contain outgoing interfaces pruned by other
IPv6 multicast routing protocols.
• ext: Specifies IPv6 PIM routing entries that contain outgoing interfaces provided by other
multicast routing protocols.
• loc: Specifies IPv6 PIM routing entries on the devices that reside on the same subnet as the
IPv6 multicast source.
• niif: Specifies IPv6 PIM routing entries that contain unknown incoming interfaces.
• nonbr: Specifies IPv6 PIM routing entries with IPv6 PIM neighbor lookup failure.
• rpt: Specifies IPv6 PIM routing entries on the RPT branches where (S, G) prunes have been
sent to the RP.
• rq: Specifies IPv6 PIM routing entries on the receiving side of the RPT-to-SPT switchover.
• spt: Specifies IPv6 PIM routing entries on the SPT.
• sq: Specifies IPv6 PIM routing entries on the originating side of the RPT-to-SPT switchover.
• swt: Specifies IPv6 PIM routing entries in the process of RPT-to-SPT switchover.
• wc: Specifies IPv6 PIM routing entries with wildcards.
fsm: Displays detailed information about the finite state machine.
incoming-interface interface-type interface-number: Specifies an incoming
interface. If you do not specify an incoming interface, this command displays IPv6 PIM routing
entries that contain all incoming interfaces.
interface-type interface-number: Specifies an interface by its type and number.
mode mode-type: Specifies an IPv6 PIM mode. If you do not specify an IPv6 PIM mode, this
command displays IPv6 PIM routing entries in all modes. The available IPv6 PIM modes include:
• dm: Specifies IPv6 PIM-DM.
• sm: Specifies IPv6 PIM-SM.
15
• ssm: Specifies IPv6 PIM-SSM.
outgoing-interface { exclude | include | match } interface-type
interface-number: Specifies an outgoing interface. If you do not specify an outgoing interface,
this command displays IPv6 PIM routing entries that contain all outgoing interfaces. Whether the
specified outgoing interface is contained in the IPv6 PIM routing table depends on the following
conditions:
• If you specify an excluded interface, this command displays IPv6 PIM routing entries that do not
contain the specified outgoing interface.
• If you specify an included interface, this command displays IPv6 PIM routing entries that
contain the specified outgoing interface.
• If you specify a matching interface, this command displays IPv6 PIM routing entries that contain
only the specified outgoing interface.
Examples
# Display IPv6 PIM routing entries.
<Sysname> display ipv6 pim routing-table
Total 0 (*, G) entries; 1 (S, G) entries
(2001::2, FFE3::101)
RP: FE80::A01:100:1
Protocol: pim-sm, Flag: SPT LOC ACT
UpTime: 02:54:43
Upstream interface: Vlan-interface1
Upstream neighbor: NULL
RPF prime neighbor: NULL
Downstream interface information:
Total number of downstream interfaces: 1
1: Vlan-interface2
Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47
# Display state machine information for the IPv6 PIM routing table.
<Sysname> display ipv6 pim routing-table fsm
Total 0 (*, G) entries; 1 (S, G) entries
(2001::2, FFE3::101)
RP: FE80::A01:100:1
Protocol: pim-sm, Flag: SPT LOC ACT
UpTime: 02:54:43
Upstream interface: Vlan-interface1
Upstream neighbor: NULL
RPF prime neighbor: NULL
Join/Prune FSM: [SPT: J] [RPT: NP]
Downstream interface information:
Total number of downstream interfaces: 1
16
1: Vlan-interface2
Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47
DR state: [DR]
Join/Prune FSM: [NI]
Assert FSM: [NI]
Field Description
Uptime Length of time since the (S, G) entry or (*, G) entry was installed.
Upstream interface Upstream (incoming) interface of the (S, G) entry or (*, G) entry.
Upstream neighbor Upstream neighbor of the (S, G) entry or (*, G) entry.
RPF neighbor of the (S, G) or (*, G) entry:
• For a (*, G) entry, if the RPF neighbor is the RP, the field displays
RPF prime neighbor NULL.
• For an (S, G) entry, if the RPF neighbor is a router that directly
connects to the IPv6 multicast source, this field displays NULL.
17
display ipv6 pim rp-info
Use display ipv6 pim rp-info to display RP information.
Syntax
display ipv6 pim rp-info [ ipv6-group-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this
argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any
hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this
command displays RP information for all IPv6 multicast groups.
Examples
# Display information about the RP for IPv6 multicast group FF73:130:7:12::1.
<Sysname> display ipv6 pim rp-info ff73:130:7:12::1
Embedded RP address is: 7:12::1
Configured ACL: 2000
# Display information about all RPs for all IPv6 multicast groups.
<Sysname> display ipv6 pim rp-info
IPv6 PIM-SM embedded RP information:
Embedded RP ACL: 2000
Group RP address
FF73:230:8:12:: 8:12::2
18
BSR RP information:
Scope: non-scoped
Group/MaskLen: FF73:230:8:12::/64
RP address Priority HoldTime Uptime Expires
8:12::2 (local) 192 180 03:01:36 00:02:29
Group/MaskLen: FF23::/92 [B]
RP address Priority HoldTime Uptime Expires
7:12::1 (local) 192 180 00:00:39 00:02:57
Static RP information:
RP address ACL Mode Preferred
3:3::1 2000 pim-sm No
3:3::2 2001 pim-sm Yes
3:3::3 2002 pim-sm No
3:3::4 pim-sm No
3:3::5 2002 pim-sm Yes
Anycast-RP information:
RP address Member address State
3:3::1 1:1::1 Active
3:3::1 1:1::2 Local
3:3::1 1:2::1 Remote
Field Description
19
Field Description
RP mapping for this group IPv6 address of the RP that provides services for the IPv6 multicast group.
Anycast-RP 7:12::1
Members of Anycast RP 7:12::1.
members
Member address IPv6 address of the Anycast RP member.
State of the interface from which the member address originates:
• Active—Activated local interface.
State
• Local—Inactivated local interface.
• Remote—Remote interface.
Field Description
20
Field Description
dscp
Use dscp to set the DSCP value for outgoing IPv6 PIM protocol packets.
Use undo dscp to restore the default.
Syntax
dscp dscp-value
undo dscp
Default
The DSCP value is 48 for outgoing IPv6 PIM protocol packets.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
dscp-value: Specifies a DSCP value in the range of 0 to 63.
Usage guidelines
The DSCP value is carried in the Traffic Class field of an IPv6 packet to determine the transmission
priority of the packet. A greater DSCP value represents a higher priority.
Examples
# Set the DSCP value to 63 for outgoing IPv6 PIM protocol packets.
<Sysname> system-view
[Sysname] ipv6 pim
21
[Sysname-pim6] dscp 63
embedded-rp
Use embedded-rp to enable embedded RP.
Use undo embedded-rp to disable embedded RP.
Syntax
embedded-rp [ ipv6-acl-number ]
undo embedded-rp
Default
Embedded RP is disabled.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic ACL number in the range of 2000 to 2999.
Usage guidelines
Embedded RP is used for RP discovery in IPv6 PIM-SM. This feature supports embedding the RP
address in an IPv6 multicast group address and enables multicast routers to extract the RP address
from the IPv6 multicast group address.
Embedded RP is supported only for IPv6 multicast group addresses in the range of FF7x::/12 or
FFFx::/12 and in compliance with RFC 3956.
If you do not specify the ipv6-acl-number argument, this command takes effect on all IPv6
multicast groups in the range of FF7x::/12 or FFFx::/12. If you specify this argument, this command
takes effect only on the IPv6 multicast groups that are in the range of FF7x::/12 or FFFx::/12 and
permitted by the ACL.
Examples
# Enable embedded RP for IPv6 multicast group addresses in the range of FF7E:140:20::101/64.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff7e:140:20::101 64
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 pim
[Sysname-pim6] embedded-rp 2000
22
Default
The DR priority is 1.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
priority: Specifies a DR priority in the range of 0 to 4294967295. The greater the value, the
higher the priority.
Usage guidelines
You can set the DR priority globally for all interfaces in IPv6 PIM view or for an interface in interface
view. For an interface, the interface-specific configuration takes priority over the global configuration.
Examples
# Set the global DR priority to 3.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] hello-option dr-priority 3
Related commands
ipv6 pim hello-option dr-priority
23
Examples
# Set the global IPv6 PIM neighbor lifetime to 120 seconds.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] hello-option holdtime 120
Related commands
ipv6 pim hello-option holdtime
Related commands
hello-option override-interval (IPv6 PIM view)
ipv6 pim hello-option lan-delay
ipv6 pim hello-option override-interval
24
Use undo hello-option neighbor-tracking to disable neighbor tracking globally.
Syntax
hello-option neighbor-tracking
undo hello-option neighbor-tracking
Default
Neighbor tracking is disabled.
Views
IPv6 PIM view
Predefined user roles
network-admin
Usage guidelines
You can enable neighbor tracking globally for all interfaces in IPv6 PIM view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
Examples
# Enable neighbor tracking globally.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] hello-option neighbor-tracking
Related commands
ipv6 pim hello-option neighbor-tracking
25
Examples
# Set the global override interval to 2000 milliseconds.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] hello-option override-interval 2000
Related commands
hello-option lan-delay (IPv6 PIM view)
ipv6 pim hello-option lan-delay
ipv6 pim hello-option override-interval
Related commands
ipv6 pim holdtime join-prune
timer join-prune (IPv6 PIM view)
26
ipv6 pim
Use ipv6 pim to enter IPv6 PIM view.
Use undo ipv6 pim to remove all configurations in IPv6 PIM view.
Syntax
ipv6 pim
undo ipv6 pim
Views
System view
Predefined user roles
network-admin
Examples
# Enable IPv6 multicast routing, and enter the IPv6 PIM view.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] quit
[Sysname] ipv6 pim
[Sysname-pim6]
27
[Sysname-Vlan-interface100] ipv6 pim bfd enable
Related commands
ipv6 pim dm
ipv6 pim sm
Related commands
c-bsr (IPv6 PIM view)
ipv6 multicast boundary
ipv6 pim dm
Use ipv6 pim dm to enable IPv6 PIM-DM.
Use undo ipv6 pim dm to disable IPv6 PIM-DM.
Syntax
ipv6 pim dm
undo ipv6 pim dm
Default
IPv6 PIM-DM is disabled.
Views
Interface view
Predefined user roles
network-admin
28
Usage guidelines
This command takes effect only when IPv6 multicast routing is enabled on the public network or for
the VPN instance to which the interface belongs.
Examples
# Enable IPv6 multicast routing, and enable IPv6 PIM-DM on VLAN-interface 100.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim dm
Related commands
ipv6 multicast routing
Related commands
hello-option dr-priority (IPv6 PIM view)
29
ipv6 pim hello-option holdtime
Use ipv6 pim hello-option holdtime to set the IPv6 PIM neighbor lifetime on an interface.
Use undo ipv6 pim hello-option holdtime to restore the default.
Syntax
ipv6 pim hello-option holdtime time
undo ipv6 pim hello-option holdtime
Default
The IPv6 PIM neighbor lifetime is 105 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
time: Specifies an IPv6 PIM neighbor lifetime in the range of 1 to 65535 seconds. If you set the
value to 65535 seconds, the IPv6 PIM neighbor is always reachable.
Usage guidelines
You can set the IPv6 PIM neighbor lifetime for an interface in interface view or globally for all
interfaces in IPv6 PIM view. For an interface, the interface-specific configuration takes priority over
the global configuration.
Examples
# Set the IPv6 PIM neighbor lifetime to 120 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim hello-option holdtime 120
Related commands
hello-option holdtime (IPv6 PIM view)
30
Predefined user roles
network-admin
Parameters
delay: Specifies an IPv6 PIM message propagation delay on a shared-media LAN in the range of 1
to 32767 milliseconds.
Usage guidelines
You can set the IPv6 PIM message propagation delay for an interface in interface view or globally for
all interfaces in IPv6 PIM view. For an interface, the interface-specific configuration takes priority
over the global configuration.
Examples
# Set the IPv6 PIM message propagation delay on a shared-media LAN to 200 milliseconds on
VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim hello-option lan-delay 200
Related commands
hello-option lan-delay (IPv6 PIM view)
hello-option override-interval (IPv6 PIM view)
ipv6 pim hello-option override-interval
31
Examples
# Enable neighbor tracking on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim hello-option neighbor-tracking
# Disable neighbor tracking on VLAN-interface 100 when neighbor tracking is enabled globally.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] hello-option neighbor-tracking
[Sysname-pim6] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim hello-option neighbor-tracking disable
Related commands
hello-option neighbor-tracking (IPv6 PIM view)
Related commands
hello-option lan-delay (IPv6 PIM view)
32
hello-option override-interval (IPv6 PIM view)
ipv6 pim hello-option lan-delay
Related commands
holdtime join-prune (IPv6 PIM view)
ipv6 pim timer join-prune
33
Default
No IPv6 PIM hello policy exists on an interface, and all IPv6 PIM hello messages are regarded as
legal.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic ACL number in the range of 2000 to 2999.
Usage guidelines
An IPv6 PIM hello policy filters IPv6 PIM hello messages to guard against hello message spoofing.
When you configure a rule in the IPv6 basic ACL, follow these restrictions and guidelines:
• The source source-address source-prefix option specifies a source IPv6 address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure an IPv6 PIM hello policy on VLAN-interface 100, so that only the devices on subnet
FE80:101::101/64 can become PIM neighbors of this switch.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source fe80:101::101 64
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim neighbor-policy 2000
34
[Sysname] ipv6 pim non-stop-routing
35
Examples
# Enable VLAN-interface 100 to drop hello messages without the generation ID options.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim require-genid
ipv6 pim sm
Use ipv6 pim sm to enable IPv6 PIM-SM.
Use undo ipv6 pim sm to disable IPv6 PIM-SM.
Syntax
ipv6 pim sm
undo ipv6 pim sm
Default
IPv6 PIM-SM is disabled.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when IPv6 multicast routing is enabled on the public network or for
the VPN instance to which the interface belongs.
Examples
# Enable IPv6 multicast routing, and enable IPv6 PIM-SM on VLAN-interface 100.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim sm
Related commands
ipv6 multicast routing
36
Views
Interface view
Predefined user roles
network-admin
Examples
# Disable the state refresh feature on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] undo ipv6 pim state-refresh-capable
Related commands
state-refresh-hoplimit (IPv6 PIM view)
state-refresh-interval (IPv6 PIM view)
state-refresh-rate-limit (IPv6 PIM view)
37
undo ipv6 pim timer hello
Default
The hello interval is 30 seconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
interval: Specifies a hello interval in the range of 0 to 18000 seconds. If you set the value to 0
seconds, the interface does not send hello messages.
Usage guidelines
You can set the hello interval for an interface in interface view or globally for all interfaces in IPv6 PIM
view. For an interface, the interface-specific configuration takes priority over the global configuration.
Examples
# Set the hello interval to 40 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim timer hello 40
Related commands
timer hello (IPv6 PIM view)
38
The configuration takes effect after the current interval ends.
To prevent the upstream neighbors from aging out, you must set the interval for sending join/prune
messages to be less than the joined/pruned state holdtime timer.
Examples
# Set the join/prune interval to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] ipv6 pim timer join-prune 80
Related commands
ipv6 pim holdtime join-prune
timer join-prune (IPv6 PIM view)
39
Default
The maximum size of a join or prune message is 8100 bytes.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
size: Specifies the maximum size of a join or prune message, in the range of 100 to 64000 bytes.
Examples
# Set the maximum size of a join or prune message to 1500 bytes.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] jp-pkt-size 1500
40
Examples
# Configure an IPv6 PIM register policy to accept register messages from sources on subnet 3:1::/64
to groups on the subnet FF0E:13::/64.
<Sysname> system-view
[Sysname] acl ipv6 advanced 3000
[Sysname-acl-ipv6-adv-3000] rule permit ipv6 source 3:1:: 64 destination ff0e:13:: 64
[Sysname-acl-ipv6-adv-3000] quit
[Sysname] ipv6 pim
[Sysname-pim6] register-policy 3000
41
Views
IPv6 PIM view
Predefined user roles
network-admin
Examples
# Configure the device to calculate the checksum based on an entire register message.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] register-whole-checksum
42
source-lifetime (IPv6 PIM view)
Use source-lifetime to set the IPv6 multicast source lifetime.
Use undo source-lifetime to restore the default.
Syntax
source-lifetime time
undo source-lifetime
Default
The IPv6 multicast source lifetime is 210 seconds.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
time: Specifies an IPv6 multicast source lifetime in the range of 0 to 31536000 seconds. If you set
the value to 0 seconds, IPv6 multicast sources are never aged out.
Examples
# Set the IPv6 multicast source lifetime to 200 seconds.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] source-lifetime 200
43
When you configure a rule in the IPv6 ACL, follow these restrictions and guidelines:
• In a basic ACL, the source source-address source-prefix option specifies a source
IPv6 address.
• In an advanced ACL, the source source-address source-prefix option specifies a
source IPv6 address. The destination dest-address dest-prefix option specifies
an IPv6 multicast group address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Configure an IPv6 multicast source policy to accept IPv6 multicast data from source 3121::1 and to
deny the data from source 3121::2.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source 3121::1 128
[Sysname-acl-ipv6-basic-2000] rule deny source 3121::2 128
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 pim
[Sysname-pim6] source-policy 2000
[Sysname-pim6] quit
44
• The specified ACL does not exist.
• The specified ACL does not have valid rules.
Usage guidelines
When you configure a rule in the IPv6 basic ACL, follow these restrictions and guidelines:
• The source source-address source-prefix option specifies an IPv6 multicast group
address.
• Among the other optional parameters, only the fragment keyword and the time-range
time-range-name option take effect.
Some devices cannot encapsulate IPv6 multicast data in register messages destined to the RP. As a
best practice to avoid IPv6 multicast data forwarding failures, do not disable the switchover to SPT
on C-RPs that might become the RP.
Examples
# Disable RPT-to-SPT switchover on receiver-side DR.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] spt-switch-threshold infinity
45
Examples
# Configure the IPv6 SSM group range as FF3E:0:8192::/96.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff3e:0:8192:: 96
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 pim
[Sysname-pim6] ssm-policy 2000
Related commands
ipv6 pim state-refresh-capable
state-refresh-interval (IPv6 PIM view)
state-refresh-rate-limit (IPv6 PIM view)
46
Default
The state refresh interval is 60 seconds.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
interval: Specifies a state refresh interval in the range of 1 to 255 seconds.
Examples
# Set the state refresh interval to 70 seconds.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] state-refresh-interval 70
Related commands
ipv6 pim state-refresh-capable
state-refresh-hoplimit (IPv6 PIM view)
state-refresh-rate-limit (IPv6 PIM view)
47
Related commands
ipv6 pim state-refresh-capable
state-refresh-hoplimit (IPv6 PIM view)
state-refresh-interval (IPv6 PIM view)
48
takes effect. If you configure multiple static RPs for the same IPv6 multicast group, the static RP with
the highest IPv6 address is used.
Examples
# Configure the interface with IPv6 address 2001::2 as a static RP for IPv6 multicast group range
FF03::101/64 and give priority to this static RP.
<Sysname> system-view
[Sysname] acl ipv6 basic 2001
[Sysname-acl-ipv6-basic-2001] rule permit source ff03::101 64
[Sysname-acl-ipv6-basic-2001] quit
[Sysname] ipv6 pim
[Sysname-pim6] static-rp 2001::2 2001 preferred
Related commands
display ipv6 pim rp-info
Related commands
ipv6 pim timer hello
49
timer join-prune (IPv6 PIM view)
Use timer join-prune to set the join/prune interval globally.
Use undo timer join-prune to restore the default.
Syntax
timer join-prune interval
undo timer join-prune
Default
The join/prune interval is 60 seconds.
Views
IPv6 PIM view
Predefined user roles
network-admin
Parameters
interval: Specifies a join/prune interval in the range of 0 to 18000 seconds. If you set the value to
0 seconds, the device does not send join or prune messages.
Usage guidelines
You can set the join/prune interval globally for all interfaces in IPv6 PIM view or for an interface in
interface view. For an interface, the interface-specific configuration takes priority over the global
configuration.
The configuration takes effect after the current interval ends.
To prevent the upstream neighbors from aging out, you must set the join/prune interval to be less
than the joined/pruned state holdtime.
Examples
# Set the global join/prune interval to 80 seconds.
<Sysname> system-view
[Sysname] ipv6 pim
[Sysname-pim6] timer join-prune 80
Related commands
holdtime join-prune (IPv6 PIM view)
ipv6 pim timer join-prune
50