Field	Description
IGMP snooping	IGMP snooping status: · Enabled. · Disabled.
Drop-unknown	Status of dropping unknown multicast data: · Enabled. · Disabled.
Version	IGMP snooping version.
Host-aging-time	Aging timer for the dynamic member port.
Router-aging-time	Aging timer for the dynamic router port.
Max-response-time	Maximum response time for IGMP general queries.
Last-member-query-interval	Interval for sending IGMP group-specific queries.
Report-aggregation	Status of IGMP report suppression: · Enabled. · Disabled.
Dot1p-priority	802.1p priority for IGMP messages. If the priority is not configured, this field displays two hyphens (--).
Querier	Status of IGMP snooping querier: · Enabled. · Disabled.
Query-interval	Interval for sending IGMP general queries.
General-query source IP	Source IP address of IGMP general queries.
Special-query source IP	Source IP address of IGMP group-specific queries.
Report source IP	Source IP address of IGMP reports.
Leave source IP	Source IP address of IGMP leave messages.

display igmp-snooping group

Use display igmp-snooping group to display dynamic IGMP snooping group entries.

Syntax

Centralized devices in standalone mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number 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 dynamic IGMP snooping group entries 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 dynamic IGMP snooping group entries 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 dynamic IGMP snooping group entries for all VLANs.

verbose: Displays detailed information about dynamic IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about dynamic IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic IGMP snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays dynamic IGMP snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic IGMP snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about dynamic IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

GE1/0/2 (00:03:23)

Table 2 Command output

Field	Description
Total 1 entries	Total number of dynamic IGMP snooping group entries.
VLAN 2: Total 1 entries	Total number of dynamic IGMP snooping group entries in VLAN 2.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the specified card or the MPU when no card is specified. · slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—No entry exists. · normal—The entry is a correct entry.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.
(00:03:23)	Remaining aging time for the dynamic member port. For a global port, this field is always displayed. (Centralized devices in standalone mode.) For a global port, this field is always displayed. (Distributed devices in standalone mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (Centralized devices in IRF mode.) For a 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. (Distributed devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.

Related commands

reset igmp-snooping group

display igmp-snooping router-port

Use display igmp-snooping router-port to display dynamic router port information.

Syntax

Centralized devices in standalone mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information. If you do not specify the keyword, this command displays brief information.

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 dynamic router port information for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic router port information for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays dynamic router port information for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display dynamic router port information for VLAN 2.

<Sysname> display igmp-snooping router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

GE1/0/1 (00:01:30)

GE1/0/2 (00:00:23)

Table 3 Command output

Field	Description
VLAN 2	VLAN ID.
Router slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have dynamic router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have dynamic router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have dynamic router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Router ports (2 in total)	Dynamic router ports, and the total number of dynamic router ports.
(00:01:30)	Remaining aging time for the dynamic router port. For a global port, this field is always displayed. (Centralized devices in standalone mode.) For a global port, this field is always displayed. (Distributed devices in standalone mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (Centralized devices in IRF mode.) For a 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. (Distributed devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.

Related commands

reset igmp-snooping router-port

display igmp-snooping static-group

Use display igmp-snooping static-group to display static IGMP snooping group entries.

Syntax

Centralized devices in standalone mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number 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 static IGMP snooping group entries 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 static IGMP snooping group entries 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 static IGMP snooping group entries for all VLANs.

verbose: Displays detailed information about static IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about static IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static IGMP snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays static IGMP snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static IGMP snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about static IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping static-group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

GE1/0/2

Table 4 Command output

Field	Description
Total 1 entries	Total number of static IGMP snooping group entries.
VLAN 2: Total 1 entries	Total number of static IGMP snooping group entries in VLAN 2.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the specified card or on the MPU when no card is specified. · slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—No entry exists. · normal—The entry is a correct entry.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.

display igmp-snooping static-router-port

Use display igmp-snooping static-router-port to display static router port information.

Syntax

Centralized devices in standalone mode:

display igmp-snooping static-router-port [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ chassis chassis-number 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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static router port information for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display static router port information for VLAN 2.

<Sysname> display igmp-snooping static-router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

GE1/0/1

GE1/0/2

Table 5 Command output

Field	Description
VLAN 2	VLAN ID.
Router slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have static router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have static router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have static router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Router ports (2 in total)	Static router ports, and the total number of static router ports.

display igmp-snooping statistics

Use display igmp-snooping statistics to display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

display igmp-snooping statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries: 0

Received IGMPv1 reports: 0

Received IGMPv2 reports: 19

Received IGMP leaves: 0

Received IGMPv2 specific queries: 0

Sent IGMPv2 specific queries: 0

Received IGMPv3 reports: 1

Received IGMPv3 reports with right and wrong records: 0

Received IGMPv3 specific queries: 0

Received IGMPv3 specific sg queries: 0

Sent IGMPv3 specific queries: 0

Sent IGMPv3 specific sg queries: 0

Received PIMv2 hello: 0

Received error IGMP messages: 19

Table 6 Command output

Field	Description
general queries	Number of IGMP general queries.
specific queries	Number of IGMP group-specific queries.
reports	Number of IGMP reports.
leaves	Number of IGMP leave messages.
reports with right and wrong records	Number of IGMP reports with correct and incorrect records.
specific sg queries	Number of IGMP group-and-source-specific queries.
PIMv2 hello	Number of PIMv2 hello messages.
error IGMP messages	Number of IGMP messages with errors.

Related commands

reset igmp-snooping statistics

display l2-multicast fast-forwarding cache

Use display l2-multicast fast-forwarding cache to display Layer 2 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] * [ chassis chassis-number 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.

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 a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

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: GigabitEthernet1/0/2

List of 1 egress ports:

GigabitEthernet1/0/3

Status: Enable Flag: 0x10

Table 7 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries in the Layer 2 multicast fast forwarding table, 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	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. · 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.
Status	Status of the (S, G) entry or the outgoing port: · Enabled—Available. · Disabled—Unavailable.
Ingress port	Incoming port of the (S, G) entry.
List of 1 egress ports	Outgoing port list of the (S, G) entry.

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

Centralized devices in standalone mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ] [ chassis chassis-number 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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 IP multicast groups for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 IP multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 IP multicast groups for VLAN 2.

<Sysname> display l2-multicast ip vlan 2

Total 1 entries.

VLAN 2: Total 1 IP entries.

(0.0.0.0, 224.1.1.1)

Attribute: static, success

Host slots (0 in total):

Host ports (1 in total):

GE1/0/1 (S, SUC)

Table 8 Command output

Field	Description
Total 1 entries	Total number of Layer 2 IP multicast groups.
VLAN 2: Total 1 IP entries	Total number of Layer 2 IP multicast groups in VLAN 2.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · dynamic—The entry is created by a dynamic protocol. · static—The entry is created by a static protocol. · pim—The entry is created by PIM. · kernel—The entry is obtained from the kernel. · success—Processing succeeds. · fail—Processing fails.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.
(S, SUC)	Port attribute: · D—Dynamic port. · S—Static port. · P—PIM port. · K—Port obtained from the kernel. · R—Port learned from (, ) entries. · W—Port learned from (*, G) entries. · SUC—Processing succeeds. · F—Processing fails. · BC—Broadcast port. The TRILL port floods multicast data after the topology changes.

display l2-multicast ip forwarding

Use display l2-multicast ip forwarding to display Layer 2 multicast IP forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ chassis chassis-number 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 Layer 2 multicast IP forwarding entries for all multicast groups.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays Layer 2 multicast IP forwarding entries 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 Layer 2 multicast IP forwarding entries for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries for the MPU. (Distributed devices in standalone mode.)

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 IP forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 multicast IP forwarding entries for VLAN 2.

<Sysname> display l2-multicast ip forwarding vlan 2

Total 1 entries.

VLAN 2: Total 1 IP entries.

(0.0.0.0, 224.1.1.1)

Host slots (0 in total):

Host ports (3 in total):

GigabitEthernet1/0/1

GigabitEthernet1/0/2

GigabitEthernet1/0/3

Table 9 Command output

Field	Description
Total 1 entries	Total number of Layer 2 multicast IP forwarding entries.
VLAN 2: Total 1 IP entries	Total number of Layer 2 multicast IP forwarding entries in VLAN 2.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (3 in total)	Member ports, and the total number of member ports.

display l2-multicast mac

Use display l2-multicast mac to display information about Layer 2 MAC multicast groups.

Syntax

Centralized devices in standalone mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number 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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 MAC multicast groups for VLAN 2.

<Sysname> display l2-multicast mac vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Attribute: success

Host slots (0 in total):

Host ports (1 in total):

GE1/0/1

Table 10 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 MAC multicast groups.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 MAC multicast groups in VLAN 2.
MAC group address	Address of the MAC multicast group.
Attribute	Entry attribute: · success—Processing succeeds. · fail—Processing fails.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.

display l2-multicast mac forwarding

Use display l2-multicast mac forwarding to display Layer 2 multicast MAC forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC multicast group by its MAC address. If you do not specify a MAC multicast group, this command displays Layer 2 multicast MAC forwarding entries for all 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 multicast MAC forwarding entries for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast MAC forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast MAC group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 multicast MAC forwarding entries for VLAN 2.

<Sysname> display l2-multicast mac forwarding vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Host slots (0 in total):

Host ports (3 in total):

GigabitEthernet1/0/1

GigabitEthernet1/0/2

GigabitEthernet1/0/3

Table 11 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 multicast MAC forwarding entries.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 multicast MAC forwarding entries in VLAN 2.
MAC group address	Address of the MAC multicast group.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (3 in total)	Member ports, and the total number of member ports.

dot1p-priority (IGMP-snooping view)

Use dot1p-priority to set the 802.1p priority for IGMP messages globally.

Use undo dot1p-priority to restore the default.

Syntax

dot1p-priority priority

undo dot1p-priority

Default

The 802.1p priority for IGMP messages is not set.

Views

IGMP-snooping 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 can set the 802.1p priority globally for all VLANs 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

enable (IGMP-snooping view)

Use enable to enable IGMP snooping for VLANs.

Use undo enable to disable IGMP snooping for VLANs.

Syntax

enable vlan vlan-list

undo enable vlan vlan-list

Default

IGMP snooping is disabled for a VLAN.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

You must enable IGMP snooping globally before you enable IGMP snooping for VLANs.

You can enable IGMP snooping for the specified VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, 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 IGMP snooping globally, and 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

entry-limit (IGMP-snooping view)

Use entry-limit to globally set the maximum number of IGMP snooping forwarding entries, including dynamic entries and static entries.

Use undo entry-limit to restore the default.

Syntax

entry-limit limit

undo entry-limit

Default

The maximum number of IGMP snooping forwarding entries is 4294967295.

Views

IGMP-snooping view

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

fast-leave (IGMP-snooping view)

Use fast-leave to enable fast-leave processing globally.

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

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

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

Examples

# Globally enable fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

Related commands

igmp-snooping fast-leave

group-policy (IGMP-snooping view)

Use group-policy to globally configure a multicast group policy to control the multicast groups that hosts can join.

Use undo group-policy to globally delete multicast group policies.

Syntax

group-policy ipv4-acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

Default

Multicast group policies are not configured, and hosts can join any multicast groups.

Views

IGMP-snooping 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.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

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:

· 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 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

host-aging-time (IGMP-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

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 in IGMP-snooping view or for a VLAN in VLAN view. 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

igmp-snooping

Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

Syntax

igmp-snooping

undo igmp-snooping

Default

IGMP snooping is disabled globally.

Views

System view

Predefined user roles

network-admin

Examples

# Enable IGMP snooping globally, 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 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 for IGMP messages is not set.

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. For a VLAN, 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.

Use undo igmp-snooping drop-unknown to disable dropping unknown multicast data packets for a VLAN.

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

Default

Dropping unknown multicast data packets is disabled for a VLAN, and unknown multicast data packets are flooded in the VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

¡ SIC-4GSW/4GSWF/4GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

You must enable IGMP snooping for a VLAN 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

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

Use igmp-snooping enable to enable IGMP snooping for a VLAN.

Use undo igmp-snooping enable to disable IGMP snooping for a VLAN.

Syntax

igmp-snooping enable

undo igmp-snooping enable

Default

IGMP snooping is disabled for a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping globally before you execute this command.

You can enable IGMP snooping for a VLAN in VLAN view or for the specified VLANs in IGMP-snooping view. For a VLAN, 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 IGMP snooping globally, and enable IGMP snooping for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] 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.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2

Related commands

fast-leave (IGMP-snooping view)

igmp-snooping general-query source-ip

Use igmp-snooping general-query source-ip to configure the source IP address for IGMP general queries.

Use undo igmp-snooping general-query source-ip to restore the default.

Syntax

igmp-snooping general-query source-ip ip-address

undo igmp-snooping general-query source-ip

Default

In a VLAN, the source IP address of IGMP general queries is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP general queries.

Usage guidelines

You must enable IGMP snooping for a VLAN 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

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 aggregate interface view

Layer 2 Ethernet 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.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

Examples

# On 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 gigabitethernet 1/0/1

[Sysname-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 are configured on a port, and hosts attached to the port can join any multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

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.

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 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 in different VLANs. If you configure multiple ACLs on a port in the same VLAN, the most recent configuration takes effect.

Examples

# On 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 gigabitethernet 1/0/1

[Sysname-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.

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

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 IGMP snooping for a VLAN before you execute this command.

You can set the timer for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. 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

# 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

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 }

Default

A port is not configured as a simulated member host for multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet 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

A port configured as a simulated member host ages out in the same way as a dynamic member port.

Make sure the simulated member host runs the same version of IGMP and IGMP snooping.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host of 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 gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 232.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping last-member-query-interval

Use igmp-snooping last-member-query-interval to set the IGMP last member query interval for a VLAN.

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

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 before you execute this command.

You can set the interval for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

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

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

last-member-query-interval (IGMP-snooping view)

igmp-snooping leave source-ip

Use igmp-snooping leave source-ip to configure the source IP address for IGMP leave messages.

Use undo igmp-snooping leave source-ip to restore the default.

Syntax

igmp-snooping leave source-ip ip-address

undo igmp-snooping leave source-ip

Default

The source IP address of IGMP leave messages is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP leave messages.

Usage guidelines

You must enable IGMP snooping for a VLAN 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 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

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.

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 in a VLAN.

Views

VLAN 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 before you execute this command.

You can set the time for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-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

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 the multicast group replacement feature on a port.

Use undo igmp-snooping overflow-replace to disable the multicast group replacement feature on a port.

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement feature is disabled.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable the multicast group replacement feature 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.

This feature does not take effect if the following conditions exist:

· The number of the IGMP snooping forwarding entries on the device reaches or exceeds the upper limit.

· The multicast group that the port newly joins is not included in the multicast group list maintained by the device.

Examples

# On GigabitEthernet 1/0/1, enable the multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2

Related commands

overflow-replace (IGMP-snooping 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

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN 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

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

subvlan (multicast VLAN view)

igmp-snooping query-interval

Use igmp-snooping query-interval to set the IGMP general query interval for a VLAN.

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 for a VLAN.

Views

VLAN 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 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

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping max-response-time

igmp-snooping querier

max-response-time

igmp-snooping report source-ip

Use igmp-snooping report source-ip to configure the source IP address for IGMP reports.

Use undo igmp-snooping report source-ip to restore the default.

Syntax

igmp-snooping report source-ip ip-address

undo igmp-snooping report source-ip

Default

The source IP address of IGMP reports is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP reports.

Usage guidelines

You must enable IGMP snooping for a VLAN 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 reports.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping report source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

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.

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 in a VLAN.

Views

VLAN 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 before you execute this command.

You can set the timer for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-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

Related commands

enable (IGMP-snooping view)

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 aggregate interface view

Layer 2 Ethernet 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 GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-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

Predefined user roles

network-admin

Usage guidelines

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping source-deny

Related commands

source-deny (IGMP-snooping view)

igmp-snooping special-query source-ip

Use igmp-snooping special-query source-ip to configure the source IP address for IGMP group-specific queries.

Use undo igmp-snooping special-query source-ip to restore the default.

Syntax

igmp-snooping special-query source-ip ip-address

undo igmp-snooping special-query source-ip

Default

In a VLAN, the source IP address of IGMP group-specific queries is one of the following:

· The source address of IGMP group-specific queries if the IGMP snooping querier has received IGMP general queries.

· The IP address of the current VLAN interface if the IGMP snooping querier does not receive an IGMP general query.

· 0.0.0.0 if the IGMP snooping querier does not receive an IGMP general query and the current VLAN interface does not have an IP address.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP group-specific queries.

Usage guidelines

You must enable IGMP snooping for a VLAN 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

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 aggregate interface view

Layer 2 Ethernet 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.

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 GigabitEthernet 1/0/1 as a static member port of 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 Gigabitethernet 1/0/1

[Sysname-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 aggregate interface view

Layer 2 Ethernet 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 GigabitEthernet 1/0/1 as a static router port in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2

igmp-snooping version

Use igmp-snooping version to specify an IGMP snooping version for a VLAN.

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 is 2.

Views

VLAN 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 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. For a VLAN, the configuration in VLAN view 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

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

version (IGMP-snooping view)

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 or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-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

max-response-time (IGMP-snooping view)

Use max-response-time to set the maximum response time for IGMP general queries globally.

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

Syntax

max-response-time seconds

undo max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

IGMP-snooping 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 can set the time for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-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

overflow-replace (IGMP-snooping view)

Use overflow-replace to enable the multicast group replacement feature globally.

Use undo overflow-replace to disable the multicast group replacement feature globally.

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement feature is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable the multicast group replacement feature 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.

This feature does not take effect if the following conditions exist:

· The number of the IGMP snooping forwarding entries on the device reaches or exceeds the upper limit.

· The multicast group that the port newly joins is not included in the multicast group list maintained by the device.

Examples

# Globally enable the multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

Related commands

igmp-snooping overflow-replace

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

reset igmp-snooping group

Use reset igmp-snooping group to clear dynamic IGMP snooping group entries.

Syntax

reset igmp-snooping group { group-address [ source-address ] | all } [ vlan vlan-id ]

Views

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

source-address: Specifies a multicast source address. If you do not specify a multicast source, this command clears dynamic IGMP snooping group entries for all multicast sources.

all: Specifies all 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 dynamic IGMP snooping group entries for all VLANs.

Examples

# Clear all dynamic IGMP snooping group entries.

<Sysname> reset igmp-snooping group all

Related commands

display igmp-snooping group

reset igmp-snooping router-port

Use reset igmp-snooping router-port to clear dynamic router port information.

Syntax

reset igmp-snooping router-port { all | vlan vlan-id }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all dynamic router ports.

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 dynamic router port information for all VLANs.

Examples

# Clear dynamic router port information.

<Sysname> reset igmp-snooping router-port all

Related commands

display igmp-snooping router-port

reset igmp-snooping statistics

Use reset igmp-snooping statistics to clear statistics for IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

reset igmp-snooping statistics

Views

User view

Predefined user roles

network-admin

Examples

# Clear the statistics for all IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> reset igmp-snooping statistics

Related commands

display igmp-snooping statistics

reset l2-multicast fast-forwarding cache

Use reset l2-multicast fast-forwarding cache to clear Layer 2 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all } [ chassis chassis-number 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.

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 a card by its slot number. If you do not specify a card, this command clears Layer 2 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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 multicast fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears Layer 2 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

all: Specifies all Layer 2 multicast fast forwarding entries.

Examples

# Clear all Layer 2 multicast fast forwarding entries.

<Sysname> reset l2-multicast fast-forwarding cache all

# Clear the Layer 2 multicast fast forwarding entry for 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

router-aging-time (IGMP-snooping view)

Use router-aging-time to set the aging timer for dynamic router ports globally.

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

Syntax

router-aging-time seconds

undo router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds.

Views

IGMP-snooping 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 can set the timer globally for all VLANs 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 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

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

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

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 GigabitEthernet 1/0/1 through GigabitEthernet 1/0/4.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] source-deny port gigabitethernet 1/0/1 to gigabitethernet 1/0/4

Related commands

igmp-snooping source-deny

version (IGMP-snooping view)

Use version to specify an IGMP snooping version for VLANs.

Use undo version to restore the default.

Syntax

version version-number vlan vlan-list

undo version vlan vlan-list

Default

The IGMP snooping version in a VLAN is 2.

Views

IGMP-snooping 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 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. For a VLAN, 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 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

Multicast routing and forwarding commands

The following matrix shows the feature and hardware compatibility:

Hardware	Multicast routing and forwarding compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes
MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	Multicast routing and forwarding compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

Commands and descriptions for centralized devices apply to the following routers:

· MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

· MSR2600-6-X1/2600-10-X1.

· MSR2630.

· MSR3600-28/3600-51.

· MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

· MSR 3610/3620/3620-DP/3640/3660.

Commands and descriptions for distributed devices apply to the following routers:

· MSR5620.

· MSR 5660.

· MSR 5680.

delete ip rpf-route-static

Use delete ip rpf-route-static to delete all static multicast routes.

Syntax

delete ip rpf-route-static [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command deletes all static multicast routes on the public network.

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 on the public network.

<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

display mac-address [ multicast ]

Use display mac-address [ multicast ] to display static multicast MAC address entries.

Syntax

display mac-address [ mac-address [ vlan vlan-id ] | [ multicast ] [ vlan vlan-id ] [ count ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a multicast MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where "x" represents a hexadecimal number from 0 to F.

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 MAC address entries for all VLANs.

multicast: Specifies static multicast MAC address entries.

count: Specifies the number of MAC address entries. If you specify the keyword, this command displays the number of matching MAC address entries. If you do not specify the keyword, this 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 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 GE1/0/1 N

GE1/0/2

# Display the number of static multicast MAC address entries.

<Sysname> display mac-address multicast count

1 mac address(es) found.

Table 12 Command output

Field	Description
MAC address	MAC address of a multicast group.
VLAN ID	ID of the VLAN to which the network device identified by the MAC address belongs.
State	Status of the MAC address. If the multicast MAC address entry is static, this field displays Multicast.
Port/NickName	Outgoing ports or nickname of the Egress RB in a TRILL network for the packet that is sent to the MAC address in this MAC address entry.
Aging	Aging time state. If this entry never expires, this field displays N.
1 mac address(es) found	One static multicast MAC address entry is found.

Related commands

mac-address multicast

display mrib interface

Use display mrib interface to display information about interfaces maintained by the MRIB.

Syntax

display mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about interfaces maintained by the MRIB on the public network.

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

Examples

# Display information about all interfaces maintained by the MRIB on the public network.

<Sysname> display mrib interface

Interface: GigabitEthernet1/0/1

Index: 0x00000001

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

Table 13 Command output

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: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA 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 address	Remote end IP address. This field is displayed only when the interface is vlink type.
Reference	Number of times that the address has been referenced.
State	Status of the interface address: NORMAL or DEL.

display multicast boundary

Use display multicast boundary to display multicast boundary information.

Syntax

display multicast [ vpn-instance vpn-instance-name ] boundary [ group-address [ mask-length | mask ] ] [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast boundary information on the public network.

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 boundary information for all multicast groups.

mask-length: Specifies an address mask length in the range of 4 to 32. The default is 32.

mask: Specifies an address mask. The default is 255.255.255.255.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays multicast boundary information for all interfaces.

Examples

# Display information about all multicast boundaries on the public network.

<Sysname> display multicast boundary

Boundary Interface

224.1.1.0/24 GE1/0/1

239.2.2.0/24 GE1/0/2

Table 14 Command output

Field	Description
Boundary	Multicast group associated with the multicast boundary.
Interface	Boundary interface associated with the multicast boundary.

Related commands

multicast boundary

display multicast fast-forwarding cache

Use display multicast fast-forwarding cache to display multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast fast forwarding entries on the public network.

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 a card by its slot number. If you do not specify a card, this command displays multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display multicast fast forwarding entries on the public network.

<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: GigabitEthernet2/0/6

List of 1 outgoing interfaces:

GigabitEthernet3/0/2

Status: Enabled Flag: 0x14

Table 15 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries in the multicast fast forwarding table, and the total number of matching (S, G) entries.
(60.1.1.200, 225.0.0.2)	(S, G) entry.
Protocol	Protocol number.
Flag	Flag of the (S, G) entry or the outgoing interface in 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 interface has flags 0x4 and 0x10. 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 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. · 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.
Status	Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable.
Incoming interface	Incoming interface of the (S, G) entry.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry.

Related commands

reset multicast fast-forwarding cache all

display multicast forwarding df-info

Use display multicast forwarding df-info to display DF information.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays DF information on the public network.

rp-address: Specifies a BIDIR-PIM RP by its IP address.

verbose: Specifies detailed information. If you do not specify the keyword, this command displays brief information.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays DF information for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays DF information for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays DF information for the global active MPU. (Distributed devices in IRF mode.)

Usage guidelines

In a BIDIR-PIM domain, only the DF on each subnet can forward multicast data destined for a multicast group toward the RP of the group. For more information about the DF, see IP Multicast Configuration Guide.

Examples

# Display brief information about DFs on an ADVPN network.

<Sysname> display multicast forwarding df-info

Total 1 RPs, 1 matched

00001. RP address: 1.1.1.1

Flags: 0x0

Uptime: 00:00:53

RPF interface: Tunnel0, 192.168.0.1

List of 2 DF interfaces:

1: LoopBack0

2: Tunnel0, 192.168.0.3

# Display brief information about DFs on the public network.

<Sysname> display multicast forwarding df-info

Total 1 RPs, 1 matched

00001. RP address: 7.11.0.2

Flags: 0x0

Uptime: 04:14:40

RPF interface: GigabitEthernet1/0/1

List of 1 DF interfaces:

1: GigabitEthernet1/0/2

# Display detailed information about DFs on the public network.

<Sysname> display multicast forwarding df-info verbose

Total 1 RPs, 1 matched

00001. RP address: 7.11.0.2

MID: 2, Flags: 0x0

Uptime: 03:37:22

Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184

RPF interface: GigabitEthernet1/0/1

Product information: 0xa567d6fc, 0xadeb03e3

Tunnel information: 0xdfb107d4, 0x7aa5d510

List of 1 DF interfaces:

1: GigabitEthernet1/0/2

Product information: 0xa986152b, 0xb74a9a2f

Tunnel information: 0x297ca208, 0x76985b89

Table 16 Command output

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.
MID	ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID.
Flags	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. · 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.
Tunnel0, 192.168.0.3	ADVPN tunnel interface, and the IP address of the remote end.

display multicast forwarding event

Use display multicast forwarding event to display statistics of multicast forwarding events.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of the multicast forwarding events on the public network.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of multicast forwarding events for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays statistics of multicast forwarding events for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display statistics of multicast forwarding events on the public network.

<Sysname> display multicast forwarding event

Total entry active events sent: 0

Total entry 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

Table 17 Command output

Field	Description
Total entry active events sent	Number of times that entry-active events have been sent.
Total entry 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 timeout	Number of times that the registration suppression has timed out in total.

Related commands

reset multicast forwarding event

display multicast forwarding-table

Use display multicast forwarding-table to display multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] 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 | statistics ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | chassis chassis-number slot slot-number | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast forwarding entries on the public network.

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 a card by its slot number. If you do not specify a card, this command displays multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

statistics: Displays statistics for the multicast forwarding table.

Examples

# Display multicast forwarding entries an ADVPN network.

<Sysname> display multicast forwarding-table

Total 1 entries, 1 matched

00001. (172.168.0.2, 227.0.0.1)

Flags: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

Incoming interface: Tunnel1, 12.1.1.3

List of 2 outgoing interface:

1: Tunnel1, 12.1.1.1

2: Tunnel1, 12.1.1.2

Matched 19648 packets(20512512 bytes), Wrong If 0 packet

Forwarded 19648 packets(20512512 bytes)

# Display multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table

Total 1 entries, 1 matched

00001. (172.168.0.2, 227.0.0.1)

Flags: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

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)

Table 18 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries, and the total number of matching (S, G) entries.
00001	Sequence number of the (S, G) entry.
(172.168.0.2,227.0.0.1)	(S, G) entry.
Flags	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 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. · 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.
Timeout in	Length of time in which the (S, G) entry will expire.
Incoming interface	Incoming interface of the (S, G) entry.
Incoming sub-VLAN	Incoming sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.
Outgoing sub-VLAN	Outgoing sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry.
Sub-VLAN	Outgoing sub-VLAN of the super VLAN when the outgoing interface of the (S, G) entry is the VLAN interface of this super VLAN.
Tunnel1, 12.1.1.1	ADVPN tunnel interface, and the IP address of the remote end.
Matched 19648 packets(20512512 bytes), Wrong If 0 packet	Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.
Forwarded 19648 packets(20512512 bytes)	Number of packets (bytes) that have been forwarded. 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

display multicast forwarding-table df-list

Use display multicast forwarding-table df-list to display information about the DF list in multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in multicast forwarding entries on the public network.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

verbose: Specifies detailed information about the DF list in multicast forwarding entries. If you do not specify the keyword, this command displays brief information about the DF list in multicast forwarding entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the DF list in multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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 the DF list in multicast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about the DF list in multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display brief information about the DF list in multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table df-list

Total 1 entries, 1 matched

00001. (0.0.0.0, 225.0.0.1)

List of 1 DF interfaces:

1: GigabitEthernet1/0/1

# Display detailed information about the DF list in multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table df-list verbose

Total 1 entries, 1 matched

00001. (0.0.0.0, 225.0.0.1)

List of 1 DF interfaces:

1: GigabitEthernet1/0/1

Product information: 0x347849f6, 0x14bd6837

Tunnel information: 0xc4857986, 0x128a9c8f

Table 19 Command output

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.

display multicast routing-table

Use display multicast routing-table to display multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-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 ] *

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: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

outgoing-interface: Specifies the multicast routing entries that contain the specified outgoing interface.

exclude: Specifies the multicast routing entries that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast routing entries that contain the specified interface in the outgoing interface list.

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 on an ADVPN network.

<Sysname> display multicast routing-table

Total 1 entries

00001. (172.168.0.2, 227.0.0.1)

Uptime: 00:00:28

Upstream Interface: Tunnel1, 12.1.1.3

List of 2 downstream interfaces

1: Tunnel1, 12.1.1.1

2: Tunnel1, 12.1.1.2

# Display multicast routing entries on the public network.

<Sysname> display multicast routing-table

Total 1 entries

00001. (172.168.0.2, 227.0.0.1)

Uptime: 00:00:28

Upstream Interface: GigabitEthernet1/0/1

List of 2 downstream interfaces

1: GigabitEthernet1/0/2

2: GigabitEthernet1/0/3

Table 20 Command output

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.
Upstream Interface	Upstream interface at which (S, G) packets should arrive.
List of 2 downstream interfaces	List of downstream interfaces that need to forward (S, G) packets.
Tunnel11, 12.1.1.1	ADVPN tunnel interface, and the IP address of the remote end.

Related commands

reset multicast routing-table

display multicast routing-table static

Use display multicast routing-table static to display static multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-table static [ source-address { mask-length | mask } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays static multicast routing entries on the public network.

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.

Usage guidelines

This command displays only valid static multicast routing entries.

Examples

# Display static multicast routing entries on the public network.

<Sysname> display multicast routing-table static

Destinations: 3 Routes: 4

Destination/Mask Pre RPF neighbor Interface

1.1.0.0/16 10 7.12.0.1 GE1/0/1

7.11.0.1 GE1/0/2

2.2.2.0/24 20 7.11.0.1 GE1/0/3

3.3.3.3/32 50 7.12.0.1 GE1/0/4

Table 21 Command output

Field	Description
Destinations	Number of the multicast destination addresses.
Routes	Number of routes.
Destination/Mask	Destination address and its mask length.
Pre	Route preference.
RPF neighbor	IP address of the RPF neighbor to the reachable destination.
Interface	Outgoing interface to the reachable destination.

display multicast rpf-info

Use display multicast rpf-info to display RPF information for a multicast source.

Syntax

display multicast [ vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for a multicast source on the public network.

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.

Examples

# Display RPF information for multicast source 192.168.1.55 on the public network.

<Sysname> display multicast rpf-info 192.168.1.55

RPF information about source 192.168.1.55:

RPF interface: GigabitEthernet1/0/1, RPF neighbor: 10.1.1.1

Referenced route/mask: 192.168.1.0/24

Referenced route type: igp

Route selection rule: preference-preferred

Load splitting rule: disable

Table 22 Command output

Field	Description
RPF neighbor	IP address of the RPF neighbor.
Referenced route/mask	Referenced route and its mask length.
Referenced route type	Type of the referenced route: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Directly connected unicast route. · unicast—Other unicast routes, such as static unicast route. · multicast static—Static multicast route. · mbgp—MBGP route.
Route selection rule	Rule for RPF route selection: · Route preference. · Longest prefix match.
Load splitting rule	Status of the load splitting rule: enable or disable.

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 [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number }

Default

No static multicast routes exist.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command configures a static multicast route on the public network.

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

When you specify an RPF neighbor, follow these guidelines:

· If the RPF neighbor is a point-to-point interface, you must specify the type and number of the interface.

· If the RPF neighbor is not a point-to-point interface, you must specify the IP address of the interface. 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

# On the public network, configure a static multicast route to multicast source 10.1.1.1/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.1 24 192.168.1.23

Related commands

delete ip rpf-route-static

display multicast routing-table static

load-splitting (MRIB view)

Use load-splitting to enable load splitting of multicast traffic.

Use undo load-splitting to restore the default.

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: Specifies load splitting on a per-source basis.

source-group: Specifies load splitting both on a per-source basis and on a per-group basis.

Usage guidelines

This command does not take effect on BIDIR-PIM.

Examples

# Enable load splitting of multicast traffic on a per-source basis on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] load-splitting source

longest-match (MRIB view)

Use longest-match to specify the longest prefix match principle for RPF route selection.

Use undo longest-match to restore the default.

Syntax

longest-match

undo longest-match

Default

Route preference is used for RPF route selection. The route with the highest preference is used as the RPF route.

Views

MRIB view

Predefined user roles

network-admin

Usage guidelines

This command enables the device to use the matching route with the longest prefix as the RPF route.

Examples

# Specify the longest prefix match principle for RPF route selection on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] multicast longest-match

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

Default

No static multicast MAC address entries exist.

Views

System view

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a static multicast MAC address, in the format 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-0001-0001 and the outgoing ports are GigabitEthernet 1/0/1 through GigabitEthernet 1/0/5 in VLAN 2.

<Sysname> system-view

[Sysname] mac-address multicast 0100-0001-0001 interface gigabitethernet 1/0/1 to gigabitethernet 1/0/5 vlan 2

# Configure a static multicast MAC address entry for multicast MAC address 0100-0001-0001 on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mac-address multicast 0100-0001-0001 vlan 2

Related commands

display mac-address multicast

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.

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 GigabitEthernet 1/0/1 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] multicast boundary 239.2.0.0 16

Related commands

display multicast boundary

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 [ vpn-instance vpn-instance-name ]

undo multicast routing [ vpn-instance vpn-instance-name ]

Default

IP multicast routing is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables IP multicast routing on the public network.

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 on the public network and enter MRIB view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib]

# Enable IP multicast routing for VPN instance mvpn and enter MRIB view.

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn]

reset multicast fast-forwarding cache

Use reset multicast fast-forwarding cache to clear multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ chassis chassis-number slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast fast forwarding entries on the public network.

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 a card by its slot number. If you do not specify a card, this command clears multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

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 the 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

reset multicast forwarding event

Use reset multicast forwarding event to clear statistics for multicast forwarding events.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] forwarding event

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the multicast forwarding events on the public network.

Examples

# Clear statistics for multicast forwarding events on the public network.

<Sysname> reset multicast forwarding event

Related commands

display multicast forwarding event

reset multicast forwarding-table

Use reset multicast forwarding-table to clear multicast forwarding entries.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] forwarding-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface { interface-type interface-number } } * | all }

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: 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 on the public network.

<Sysname> reset multicast forwarding-table 225.5.4.3

Related commands

display multicast forwarding-table

reset multicast routing-table

Use reset multicast routing-table to clear multicast routing entries.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] routing-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * | all }

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: 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 on the public network.

<Sysname> reset multicast routing-table 225.5.4.3

Related commands

display multicast routing-table

IGMP commands

The following matrix shows the feature and hardware compatibility:

Hardware	IGMP compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes
MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	IGMP compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

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 [ vpn-instance vpn-instance-name ] group [ group-address | interface interface-type interface-number ] [ static | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about IGMP multicast groups on the public network.

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, the 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, the 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 on the public network.

<Sysname> display igmp group

IGMP groups in total: 3

GigabitEthernet1/0/1(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

Table 23 Command output

Field	Description
IGMP groups in total	Total number of IGMP multicast groups.
IGMP groups reported in total	Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.
Group address	Multicast group address.
Last reporter	Address of the last host that reported its membership to the multicast group.
Uptime	Length of time since the multicast group was reported.
Expire	Remaining lifetime for the multicast group. This field displays Off if the timer is disabled.

# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically joined on the public network. In this example, the router is configured with IGMPv3.

<Sysname> display igmp group 232.1.1.1 verbose

GigabitEthernet1/0/1(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

Table 24 Command output

Field	Description
IGMP groups reported in total	Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.
Group	Multicast group address.
Uptime	Length of time since the multicast group was reported.
Exclude expires	Remaining lifetime for the multicast group in Exclude mode. This field displays Off if the timer is disabled.
Mapping expires	Remaining time for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Last reporter	Address of the last host that reported its membership to this multicast group.
Last-member-query-counter	Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group.
Last-member-query-timer-expiry	Remaining time for the last member query timer for the multicast group. This field displays Off if the timer is disabled.
Mapping last-member-query-counter	Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Mapping last-member-query-timer-expiry	Remaining time for the last member query timer of the multicast group specified in IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings.
Group mode	Multicast source filtering mode: · Include—Include mode. · Exclude—Exclude mode. For a device that runs IGMPv1 or IGMPv2: · If IGMP SSM mappings are not configured, this field displays Exclude. · If IGMP SSM mappings are configured, this field displays Include or Exclude depending on the SSM mappings and the multicast groups that the host joins.
Version1-host-present-timer-expiry	Remaining time for the IGMPv1 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv2 or IGMPv3.
Version2-host-present-timer-expiry	Remaining time for the IGMPv2 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv3.
Mapping version1-host-present-timer-expiry	Remaining time for the IGMPv1 host present timer when the device is configured with IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings.
Source list (sources in total)	List of multicast sources and total number of multicast sources. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Source	Multicast source address. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Uptime	Length of time since the multicast source was reported. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
V3 expires	Remaining time for the multicast source when the device runs IGMPv3. This field displays Off if the timer is disabled and displays three hyphens (---) if the multicast source is specified in IGMP SSM mappings. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Mapping expires	Remaining time for the multicast source specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Last-member-query-counter	Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast source and group. This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings.
Last-member-query-timer-expiry	Remaining time for the last member query timer for the multicast source and group. 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 on the public network.

<Sysname> display igmp group static

Entries in total: 2

Group address Source address Interface Expires

225.1.1.1 0.0.0.0 GE1/0/1 Never

225.2.2.2 1.1.1.1 GE1/0/1 Never

Table 25 Command output

Field	Description
Entries in total	Total number of the multicast groups that hosts have joined statically.
Group address	Multicast group address.
Source address	Multicast source address.
Interface	Interface name.
Expires	Remaining lifetime for the multicast group. This field always displays Never because the multicast group never expires.

Related commands

reset igmp group

display igmp interface

Use display igmp interface to display IGMP information for interfaces.

Syntax

display igmp [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ proxy ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IGMP information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays IGMP information for all IGMP-enabled interfaces.

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 GigabitEthernet 1/0/1 (non-proxy interface) on the public network.

<Sysname> display igmp interface gigabitethernet 1/0/1 verbose

GigabitEthernet1/0/1(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

Authorization: Disabled

Join-by-session: Disabled

User-VLAN-aggregation: Disabled

IGMP groups reported in total: 1

# Display detailed IGMP information for all IGMP proxy interfaces on the public network.

<Sysname> display igmp interface proxy verbose

GigabitEthernet1/0/2(20.10.1.20):

IGMP proxy is enabled.

IGMP version: 2

Multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

Table 26 Command output

Field	Description
GigabitEthernet1/0/1(10.10.1.20)	Interface and its IP address. (on a router)
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.
Last member query interval	Interval for sending IGMP group-specific queries or IGMP group-and-source-specific queries, in seconds.
Last member query count	Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast group.
Startup query interval	Interval for sending IGMP general queries on startup, in seconds.
Startup query count	Number of IGMP general queries that the device sends on startup.
General query timer expiry	Remaining time for the IGMP general query timer. This field displays Off if the timer is disabled.
Querier for IGMP	IP address of the IGMP querier. This field is not displayed when the device runs IGMPv1 and the device is not the IGMP querier. NOTE: In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.
No querier elected	No IGMP querier election is performed. This field is displayed when the device runs IGMPv1 and is not the IGMP querier. NOTE: In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.
IGMP activity: 1 join(s), 0 leave(s)	Statistics of IGMP activities: · join(s)—Total number of multicast groups that this interface has joined. · leave(s)—Total number of multicast groups that this interface has left.
Multicast routing on this interface	Whether IP multicast routing is enabled: Enabled or Disabled.
Robustness	Robustness variable of the IGMP querier.
Require-router-alert	Whether the feature of dropping IGMP messages without Router-Alert is enabled: Enabled or Disabled,
Fast-leave	Whether the fast-leave processing feature is enabled: Enabled or Disabled.
Startup-query	Whether the IGMP querier sends IGMP general queries at the startup query interval on startup: · On—The IGMP querier performs the above action. · Off—The IGMP querier does not perform the above action.
Other-querier-present-timer-expiry	Remaining time for the other querier present timer. This field displays Off if the timer is disabled.
IGMP groups reported in total	Total number of multicast groups that the interface has joined dynamically. This field is not displayed if the interface does not join multicast groups.
IGMP proxy is enabled	IGMP proxying is enabled on the interface.
Version1-querier-present-timer-expiry	Remaining time for the IGMPv1 querier present timer. This field displays Off if the timer is disabled.

display igmp proxy group

Use display igmp proxy group to display information about multicast groups maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy group [ group-address | interface interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about multicast groups maintained by the IGMP proxy on the public network.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays information about multicast groups maintained by the IGMP proxy for all interfaces.

verbose: Displays detailed information.

Examples

# Display information about multicast groups maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy group

IGMP proxy group records in total: 2

GigabitEthernet1/0/1(1.1.1.20):

IGMP proxy group records in total: 2

Group address Member state Expires

225.1.1.1 Delay 00:00:02

225.1.1.2 Idle Off

# Display detailed information about multicast group 225.1.1.1 maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy group 225.1.1.1 verbose

GigabitEthernet1/0/1(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

Table 27 Command output

Field	Description
IGMP groups records in total	Total number of multicast groups maintained by the IGMP proxy.
GigabitEthernet1/0/1(1.1.1.20)	IGMP proxy interface and its IP address. (on a router)
Pending proxy group	Pending multicast groups maintained by the IGMP proxy.
Group address/Group	Multicast group address.
Member state	Member host states: · Delay—The member host has joined a group and started a delay timer. · Idle—The member host has joined a group, but didn't start a delay timer.
Expires	Remaining delay time for the member host to send a responding report. This field displays Off if the timer is disabled.
Group mode	Multicast source filtering mode: Include or Exclude.
Source list	Multicast source list for the multicast group maintained by the IGMP proxy.
sources in total	Total number of multicast sources.

display igmp proxy routing-table

Use display igmp proxy routing-table to display multicast routing entries maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] ] * [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays multicast routing entries maintained by the IGMP proxy on the public network.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, the 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, the 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 on the public network.

<Sysname> display igmp proxy routing-table

Total 1 (*, G) entries, 2 (S, G) entries.

(172.168.0.12, 227.0.0.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

(*, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

(2.2.2.2, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

2: GigabitEthernet1/0/2

Protocol: PROXY

# Display detailed information about multicast routing entries maintained by the IGMP proxy on the public network.

<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: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces: None

(*, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

Querier state: Non-querier

Join/Prune state:Join

(2.2.2.2, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

Querier state: Querier

Join/Prune state: Join

2: GigabitEthernet1/0/2

Protocol: PROXY

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces: None

Table 28 Command output

Field	Description
Total 1 (*, G) entries, 2 (S, G) entries	Total number of (*, G) entries, and the total number of (S, G) entries.
(172.168.0.12, 227.0.0.1)	(S, G) entry.
Upstream interface	Incoming interface of the (S, G) entry.
Downstream interfaces (1 in total)	Outgoing interfaces of the (S, G) entry, and the total number of outgoing interfaces.
Non-downstream interfaces (1 in total)	Non-outgoing interfaces of the (S, G) entry, and the total number of non-outgoing interfaces.
1: GigabitEthernet1/0/2	Index of an interface, and the interface. (on a router)
Protocol	Protocol type: · IGMP—Dynamic IGMP. · PROXY—IGMP proxy. · STATIC—Static IGMP.
Querier state	Querier state: · Querier. · Non-querier.
Join/Prune state	Joined or pruned state of the interface: · NI—Default state. · Join—Joined state. · Prune—Pruned state.

display igmp ssm-mapping

Use display igmp ssm-mapping to display IGMP SSM mappings.

Syntax

display igmp [ vpn-instance vpn-instance-name ] ssm-mapping group-address

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.

Examples

# Display IGMP SSM mappings for multicast group 232.1.1.1 on the public network.

<Sysname> display igmp ssm-mapping 232.1.1.1

Group: 232.1.1.1

Source list:

1.2.3.4

5.5.5.5

10.1.1.1

100.1.1.10

Table 29 Command output

Field	Description
Group	Multicast group address.
Source list	List of multicast source addresses.

igmp

Use igmp to enter IGMP view.

Use undo igmp to delete the configurations in IGMP view.

Syntax

igmp [ vpn-instance vpn-instance-name ]

undo igmp [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command applies to the public network.

Examples

# Enter IGMP view for the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp]

# Enter IGMP view for VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

igmp enable

Use igmp enable to enable IGMP on an interface.

Use undo igmp enable to disable IGMP on an interface.

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 on the public network, and enable IGMP on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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:

· You do not specify an ACL.

· The specified ACL does not exist.

· The specified ACL does not have valid rules.

Usage guidelines

This feature enables an IGMP querier to send leave notifications to the upstream routers without sending group-specific or group-and-source-specific queries after receiving leave messages.

When you configure a rule in the IPv4 basic 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.

· 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 all multicast group polices.

Syntax

igmp group-policy ipv4-acl-number [ version-number ]

undo igmp group-policy

Default

No multicast group policies exist on an interface, and hosts attached to the interface can join any multicast groups.

Views

Interface view

Predefined user roles

network-admin

Parameters

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.

Usage guidelines

A multicast group policy control the multicast groups that the hosts can join by filtering IGMP messages. It does not take effect on a static member interface, because a static member interface does not send IGMP messages.

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

Examples

# Configure a multicast group policy on GigabitEthernet 1/0/1 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 gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp last-member-query-interval 6

Related commands

last-member-query-interval (IGMP view)

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

Predefined user roles

network-admin

Usage guidelines

The following matrix shows the command and hardware compatibility:

Hardware	Command compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	No
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR5620/5660/5680	Yes

Hardware	Command compatibility
MSR810-LM-GL	No
MSR810-W-LM-GL	No
MSR830-6EI-GL	No
MSR830-10EI-GL	No
MSR830-6HI-GL	No
MSR830-10HI-GL	No
MSR2600-6-X1-GL	No
MSR3600-28-SI-GL	No

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp other-querier-present-interval 125

Related commands

other-querier-present-interval (IGMP view)

igmp proxy enable

Use igmp proxy enable to enable IGMP proxying on an interface.

Use to undo igmp proxy enable to disable IGMP proxying on an interface.

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 on the public network, and enable IGMP proxying on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp proxy enable

Related commands

multicast routing

igmp proxy forwarding

Use igmp proxy forwarding to enable multicast forwarding on a non-querier interface.

Use undo igmp proxy forwarding to disable multicast forwarding on a non-querier interface.

Syntax

igmp proxy forwarding

undo igmp proxy forwarding

Default

Multicast forwarding is disabled for a non-querier interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

Typically, only IGMP queriers can forward multicast traffic but non-queriers cannot. This mechanism prevents multicast data from being repeatedly forwarded. If a router interface on the IGMP proxy failed the querier election, enable multicast forwarding on the interface to forward multicast data to attached receivers.

Examples

# Enable multicast forwarding on GigabitEthernet 1/0/1. (GigabitEthernet 1/0/1 is a non-querier interface on the IGMP proxy device.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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.

Views

Interface view

Predefined user roles

network-admin

Parameters

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 ]

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-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, the 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 GigabitEthernet 1/0/1 as a static group member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 224.1.1.1

# Configure GigabitEthernet 1/0/1 as a static group member of multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 232.1.1.1 source 192.168.1.1

# Enable per-session multicast forwarding on GigabitEthernet 1/0/1.1. Configure the subinterface as a static group member of multicast group 224.1.1.1 for users with outer VLAN ID 10 and inner VLAN IDs in the range of 10 to 20.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] igmp join-by-session

[Sysname-GigabitEthernet1/0/1.1] igmp static-group 224.1.1.1 dot1q vid 10 second-dot1q 10 to 20

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.

Examples

# Specify IGMP version 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp version 1

last-member-query-count (IGMP view)

Use last-member-query-count to set the IGMP last member query count globally.

Use undo last-member-query-count to restore the default.

Syntax

last-member-query-count count

undo last-member-query-count

Default

The IGMP last member query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

Parameters

Usage guidelines

You can set the IGMP last member 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 last member query count to 6 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-count 6

Related commands

igmp last-member-query-count

last-member-query-interval (IGMP 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 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 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-interval 6

Related commands

igmp last-member-query-interval

max-response-time (IGMP view)

Use max-response-time to set the maximum response time for IGMP general queries globally.

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

Syntax

max-response-time time

undo max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

IGMP 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 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 maximum response time for IGMP general queries to 25 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 25

Related commands

igmp max-response-time

other-querier-present-interval (IGMP view)

Use other-querier-present-interval to set the IGMP other querier present timer globally.

Use undo other-querier-present-interval to restore the default.

Syntax

other-querier-present-interval interval

undo 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

IGMP 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 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 other querier present timer to 125 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] other-querier-present-interval 125

Related commands

igmp other-querier-present-interval

proxy multipath (IGMP view)

Use proxy multipath to enable load splitting on an IGMP proxy device.

Use undo proxy multipath to disable load splitting on an IGMP proxy device.

Syntax

proxy multipath

undo proxy multipath

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 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] proxy multipath

query-interval (IGMP view)

Use query-interval to set the IGMP general query interval globally.

Use undo query-interval to restore the default.

Syntax

query-interval interval

undo query-interval

Default

The IGMP general query interval is 125 seconds.

Views

IGMP 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 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 general query interval to 60 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] query-interval 60

Related commands

igmp query-interval

reset igmp group

Use reset igmp group to clear dynamic IGMP multicast group entries.

Syntax

reset igmp [ vpn-instance vpn-instance-name ] 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

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears dynamic IGMP multicast group entries on the public network.

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, the command deletes 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 on the public network.

<Sysname> reset igmp group all

# Clear all dynamic IGMP multicast group entries for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset igmp group interface gigabitethernet 1/0/1 all

# Clear the dynamic IGMP multicast group entry of the group 225.0.0.1 for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset igmp group interface gigabitethernet 1/0/1 225.0.0.1

Related commands

display igmp group

robust-count (IGMP view)

Use robust-count to set the IGMP querier's robustness variable globally.

Use undo robust-count to restore the default.

Syntax

robust-count count

undo robust-count

Default

The IGMP querier's robustness variable is 2.

Views

IGMP view

Predefined user roles

network-admin

Parameters

Usage guidelines

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 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 5

Related commands

igmp robust-count

ssm-mapping (IGMP view)

Use ssm-mapping to configure an IGMP SSM mapping.

Use undo ssm-mapping to delete IGMP SSM mappings.

Syntax

ssm-mapping source-address ipv4-acl-number

undo ssm-mapping { source-address | all }

Default

No IGMP SSM mappings exist.

Views

IGMP view

Predefined user roles

network-admin

Parameters

source-address: Specifies a multicast source by its IP address.

ipv4-acl-number: Specifies a basic ACL number in the range of 2000 to 2999. In IGMP SSM mappings, the specified multicast source is associated with multicast groups that the ACL permits. The multicast source is not associated with any multicast groups if the ACL does not exist or does not have valid rules.

all: Specifies all IGMP SSM mappings.

Usage guidelines

When you configure a rule in the IPv4 basic 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.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take 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

startup-query-count (IGMP view)

Use startup-query-count to set the IGMP startup query count globally.

Use undo startup-query-count to restore the default.

Syntax

startup-query-count count

undo startup-query-count

Default

The IGMP startup query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

Parameters

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 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-count 5

Related commands

igmp startup-query-count

startup-query-interval (IGMP view)

Use startup-query-interval to set the IGMP startup query interval globally.

Use undo startup-query-interval to restore the default.

Syntax

startup-query-interval interval

undo startup-query-interval

Default

The IGMP startup query interval equals one quarter of the IGMP general query interval.

Views

IGMP 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 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 interval to 100 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-interval 100

Related commands

igmp startup-query-interval

PIM commands

The following matrix shows the feature and hardware compatibility:

Hardware	PIM compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes
MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	PIM compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

anycast rp (PIM view)

Use anycast-rp to configure an Anycast RP.

Use undo anycast-rp to remove an Anycast RP.

Syntax

anycast-rp anycast-rp-address member-address

undo anycast-rp anycast-rp-address member-address

Default

No Anycast RPs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

anycast-rp-address: Specify 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: Specify 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.

Usage guidelines

To add multiple RP member addresses to an Anycast RP set, use this command repeatedly with the same Anycast RP address but different RP member addresses.

An RP member address must be different from the Anycast RP address.

Examples

# On the public network, specify 1.1.0.0 as the Anycast RP address, and specify 1.1.0.1 and 1.2.0.1 as the member addresses.

<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

auto-rp enable (PIM view)

Use auto-rp enable to enable Auto-RP listening.

Use undo auto-rp enable to disable Auto-RP listening.

Syntax

auto-rp enable

undo auto-rp enable

Default

Auto-RP listening is disabled.

Views

PIM view

Predefined user roles

network-admin

Examples

# Enable Auto-RP listening on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] auto-rp enable

bidir-pim enable (PIM view)

Use bidir-pim enable to enable BIDIR-PIM.

Use undo bidir-pim enable to disable BIDIR-PIM.

Syntax

bidir-pim enable

undo bidir-pim enable

Default

BIDIR-PIM is disabled.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled.

Examples

# Enable IP multicast routing on the public network, and enable BIDIR-PIM.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim] bidir-pim enable

Related commands

multicast routing

bidir-rp-limit (PIM view)

Use bidir-rp-limit to set the maximum number of BIDIR-PIM RPs.

Use undo bidir-rp-limit to restore the default.

Syntax

bidir-rp-limit limit

undo bidir-rp-limit

Default

The upper limit is 6.

Views

PIM view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of RPs in BIDIR-PIM, in the range of 1 to the number allowed by the system.

The following matrix shows the limit argument and hardware compatibility:

Hardware	Argument compatibility	Value range
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes	1 to 64
MSR810-LMS/810-LUS	No	N/A
MSR2600-6-X1/2600-10-X1	Yes	1 to 64
MSR 2630	Yes	1 to 64
MSR3600-28/3600-51	Yes	1 to 64
MSR3600-28-SI/3600-51-SI	No	N/A
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes	1 to 128
MSR 3610/3620/3620-DP/3640/3660	Yes	1 to 128
MSR5620/5660/5680	Yes	1 to 256

Hardware	Argument compatibility	Value range
MSR810-LM-GL	Yes	1 to 64
MSR810-W-LM-GL	Yes	1 to 64
MSR830-6EI-GL	Yes	1 to 64
MSR830-10EI-GL	Yes	1 to 64
MSR830-6HI-GL	Yes	1 to 64
MSR830-10HI-GL	Yes	1 to 64
MSR2600-6-X1-GL	Yes	1 to 64
MSR3600-28-SI-GL	No	N/A

Usage guidelines

In a BIDIR-PIM domain, one DF election per RP is implemented on all PIM interfaces. As a best practice 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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] bidir-rp-limit 3

bsm-fragment enable (PIM view)

Use bsm-fragment enable to enable bootstrap message (BSM) semantic fragmentation.

Use undo bsm-fragment enable to disable BSM semantic fragmentation.

Syntax

bsm-fragment enable

undo bsm-fragment enable

Default

BSM semantic fragmentation is enabled.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

Disable BSM semantic fragmentation if the PIM-SM or BIDIR-PIM domain contains a device that does not support BSM semantic fragmentation.

Examples

# Disable BSM semantic fragmentation on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] undo bsm-fragment enable

bsm-reflection enable (PIM view)

Use bsm-reflection enable to enable the device to forward BSMs out of incoming interfaces.

Use undo bsm-reflection enable to disable the device to forward BSMs out of incoming interfaces.

Syntax

bsm-reflection enable

undo bsm-reflection enable

Default

The device is enabled to forward BSMs out of incoming interfaces.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

Disable this feature if all the devices in the PIM-SM or BIDIR-PIM domain have consistent routing information.

Examples

# Disable the device to forward BSMs out of incoming interfaces on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] undo bsm-reflection enable

bsr-policy (PIM view)

Use bsr-policy to configure a BSR policy to guard against BSR spoofing.

Use undo bsr-policy to restore the default.

Syntax

bsr-policy ipv4-acl-number

undo bsr-policy

Default

No BSR policies exist, and all bootstrap messages are regarded as legal.

Views

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

Usage guidelines

When you configure a rule in the IPv4 basic 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 BSR address.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# On the public network, configure a BSR policy so that only the devices on the subnet of 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)

Use c-bsr to configure a candidate-BSR (C-BSR).

Use undo c-bsr to remove the configuration of a C-BSR.

Syntax

c-bsr ip-address [ scope group-address { mask-length | mask } ] [ hash-length hash-length | priority priority ] *

undo c-bsr ip-address [ scope group-address { mask-length | mask } ]

Default

No C-BSRs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address of a C-BSR. You must specify the IP address of a local PIM interface.

scope group-address: Specifies a multicast group by its IP address in the range of 239.0.0.0 to 239.255.255.255. If you do not specify a multicast group, the command designates the C-BSR to the global-scoped zone.

mask-length: Specifies an address mask length in the range of 8 to 32.

mask: Specifies an address mask.

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 the C-BSR for the global-scoped zone on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr 1.1.1.1

c-rp (PIM view)

Use c-rp to configure a candidate-RP (C-RP).

Use undo c-rp to remove the configuration of a C-RP.

Syntax

c-rp ip-address [ advertisement-interval adv-interval | group-policy ipv4-acl-number | holdtime hold-time | priority priority ] * [ bidir ]

undo c-rp ip-address

Default

No C-RPs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address of a C-RP. You must specify the IP address of a local PIM interface.

advertisement-interval adv-interval: Specifies a C-RP advertisement interval in the range of 1 to 65535 seconds. The default value is 60 seconds.

group-policy ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. If you specify an ACL, the command designates the C-RP to IPv4 multicast groups 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

When you configure a rule in the IPv4 basic 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.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

To designate a C-RP to multiple multicast group ranges, create multiple rules that specify different multicast group ranges in the ACL.

If you execute this command by using the same C-RP IP address multiple times, the most recent configuration takes effect.

Examples

# On the public network, configure the interface with IP address 1.1.1.1 as the 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

crp-policy (PIM view)

Use crp-policy to configure a C-RP policy to guard against C-RP spoofing.

Use undo crp-policy to restore the default.

Syntax

crp-policy ipv4-acl-number

undo crp-policy

Default

No C-RP policies exist, and all C-RP messages are regarded as legal.

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

When you configure a rule in the IPv4 advanced 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 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.

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.

Examples

# On the public network, configure a C-RP policy so that only devices in the address 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)

display interface register-tunnel

Use display interface register-tunnel to display register-tunnel interface information.

Syntax

display interface [ register-tunnel [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

register-tunnel: Displays information about the register-tunnel interface. If you do not specify this keyword, the command displays information about all interfaces on the device.

interface-number: Specifies a register-tunnel interface by its number. The device has only one register-tunnel interface, and the value for this argument is fixed at 0. The command always displays information about Register-Tunnel 0 when you specify the register-tunnel keyword, regardless of whether you specify an interface number.

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

Current state: UP

Line protocol state: DOWN

Description: Register-Tunnel0 Interface

Maximum Transmit 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

# Display brief information about Register-Tunnel 0.

<Sysname> display interface register-tunnel 0 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

REG0 UP -- --

Table 30 Command output

Field	Description
Current state	Physical state of the register-tunnel interface. This field always displays UP.
Line protocol state	Link state of the register-tunnel interface. This field always displays DOWN.
Description	Description of the register-tunnel interface. It is not configurable.
Maximum Transmit Unit	MTU of the register-tunnel interface. It is not configurable.
Internet protocol processing	IP protocol processing capability. This field always displays disabled, because the register-tunnel interface cannot process IP protocol packets.
Physical	Physical type of the register-tunnel interface. This field always displays Unknown, because the physical type of the register-tunnel interface is unknown.
Last 300 seconds input rate	Average incoming rate in the last 300 seconds. This field always displays 0.
Last 300 seconds output rate	Average outgoing rate in the last 300 seconds. This field always displays 0.
Input	Number of incoming packets, incoming bytes, and discarded packets. This field always displays 0.
Output	Number of outgoing packets, outgoing bytes, and discarded packets. This field always displays 0.
Brief information on interface(s) under route mode	Brief information about Layer 3 interfaces.
Link: ADM - administratively down; Stby - standby	Physical state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been administratively shut down. To recover its physical state, use the undo shutdown command. · Stby—The interface is a backup interface. To display information about the primary interface, use the display interface-backup command.
Protocol: (s) - spoofing	If the Protocol field contains "(s)", it means one of the following conditions: · The data link protocol state of the interface is UP, but no link is present on the interface. · The link is created on demand. Typically, null interfaces or loopback interfaces have this attribute.
Protocol	Protocol connection state of the interface. This field always displays double hyphens (--).
Main IP	IP address of the interface. This field always displays double hyphens (--).
Cause	Causes why the physical state of the interface is down. This field always displays Not connected.

display pim bsr-info

Use display pim bsr-info to display BSR information.

Syntax

display pim [ vpn-instance vpn-instance-name ] bsr-info

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display BSR information on the public network.

<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

Table 31 Command output

Field	Description
Bootstrap timer	Aging timer for the BSR.
Scope-zone expiry timer	Aging timer for the scoped zone.
Elected BSR address	Address of the elected BSR.
Candidate BSR address	Address of the C-BSR.
Priority	BSR priority.
Uptime	Length of time the BSR has been up.

display pim claimed-route

Use display pim claimed-route to display information about all routes that PIM uses.

Syntax

display pim [ vpn-instance vpn-instance-name ] claimed-route [ source-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, the command displays information about all routes that PIM uses.

Examples

# Display information about all routes that PIM uses on the public network.

<Sysname> display pim claimed-route

RPF-route selecting rule: longest-match

Route/mask: 7.11.0.0/16 (unicast (direct))

RPF interface: GigabitEthernet1/0/1, RPF neighbor: 8.0.0.2

Total number of (S,G) or (*,G) dependent on this route entry: 4

(7.11.0.10, 225.1.1.1)

(7.11.0.10, 226.1.1.1)

(7.11.0.10, 227.1.1.1)

(*, 228.1.1.1)

Route/mask: 7.12.0.0/16 (multicast static)

RPF interface: GigabitEthernet1/0/2, RPF neighbor: 8.0.0.3,

Config NextHop: 8.0.0.5

Total number of (S,G) or (*,G) dependent on this route entry: 2

(7.12.0.10, 226.1.1.1)

(7.12.0.10, 225.1.1.1)

Table 32 Command output

Field	Description
Route/mask	Route entry. Route types in parentheses include: · 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.
RPF interface	Name of the RPF interface.
RPF neighbor	IP address of the RPF neighbor.
Config NextHop	Address of the configured next hop. This field is displayed only when the static multicast route is configured with a next hop.
Total number of (S,G) or (*,G) dependent on this route entry	Total number of (S, G) or (*, G) entries associated with the RPF route and the entry list.

display pim c-rp

Use display pim c-rp to display C-RP information.

Syntax

display pim [ vpn-instance vpn-instance-name ] c-rp [ local ]

Views

Any view

Predefined user roles

network-admin

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 view information about learned C-RPs only on the BSR. On other devices, you can view information about the locally configured C-RPs.

Examples

# Display information about learned C-RPs on the public network.

<Sysname> display pim c-rp

Scope: non-scoped

Group/MaskLen: 224.0.0.0/4

C-RP address Priority HoldTime Uptime Expires

1.1.1.1 (local) 192 150 03:01:36 00:02:29

2.2.2.2 192 150 1d:13h 00:02:02

Group/MaskLen: 226.1.1.0/24 [B] Expires: 00:00:33

Group/MaskLen: 225.1.0.0/16 [B]

C-RP Address Priority HoldTime Uptime Expires

3.3.3.3 192 150 12w:5d 00:02:05

# 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

Table 33 Command output

Field	Description
Group/MaskLen	Multicast group to which the C-RP is designated.
[B]	BIDIR-PIM C-RP. This field is not displayed if the C-RP is a PIM-SM C-RP.
C-RP address	IP address of the C-RP. If the C-RP resides on the device where the command is executed, this field displays (local) after the address.
Priority	Priority of the C-RP.
HoldTime	Lifetime of the C-RP.
Uptime	Length of time the C-RP has been up: · w—Weeks. · d—Days. · h—Hours.
Expires	Remaining lifetime for the C-RP and the multicast group.
Candidate RP	IP address of the locally configured C-RP.
Advertisement interval	Interval between two advertisement messages sent by the locally configured C-RP.
Next advertisement scheduled at	Remaining time for the locally configured C-RP to send the next advertisement message.

display pim df-info

Use display pim df-info to display BIDIR-PIM DF information.

Syntax

display pim [ vpn-instance vpn-instance-name ] df-info [ rp-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

rp-address: Specifies a BIDIR-PIM RP by its IP address.

Examples

# Display BIDIR-PIM DF information on the public network.

<Sysname> display pim df-info

RP address: 12.12.12.12

Interface: GigabitEthernet1/0/4

State : Win DF preference: 10

DF metric : 1562 DF uptime : 00:06:59

DF address: 30.1.1.11 (local)

Interface: Tunnel0, 100.1.1.12

State : Lose DF preference: 0

DF metric : 0 DF uptime : 00:06:59

DF address: 100.1.1.12

Table 34 Command output

Field	Description
RP address	IP address of the BIDIR-PIM RP.
Interface	DF interface. If the interface is an NBMA mode-enabled ADVPN tunnel interface, this field also displays the IP address of the remote end.
State	DF election state: · Win—The interface wins the DF election. · Lose—The interface loses the DF election. · Offer—The interface is in the initial state of the DF election. · Backoff—The interface is acting as the DF, but there are more appropriate devices running for the DF. If the interface does not participate in the DF election, this field displays a hyphen (-).
DF preference	Advertised route preference for DF election.
DF metric	Advertised route metric for DF election.
DF uptime	Length of time the DF has been up.
DF address	IP address of DF. If the DF resides on the device where the command is executed, this field displays (local) after the IP address.

display pim interface

Use display pim interface to display PIM information for interfaces.

Syntax

display pim [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays PIM information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays PIM information for all interfaces.

verbose: Displays detailed PIM information. If you do not specify this keyword, the command displays brief PIM information.

Examples

# Display brief PIM information for all interfaces on the public network.

<Sysname> display pim interface

Interface NbrCnt HelloInt DR-Pri DR-Address

GE1/0/1 1 30 1 10.1.1.2

GE1/0/2 0 30 1 172.168.0.2 (local)

GE1/0/3 1 30 1 20.1.1.2

Table 35 Command output

Field	Description
NbrCnt	Number of PIM neighbors.
HelloInt	Interval for sending hello messages.
DR-Pri	Priority for DR election.
DR-Address	IP address of the DR. If the DR resides on the device where the command is executed, this field displays (local) after the address.

# Display detailed PIM information for GigabitEthernet 1/0/1 on the public network.

<Sysname> display pim interface gigabitethernet 1/0/1 verbose

Interface: GigabitEthernet1/0/1, 10.1.1.1

PIM version: 2

PIM mode: Sparse

PIM DR: 10.1.1.2

PIM DR Priority (configured): 1

PIM neighbors count: 1

PIM hello interval: 30 s

PIM LAN delay (negotiated): 500 ms

PIM LAN delay (configured): 500 ms

PIM override interval (negotiated): 2500 ms

PIM override interval (configured): 2500 ms

PIM neighbor tracking (negotiated): disabled

PIM neighbor tracking (configured): disabled

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

Table 36 Command output

Field	Description
PIM version	Version of the PIM protocol.
PIM mode	PIM mode: dense or sparse.
PIM DR	IP address of the DR.
PIM DR Priority (configured)	Configured priority for DR election.
PIM neighbors count	Total number of PIM neighbors.
PIM hello interval	Interval between two hello messages.
PIM LAN delay (negotiated)	Negotiated PIM message propagation delay.
PIM LAN delay (configured)	Configured PIM message propagation delay.
PIM override interval (negotiated)	Negotiated interval for overriding prune messages.
PIM override interval (configured)	Configured interval for overriding prune messages.
PIM neighbor tracking (negotiated)	Negotiated neighbor tracking status: enabled or disabled.
PIM neighbor tracking (configured)	Configured neighbor tracking status: enabled or disabled.
PIM require generation ID	Whether the feature of discarding hello messages without Generation_ID is enabled.
PIM hello hold interval	PIM neighbor lifetime.
PIM assert hold interval	Assert holdtime timer.
PIM triggered hello delay	Maximum delay for sending hello messages.
PIM J/P interval	Interval between two join/prune messages.
PIM J/P hold interval	Joined/pruned state holdtime timer.
PIM BSR domain border	Whether a PIM domain border is configured.
PIM BFD	Whether PIM is enabled to work with BFD.
PIM passive	Whether PIM passive mode is enabled on the interface.
Number of routers on network not using DR priority	Number of routers that do not use the DR priority field on the subnet where the interface resides.
Number of routers on network not using LAN delay	Number of routers that do not use the LAN delay field on the subnet where the interface resides.
Number of routers on network not using neighbor tracking	Number of routers that are not enabled with neighbor tracking on the subnet where the interface resides.

display pim nbma-link

Use display pim nbma-link to display remote end information maintained by PIM for ADVPN tunnel interfaces.

Syntax

display pim [ vpn-instance vpn-instance-name ] nbma-link [ interface { interface-type interface-number } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays remote end information maintained by PIM for ADVPN tunnel interfaces on the public network.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command display remote end information maintained by PIM for all ADVPN tunnel interfaces.

Examples

# Display remote end information maintained by PIM for ADVPN tunnel interfaces on the public network.

<Sysname> display pim nbma-link

Interface: Tunnel1

Number of links: 1

Remote address: 10.0.0.1

Private index : 0XCC000000

Private interface: Multicast-NBMA0

Interface: Tunnel2

Number of links: 1

Remote address: 20.0.0.2

Private index : 0XCC000001

Private interface: Multicast-NBMA1

# Display remote end information maintained by PIM for ADVPN interface tunnel1 on the public network.

<Sysname> display pim nbma-link interface tunnel 1

Interface: Tunnel1

Number of links: 1

Remote address: 10.0.0.1

Private index : 0XCC000000

Private interface: Multicast-NBMA0

Table 37 Command output

Field	Description
Interface	Local ADVPN tunnel interface.
Number of links	Number of remote ends.
Remote address	IP address of the remote end.
Private index	Index of the remote end.
Private interface	Interface name of the remote end.

display pim neighbor

Use display pim neighbor to display PIM neighbor information.

Syntax

display pim [ vpn-instance vpn-instance-name ] neighbor [ neighbor-address | interface interface-type interface-number | verbose ] *

Views

Any view

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, the 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, the 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 on the public network.

<Sysname> display pim neighbor

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires DR-Priority Mode

10.1.1.2 GE1/0/1 02:50:49 00:01:31 1 B

20.1.1.2 GE1/0/2 02:49:39 00:01:42 1 P

# Display detailed information about the PIM neighbor with IP address 11.110.0.20 on the public network.

<Sysname> display pim neighbor 11.110.0.20 verbose

Neighbor: 11.110.0.20

Interface: GigabitEthernet1/0/3

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

RPF proxy vector: Enabled

Table 38 Command output

Field	Description
Total Number of Neighbors	Total number of PIM neighbors.
Neighbor	IP address of the PIM neighbor.
Interface	Interface that connects to the PIM neighbor.
Uptime	Length of time the PIM neighbor has been up.
Expires/Expiry time	Remaining lifetime for the PIM neighbor. If the PIM neighbor is always up and reachable, this field displays never.
DR-Priority/DR Priority	Priority of the PIM neighbor.
Mode	PIM mode: · B—The PIM mode is BIDIR-PIM. · P—The RPF proxy vector is enabled. This field is empty if the PIM mode is not BIDIR-PIM and the RPF vector is disabled.
Generation ID	Generation ID of the PIM neighbor. (A random value represents a status change of the PIM neighbor.)
Holdtime	Lifetime of the PIM neighbor. If the PIM neighbor is always up and reachable, this field displays forever.
LAN delay	PIM message propagation delay on a shared-media LAN.
Override interval	Interval for overriding prune messages.
State refresh interval	Interval for refreshing state. This field is displayed only when the PIM neighbor operates in the PIM-DM mode and the state refresh capability is enabled.
Neighbor tracking	Neighbor tracking status: enabled or disabled.
Bidirectional PIM	Whether BIDIR-PIM is enabled.
RPF proxy vector	Whether the RPF vector feature is enabled. For more information about the RPF proxy vector feature, see "Configuring multicast VPN."

display pim routing-table

Use display pim routing-table to display PIM routing entries.

Syntax

display pim [ vpn-instance vpn-instance-name ] routing-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | flags flag-value | fsm | incoming-interface interface-type interface-number | mode mode-type | outgoing-interface { exclude | include | match } interface-type interface-number | proxy ] *

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, the command displays PIM routing entries for all multicast groups.

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, the 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.

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

· 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, the 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, the 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, the 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, the command displays PIM routing entries that do not contain the specified outgoing interface.

· If you specify an included interface, the command displays PIM routing entries that contain the specified outgoing interface.

· If you specify a matching interface, the command displays PIM routing entries that contain only the specified outgoing interface.

proxy: Displays information about the RPF vector used by PIM routing entries.

Examples

# Display PIM routing entries on the public network. This example uses an ADVPN network.

<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: Tunnel0, 13.1.1.1

Upstream neighbor: 12.1.1.1

RPF prime neighbor: 12.1.1.1

Downstream interface information:

Total number of downstream interfaces: 1

1: Tunnel0, 13.1.1.2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

# Display PIM routing entries on the public network.

<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: GigabitEthernet1/0/1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface information:

Total number of downstream interfaces: 1

1: GigabitEthernet1/0/2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

Table 39 Command output

Field	Description
Total 0 (*, G) entries; 1 (S, G) entries	Total number of (*, G) entries, and the total number of (S, G) entries.
(172.168.0.12, 227.0.0.1)	(S, G) entry.
Protocol	PIM mode.
Flag	Flag of the (S, G) entry or (*, G) entry: · 2MSDP—The entry is to be advertised by the MSDP module in the next (S, A) message. · ACT—The entry has been used for routing data. · DEL—The entry is to be removed. · EXPRUNE—Some outgoing interfaces are pruned by other multicast routing protocols. · EXT—The entry contains outgoing interfaces provided by other multicast routing protocols. · LOC—The entry is on a router directly connected to the same subnet with the multicast source. · MSDP—The entry is learned from an MSDP (S, A) message. · NIIF—The entry contains unknown incoming interfaces. · NONBR—The entry has a PIM neighbor lookup failure. · RPT—The entry is on an RPT branch where (S, G) prunes have been sent to the RP. · SPT—The entry is on the SPT. · SQ—The entry triggers the default-MDT to data-MDT switchover. · 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. If the upstream interface is an NBMA mode-enabled ADVPN tunnel interface, this field also displays the IP address of the remote end.
Upstream neighbor	Upstream neighbor of the (S, G) entry or (*, G) entry.
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry: · For a (, G) entry, if the RPF neighbor is the RP, the field displays NULL. · For an (S, G) entry, if the RPF neighbor is a router that directly connects to the multicast source, this field displays NULL.
RPF proxy vector	RPF vector. This field is displayed only on MD VPN inter-AS option B network. For more information about MD VPN inter-AS option B, see "Configuring multicast VPN."
Downstream interface information	Information about the downstream interfaces: · Total number of downstream interfaces. · Names of the downstream interfaces. · Protocol type on the downstream interfaces. · Uptime of the downstream interfaces. · Expiration time of the downstream interfaces. · IP addresses of the remote ends associated with the downstream ADVPN tunnel interfaces.

# Display information about the RPF vector used by the public network PIM routing entries on a PE device.

<Sysname> display pim routing-table proxy

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/192.168.0.4

Assigner: 0.0.0.0 Origin: BGP MDT

Uptime: 02:08:18 Expires: Off

# Display information about the RPF vector used by the public network PIM routing entries on a P device.

<Sysname> display pim routing-table proxy

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/192.168.0.4

Assigner: 1.0.3.1 Origin: PIM

Uptime: 02:19:33 Expires: 00:02:12

# Display information about the RPF vector used by the public network PIM routing entries on an ASBR.

<Sysname> display pim routing-table proxy

(100.0.0.1, 232.1.1.1)

Proxy: 10:1/local

Assigner: 1.0.5.9 Origin: PIM

Uptime: 02:22:04 Expires: 00:02:35

(100.0.0.8, 232.1.1.1)

Proxy: 10:1/local

Assigner: 1.0.4.1 Origin: PIM

Uptime: 02:21:10 Expires: 00:02:35

Table 40 Command output

Field	Description
Proxy	RPF vector, including the RD and the IP address of the RPF vector. If the RPF vector resides on the device where the command is executed, this field displays (local) after the IP address.
Assigner	IP address of the device from which the RPF vector is obtained: · On PE devices, the RPF vector is obtained from a BGP MDT routing entry. This field displays 0.0.0.0. · On non-PE devices, the RPF vector is obtained from the PIM join message sent by a downstream PIM neighbor. This field displays the IP address of the downstream PIM neighbor.
Origin	Protocol that origins the RPF vector: · On PE devices, the RPF vector is obtained from a BGP MDT routing entry. This field displays BGP MDT. · On non-PE devices, the RPF vector is obtained from the PIM join message sent by a downstream PIM neighbor. This field displays PIM.
Uptime	Length of time since the RPF vector is originated.
Expires	Remaining timeout time for the RPF vector, where Off means that the timer is disabled.

display pim rp-info

Use display pim rp-info to display PIM RP information.

Syntax

display pim [ vpn-instance vpn-instance-name ] rp-info [ group-address ]

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, the command displays RP information for all multicast groups.

Examples

# Display RP information for multicast group 224.0.1.1 on the public network.

<Sysname> display pim rp-info 224.0.1.1

BSR RP address is: 2.2.2.2

Priority: 192

HoldTime: 180

Uptime: 03:01:10

Expires: 00:02:30

Static RP address is: 3.3.3.5

Preferred: Yes

Configured ACL: 2003

RP mapping for this group is: 3.3.3.5

Anycast-RP 3.3.3.5 members:

Member address State

1.1.0.1 Active

1.2.0.2 Local

1.2.0.1 Remote

# Display RP information for all multicast groups on the public network.

<Sysname> display pim rp-info

BSR RP information:

Scope: non-scoped

Group/MaskLen: 224.0.0.0/4

RP address Priority HoldTime Uptime Expires

1.1.1.1 (local) 192 180 03:01:36 00:02:29

2.2.2.2 192 180 1d:13h 00:02:02

Group/MaskLen: 225.1.0.0/16 [B]

RP address Priority HoldTime Uptime Expires

3.3.3.3 192 180 12w:5d 00:02:05

Static RP information:

RP address ACL Mode Preferred

3.3.3.1 2000 pim-sm No

3.3.3.2 2001 bidir 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

Table 41 Command output

Field	Description
BSR RP address is	IP address of the RP.
BSR RP information	Information about the RP.
Group/MaskLen	Multicast group to which the RP is designated.
[B]	The RP is a BIDIR-PIM RP. This field is not displayed if the RP is a PIM-SM RP.
RP address	IP address of the RP. If the RP resides on the device where the command is executed, this field displays (local) after the address.
Priority	Priority of the RP.
HoldTime	RP lifetime.
Uptime	Length of time the RP has been up.
Expires	Remaining lifetime for the RP.
Preferred	Whether the static RP is preferred.
Configured ACL/ACL	ACL defining the multicast groups to which the static RP is designated.
Mode	RP service mode, PIM-SM or BIDIR-PIM.
RP mapping for this group	IP address of the RP that provides services for the multicast group.
Anycast-RP 3.3.3.5 members	Members of Anycast RP 3.3.3.5.
Member address	IP address of the Anycast RP member.
State	State of the interface from which the member address originates: · Active—Activated local interface. · Local—Inactivated local interface. · Remote—Remote interface.

display pim statistics

Use display pim statistics to display statistics for PIM packets.

Syntax

display pim statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for PIM packets.

<Sysname> display pim statistics

Received PIM packets: 3295

Sent PIM packets : 5975

Valid Invalid Succeeded Failed

Hello : 3128 0 4333 0

Reg : 14 0 0 0

Reg-stop : 0 0 0 0

JP : 151 0 561 0

BSM : 0 0 1081 0

Assert : 0 0 0 0

Graft : 0 0 0 0

Graft-ACK: 0 0 0 0

C-RP : 0 0 0 0

SRM : 0 0 0 0

DF : 0 0 0 0

Table 42 Command output

Field	Description
Received PIM packets	Total number of received PIM protocol packets.
Sent PIM packets	Total number of sent PIM protocol packets.
Valid	Number of received legal PIM protocol packets.
Invalid	Number of received illegal PIM protocol packets.
Succeeded	Number of PIM protocol packets that were sent successfully.
Failed	Number of PIM protocol packets that failed to be sent.
Hello	Hello message statistics.
Reg	Register message statistics.
Reg-stop	Register-stop message statistics.
JP	Join/prune message statistics.
BSM	Bootstrap message statistics.
Assert	Assert message statistics.
Graft	Graft message statistics.
Graft-ACK	Graft-ACK message statistics.
C-RP	C-RP message statistics.
SRM	State refresh message statistics.
DF	Designated forwarder statistics.

hello-option dr-priority (PIM view)

Use hello-option dr-priority to set the DR priority globally.

Use undo hello-option dr-priority to restore the default.

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

Default

The DR priority is 1.

Views

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 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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option dr-priority 3

Related commands

pim hello-option dr-priority

hello-option holdtime (PIM view)

Use hello-option holdtime to set the PIM neighbor lifetime globally.

Use undo hello-option holdtime to restore the default.

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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

Related commands

pim hello-option holdtime

hello-option lan-delay (PIM view)

Use hello-option lan-delay to set the PIM message propagation delay on a shared-media LAN globally.

Use undo hello-option lan-delay to restore the default.

Syntax

hello-option lan-delay delay

undo hello-option lan-delay

Default

The PIM message propagation delay on a shared-media LAN is 500 milliseconds.

Views

PIM view

Predefined user roles

network-admin

Parameters

delay: Specifies a PIM message propagation delay on a shared-media LAN, in the range of 1 to 32767 milliseconds.

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 on the public network.

<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

hello-option neighbor-tracking (PIM view)

Use hello-option neighbor-tracking to enable neighbor tracking and disable join message suppression globally.

Use undo hello-option neighbor-tracking to disable neighbor tracking and enable join message suppression globally.

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

Default

Neighbor tracking is disabled, and join message suppression is enabled.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

You can enable neighbor tracking 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

# Enable neighbor tracking globally on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

Related commands

pim hello-option neighbor-tracking

hello-option override-interval (PIM view)

Use hello-option override-interval to set the override interval globally.

Use undo hello-option override-interval to restore the default.

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 on the public network.

<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

holdtime join-prune (PIM view)

Use holdtime join-prune to set the joined/pruned state holdtime globally.

Use undo holdtime join-prune to restore the default.

Syntax

holdtime join-prune time

undo holdtime join-prune

Default

The joined/pruned state holdtime is 210 seconds.

Views

PIM 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 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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

Related commands

pim holdtime join-prune

timer join-prune (PIM view)

jp-pkt-size (PIM view)

Use jp-pkt-size to set the maximum size of each join/prune message.

Use undo jp-pkt-size to restore the default.

Syntax

jp-pkt-size size

undo jp-pkt-size

Default

The maximum size of a join/prune message is 8100 bytes.

Views

PIM view

Predefined user roles

network-admin

Parameters

size: Specifies the maximum size of each join/prune message, in the range of 100 to 8100 bytes.

Examples

# Set the maximum size of each join/prune message to 1500 bytes on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

pim

Use pim to enter PIM view.

Use undo pim to remove all configurations in PIM view.

Syntax

pim [ vpn-instance vpn-instance-name ]

undo pim [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, you enter public network PIM view.

Examples

# Enable IP multicast routing on the public network and enter public network PIM view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim]

# Enable IP multicast routing for VPN instance mvpn and enter PIM view of the VPN instance.

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn]

Related commands

multicast routing-enable

pim bfd enable

Use pim bfd enable to enable BFD for PIM.

Use undo pim bfd enable to disable BFD for PIM.

Syntax

pim bfd enable

undo pim bfd enable

Default

BFD is disabled for PIM.

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 on the public network. Then, enable PIM-DM on GigabitEthernet 1/0/1, and enable BFD for PIM on the interface.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim dm

[Sysname-GigabitEthernet1/0/1] pim bfd enable

Related commands

pim dm

pim sm

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 GigabitEthernet 1/0/1 as a PIM-SM domain border.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 on the public network, and enable PIM-DM on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim dm

Related commands

multicast routing

pim hello-option dr-priority

Use pim hello-option dr-priority to set the DR priority on an interface.

Use undo pim hello-option dr-priority to restore the default.

Syntax

pim hello-option dr-priority priority

undo pim hello-option dr-priority

Default

The DR priority is 1.

Views

Interface 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 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 DR priority to 3 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim hello-option dr-priority 3

Related commands

hello-option dr-priority (PIM view)

pim hello-option holdtime

Use pim hello-option holdtime to set the PIM neighbor lifetime on an interface.

Use undo pim hello-option holdtime to restore the default.

Syntax

pim hello-option holdtime time

undo pim hello-option holdtime

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim hello-option holdtime 120

Related commands

hello-option holdtime (PIM view)

pim hello-option lan-delay

Use pim hello-option lan-delay to set the PIM message propagation delay on a shared-media LAN for an interface.

Use undo pim hello-option lan-delay to restore the default.

Syntax

pim hello-option lan-delay delay

undo pim hello-option lan-delay

Default

The PIM message propagation delay on a shared-media LAN is 500 milliseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

delay: Specifies a PIM message propagation delay on a shared-media LAN in the range of 1 to 32767 milliseconds.

Usage guidelines

You can set the PIM message propagation delay 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 message propagation delay on a shared-media LAN to 200 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

pim hello-option neighbor-tracking

Use pim hello-option neighbor-tracking to enable neighbor tracking and disable join message suppression on an interface.

Use pim hello-option neighbor-tracking disable to disable neighbor tracking on an interface when neighbor tracking is enabled globally.

Use undo pim hello-option neighbor-tracking to restore neighbor tracking setting on an interface to be consistent with the global setting.

Syntax

pim hello-option neighbor-tracking

pim hello-option neighbor-tracking disable

undo pim hello-option neighbor-tracking

Default

For an interface, neighbor tracking is disabled and join message suppression is enabled.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

You can enable neighbor tracking 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

# Enable neighbor tracking on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim hello-option neighbor-tracking

# On the public network, disable neighbor tracking on GigabitEthernet 1/0/1 when neighbor tracking is enabled globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

[Sysname-pim] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim hello-option neighbor-tracking disable

Related commands

hello-option neighbor-tracking (PIM view)

pim hello-option override-interval

Use pim hello-option override-interval to set the override interval on an interface.

Use undo pim hello-option override-interval to restore the default.

Syntax

pim hello-option override-interval interval

undo pim hello-option override-interval

Default

The override interval is 2500 milliseconds.

Views

Interface 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 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 override interval to 2000 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim hello-option override-interval 2000

Related commands

hello-option lan-delay (PIM view)

hello-option override-interval (PIM view)

pim hello-option lan-delay

pim holdtime join-prune

Use pim holdtime join-prune to set the joined/pruned state holdtime on an interface.

Use undo pim holdtime join-prune to restore the default.

Syntax

pim holdtime join-prune time

undo pim holdtime join-prune

Default

The joined/pruned state holdtime is 210 seconds.

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim holdtime join-prune 280

Related commands

holdtime join-prune (PIM view)

pim timer join-prune

pim nbma-mode

Use pim nbma-mode to enable NBMA mode for an ADVPN tunnel interface.

Use undo pim nbma-mode to disable NBMA mode on an ADVPN tunnel interface.

Syntax

pim nbma-mode

undo pim nbma-mode

Default

NBMA mode is disabled for an ADVPN tunnel interface.

Views

Tunnel interface view

Predefined user roles

network-admin

Usage guidelines

This command is not available for PIM-DM.

This command takes effect only when PIM-SM is enabled on the interface.

Examples

# Enable IP multicast routing on the public network, and enable NBMA mode on ADVPN tunnel interface tunnel0.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface tunnel 0 mode advpn gre

[Sysname-Tunnel0] pim sm

[Sysname-Tunnel0] pim nbma-mode

pim neighbor-policy

Use pim neighbor-policy to configure a PIM hello policy to guard against hello message spoofing.

Use undo pim neighbor-policy to restore the default.

Syntax

pim neighbor-policy ipv4-acl-number

undo pim neighbor-policy

Default

No PIM hello policies exist 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.

Usage guidelines

When you configure a rule in the IPv4 basic 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.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Configure a PIM hello policy on GigabitEthernet 1/0/1 so that only the devices on the subnet of 10.1.1.0/24 can become PIM neighbors of this router.

<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 gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim neighbor-policy 2000

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

Usage guidelines

The following matrix shows the command and hardware compatibility:

Hardware	Command compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	No
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR5620/5660/5680	Yes

Hardware	Command compatibility
MSR810-LM-GL	No
MSR810-W-LM-GL	No
MSR830-6EI-GL	No
MSR830-10EI-GL	No
MSR830-6HI-GL	No
MSR830-10HI-GL	No
MSR2600-6-X1-GL	No
MSR3600-28-SI-GL	No

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 on the public network. Then, enable PIM-DM and enable PIM passive mode on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim dm

[Sysname-GigabitEthernet1/0/1] pim passive

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 GigabitEthernet 1/0/1 to drop hello messages without the generation ID options.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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.

Examples

# Enable IP multicast routing on the public network, and enable PIM-SM on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] undo pim state-refresh-capable

Related commands

state-refresh-interval (PIM view)

state-refresh-rate-limit (PIM view)

state-refresh-ttl (PIM view)

pim timer graft-retry

Use pim timer graft-retry to set a graft retry timer.

Use undo pim timer graft-retry to restore the default.

Syntax

pim timer graft-retry interval

undo pim timer graft-retry

Default

The graft retry timer is 3 seconds.

Views

Interface view

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim timer graft-retry 80

pim timer hello

Use pim timer hello to set the hello interval on an interface.

Use undo pim timer hello to restore the default.

Syntax

pim timer hello interval

undo 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 PIM view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the hello interval to 40 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim timer hello 40

Related commands

timer hello (PIM view)

pim timer join-prune

Use pim timer join-prune to set the join/prune interval on an interface.

Use undo pim timer join-prune to restore the default.

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pim triggered-hello-delay 3

register-policy (PIM view)

Use register-policy to configure a PIM register policy.

Use undo register-policy to restore the default.

Syntax

undo register-policy

Default

No PIM register policies exist, and all PIM register messages are regarded as legal.

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

When you configure a rule in the IPv4 advanced 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 source address.

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

Examples

# Configure a PIM register policy on the public network. 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

register-suppression-timeout (PIM view)

Use register-suppression-timeout to set the register suppression time.

Use undo register-suppression-timeout to restore the default.

Syntax

undo register-suppression-timeout

Default

The register suppression time is 60 seconds.

Views

PIM view

Predefined user roles

network-admin

Parameters

interval: Specifies a register suppression time in the range of 1 to 65535 seconds.

Examples

# Set the register suppression time to 70 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

register-whole-checksum (PIM view)

Use register-whole-checksum to configure the device to calculate the checksum based on an entire register message.

Use undo register-whole-checksum to restore the default.

Syntax

undo register-whole-checksum

Default

The device calculates the checksum based on the register message header.

Views

PIM view

Predefined user roles

network-admin

Examples

# Configure the device to calculate the checksum based on an entire register message on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-whole-checksum

snmp-agent trap enable pim

Use snmp-agent trap enable pim to enable SNMP notifications for PIM.

Use undo snmp-agent trap enable pim to disable SNMP notifications for PIM.

Syntax

snmp-agent trap enable pim [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

undo snmp-agent trap enable pim [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

Default

SNMP notifications for PIM are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

candidate-bsr-win-election: Specifies notifications about winning the BSR election.

elected-bsr-lost-election: Specifies notifications about losing the BSR election.

neighbor-loss: Specifies notifications about losing neighbors.

Usage guidelines

If you do not specify an optional keyword, this command enables or disables PIM to generate SNMP notifications.

To report critical PIM events to an NMS, enable SNMP notifications for PIM. For PIM event notifications to be sent correctly, you must also configure SNMP as described in Network Management and Monitoring Configuration Guide.

Examples

# Disable SNMP notifications for PIM.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable pim

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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

source-policy (PIM view)

Use source-policy to configure a multicast source policy.

Use undo source-policy to restore the default.

Syntax

source-policy ipv4-acl-number

undo source-policy

Default

No multicast source policies exist, and all multicast data packets are regarded as legal.

Views

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

Usage guidelines

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

# On the public network, 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

spt-switch-threshold (PIM view)

Use spt-switch-threshold to configure a criterion for an RPT-to-SPT switchover.

Use undo spt-switch-threshold to remove criteria for RPT-to-SPT switchovers.

Syntax

spt-switch-threshold { traffic-rate | immediacy | infinity } [ group-policy ipv4-acl-number ]

undo spt-switch-threshold [ traffic-rate | immediacy | infinity ] [ group-policy ipv4-acl-number ]

Default

The first multicast packet triggers the RPT-to-STP switchover.

Views

PIM view

Predefined user roles

network-admin

Parameters

traffic-rate: Specifies a traffic rate threshold for triggering an RPT-to-STP switchover, in the range of 1 to 4194304 kbps. Support for this argument depends on the device model.

immediacy: Triggers an RPT-to-STP switchover.

infinity: Disables RPT-to-STP switchover.

group-policy ipv4-acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999. If you specify an ACL, the configuration applies to the multicast groups that the ACL permits. The configuration applies to all 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

CAUTION:

If the device is an RP, disabling RPT-to-STP switchover might cause multicast traffic forwarding failures on the source-side DR. When disabling RPT-to-SPT switchover, make sure you fully understand its impact on your network.

When you configure a rule in the IPv4 basic 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.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

You can configure multiple traffic rate thresholds by executing this command multiple times. However, if you specify the same ACL in the command, the most recent configuration takes effect. If the configured traffic rate thresholds are applied to the same multicast group, the first configuration takes effect.

Examples

# Set the traffic rate threshold to 4 kbps for triggering an RPT-to-STP switchover on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold 4

# Disable RPT-to-STP switchover on a receiver-side DR on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

ssm-policy (PIM view)

Use ssm-policy to configure the SSM group range.

Use undo ssm-policy to restore the default.

Syntax

ssm-policy ipv4-acl-number

undo ssm-policy

Default

The SSM group range is 232.0.0.0/8.

Views

PIM view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999.

Usage guidelines

This command defines a multicast group range that is used by PIM-SSM. For multicast packets that are permitted by the ACL, the PIM-SSM mode is used. For multicast packets that are not permitted by the ACL, the PIM-SM mode is used.

When you configure a rule in the IPv4 basic 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.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take 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

state-refresh-interval (PIM view)

Use state-refresh-interval to set the state refresh interval.

Use undo state-refresh-interval to restore the default.

Syntax

state-refresh-interval interval

undo state-refresh-interval

Default

The state refresh interval is 60 seconds.

Views

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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

Related commands

pim state-refresh-capable

state-refresh-rate-limit (PIM view)

state-refresh-ttl (PIM view)

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 on the public network.

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

Use state-refresh-ttl to set the TTL value for state refresh messages.

Use undo state-refresh-ttl to restore the default.

Syntax

state-refresh-ttl ttl-value

undo state-refresh-ttl

Default

The TTL value for state refresh messages is 255.

Views

PIM view

Predefined user roles

network-admin

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 on the public network.

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

static-rp (PIM view)

Use static-rp to configure a static RP.

Use undo static-rp to delete a static RP.

Syntax

static-rp rp-address [ ipv4-acl-number | bidir | preferred ] *

undo static-rp rp-address

Default

No static RPs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

rp-address: Specifies the IP address of the static RP. The IP address must be valid and cannot be on the subnet 127.0.0.0/8. For a static PIM-SM RP, you must specify a used IP address. For a static BIDIR-PIM RP, you can specify an unused IP address.

ipv4-acl-number: Specifies an IPv4 basic ACL number in the range of 2000 to 2999. If you specify an ACL, the static RP is designated only to multicast groups that the ACL permits. The static RP is designated to all 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.

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

· 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

# On the public network, 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

timer hello (PIM view)

Use timer hello to set the hello interval globally.

Use undo timer hello to restore the default.

Syntax

timer hello interval

undo timer hello

Default

The hello interval is 30 seconds.

Views

PIM 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 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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

Related commands

pim timer hello

timer join-prune (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

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 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 expiring, 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 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

Related commands

holdtime join-prune (PIM view)

pim timer join-prune

MSDP commands

The following matrix shows the feature and hardware compatibility:

Hardware	MSDP compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes
MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	MSDP compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

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 on the public network, 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

display msdp brief

Use display msdp brief to display brief information about MSDP peers.

Syntax

display msdp [ vpn-instance vpn-instance-name ] brief [ state { connect | disabled | established | listen | shutdown } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays brief information about MSDP peers on the public network.

state: Specifies a state. If you do not specify this keyword, the command displays brief information about MSDP peers in all states.

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 on the public network.

<Sysname> display msdp brief

Configured Established Listen Connect Shutdown Disabled

1 1 0 0 0 0

Peer address State Up/Down time AS SA count Reset count

20.20.20.20 Established 00:00:13 100 0 0

Table 43 Command output

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.
State	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 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.
Up/Down time	Length of time since the MSDP peering connection was established or torn down.
AS	Number of the AS where the MSDP peer is located. If the system could not obtain the AS number, this field displays a question mark (?).
SA count	Number of (S, G) entries in the SA cache.
Reset count	MSDP peering connection reset times.

display msdp peer-status

Use display msdp peer-status to display detailed status information for MSDP peers.

Syntax

display msdp [ vpn-instance vpn-instance-name ] peer-status [ peer-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays detailed status information for MSDP peers on the public network.

peer-address: Specifies an MSDP peer by its address. If you do not specify an MSDP peer, the command displays detailed status information for all MSDP peers.

Examples

# Display detailed status information for MSDP peer 20.20.20.20 on the public network.

<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

Table 44 Command output

Field	Description
MSDP peer	MSDP peer address.
AS	Number of the AS where the MSDP peer is located. If the system could not obtain the AS number, this field displays a question mark (?).
State	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 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.
Up/Down time	Length of time since the MSDP peering connection was established or torn down.
Resets	MSDP peering connection reset times.
Connection interface	Interface and IP address used for setting up a TCP connection with the remote MSDP peer.
Received/sent messages	Number of SA messages sent and received through this connection.
Discarded input messages	Number of discarded incoming messages.
Discarded output messages	Number of discarded outgoing messages.
Elapsed time since last connection or counters clear	Elapsed time since the MSDP peer information was last cleared.
Mesh group peer joined	Mesh group that the MSDP peer has joined. This field is not displayed if the MSDP peer does not join a mesh group.
Last disconnect reason	Reason why last MSDP peering connection was torn down. If the connection is not terminated, this field does not display a value. · Hold timer expired without message—Hold timer expires and the receiving cache has no messages. · Hold timer expired with truncated message—Hold timer expires and messages in the receiving buffer are not intact. ¡ bytes in buffer—Size of data in the receiving buffer when the connection was terminated. ¡ type—Type of packets in the receiving buffer when the connection was terminated. ¡ length—Length of packets in the receiving buffer when the connection was terminated. If the packet is too small in size, this field cannot be resolved and is not displayed. ¡ without packet time—Length of time since packets were last processed. · Remote peer has been closed—The MSDP peering connection has been torn down. · TCP ERROR/HUP event received—Error/hup event received by the TCP socket when the MSDP peer sent messages. · Illegal message received—The MSDP peer received illegal messages. · Notification received—The MSDP peer received notification messages. · Reset command executed—The user executed the reset msdp peer command. · Shutdown command executed—The user executed the shutdown command. · Interface downed—The MSDP peer received the interface down event when connecting to the remote MSDP peer.
Information about (Source, Group)-based SA filtering policy	SA message filtering list information: · 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.
Information about SA-Requests	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 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 encapsulated data	Lower TTL threshold for the multicast packets encapsulated in SA messages.
SAs learned from this peer	Number of cached (S, G) entries learned from the specified MSDP peer.
SA-cache maximum for the peer	Maximum number of (S, G) entries learned from the specified MSDP 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.
Counters for MSDP message	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 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.

display msdp sa-cache

Use display msdp sa-cache to display (S, G) entries in the SA cache.

Syntax

display msdp [ vpn-instance vpn-instance-name ] sa-cache [ group-address | source-address | as-number ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays (S, G) entries in the SA cache on the public network.

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, the 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, the 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, the 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 on the public network.

<Sysname> display msdp sa-cache

Total Source-Active Cache - 5 entries

Matched 5 entries

Source Group Origin RP Pro AS Uptime Expires

10.10.1.2 225.0.0.1 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.2 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.3 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.4 10.10.10.10 BGP 100 00:00:11 00:05:49

10.10.1.2 225.0.0.5 10.10.10.10 BGP 100 00:00:11 00:05:49

Table 45 Command output

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.
Pro	Type of protocol from which the AS number of the origin RP originates. If the system could not obtain the AS number, this field displays a question mark (?).
AS	AS number of the origin RP. If the system could not obtain the 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

display msdp sa-count

Use display msdp sa-count to display the number of (S, G) entries in the SA cache.

Syntax

display msdp [ vpn-instance vpn-instance-name ] sa-count [ as-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays the number of (S, G) entries in the SA cache on the public network.

as-number: Specifies an AS number in the range of 1 to 4294967295. If you do not specify an AS number, the 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 on the public network.

<Sysname> display msdp sa-count

(S, G) entries statistics, counted by peer

Peer address SA count

10.10.10.10 5

(S, G) entries statistics, counted by AS

AS Source count Group count

? 3 3

5 (S, G) entries in total

Table 46 Command output

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	AS number. If the system could not obtain the AS number, this 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

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 on the public network.

<Sysname> system-view

[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, the command advertises only the (S, G) entries that the ACL permits. The 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:

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

Examples

# On the public network, configure an SA creation policy to advertise only the (10.10.0.0/16, 225.1.0.0/16) entries when creating an SA message.

<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

[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 [ vpn-instance vpn-instance-name ]

undo msdp [ vpn-instance vpn-instance-name ]

Default

MSDP is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command applies to the public network.

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 on the public network. Then, enable MSDP on the public network and enter MSDP view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] msdp

[Sysname-msdp]

Related commands

multicast routing

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

# On the public network, configure GigabitEthernet 1/0/1 as the originating RP of SA messages.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] originating-rp gigabitethernet 1/0/1

peer

Use peer to specify an MSDP peer.

Use undo peer to remove an MSDP peer.

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

# On the public network, specify the router with IP address 125.10.7.6 as an MSDP peer and GigabitEthernet 1/0/1 as the local connection port.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface gigabitethernet 1/0/1

peer description

Use peer description to configure the 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.

Examples

# Configure the description CustomerA for MSDP peer 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

# On the public network, assign MSDP peer 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

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

# On the public network, set the lower TTL threshold to 10 for multicast data packets to be encapsulated in SA messages. Only multicast data packets whose TTL values are larger than or equal to 10 can 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

[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

# On the public network, 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

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

# On the public network, 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.

Use undo peer sa-policy to delete all SA incoming or outgoing policies.

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 policies exist, and all SA messages 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.

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 controls 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:

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

Examples

# On the public network, 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 gigabitethernet 1/0/1

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

Use undo peer sa-request-policy to delete all SA request policies.

Syntax

peer peer-address sa-request-policy [ acl ipv4-acl-number ]

undo peer peer-address sa-request-policy

Default

No SA request policies exist, and all SA request messages are accepted.

Views

MSDP view

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:

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

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Configure an SA request policy on the public network. Then, the device accepts only SA requests that are from MSDP peer 175.58.6.5 and for multicast groups in the range of 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

reset msdp peer

Use reset msdp peer to reset the TCP connection with an MSDP peer and clear statistics for the MSDP peer.

Syntax

reset msdp [ vpn-instance vpn-instance-name ] peer [ peer-address ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command resets the TCP connection with the specified MSDP peer and clears statistics for the MSDP peer on the public network.

peer-address: Specifies an MSDP peer by its IP address. If you do not specify an MSDP peer, the command resets the TCP connections with all MSDP peers.

Examples

# On the public network, reset the TCP connection with MSDP peer 125.10.7.6, and clear all statistics for the MSDP peer.

<Sysname> reset msdp peer 125.10.7.6

reset msdp sa-cache

Use reset msdp sa-cache to clear (S, G) entries in the SA cache.

Syntax

reset msdp [ vpn-instance vpn-instance-name ] sa-cache [ group-address ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears (S, G) entries in the SA cache on the public network.

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, the command clears (S, G) entries for all multicast groups in the SA cache.

Examples

# Clear (S, G) entries for multicast group 225.5.4.3 in the SA cache on the public network.

<Sysname> reset msdp sa-cache 225.5.4.3

Related commands

cache-sa-enable

display msdp sa-cache

reset msdp statistics

Use reset msdp statistics to clear statistics for an MSDP peer without resetting the TCP connection with the MSDP peer.

Syntax

reset msdp [ vpn-instance vpn-instance-name ] statistics [ peer-address ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears statistics for the specified MSDP peer without resetting the TCP connection with the MSDP peer on the public network.

peer-address: Specifies an MSDP peer by its IP address. If you do not specify an MSDP peer, the command clears statistics for all MSDP peers.

Examples

# On the public network, clear statistics for MSDP peer 125.10.7.6 without resetting the TCP connection with the peer.

<Sysname> reset msdp statistics 125.10.7.6

shutdown (MSDP view)

Use shutdown to tear down the connection with an MSDP peer.

Use undo shutdown to re-establish the connection 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 MSDP peer 125.10.7.6 on the public network.

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

Usage guidelines

This feature exempts SA messages forwarded by the static RPF peer from RPF checks. This simplifies the RPF check mechanism for SA messages.

Examples

# On the public network, configure IP prefix list list1 to permit SA messages originated by RPs in the range of 130.10.0.0/16.

<Sysname> system-view

[Sysname] ip prefix-list list1 permit 130.10.0.0 16 greater-equal 16 less-equal 32

# On the public network, configure the interface with IP address 130.10.7.6 as the static RPF peer and reference IP prefix list list1.

[Sysname] msdp

[Sysname-msdp] peer 130.10.7.6 connect-interface gigabitethernet 1/0/1

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

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 on the public network.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] timer retry 60

Multicast VPN commands

The following matrix shows the feature and hardware compatibility:

Hardware	Multicast VPNcompatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK	Yes
MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	Multicast VPN compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

IPv6-related parameters are not supported on the following routers:

· MSR810.

· MSR810-W.

· MSR810-W-DB.

· MSR810-LM.

· MSR810-W-LM.

· MSR 810-10-PoE.

· MSR810-LM-HK.

· MSR810-W-LM-HK.

address-family ipv4

Use address-family ipv4 to create an MD IPv4 address family and enter its view, or enter the view of the existing MD IPv4 address family.

Use undo address-family ipv4 to delete the MD IPv4 address family and configurations in MD IPv4 address family view.

Syntax

address-family ipv4

undo address-family ipv4

Default

No MD IPv4 address family exists.

Views

MD view

Predefined user roles

network-admin

network-operator

Usage guidelines

Configurations in MD IPv4 address family view of a VPN instance apply only to IPv4 multicast packets of that instance.

Examples

# In MD view of VPN instance mvpn, create an MD IPv4 address family and enter its view.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4]

address-family ipv4 mdt

Use address-family ipv4 mdt to create a BGP IPv4 MDT address family and enter its view, or enter the view of the existing BGP IPv4 MDT address family.

Use undo address-family ipv4 mdt to delete the BGP IPv4 MDT address family and all configurations in BGP IPv4 MDT address family view.

Syntax

address-family ipv4 mdt

undo address-family ipv4 mdt

Default

No BGP IPv4 MDT address family exists.

Views

BGP instance view

Predefined user roles

network-admin

Usage guidelines

Execute this command before you use the peer enable command to enable BGP peers to exchange MDT information. MDT information includes the IP address of a PE device and the default-group to which the PE device belongs. On a public network running PIM-SSM, multicast VPN establishes a default-MDT rooted at the PE device (multicast source) based on the MDT information.

Configurations in BGP IPv4 MDT address family view takes effect only on BGP MDT messages, BGP MDT peers, and BGP MDT peer groups.

Examples

# In BGP instance view of BGP instance default, create a BGP IPv4 MDT address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100

[Sysname-bgp-default] address-family ipv4 mdt

[Sysname-bgp-default-mdt]

# In BGP instance view of BGP instance abc, create a BGP IPv4 MDT address family and enter its view.

<Sysname> system-view

[Sysname] bgp 100 instance abc

[Sysname-bgp-abc] address-family ipv4 mdt

[Sysname-bgp-abc-mdt]

Related commands

peer enable (see Layer 3—IP Routing Configuration Guide)

address-family ipv6

Use address-family ipv6 to create an MD IPv6 address family and enter its view, or enter the view of the existing MD IPv6 address family.

Use undo address-family ipv6 to delete the MD IPv6 address family and configurations in MD IPv6 address family view.

Syntax

address-family ipv6

undo address-family ipv6

Default

No MD IPv6 address family exists.

Views

MD view

Predefined user roles

network-admin

network-operator

Usage guidelines

Configurations in MD IPv6 address family view of a VPN instance apply only to IPv6 multicast packets of that instance.

Examples

# In MD view of VPN instance mvpn, create an MD IPv6 address family and enter its view.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv6

[Sysname-md-mvpn-ipv6]

data-delay

Use data-delay to set the data-delay period (delay period before the default-MDT switches to the data-MDT).

Use undo data-delay to restore the default.

Syntax

data-delay delay

undo data-delay

Default

The data-delay period is 3 seconds.

Views

MD IPv4 address family view

MD IPv6 address family view

Predefined user roles

network-admin

Parameters

delay: Specifies a data-delay period in the range of 1 to 60 seconds.

Examples

# In MD IPv4 address family view of VPN instance mvpn, set the data-delay period to 20 seconds.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] data-delay 20

data-group

Use data-group to specify a data-group range and optionally configure the criteria for the default-MDT to data-MDT switchover.

Use undo data-group to restore the default.

Syntax

data-group group-address { mask-length | mask } [ acl acl-number | threshold threshold-value ] *

undo data-group

Default

No data-group range exists, and the default-MDT to data-MDT switchover never occurs.

Views

MD IPv4 address family view

MD IPv6 address family 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.

mask-length: Specifies a mask length for the multicast group address.

mask: Specifies a subnet mask for the multicast group address.

acl acl-number: Specifies an advanced ACL by its number in the range of 3000 to 3999. If you specify an ACL, the multicast data permitted by the ACL can trigger the switchover. If you do not specify an ACL, any multicast data can trigger the switchover. For the ACL to take effect, specify the protocol type as IP, and include the source and destination keywords when you create an ACL rule. The source and destination keywords specify a multicast source address range and a multicast group address range, respectively.

threshold threshold-value: Sets the traffic rate threshold that triggers an MDT switchover. The value range for the threshold-value argument is 0 to 16777216 kbps, and the default is 0 kbps.

Usage guidelines

This command enables the device to trigger the default-MDT to data-MDT switchover when the following conditions exist:

· The VPN multicast data permitted by the ACL keeps arriving for a data-delay period.

· The rate of the VPN multicast data stays higher than the traffic rate threshold during the data-delay period.

On a PE, the data-group range for an MD cannot include the default-group or data-groups of any other MD. For an MD that transmits both IPv4 and IPv6 multicast packets, the data-group ranges in MD IPv4 address family view and MD IPv6 address family view cannot overlap.

All VPN instances share the data-group resources. As a best practice to avoid data-group resource exhaustion, specify a reasonable data-group range for a VPN instance.

The data-group ranges for different MDs on different PE devices cannot overlap with one another if the PIM mode is not PIM-SSM on the public network.

If you execute the command multiple times for an MD, the most recent configuration takes effect.

Examples

# In MD IPv4 address family view of VPN instance mvpn, specify 239.1.2.0/24 as the data-group range.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] data-group 239.1.2.0 24

data-holddown

Use data-holddown to set the data-holddown period (holddown period before the data-MDT switches back to the default-MDT).

Use undo data-holddown to restore the default.

Syntax

data-holddown delay

undo data-holddown

Default

The data-holddown period is 60 seconds.

Views

MD IPv4 address family view

MD IPv6 address family view

Predefined user roles

network-admin

Parameters

delay: Specifies a data-holddown period in the range of 0 to 180 seconds.

Examples

# In MD IPv4 address family view of VPN instance mvpn, set the data-holddown period to 120 seconds.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] data-holddown 120

default-group

Use default-group to specify a default-group.

Use undo default-group to restore the default.

Syntax

default-group group-address

undo default-group

Default

No default-group exists.

Views

MD IPv4 address family view

MD IPv6 address family view

Predefined user roles

network-admin

Parameters

group-address: Specifies a default-group in the range of 224.0.1.0 to 239.255.255.255.

Usage guidelines

You must specify the same default-group on all PE devices that belong to the same MD.

The default-group for an MD must be different from the default-group and the data-group used by any other MD.

For an MD that transmits both IPv4 and IPv6 multicast packets, you must specify the same default-group in MD IPv4 and IPv6 address family views.

Examples

# In MD IPv4 family view and MD IPv6 address family view of VPN instance mvpn, specify 239.1.1.1 as the default-group.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] default-group 239.1.1.1

[Sysname-md-mvpn-ipv4] quit

[Sysname-md-mvpn] address-family ipv6

[Sysname-md-mvpn-ipv6] default-group 239.1.1.1

display bgp routing-table ipv4 mdt

Use display bgp routing-table ipv4 mdt to display BGP MDT routing information.

Syntax

display bgp [ instance instance-name ] routing-table ipv4 mdt [ route-distinguisher route-distinguisher ] [ ip-address [ advertise-info ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a BGP instance, this command displays BGP MDT routing information for the BGP instance default.

route-distinguisher route-distinguisher: Specifies an RD, a string of 3 to 21 characters. If you do not specify an RD, this command displays BGP MDT routing information for all RDs. An RD can be in one of the following formats:

· 16-bit AS number:32-bit user-defined number. For example, 101:3.

· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.

· 32-bit AS number:16-bit user-defined number, where the AS number must be equal to or greater than 65536. For example, 65536:1.

ip-address: Specifies a multicast source by its IP address. The ip-address argument represents the IP address of the PE device in the default-MDT. If you do not specify a multicast source, this command displays brief information about BGP MDT routes for all multicast sources.

advertise-info: Displays advertisement information. If you do not specify this keyword, no advertisement information is displayed.

Examples

# Display brief information about BGP MDT routes for all multicast sources.

<Sysname> display bgp routing-table ipv4 mdt

BGP local router ID is 1.1.1.1

Status codes: * - valid, > - best, d - dampened, h - history,

s - suppressed, S - stale, i - internal, e - external

Origin: i - IGP, e - EGP, ? - incomplete

Route distinguisher: 100:1

Total number of routes: 2

Network NextHop MED LocPrf PrefVal Path/Ogn

* > 1.1.1.1/32 0.0.0.0 32768 ?

* >i 2.2.2.2/32 2.2.2.2 100 0 ?

# Display detailed information about BGP MDT routes for multicast source 1.1.1.1.

<Sysname> display bgp routing-table ipv4 mdt 1.1.1.1

BGP local router ID: 1.1.1.1

Local AS number: 100

Route distinguisher: 100:1

Total number of routes: 1

Paths: 1 available, 1 best

BGP MDT information of source 1.1.1.1:

Default-group : 224.1.1.1

Original nexthop: 0.0.0.0

AS-path : (null)

Origin : incomplete

Attribute value : pref-val 32768

State : valid, local, best

IP precedence : N/A

QoS local ID : N/A

Traffic index : N/A

# Display advertisement information about BGP MDT routes for multicast source 1.1.1.1.

<Sysname> display bgp routing-table ipv4 mdt 1.1.1.1 advertise-info

BGP local router ID: 1.1.1.1

Local AS number: 100

Route distinguisher: 100:1

Total number of routes: 1

Paths: 1 best

BGP MDT information of source 1.1.1.1:

Default-group: 224.1.1.1

Advertised to peers (1 in total):

6.6.6.6

Table 47 Command output

Field	Description
BGP local router ID	ID of the local router.
Status codes	Codes of route status: · * – valid—Valid route. · > – best—Best route. · d – damped—Dampened route. · h – history—History route. · s – suppressed—Suppressed route. · S – Stale—Stale route. · i – internal—Internal route. · e – external—External route.
Origin	Origin of the route information: · i – IGP—Originated in the AS. The origins of the routes advertised by the network command are IGP. · e – EGP—Learned through EGP. · ? – incomplete—Learned by some other means. The origins of routes redistributed by IGP are incomplete.
Total number of routes	Total number of BGP MDT routes.
Network	Source IP address of the default-MDT.
NextHop	IP address of the next hop.
MED	Attribute value of Multi-Exit-Discrimination (MED).
LocPrf	Local preference value.
PrefVal	Preferred value of a route.
Path/Ogn	AS PATH attribute and ORIGIN attribute: · AS_PATH—Records the ASs the packet has passed to avoid routing loops. · ORIGIN—Identifies the origin of the BGP MDT routes.
Paths	Number of the BGP MDT routes: · available—Number of valid BGP MDT routes. · best—Number of the best BGP MDT routes.
BGP MDT information of source 1.1.1.1	BGP MDT routing information for the multicast source 1.1.1.1.
Default-group	Default-group address to which the route belongs.
Advertised to peers (1 in total)	Peers to which the route has been advertised and total number of peers.
From	IP address of the BGP peer that advertises the BGP MDT route.
Original nexthop	IP address of the original next hop. If the BGP MDT route is learned from the BGP update message, this field displays the IP address of the next hop that receives the message.
AS-path	AS PATH attribute of the path, recording the ASs that the BGP MDT route has passed to avoid routing loops.
Attribute value	Attributes of the BGP MDT routes: · MED—MED value related to destination network. · Localpref—Local preferred value. · pref-val—Preferred value of the route. · pre—Preferred value of the protocol.
State	Current states: · valid—Valid routes. · internal—Internal routes. · external—External routes. · local—Local routes. · synchronize—Synchronized routes. · best—Best routes.
IP precedence	IP precedence of the route, which is set by the QPPB feature. This field displays N/A if the IP precedence of the route is not set.
QoS local ID	QoS local ID of the route, which is set by the QPPB feature. This field displays N/A if the QoS local ID of the route is not set.
Traffic index	Traffic index of the route, which is set by the QPPB feature. This field displays N/A if the Traffic index of the route is not set.

display multicast-domain data-group receive

Use display multicast-domain data-group receive to display information about data-groups that are received in the MD of a VPN instance for IPv4 multicast transmission.

Syntax

display multicast-domain vpn-instance vpn-instance-name data-group receive [ brief | [ active | group group-address | sender source-address | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] * ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.

brief: Displays brief information. If you do not specify this keyword, the command displays detailed information.

active: Specifies data-groups that have joined the data-MDT.

group group-address: Specifies a data-group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

sender source-address: Specifies an MD source interface by its IP address.

vpn-source-address: Specifies a multicast source address of the specified VPN instance.

vpn-group-address: Specifies a multicast group address of the specified VPN instance. The value range for this argument is 224.0.0.0 to 239.255.255.255.

mask-length: Specifies a mask length of the specified multicast source address or multicast group address. The value range for this argument is 0 to 32, and the default is 32.

mask: Specifies a subnet mask of the specified multicast source address or multicast group address. The default is 255.255.255.255.

Examples

# Display detailed information about data-groups that are received in the MD of VPN instance mvpn for IPv4 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn data-group receive

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

Data-group: 226.1.1.0 Reference count: 4 Active count: 2

Sender: 172.100.1.1 Active count: 1

(192.6.1.5, 239.1.1.1) expires: 00:03:10 active

(192.6.1.5, 239.1.1.158) expires: 00:03:10

Sender: 181.100.1.1, active count: 1

(195.6.1.2, 239.1.2.12) expires: 00:03:10 active

(195.6.1.2, 239.1.2.197) expires: 00:03:10

Data-group: 229.1.1.0 Reference count: 4 Active count: 2

Sender: 185.100.1.1 Active count: 1

(198.6.1.5, 239.1.3.62) expires: 00:03:10 active

(198.6.1.5, 225.1.1.109) expires: 00:03:10

Sender: 190.100.1.1 Active count: 1

(200.6.1.2, 225.1.4.80) expires: 00:03:10 active

(200.6.1.2, 225.1.4.173) expires: 00:03:10

# Display brief information about data-groups that are received in the MD of VPN instance mvpn for IPv4 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn data-group receive brief

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

Data group: 226.1.1.0 Reference count: 4 Active count: 2

Data group: 229.1.1.0 Reference count: 4 Active count: 2

Table 48 Command output

Field	Description
MD data-group information received by VPN instance: mvpn	Information about data-groups that are received in the MD of the VPN instance mvpn for IPv4 multicast transmission.
Total 2 data-groups for 8 entries	A total of 2 data-groups, associated with 8 (S, G) entries.
Total 2 data-groups and 8 entries matched	A total of 2 matching data-groups, associated with 8 (S, G) entries.
Data-group	IP address of the received data-group.
Sender	BGP peer address of the PE device that sent the data-group.
Reference count	Number of (S, G) entries that use the data-group in the VPN instance.
Active count	Number of active (S, G) entries (entries with active receivers) that use the data-group in the VPN instance.
expires	Remaining time for the (S, G) entry that uses the data-group in the VPN instance.

display multicast-domain data-group send

Use display multicast-domain data-group send to display information about data-groups that are sent in the MD of a VPN instance for IPv4 multicast transmission.

Syntax

display multicast-domain vpn-instance vpn-instance-name data-group send [ group group-address | reuse interval | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.

group group-address: Specifies a data-group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

reuse interval: Specifies an interval during which data-group reuses occur, in the range of 1 to 2147483647 seconds.

vpn-source-address: Specifies a multicast source address of the specified VPN instance.

vpn-group-address: Specifies a multicast group address of the specified VPN instance. The value range for this argument is 224.0.0.0 to 239.255.255.255.

mask-length: Specifies a mask length of the specified multicast source address or multicast group address. The value range for this argument is 0 to 32, and the default is 32.

mask: Specifies a subnet mask of the specified multicast source address or multicast group address. The default is 255.255.255.255.

Examples

# Display information about data-groups that are sent in the MD of VPN instance mvpn for IPv4 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn data-group send

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 6 entries

Total 2 data-groups and 6 entries matched

Reference count of 226.1.1.0: 3

(192.6.1.5, 239.1.1.1) switch time: 00:00:21

(192.6.1.5, 239.1.1.158) switch time: 00:00:21

(192.6.1.5, 239.1.2.50) switch time: 00:00:05

Reference count of 226.1.1.1: 3

(192.6.1.2, 225.1.1.1) switch time: 00:00:21

(192.6.1.2, 225.1.2.50) switch time: 00:00:05

(192.6.1.5, 239.1.1.159) switch time: 00:00:21

# Display reuse information about data-groups that are sent in the MD of VPN instance mvpn for IPv4 multicast transmission within 30 seconds.

<Sysname> display multicast-domain vpn-instance mvpn data-group send reuse 30

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 3 entries

Total 2 data-groups and 3 entries matched

Reuse count of 226.1.1.0: 1

Reuse count of 226.1.1.1: 1

Reuse count of 226.1.1.2: 1

Table 49 Command output

Field	Description
MD data-group information sent by VPN instance: mvpn	Information about data-groups that are sent in the MD of the VPN instance mvpn for IPv4 multicast transmission.
Total 2 data-groups for 6 entries	A total of 2 data-groups, associated with 6 (S, G) entries.
Total 2 data-groups and 6 entries matched	A total of 2 matching data-groups, associated with 6 (S, G) entries.
Reference count of 226.1.1.0	Number of (S, G) entries that use the data-group in the VPN instance.
switch time	Switchover time of the (S, G) entry that uses the data-group in the VPN instance.
Reuse count of 226.1.1.0	Number of times that the data-group is reused during the specified length of time.

display multicast-domain default-group

Use display multicast-domain default-group to display information about default-groups for IPv4 multicast transmission.

Syntax

display multicast-domain [ vpn-instance vpn-instance-name ] default-group { local | remote }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

local: Specifies local default-groups for IPv4 multicast transmission.

remote: Specifies remote default-groups for IPv4 multicast transmission.

Examples

# Display information about local default-groups of all VPN instances for IPv4 multicast transmission.

<Sysname> display multicast-domain default-group local

MD local default-group information:

Group address Source address Interface VPN instance

239.1.1.1 1.1.1.1 MTunnel0 mvpna

239.2.1.1 1.1.1.1 MTunnel1 mvpnb

239.3.1.1 -- MTunnel2 mvpnc

# Display information about remote default-groups of all VPN instances for IPv4 multicast transmission.

<Sysname> display multicast-domain default-group remote

MD remote default-group information:

Group address Source address Next hop VPN instance

239.1.1.1 1.2.0.1 1.2.0.1 a

239.1.1.1 1.2.0.2 1.2.0.2 a

239.1.1.1 1.2.0.3 1.2.0.3 a

239.1.1.2 1.2.0.1 1.2.0.1 b

239.1.1.2 1.2.0.2 1.2.0.2 b

239.1.1.3 1.2.0.1 1.2.0.1 -

Table 50 Command output

Field	Description
Group address	IP address of the default-group for IPv4 multicast transmission.
Source address	IP address of the MD source interface, which is used by the MTI as the source address to encapsulate multicast packets for the VPN instance.
Interface	MTI interface.
Next hop	IP address of the next hop.
VPN instance	VPN instance to which the default-group belongs.

display multicast-domain ipv6 data-group receive

Use display multicast-domain ipv6 data-group receive to display information about data-groups that are received in the MD of a VPN instance for IPv6 multicast transmission.

Syntax

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.

brief: Displays brief information. If you do not specify this keyword, the command displays detailed information.

active: Specifies data-groups that have joined the data-MDT.

group group-address: Specifies a data-group by its address in the range of 224.0.1.0 to 239.255.255.255.

sender source-address: Specifies an MD source interface by its address.

vpn-source-address: Specifies an IPv6 multicast source address of the specified VPN instance.

vpn-group-address: Specifies an IPv6 multicast group address of the specified VPN instance. The value range for this argument is FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.

mask-length: Specifies a mask length of the specified IPv6 multicast source address or IPv6 multicast group address. For the IPv6 multicast source address, the value range for this argument is 8 to 128, and the default is 128. For the IPv6 multicast group address, the value range for this argument is 0 to 128, and the default is 128.

Examples

# Display detailed information about data-groups that are received in the MD of VPN instance mvpn for IPv6 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn ipv6 data-group receive

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

Data-group: 226.1.1.0 Reference count: 4 Active count: 2

Sender: 172.100.1.1 Active count: 1

(192::1, ff1e::1)

expires: 00:03:10 active

(192::1, ff1e::2)

expires: 00:03:10

Sender: 181.100.1.1, active count: 1

(192::2, ff1e::11)

expires: 00:03:10 active

(192::2, ff1e::12)

expires: 00:03:10

Data-group: 229.1.1.0 Reference count: 4 Active count: 2

Sender: 185.100.1.1 Active count: 1

(192::6, ff1e::15)

expires: 00:03:10 active

(192::6, ff1e::16)

expires: 00:03:10

Sender: 190.100.1.1 Active count: 1

(192::11, ff1e::21)

expires: 00:03:10 active

(192::11, ff1e::22)

expires: 00:03:10

# Display brief information about data-groups that are received in the MD of VPN instance mvpn for IPv6 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn ipv6 data-group receive brief

MD data-group information received by VPN instance: mvpn

Total 2 data-groups for 8 entries

Total 2 data-groups and 8 entries matched

Data group: 226.1.1.0 Reference count: 4 Active count: 2

Data group: 229.1.1.0 Reference count: 4 Active count: 2

Table 51 Command output

Field	Description
MD data-group information received by VPN instance: mvpn	Information about data-groups that are received in the MD of the VPN instance mvpn for IPv6 multicast transmission.
Total 2 data-groups for 8 entries	A total of 2 data-groups, associated with 8 (S, G) entries.
Total 2 data-groups and 8 entries matched	A total of 2 matching data-groups, associated with 8 matching (S, G) entries.
Data-group	IP address of the received data-group.
Sender	BGP peer address of the PE device that sent the data-group.
Reference count	Number of (S, G) entries that use the data-group in the VPN instance.
Active count	Number of active (S, G) entries (entries with receivers) that use the data-group in the VPN instance.
expires	Remaining time for the (S, G) entry that uses the data-group in the VPN instance.

display multicast-domain ipv6 data-group send

Use display multicast-domain ipv6 data-group send to display information about data-groups that are sent in the MD of a VPN instance for IPv6 multicast transmission.

Syntax

display multicast-domain vpn-instance vpn-instance-name ipv6 data-group send [ group group-address | reuse interval | vpn-source-address [ mask-length ] | vpn-group-address [ mask-length ] ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

group group-address: Specifies a data-group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

reuse interval: Specifies an interval during which data-group reuses occur, in the range of 1 to 2147483647 seconds.

vpn-source-address: Specifies an IPv6 multicast source address of the specified VPN instance.

mask-length: Specifies a mask length of the specified IPv6 multicast source or IPv6 multicast group address. For the IPv6 multicast source address, the value range for this argument is 8 to 128, and the default is 128. For the IPv6 multicast group address, the value range for this argument is 0 to 128, and the default is 128.

Examples

# Display information about data-groups that are sent in the MD of VPN instance mvpn for IPv6 multicast transmission.

<Sysname> display multicast-domain vpn-instance mvpn ipv6 data-group send

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 6 entries

Total 2 data-groups and 6 entries matched

Reference count of 226.1.1.0: 3

(192::1, ff1e::1)

switch time: 00:00:21

(192::1, ff1e::2)

switch time: 00:00:21

(192::1, ff1e::3)

switch time: 00:00:05

Reference count of 226.1.1.1: 3

(192::2, ff1e::4)

switch time: 00:00:21

(192::2, ff1e::5)

switch time: 00:00:05

(192::2, ff1e::6)

switch time: 00:00:21

# Display reuse information about data-groups that are sent in the MD of VPN instance mvpn for IPv6 multicast transmission within 30 seconds.

<Sysname> display multicast-domain vpn-instance mvpn ipv6 data-group send reuse 30

MD data-group information sent by VPN instance: mvpn

Total 2 data-groups for 3 entries

Total 2 data-groups and 3 entries matched

Reuse count of 226.1.1.0: 1

Reuse count of 226.1.1.1: 1

Reuse count of 226.1.1.2: 1

Table 52 Command output

Field	Description
MD data-group information sent by VPN instance: mvpn	Information about data-groups sent in the MD of VPN instance mvpn for IPv6 multicast transmission.
Total 2 data-groups for 6 entries	A total of 2 data-groups, associated with 6 (S, G) entries.
Total 2 data-groups and 6 entries matched	A total of 2 matching data-groups, associated with 6 matching (S, G) entries.
Reference count of 226.1.1.0	Number of (S, G) entries that use the data-group in the VPN instance.
switch time	Switchover time of the (S, G) entry that uses the data-group in the VPN instance.
Reuse count of 226.1.1.0	Number of times that the data-group is reused during the specified length of time.

display multicast-domain ipv6 default-group

Use display multicast-domain ipv6 default-group to display information about default-groups for IPv6 multicast transmission.

Syntax

display multicast-domain [ vpn-instance vpn-instance-name ] ipv6 default-group { local | remote }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

local: Specifies local default-groups for IPv6 multicast transmission.

remote: Specifies remote default-groups for IPv6 multicast transmission.

Examples

# Display information about all local default-groups of all VPN instances for IPv6 multicast transmission.

<Sysname> display multicast-domain ipv6 default-group local

MD local default-group information:

Group address Source address Interface VPN instance

239.1.1.1 1.1.1.1 MTunnel0 mvpna

239.2.1.1 1.1.1.1 MTunnel1 mvpnb

239.3.1.1 -- MTunnel2 mvpnc

# Display information about all remote default-groups of all VPN instances for IPv6 multicast transmission.

<Sysname> display multicast-domain ipv6 default-group remote

MD remote default-group information:

Group address Source address Next hop VPN instance

239.1.1.1 1.2.0.1 1.2.0.1 a

239.1.1.1 1.2.0.2 1.2.0.2 a

239.1.1.1 1.2.0.3 1.2.0.3 a

239.1.1.2 1.2.0.1 1.2.0.1 b

239.1.1.2 1.2.0.2 1.2.0.2 b

239.1.1.3 1.2.0.1 1.2.0.1 -

Table 53 Command output

Field	Description
Group address	IP address of the default-group for IPv6 multicast transmission.
Source address	IP address of the MD source interface, which is used by the MTI as the source address to encapsulate IPv6 multicast packets of the VPN instance.
Interface	MTI interface.
Next hop	IP address of the next hop.
VPN instance	VPN instance to which the default-group belongs.

log data-group-reuse

Use log data-group-reuse to enable data-group reuse logging.

Use undo log data-group-reuse to disable data-group reuse logging.

Syntax

log data-group-reuse

undo log data-group-reuse

Default

Data-group reuse logging is disabled.

Views

MD IPv4 address family view

MD IPv6 address family view

Predefined user roles

network-admin

Examples

# In MD IPv4 address family view of VPN instance mvpn, enable data-group reuse logging.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] log data-group-reuse

multicast-domain

Use multicast-domain to create an MD for a VPN instance and enter its view, or enter the view of the existing MD.

Use undo multicast-domain to delete configurations in MD view for a VPN instance.

Syntax

multicast-domain vpn-instance vpn-instance-name

undo multicast-domain vpn-instance vpn-instance-name

Default

No MD exists.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

Examples

# Create an MD for VPN instance mvpn and enter MD view.

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn]

multicast rpf-proxy-vector compatible

Use multicast rpf-proxy-vector compatible to enable RPF vector compatibility.

Use undo multicast rpf-proxy-vector compatible to disable RPF vector compatibility.

Syntax

multicast rpf-proxy-vector compatible

undo multicast rpf-proxy-vector compatible

Default

RPF vector compatibility is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command enables the device to work with other manufacturers' products on the RPF vector. You must configure this command on all H3C routers on the public network for multicast VPN inter-AS option B.

Examples

# Enable RPF vector compatibility.

<Sysname> system-view

[Sysname] multicast rpf-proxy-vector compatible

rpf proxy vector

Use rpf proxy vector to enable the RPF vector feature.

Use undo rpf proxy vector to disable the RPF vector feature.

Syntax

rpf proxy vector

undo rpf proxy vector

Default

The RPF vector feature is disabled.

Views

MRIB view

Predefined user roles

network-admin

network-operator

Usage guidelines

This feature enables PE devices to carry the RPF vector information in PIM join messages for other devices to perform RPF check on the messages.

You must enable this feature on PE devices (excluding the PE devices that do not have attached receivers) when you configure multicast VPN inter-AS option B.

Only the configuration made in MRIB view of a VPN instance takes effect. The configuration made in MRIB view on the public network does not take effect.

Examples

# Enable the RPF vector feature for VPN instance mvpn.

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn] rpf proxy vector

source

Use source to specify an MD source interface.

Use undo source to restore the default.

Syntax

source interface-type interface-number

undo source

Default

No MD source interface is specified.

Views

MD IPv4 address family view

MD IPv6 address family view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

For the PE device to obtain correct routing information, you must specify the interface used for establishing BGP peer relationship as the MD source interface.

For an MD that transmits both IPv4 and IPv6 multicast packets, you must specify the same MD source interface in MD IPv4 and IPv6 address family views.

Examples

# In MD IPv4 and IPv6 address family views, specify Loopback 1 as the MD source interface for VPN instance mvpn. (Loopback 1 is the source interface used for establishing BGP peer relationship.)

<Sysname> system-view

[Sysname] multicast-domain vpn-instance mvpn

[Sysname-md-mvpn] address-family ipv4

[Sysname-md-mvpn-ipv4] source loopback 1

[Sysname-md-mvpn-ipv4] quit

[Sysname-md-mvpn] address-family ipv6

[Sysname-md-mvpn-ipv6] source loopback 1

MLD snooping commands

This feature is supported only on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

¡ SIC-4GSW/4GSWF/4GSW-PoE.

¡ SIC-9FSW/9FSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

Commands and descriptions for centralized devices apply to the following routers:

· MSR2600-6-X1/2600-10-X1.

· MSR 2630.

· MSR3600-28/3600-51.

· MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

· MSR 3610/3620/3620-DP/3640/3660.

· MSR810-LM-GL/810-W-LM-GL/830-6EI-GL/830-10EI-GL/830-6HI-GL/830-10HI-GL/2600-6-X1-GL.

Commands and descriptions for distributed devices apply to the following routers:

· MSR5620.

· MSR 5660.

· MSR 5680.

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

Centralized devices in standalone mode:

display ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] [ ipv6-source-address | ipv6-group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] [ ipv6-source-address | ipv6-group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] [ ipv6-source-address | ipv6-group-address ] * [ chassis chassis-number 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 a card by its slot number. If you do not specify a card, this command displays Layer 2 IPv6 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 IPv6 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

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: GigabitEthernet1/0/2

List of 1 egress ports:

GigabitEthernet1/0/3

Status: Enable Flag: 0x10

Table 54 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries in the Layer 2 IPv6 multicast fast forwarding table, and the total number of matching entries.
(1::6, FF1E::2)	(S, G) entry in the Layer 2 IPv6 multicast fast forwarding table.
Protocol	Protocol number.
VLAN	VLAN ID.
Flag	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. · 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.
Status	Status of the (S, G) entry or the outgoing port: · Enabled—Available. · Disabled—Unavailable.
Ingress port	Incoming port of the (S, G) entry.
List of 1 egress ports	List of outgoing ports of the (S, G) entry.

Related commands

reset ipv6 l2-multicast fast-forwarding cache all

display ipv6 l2-multicast ip

Use display ipv6 l2-multicast ip to display information about Layer 2 IPv6 multicast groups.

Syntax

Centralized devices in standalone mode:

display ipv6 l2-multicast ip [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 l2-multicast ip [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 l2-multicast ip [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group ipv6-group-address: Specifies an IPv6 multicast group by its IPv6 address. If you do not specify an IPv6 multicast group, this command displays information about all Layer 2 IPv6 multicast groups.

source 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 Layer 2 IPv6 multicast groups for all IPv6 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 IPv6 multicast groups for all VLANs.

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 IP multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 IPv6 multicast groups for VLAN 2.

<Sysname> display ipv6 l2-multicast ip vlan 2

Total 1 entries.

VLAN 2: Total 1 IP entries.

(::, FF1E::101)

Attribute: static, success

Host slots (0 in total):

Host ports (1 in total):

GE1/0/1 (S, SUC)

Table 55 Command output

Field	Description
Total 1 entries	Total number of Layer 2 IPv6 multicast groups.
VLAN 2: Total 1 IP entries	Total number of Layer 2 IPv6 multicast groups in VLAN 2.
(::, FF1E::101)	(S, G) entry, where a double colon (::) in the S position means all IPv6 multicast sources.
Attribute	Entry attribute: · dynamic—The entry is created by a dynamic protocol. · static—The entry is created by a static protocol. · pim—The entry is created by IPv6 PIM. · kernel—The entry is obtained from the kernel. · success—Processing succeeds. · fail—Processing fails.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.
(S, SUC)	Port attribute: · D—Dynamic port. · S—Static port. · P—IPv6 PIM port. · K—Port obtained from the kernel. · R—Port learned from (, ) entries. · W—Port learned from (*, G) entries. · SUC—Processing succeeds. · F—Processing fails. · BC—Broadcast port. The TRILL port floods IPv6 multicast data after the topology changes.

display ipv6 l2-multicast ip forwarding

Use display ipv6 l2-multicast ip forwarding to display Layer 2 IPv6 multicast IP forwarding entries.

Syntax

Centralized devices in standalone mode:

display ipv6 l2-multicast ip forwarding [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 l2-multicast ip forwarding [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 l2-multicast ip forwarding [ group ipv6-group-address | source ipv6-source-address ] * [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group ipv6-group-address: Specifies an IPv6 multicast group by its IPv6 address. If you do not specify an IPv6 multicast group, this command displays Layer 2 IPv6 multicast IP forwarding entries for all IPv6 multicast groups.

source ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not specify an IPv6 multicast source, this command displays Layer 2 IPv6 multicast IP forwarding entries for all IPv6 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 Layer 2 IPv6 multicast IP forwarding entries for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the Layer 2 IPv6 multicast IP forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 IPv6 multicast IP forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 IPv6 multicast IP forwarding entries for VLAN 2.

<Sysname> display ipv6 l2-multicast ip forwarding vlan 2

Total 1 entries.

VLAN 2: Total 1 IP entries.

(::, FF1E::101)

Host slots (0 in total):

Host ports (3 in total):

GigabitEthernet1/0/1

GigabitEthernet1/0/2

GigabitEthernet1/0/3

Table 56 Command output

Field	Description
Total 1 entries	Total number of Layer 2 IPv6 multicast IP forwarding entries.
VLAN 2: Total 1 IP entries	Total number of Layer 2 IPv6 multicast IP forwarding entries in VLAN 2.
(::, FF1E::101)	(S, G) entry, where a double colon (::) in the S position means all IPv6 multicast sources.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (3 in total)	Member ports, and the total number of member ports.

display ipv6 l2-multicast mac

Use display ipv6 l2-multicast mac to display information about Layer 2 IPv6 multicast MAC multicast groups.

Syntax

Centralized devices in standalone mode:

display ipv6 l2-multicast mac [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies an IPv6 multicast MAC address. If you do not specify an IPv6 multicast MAC address, this command displays information about all Layer 2 IPv6 multicast 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 IPv6 multicast MAC multicast groups for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the Layer 2 IPv6 multicast MAC multicast groups for the MPU. (Distributed devices in standalone mode.)

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 IPv6 multicast MAC multicast groups for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 IPv6 multicast MAC multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 IPv6 multicast MAC multicast groups for VLAN 2.

<Sysname> display ipv6 l2-multicast mac vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 3333-0000-0101

Attribute: success

Host slots (0 in total):

Host ports (1 in total):

GE1/0/1

Table 57 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 IPv6 MAC multicast groups.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 IPv6 MAC multicast groups in VLAN 2.
MAC group address	IPv6 address of the Layer 2 IPv6 MAC multicast group.
Attribute	Entry attribute: · success—Processing succeeds. · fail—Processing fails.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.

display ipv6 l2-multicast mac forwarding

Use display ipv6 l2-multicast mac forwarding to display Layer 2 IPv6 multicast MAC forwarding entries.

Syntax

Centralized devices in standalone mode:

display ipv6 l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 IPv6 multicast MAC forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 IPv6 multicast MAC forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 IPv6 multicast MAC forwarding entries for VLAN 2.

<Sysname> display ipv6 l2-multicast mac forwarding vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 3333-0000-0101

Host slots (0 in total):

Host ports (3 in total):

GigabitEthernet1/0/1

GigabitEthernet1/0/2

GigabitEthernet1/0/3

Table 58 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 IPv6 multicast MAC forwarding entries.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 IPv6 multicast MAC forwarding entries in VLAN 2.
MAC group address	Address of the IPv6 MAC multicast group.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (3 in total)	Member ports, and the total number of member ports.

display mld-snooping

Use display mld-snooping to display MLD snooping status.

Syntax

display mld-snooping [ global | vlan vlan-id ]

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.

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.

Examples

# Display the global MLD snooping status and the MLD snooping status for all VLANs.

<Sysname> display mld-snooping

MLD snooping information: Global

MLD snooping: Enabled

Drop-unknown: Disabled

Host-aging-time: 260s

Router-aging-time: 260s

Max-response-time: 10s

Last-listener-query-interval: 1s

Report-aggregation: Enabled

Dot1p-priority: --

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: 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

Dot1p-priority: 2

MLD snooping information: VLAN 10

MLD snooping: Enabled

Drop-unknown: Enabled

Version: 2

Host-aging-time: 260s

Router-aging-time: 260s

Max-response-time: 10s

Last-listener-query-interval: 1s

Querier: 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

Dot1p-priority: --

Table 59 Command output

Field	Description
MLD snooping	MLD snooping status: · Enabled. · Disabled.
Drop-unknown	Status of dropping unknown IPv6 multicast data: · Enabled. · Disabled.
Version	MLD snooping version.
Host-aging-time	Aging timer for the dynamic member port.
Router-aging-time	Aging timer for the dynamic router port.
Max-response-time	Maximum time for responding to MLD general queries.
Last-listener-query-interval	Interval for sending MLD multicast-address-specific queries.
Report-aggregation	Status of MLD report suppression: · Enabled. · Disabled.
Dot1p-priority	802.1p priority for MLD messages. This field displays two hyphens (--) if the 802.1p priority is not configured.
Querier	Status of MLD snooping querier: · Enabled. · Disabled.
Query-interval	Interval for sending MLD general queries.
General-query source IP	Source IPv6 address of MLD general queries.
Special-query source IP	Source IPv6 address of MLD multicast-address-specific queries.
Report source IP	Source IPv6 address of MLD reports.
Done source IP	Source IPv6 address of MLD done messages.

display mld-snooping group

Use display mld-snooping group to display dynamic MLD snooping group entries.

Syntax

Centralized devices in standalone mode:

display mld-snooping group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display mld-snooping group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display mld-snooping group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]

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 dynamic MLD snooping group entries for all IPv6 multicast groups.

ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not specify an IPv6 multicast source, this command displays dynamic MLD snooping group entries for all IPv6 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 dynamic MLD snooping group entries for all VLANs.

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 a card by its slot number. If you do not specify a card, this command displays dynamic MLD snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays dynamic MLD snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic MLD snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about dynamic MLD snooping group entries for VLAN 2.

<Sysname> display mld-snooping group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(::,FF1E::101)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

GE1/0/2 (00:03:23)

Table 60 Command output

Field	Description
Total 1 entries	Total number of dynamic MLD snooping group entries.
VLAN 2: Total 1 entries	Total number of dynamic MLD snooping group entries in VLAN 2.
(::, FF1E::101)	(S, G) entry, where a double colon (::) in the S position means all IPv6 multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the specified card or on the MPU when no card is specified. · slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—The entry does not exist. · normal—The entry is a correct entry.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.
(00:03:23)	Remaining aging time for the dynamic member port. This field is always displayed for a global port (including Layer 2 aggregate interfaces, AC interfaces, N-PW interfaces, and U-PW interfaces). (Centralized devices in standalone mode.) For a non-global dynamic member port, this field is always displayed. (Distributed devices in standalone mode.) For a non-global dynamic member port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (Centralized devices in IRF mode.) For a non-global dynamic member 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. (Distributed devices in IRF mode.) For a non-global dynamic member port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.

Related commands

reset mld-snooping group

display mld-snooping router-port

Use display mld-snooping router-port to display dynamic router port information.

Syntax

Centralized devices in standalone mode:

display mld-snooping router-port [ verbose | vlan vlan-id [ verbose ] ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display mld-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ slot slot-number ]

Distributed devices in IRF mode:

display mld-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information. If you do not specify the keyword, this command displays brief information.

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 dynamic router port information for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic router port information for the MPU. (Distributed devices in standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display dynamic router port information for VLAN 2.

<Sysname> display mld-snooping router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

GE1/0/1 (00:01:30)

GE1/0/2 (00:00:23)

Table 61 Command output

Field	Description
VLAN 2	VLAN ID.
Router slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have dynamic router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have dynamic router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have dynamic router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Router ports (2 in total)	Dynamic router ports, and the total number of dynamic router ports.
(00:01:30)	Remaining aging time for the dynamic router port. This field is always displayed for a global port (including Layer 2 aggregate interfaces). (Centralized devices in standalone mode.) For a global port, this field is always displayed. (Distributed devices in standalone mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (Centralized devices in IRF mode.) For a 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. (Distributed devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.

Related commands

reset mld-snooping router-port

display mld-snooping static-group

Use display mld-snooping static-group to display static MLD snooping group entries.

Syntax

Centralized devices in standalone mode:

display mld-snooping static-group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display mld-snooping static-group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display mld-snooping static-group [ ipv6-group-address | ipv6-source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]

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 static MLD snooping group entries for all IPv6 multicast groups.

ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not specify an IPv6 multicast source, this command displays static MLD snooping group entries for all IPv6 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 static MLD snooping group entries for all VLANs.

verbose: Displays detailed information about static MLD snooping group entries. If you do not specify the keyword, this command displays brief information about static MLD snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static MLD snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays static MLD snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static MLD snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about static MLD snooping group entries for VLAN 2.

<Sysname> display mld-snooping static-group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(::,FF1E::101)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

GE1/0/2

Table 62 Command output

Field	Description
Total 1 entries	Total number of static MLD snooping group entries.
VLAN 2: Total 1 entries	Total number of static MLD snooping group entries in VLAN 2.
(::, FF1E::101)	(S, G) entry, where a double colon (::) in the S position means all IPv6 multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the specified card or on the MPU when no card is specified. · slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—The entry does not exist. · normal—The entry is a correct entry.
Host slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Host ports (1 in total)	Member ports, and the total number of member ports.

display mld-snooping static-router-port

Use display mld-snooping static-router-port to display static router port information.

Syntax

Centralized devices in standalone mode:

display mld-snooping static-router-port [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display mld-snooping static-router-port [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display mld-snooping static-router-port [ vlan vlan-id ] [ chassis chassis-number 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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static router port information for the MPU. (Distributed devices in standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display static router port information for VLAN 2.

<Sysname> display mld-snooping static-router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

GE1/0/1

GE1/0/2

Table 63 Command output

Field	Description
VLAN 2	VLAN ID.
Router slots (0 in total)	This field is not supported. (Centralized devices in standalone mode.) Slot numbers and total number of the cards that have static router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.) Member IDs and total number of the member devices that have static router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have static router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)
Router ports (2 in total)	Static router ports, and the total number of static router ports.

display mld-snooping statistics

Use display mld-snooping statistics to display statistics for the MLD messages and IPv6 PIM hello messages learned through MLD snooping.

Syntax

display mld-snooping statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for the MLD messages and IPv6 PIM hello messages learned through MLD snooping.

<Sysname> display mld-snooping statistics

Received MLD general queries: 0

Received MLDv1 specific queries: 0

Received MLDv1 reports: 0

Received MLD dones: 0

Sent MLDv1 specific queries: 0

Received MLDv2 reports: 0

Received MLDv2 reports with right and wrong records: 0

Received MLDv2 specific queries: 0

Received MLDv2 specific sg queries: 0

Sent MLDv2 specific queries: 0

Sent MLDv2 specific sg queries: 0

Received IPv6 PIM hello: 0

Received error MLD messages: 0

Table 64 Command output

Field	Description
general queries	Number of MLD general queries.
specific queries	Number of MLD multicast-address-specific queries.
reports	Number of MLD reports.
dones	Number of MLD done messages.
reports with right and wrong records	Number of MLD reports with correct and incorrect records.
specific sg queries	Number of MLD multicast-address-and-source-specific queries.
IPv6 PIM hello	Number of IPv6 PIM hello messages.
error MLD messages	Number of MLD messages with errors.

Related commands

reset mld-snooping statistics

dot1p-priority (MLD-snooping view)

Use dot1p-priority to set the 802.1p priority for MLD messages globally.

Use undo dot1p-priority to restore the default.

Syntax

dot1p-priority priority

undo dot1p-priority

Default

The 802.1p priority for MLD messages is not set.

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

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

MLD snooping is disabled for a VLAN.

Views

MLD-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

You must globally enable MLD snooping before you execute this command.

You can enable MLD snooping for the specified VLANs in MLD-snooping view or for a VLAN in VLAN view. For a VLAN, 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 MLD snooping globally, and 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

entry-limit (MLD-snooping view)

Use entry-limit to globally set the maximum number of MLD snooping forwarding entries, including dynamic entries and static entries.

Use undo entry-limit to restore the default.

Syntax

entry-limit limit

undo entry-limit

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

fast-leave (MLD-snooping view)

Use fast-leave to enable fast-leave processing globally.

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

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

MLD-snooping view

Predefined user roles

network-admin

Parameters

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 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 MLD snooping fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] fast-leave vlan 2

Related commands

mld-snooping fast-leave

group-policy (MLD-snooping view)

Use group-policy to globally configure an IPv6 multicast group policy to control the IPv6 multicast groups that hosts can join.

Use undo group-policy to globally delete IPv6 multicast group policies.

Syntax

group-policy ipv6-acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

Default

No IPv6 multicast group policies are configured, and hosts can join any IPv6 multicast groups.

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.

Usage guidelines

This configuration takes effect only on the IPv6 multicast groups that the port joins dynamically.

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 the following MLD reports, set the source source-address source-prefix option to 0::0:

¡ MLDv1 reports.

¡ MLDv2 IS_EX and MLDv2 TO_EX reports that do not carry IPv6 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 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

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 in MLD-snooping view or for a VLAN in VLAN view. 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

last-listener-query-interval (MLD-snooping view)

Use last-listener-query-interval to set the MLD last listener query interval globally.

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

Syntax

last-listener-query-interval interval

undo last-listener-query-interval

Default

The MLD last listener query interval is 1 second.

Views

MLD-snooping 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 interval 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

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

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] last-listener-query-interval 3

Related commands

mld-snooping last-listener-query-interval

max-response-time (MLD-snooping view)

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

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

Syntax

max-response-time seconds

undo max-response-time

Default

The maximum response time for MLD general queries is 10 seconds.

Views

MLD-snooping 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 can set the time globally for all VLANs in MLD-snooping view or for a VLAN in VLAN view. For a VLAN, the VLAN-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

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

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] max-response-time 5

Related commands

mld-snooping max-response-time

mld-snooping query-interval

mld-snooping

Use mld-snooping to enable MLD snooping globally and enter MLD-snooping view.

Use undo mld-snooping to disable MLD snooping globally.

Syntax

mld-snooping

undo mld-snooping

Default

MLD snooping is globally disabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable MLD snooping globally, 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 done source-ip

Use mld-snooping done source-ip to configure the source IPv6 address for MLD done messages.

Use undo mld-snooping done source-ip to restore the default.

Syntax

mld-snooping done source-ip ipv6-address

undo mld-snooping done source-ip

Default

The source IPv6 address of MLD done messages is the IPv6 link-local address of the current VLAN interface. If the current VLAN interface does not have an IPv6 link-local address, the source IPv6 address is FE80::02FF:FFFF:FE00:0001.

Views

VLAN view

Predefined user roles

network-admin

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

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 for MLD messages is not set.

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.

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.

Use undo mld-snooping drop-unknown to disable dropping unknown IPv6 multicast data packets for a VLAN.

Syntax

mld-snooping drop-unknown

undo mld-snooping drop-unknown

Default

Dropping unknown IPv6 multicast data packets is disabled for a VLAN, and unknown IPv6 multicast data packets are flooded in the VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

¡ SIC-4GSW/4GSWF/4GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

You must enable MLD snooping for a VLAN before you execute this command.

You can enable this feature for a VLAN in VLAN view or globally for all VLANs in MLD-snooping view.

The mld-snooping drop-unknown command and the drop-unknown command in MLD-snooping view are mutually exclusive. You cannot configure them on the same device.

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

[Sysname-vlan2] mld-snooping drop-unknown

Related commands

drop-unknown (MLD-snooping view)

enable (MLD-snooping view)

mld-snooping enable

Use mld-snooping enable to enable MLD snooping for a VLAN.

Use undo mld-snooping enable to disable MLD snooping for a VLAN.

Syntax

mld-snooping enable

undo mld-snooping enable

Default

MLD snooping is disabled for a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable MLD snooping globally before you enable MLD snooping for a VLAN.

You can enable MLD snooping for a VLAN in VLAN view or for the specified VLANs in MLD-snooping view. For a VLAN, 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 MLD snooping globally, and enable MLD snooping for VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] 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 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping fast-leave vlan 2

Related commands

fast-leave (MLD-snooping view)

mld-snooping general-query source-ip

Use mld-snooping general-query source-ip to configure the source IPv6 address for MLD general queries.

Use undo mld-snooping general-query source-ip to restore the default.

Syntax

mld-snooping general-query source-ip ipv6-address

undo mld-snooping general-query source-ip

Default

In a VLAN, the source IPv6 address for MLD general queries is the IPv6 link-local address of the current VLAN interface. If the current VLAN interface does not have an IPv6 link-local address, the source IPv6 address is FE80::02FF:FFFF:FE00:0001.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies the source IPv6 address for MLD general queries.

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 general queries.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping general-query source-ip fe80:0:0:1::1

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 aggregate interface view

Layer 2 Ethernet 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.

Usage guidelines

This command takes effect only on the IPv6 multicast groups that a port joins dynamically.

Examples

# On 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 gigabitethernet 1/0/1

[Sysname-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.

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 are configured on a port, and hosts attached to the port can join IPv6 multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet 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.

Usage guidelines

This command takes effect only on the IPv6 multicast groups that a port joins dynamically.

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:

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

To match the following MLD reports, set the source source-address source-prefix option to 0::0:

¡ MLDv1 reports.

¡ MLDv2 IS_EX and MLDv2 TO_EX reports that do not carry IPv6 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 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 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 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] interface gigabitethernet 1/0/1

[Sysname-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.

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

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 before you execute this command.

You can set the timer 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.

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

[Sysname-vlan2] 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.

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 IPv6 multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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.

Usage guidelines

A port configured as a simulated member host ages out in the same way as a dynamic member port.

Make sure the simulated member host runs the same version of MLD and MLD snooping.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host for IPv6 multicast source and group (2002::22, 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] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping host-join ff3e::101 source-ip 2002::22 vlan 2

mld-snooping last-listener-query-interval

Use mld-snooping last-listener-query-interval to set the MLD last listener query interval for a VLAN.

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

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 before you execute this command.

You can set the interval 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 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

Related commands

enable (MLD-snooping view)

last-listener-query-interval (MLD-snooping view)

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.

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

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 or globally for all VLANs in MLD-snooping view. For a VLAN, the VLAN-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

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 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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 GigabitEthernet 1/0/1, enable the IPv6 multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping overflow-replace vlan 2

Related commands

overflow-replace (MLD-snooping 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

Default

The MLD snooping querier 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 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

Related commands

enable (MLD-snooping view)

mld-snooping enable

subvlan (IPv6 multicast-VLAN view)

mld-snooping query-interval

Use mld-snooping query-interval to set the MLD general query interval for a VLAN.

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

Predefined user roles

network-admin

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

Related commands

enable (MLD-snooping view)

max-response-time

mld-snooping enable

mld-snooping max-response-time

mld-snooping querier

mld-snooping report source-ip

Use mld-snooping report source-ip to configure the source IPv6 address for MLD reports.

Use undo mld-snooping report source-ip to restore the default.

Syntax

mld-snooping report source-ip ipv6-address

undo mld-snooping report source-ip

Default

The source IPv6 address for MLD reports is the IPv6 link-local address of the current VLAN interface. If the current VLAN interface does not have an IPv6 link-local address, the source IPv6 address is FE80::02FF:FFFF:FE00:0001.

Views

VLAN 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

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.

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

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 before you execute this command.

You can set the timer 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 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

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 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-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

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping source-deny

Related commands

source-deny (MLD-snooping view)

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

Views

VLAN 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 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

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.

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 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

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.

Examples

# Configure GigabitEthernet 1/0/1 as a static member port for IPv6 multicast source and group (2002::22, 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] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping static-group ff3e::101 source-ip 2002::22 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 aggregate interface view

Layer 2 Ethernet 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 GigabitEthernet 1/0/1 as a static router port in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-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.

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 is 1.

Views

VLAN 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 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. For a VLAN, the configuration in VLAN view 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

Related commands

enable (MLD-snooping view)

mld-snooping enable

version (MLD-snooping view)

overflow-replace (MLD-snooping view)

Use overflow-replace to enable the IPv6 multicast group replacement feature globally.

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

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

Default

The IPv6 multicast group replacement feature is disabled.

Views

MLD-snooping view

Predefined user roles

network-admin

Parameters

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

report-aggregation (MLD-snooping view)

Use report-aggregation to enable MLD report suppression.

Use undo report-aggregation to disable MLD report suppression.

Syntax

report-aggregation

undo report-aggregation

Default

MLD report suppression is enabled.

Views

MLD-snooping view

Predefined user roles

network-admin

Examples

# Disable MLD report suppression.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] undo report-aggregation

reset ipv6 l2-multicast fast-forwarding cache

Use reset ipv6 l2-multicast fast-forwarding cache to clear Layer 2 IPv6 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] { { ipv6-source-address | ipv6-group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] { { ipv6-source-address | ipv6-group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset ipv6 l2-multicast fast-forwarding cache [ vlan vlan-id ] { { ipv6-source-address | ipv6-group-address } * | all } [ chassis chassis-number 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.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears Layer 2 IPv6 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears Layer 2 IPv6 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

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 IPv6 multicast source and group (1::6, FF1E::2).

<Sysname> reset ipv6 l2-multicast fast-forwarding cache 1::6 FF1E::2

Related commands

display ipv6 l2-multicast fast-forwarding cache

reset mld-snooping group

Use reset mld-snooping group to clear dynamic MLD snooping group entries.

Syntax

reset mld-snooping group { ipv6-group-address [ ipv6-source-address ] | all } [ vlan vlan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

ipv6-source-address: Specifies an IPv6 multicast source address. If you do not specify an IPv6 multicast source, this command clears dynamic MLD snooping group entries for all IPv6 multicast sources.

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 dynamic MLD snooping group entries for all VLANs.

Examples

# Clear all dynamic MLD snooping group entries.

<Sysname> reset mld-snooping group all

Related commands

display mld-snooping group

reset mld-snooping router-port

Use reset mld-snooping router-port to clear dynamic router port information.

Syntax

reset mld-snooping router-port { all | vlan vlan-id }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all dynamic router ports.

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 dynamic router port information for all VLANs.

Examples

# Clear information about all dynamic router ports.

<Sysname> reset mld-snooping router-port all

Related commands

display mld-snooping router-port

reset mld-snooping statistics

Use reset mld-snooping statistics to clear statistics for MLD messages and IPv6 PIM hello messages learned through MLD snooping.

Syntax

reset mld-snooping statistics

Views

User view

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

router-aging-time (MLD-snooping view)

Use router-aging-time to set the aging timer for dynamic router ports globally.

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

Syntax

router-aging-time seconds

undo router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds.

Views

MLD-snooping 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 can set the timer globally for all VLANs 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 global aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] mld-snooping

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

Related commands

mld-snooping router-aging-time

source-deny (MLD-snooping view)

Use source-deny to enable IPv6 multicast source port filtering on ports to discard all IPv6 multicast data packets.

Use undo source-deny to disable IPv6 multicast source port filtering on ports.

Syntax

source-deny port interface-list

undo source-deny port interface-list

Default

IPv6 multicast source port filtering is disabled.

Views

MLD-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

This feature is supported on the following ports:

· Layer 2 Ethernet ports on the following modules:

¡ HMIM-8GSW.

¡ HMIM-8GSWF.

¡ HMIM-24GSW/24GSW-PoE.

· Fixed Layer 2 Ethernet ports on the following routers:

¡ MSR2600-6-X1/2600-10-X1.

¡ MSR3600-28/3600-51.

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 GigabitEthernet 1/0/1 through GigabitEthernet 1/0/4.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] source-deny port gigabitethernet 1/0/1 to gigabitethernet 1/0/4

Related commands

mld-snooping source-deny

version (MLD-snooping view)

Use version to specify an MLD snooping version for VLANs.

Use undo version to restore the default.

Syntax

version version-number vlan vlan-list

undo version vlan vlan-list

Default

The MLD snooping version in a VLAN is 1.

Views

MLD-snooping 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 the specified VLANs before you execute this command.

You can specify the version for the specified VLANs in MLD-snooping view or for a VLAN in VLAN view. For a VLAN, the configuration in MLD-snooping view has the same priority as the configuration in VLAN view, and the most recent configuration takes effect.

Examples

# Enable MLD snooping for VLAN 2 through VLAN 10, and specify MLD snooping version 2 for these VLANs.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] enable vlan 2 to 10

[Sysname-mld-snooping] version 2 vlan 2 to 10

Related commands

enable (MLD-snooping view)

mld-snooping enable

mld-snooping version

IPv6 multicast routing and forwarding commands

The following matrix shows the feature and hardware compatibility:

Hardware	IPv6 multicast routing and forwarding compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/ MSR810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	IPv6 multicast routing and forwarding compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

Commands and descriptions for centralized devices apply to the following routers:

· MSR2600-6-X1/2600-10-X1.

· MSR 2630.

· MSR3600-28/3600-51.

· MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

· MSR 3610/3620/3620-DP/3640/3660.

Commands and descriptions for distributed devices apply to the following routers:

· MSR5620.

· MSR 5660.

· MSR 5680.

display ipv6 mrib interface

Use display ipv6 mrib interface to display information about interfaces maintained by the IPv6 MRIB.

Syntax

display ipv6 mrib [ vpn-instance vpn-instance-name ] 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 on the public network.

<Sysname> display ipv6 mrib interface

Interface: GigabitEthernet1/0/1

Index: 0x00000001

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

Table 65 Command output

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: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA 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 address	Remote end IP address. This field is displayed only when the interface is vlink type.
Reference	Number of times that the address has been used.
State	Status of the interface address: NORMAL or DEL.

display ipv6 multicast boundary

Use display ipv6 multicast boundary to display IPv6 multicast boundary information.

Syntax

display ipv6 multicast [ vpn-instance vpn-instance-name ] boundary { group [ ipv6-group-address [ prefix-length ] ] | scope [ scope-id ] } [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast boundary information on the public network.

group: Displays the IPv6 multicast boundary information for the specified groups.

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. If you do not specify an IPv6 multicast group, this command displays IPv6 multicast boundary information for all IPv6 multicast groups.

prefix-length: Specifies an address prefix length in the range of 8 to 128. The default is 128.

scope: Displays the IPv6 multicast group boundary information in the admin-scoped zone.

scope-id: Specifies an admin-scope zone by its ID in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address. If you do not specify an admin-scoped zone, this command displays IPv6 multicast boundary information for all IPv6 admin-scoped zones.

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 on the public network.

<Sysname> display ipv6 multicast boundary group

Boundary Interface

FF1E::/64 GE1/0/1

# Display IPv6 multicast boundary information in all IPv6 admin-scope zones for all interfaces on the public network.

<Sysname> display ipv6 multicast boundary scope

Boundary Interface

3 GigabitEthernet1/0/1

Table 66 Command output

Field	Description
Boundary	IPv6 multicast group or IPv6 admin-scoped zone associated with the IPv6 multicast boundary.
Interface	Boundary interface associated with the IPv6 multicast boundary.

Related commands

ipv6 multicast boundary

display ipv6 multicast fast-forwarding cache

Use display ipv6 multicast fast-forwarding cache to display IPv6 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] * [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast fast forwarding entries on the public network.

ipv6-source-address: Specifies an IPv6 multicast source address.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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 fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display IPv6 multicast fast forwarding entries on the public network.

<Sysname> display ipv6 multicast fast-forwarding cache

Total 1 entries, 1 matched

(FE1F:60::200, FF0E::1)

Status : Enabled

Source port: 2001 Destination port: 2002

Protocol : 2 Flag : 0x2

Incoming Interface: GigabitEthernet2/0/6

List of 1 outgoing interfaces:

GigabitEthernet3/0/2

Status: Enabled Flag: 0x14

Table 67 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries, and the total number of matching (S, G) entries.
(FE1F:60::200, FF0E::1)	(S, G) entry.
Protocol	Protocol number.
Flag	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. 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. · 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.
Status	Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable.
Incoming interface	Incoming interface of the (S, G) entry.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry.

Related commands

reset ipv6 multicast fast-forwarding cache all

display ipv6 multicast forwarding df-info

Use display ipv6 multicast forwarding df-info to display DF information.

Syntax

Centralized devices in standalone mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ipv6-rp-address: Specifies an IPv6 BIDIR-PIM RP by its IPv6 address.

verbose: Displays detailed information. If you do not specify the keyword, this command displays brief information.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays DF information for the MPU. (Distributed devices in standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays DF information for the global active MPU. (Distributed devices in IRF mode.)

Usage guidelines

In an IPv6 BIDIR-PIM domain, only the DF on each subnet can forward IPv6 multicast data destined for an IPv6 multicast group toward the RP of the group. For more information about DFs, see IP Multicast Configuration Guide.

Examples

# Display brief DF information on the public network. This example uses an ADVPN network.

<Sysname> display ipv6 multicast forwarding df-info

Total 1 RPs, 1 matched

00001. RP address: 2::2

Flags: 0x0

Uptime: 00:00:14

RPF interface: LoopBack0

List of 2 DF interfaces:

1: Tunnel0, FE80::1

2: Tunnel0, FE80::3

# Display brief information about DFs on the public network.

<Sysname> display ipv6 multicast forwarding df-info

Total 1 RPs, 1 matched

00001. RP address: 7:11::1

Flags: 0x0

Uptime: 01:46:40

RPF interface: GigabitEthernet1/0/1

List of 1 DF interface:

1: GigabitEthernet1/0/2

# Display detailed information about DFs on the public network.

<Sysname> display ipv6 multicast forwarding df-info verbose

Total 1 RPs, 1 matched

00001. RP address: 7:11::1

MID: 2, Flags: 0x0

Uptime: 00:03:53

Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184

RPF interface: GigabitEthernet1/0/1

Product information: 0xa567d6fc, 0xadeb03e3

Tunnel information: 0xdfb107d4, 0x7aa5d510

List of 1 DF interface:

1: GigabitEthernet1/0/2

Product information: 0xa986152b, 0xb74a9a2f

Tunnel information: 0x297ca208, 0x76985b89

Table 68 Command output

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	IPv6 address of the RP.
MID	ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID.
Flags	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. · 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.
Tunnel0, FE80::1	ADVPN tunnel interface, and the IPv6 link-local address of the remote end.

display ipv6 multicast forwarding event

Use display ipv6 multicast forwarding event to display statistics of IPv6 multicast forwarding events.

Syntax

Centralized devices in standalone mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of IPv6 multicast forwarding events on the public network.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of IPv6 multicast forwarding events for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays statistics of IPv6 multicast forwarding events for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display statistics of IPv6 multicast forwarding events on the public network.

<Sysname> display ipv6 multicast forwarding event

Total entry active events sent: 0

Total entry 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

Table 69 Command output

Field	Description
Total entry active events sent	Number of times that entry-active events have been sent.
Total entry 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.
WrongIF rate limit	Rate limit for sending WrongIF events, in packets per 10 seconds.
Total timer of register suppress timeout	Number of times that the registration suppression has timed out in total.

Related commands

reset ipv6 multicast forwarding event

display ipv6 multicast forwarding-table

Use display ipv6 multicast forwarding-table to display IPv6 multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] 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 | statistics ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

Distributed devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | chassis chassis-number slot slot-number | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast forwarding entries on the public network.

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 a card by its slot number. If you do not specify a card, this command displays IPv6 multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

statistics: Displays statistics for the IPv6 multicast forwarding table.

Examples

# Display IPv6 multicast forwarding entries on the public network. This example uses an ADVPN network.

<Sysname> display ipv6 multicast forwarding-table

Total 1 entries, 1 matched

00001. (1::1, ff0e::1)

Flags: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

Incoming interface: Tunnel1, FE80::20:11

List of 1 outgoing interfaces:

1: Tunnel1, FE80::20:12

2: Tunnel1, FE80::20:13

Matched 19648 packets(20512512 bytes), Wrong If 0 packet

Forwarded 19648 packets(20512512 bytes)

# Display IPv6 multicast forwarding entries on the public network.

<Sysname> display ipv6 multicast forwarding-table

Total 1 entries, 1 matched

00001. (1::1, ff0e::1)

Flags: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

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)

Table 70 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries, and the total number of matching (S, G) entries.
00001	Sequence number of the (S, G) entry.
(1::1, ff0e::1)	(S, G) entry.
Flags	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 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. · 0x20000000—The entry is an IPv6 BIDIR-PIM forwarding entry.
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	Incoming sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.
Outgoing sub-VLAN	Outgoing sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry.
Sub-VLAN	Outgoing sub-VLAN of the super VLAN when the outgoing interface of the (S, G) entry is the VLAN interface of this super VLAN.
Tunnel1, FE80::20:12	ADVPN tunnel interface, and the IPv6 link-local address of the remote end.
Matched 19648 packets (20512512 bytes), Wrong If 0 packet	Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.
Forwarded 19648 packets (20512512 bytes)	Number of packets (bytes) that have been forwarded. 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

display ipv6 multicast forwarding-table df-list

Use display ipv6 multicast forwarding-table df-list to display information about the DF list in IPv6 multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in IPv6 multicast forwarding entries on the public network.

ipv6-group-address: Specifies an IPv6 multicast 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.

verbose: Displays detailed information. If you do not specify the keyword, this command displays brief information.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the DF list in IPv6 multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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 the DF list in IPv6 multicast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about the DF list in IPv6 multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display brief information about the DF list in IPv6 multicast forwarding entries on the public network.

<Sysname> display ipv6 multicast forwarding-table df-list

Total 1 entries, 1 matched

00001. (::, FF1E::1)

List of 1 DF interfaces:

1: GigabitEthernet1/0/1

# Display detailed information about the DF list in IPv6 multicast forwarding entries on the public network.

<Sysname> display ipv6 multicast forwarding-table df-list verbose

Total 1 entries, 1 matched

00001. (::, FF1E::1)

List of 1 DF interfaces:

1: GigabitEthernet1/0/1

Product information: 0x347849f6, 0x14bd6837

Tunnel information: 0xc4857986, 0x128a9c8f

Table 71 Command output

Field	Description
Total 1 entries, 1 matched	Total number of entries, and the total number of matching entries.
00001	Sequence number of the entry.
(::, FF1E::1)	(*, G) entry.
List of 1 DF interfaces	DF interface list.

display ipv6 multicast routing-table

Use display ipv6 multicast routing-table to display IPv6 multicast routing entries.

Syntax

display ipv6 multicast [ vpn-instance vpn-instance-name ] routing-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 ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast routing entries on the public network.

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 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: Displays the IPv6 routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

outgoing-interface: Displays the IPv6 routing entries that contain the specified outgoing interface.

exclude: Displays the IPv6 routing entries that do not contain the specified interface in the outgoing interface list.

include: Displays the IPv6 routing entries that contain the specified interface in the outgoing interface list.

match: Displays the IPv6 routing entries that contain only the specified interface in the outgoing interface list.

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 on the public network. This example uses an ADVPN network.

<Sysname> display ipv6 multicast routing-table

Total 1 entries

00001. (2001::2, FFE3::101)

Uptime: 00:00:14

Upstream Interface: Tunnel1, FE80::20:11

List of 2 downstream interfaces

1: Tunnel1, FE80::20:12

2: Tunnel1, FE80::20:13

# Display IPv6 multicast routing entries on the public network.

<Sysname> display ipv6 multicast routing-table

Total 1 entries

00001. (2001::2, FFE3::101)

Uptime: 00:00:14

Upstream Interface: GigabitEthernet1/0/1

List of 2 downstream interfaces

1: GigabitEthernet1/0/2

2: GigabitEthernet1/0/3

Table 72 Command output

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.
Tunnel11, FE80::20:12	ADVPN tunnel interface, and the IPv6 link-local address of the remote end.

Related commands

reset ipv6 multicast routing-table

display ipv6 multicast rpf-info

Use display ipv6 multicast rpf-info to display RPF information for an IPv6 multicast source.

Syntax

display ipv6 multicast [ vpn-instance vpn-instance-name ] rpf-info ipv6-source-address [ ipv6-group-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for an IPv6 multicast source on the public network.

ipv6-source-address: Specifies an IPv6 multicast source address.

ipv6-group-address: Specifies an IPv6 multicast group address in the range of 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 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: GigabitEthernet1/0/1, 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

Table 73 Command output

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.
Referenced route type	Type of the referenced route: · igp—IPv6 IGP unicast route. · egp—IPv6 EGP unicast route. · unicast (direct) —IPv6 directly connected unicast route. · unicast—Other IPv6 unicast route, such as IPv6 unicast static route. · mbgp—IPv6 MBGP route.
Route selection rule	RPF route selection rule: · Route preference. · Longest prefix match.
Load splitting rule	Whether load splitting is enabled.

Related commands

display ipv6 multicast forwarding-table

display ipv6 multicast routing-table

ipv6 multicast boundary

Use ipv6 multicast boundary to configure an IPv6 multicast forwarding boundary.

Use undo ipv6 multicast boundary to delete an IPv6 multicast forwarding boundary.

Syntax

ipv6 multicast boundary { ipv6-group-address prefix-length | scope { scope-id | admin-local | global | organization-local | site-local } }

undo ipv6 multicast boundary { ipv6-group-address prefix-length| all | scope { scope-id | admin-local | global | organization-local | site-local } }

Default

An interface is not an IPv6 multicast forwarding boundary.

Views

Interface view

Predefined user roles

network-admin

Parameters

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 in the range of 8 to 128.

all: Specifies all IPv6 multicast boundaries configured on the interface.

scope-id: Specifies the ID of an admin-scoped zone, in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address.

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 GigabitEthernet 1/0/1 as the forwarding boundary of IPv6 multicast groups in the range of FF03::/16.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 multicast boundary ff03:: 16

# Configure GigabitEthernet 1/0/1 as the forwarding boundary of IPv6 multicast groups in the admin-local scope.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 multicast boundary scope 4

Related commands

display ipv6 multicast boundary

ipv6 multicast routing

Use ipv6 multicast routing to enable IPv6 multicast routing and enter IPv6 MRIB view.

Use undo ipv6 multicast routing to disable IPv6 multicast routing.

Syntax

ipv6 multicast routing [ vpn-instance vpn-instance-name ]

undo ipv6 multicast routing [ vpn-instance vpn-instance-name ]

Default

IPv6 multicast routing is disabled.

Views

System view

Predefined user roles

network-admin

parameters

Usage guidelines

Other Layer 3 IPv6 multicast commands take effect only when IPv6 multicast routing is enabled.

The device does not forward any IPv6 multicast packets before IPv6 multicast routing is enabled.

Examples

# Enable IPv6 multicast routing on the public network, and enter IPv6 MRIB view.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6]

# Enable IPv6 multicast routing for VPN instance mvpn, and enter IPv6 MRIB view.

<Sysname> system-view

[Sysname] ipv6 multicast routing vpn-instance mvpn

[Sysname-mrib6-mvpn]

load-splitting (IPv6 MRIB view)

Use load-splitting to enable load splitting of IPv6 multicast traffic.

Use multicast load-splitting to restore the default.

Syntax

load-splitting { source | source-group }

undo load-splitting

Default

IPv6 multicast load splitting is disabled.

Views

IPv6 MRIB view

Predefined user roles

network-admin

Parameters

source: Specifies IPv6 multicast load splitting on a per-source basis.

source-group: Specifies IPv6 multicast load splitting on a per-source basis and on a per-group basis.

Usage guidelines

This command does not take effect on IPv6 BIDIR-PIM.

Examples

# Enable load splitting of IPv6 multicast traffic on a per-source basis on the public network.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] load-splitting source

longest-match (IPv6 MRIB view)

Use longest-match to specify the longest prefix match principle for RPF route selection.

Use undo longest-match to restore the default.

Syntax

longest-match

undo longest-match

Default

Route preference is used for RPF route selection. The route with the highest route preference is used as the RPF route.

Views

IPv6 MRIB view

Predefined user roles

network-admin

Usage guidelines

This command enables the router to use the matching route with the longest prefix as the RPF route.

Examples

# Specify the longest prefix match principle for RPF route selection on the public network.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] longest-match

reset ipv6 multicast fast-forwarding cache

Use reset ipv6 multicast fast-forwarding cache to clear IPv6 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all } [ chassis chassis-number slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast fast forwarding entries on the public network.

ipv6-source-address: Specifies an IPv6 multicast source address.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears IPv6 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

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. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears IPv6 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

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

reset ipv6 multicast forwarding event

Use reset ipv6 multicast forwarding event to clear statistics for IPv6 multicast forwarding events.

Syntax

reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the IPv6 multicast forwarding events on the public network.

Examples

# Clear statistics for the IPv6 multicast forwarding events on the public network.

<Sysname> reset ipv6 multicast forwarding event

Related commands

display ipv6 multicast forwarding event

reset ipv6 multicast forwarding-table

Use reset ipv6 multicast forwarding-table to clear IPv6 multicast forwarding entries.

Syntax

reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number } } * | all }

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast forwarding entries on the public network.

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 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 on the public network.

<Sysname> reset ipv6 multicast forwarding-table ff0e::1

Related commands

display ipv6 multicast forwarding-table

reset ipv6 multicast routing-table

Use reset ipv6 multicast routing-table to clear IPv6 multicast routing entries.

Syntax

reset ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number } * | all }

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast routing entries on the public network.

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.

incoming-interface: Specifies the IPv6 multicast routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

all: Specifies all IPv6 multicast routing entries.

Usage guidelines

When you clear an IPv6 multicast routing entry, the associated IPv6 multicast forwarding entry is also cleared.

Examples

# Clear IPv6 multicast routing entries for IPv6 multicast group FF03::101 on the public network.

<Sysname> reset ipv6 multicast routing-table ff03::101

Related commands

display ipv6 multicast routing-table

MLD commands

The following matrix shows the feature and hardware compatibility:

Hardware	MLD compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	MLD compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

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 [ vpn-instance vpn-instance-name ] 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, the 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, the 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 on the public network.

<Sysname> display mld group

MLD groups in total: 1

GigabitEthernet1/0/1(FE80::101):

MLD groups reported in total: 1

Group address: FF03::101

Last reporter: FE80::10

Uptime: 00:02:04

Expires: 00:01:15

Table 74 Command output

Field	Description
MLD groups in total	Total number of MLD multicast groups.
MLD groups reported in total	Total number of MLD multicast groups that the hosts attached to the interface have joined dynamically.
Group address	IPv6 multicast group address.
Last reporter	IPv6 address of the receiver host that last reported membership for the group.
Uptime	Length of time since the IPv6 multicast group was joined.
Expires	Remaining lifetime for the IPv6 multicast group. This field displays Off if the timer is disabled.

# Display detailed information about MLD multicast group FF3E::101 that hosts have statically joined on the public network. In this example, the router is configured with MLDv2.

<Sysname> display mld group ff3e::101 verbose

GigabitEthernet1/0/1(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

Table 75 Command output

Field	Description
MLD groups reported in total	Total number of MLD multicast groups that the hosts attached to the interface have joined dynamically.
Group	IPv6 multicast group address.
Uptime	Length of time since the IPv6 multicast group was reported.
Exclude expires	Remaining time for the IPv6 multicast group in Exclude mode. This field displays Off if the timer is disabled.
Mapping expires	Remaining time for the IPv6 multicast group specified in MLD SSM mappings. This field is displayed only when the device is configured with MLD SSM mappings.
Last reporter	IPv6 address of the receiver host that last reported membership for this group.
Last-listener-query-counter	Number of MLD multicast-address-specific queries or MLD multicast-address-and-source-specific queries sent for the group.
Last-listener-query-timer-expiry	Remaining time for the MLD last listener query timer for the multicast group. This field displays Off if the timer is disabled.
Mapping last-listener-query-counter	Number of MLD multicast-address-specific queries or MLD multicast-address-and-source-specific queries sent for the IPv6 multicast group specified in MLD SSM mappings. This field is displayed only when the device is configured with MLD SSM mappings.
Mapping last-listener-query-timer-expiry	Remaining time for the last listener query timer of the IPv6 multicast group specified in MLD SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with MLD SSM mappings.
Group mode	IPv6 multicast source filtering mode: · Include—Include mode. · Exclude—Exclude mode. For a device that runs MLDv1: · If MLD SSM mappings are not configured, this field displays Exclude. · If MLD SSM mappings are configured, this field displays Include or Exclude depending on the SSM mappings and the IPv6 multicast groups that the host joins.
Version1-host-present-timer-expiry	Remaining time for the MLDv1 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs MLDv2.
Source list (sources in total 1)	List of IPv6 multicast sources and total number of IPv6 multicast sources. This field is displayed only when the device runs MLDv2 or is configured with MLD SSM mappings.
Source	IPv6 multicast source address. This field is displayed only when the device runs MLDv2 or the device is configured with MLD SSM mappings.
Uptime	Length of time since the IPv6 multicast source was reported. This field is displayed only when the device runs MLDv2 or is configured with MLD SSM mappings.
V2 expires	Remaining time for the IPv6 multicast source when the device runs MLDv2. This field displays Off if the timer is disabled. This field displays three hyphens (---) if the IPv6 multicast source is specified in MLD SSM mappings. This field is displayed only when the device runs MLDv2 or is configured with MLD SSM mappings.
Mapping expires	Remaining time for the IPv6 multicast sources specified in MLD SSM mappings.
Last-listener-query-counter	Number of MLD multicast-address-specific queries or MLD multicast-address-and-source-specific queries sent for the IPv6 multicast source and group. This field is displayed only when the device runs MLDv2 or is configured with MLD SSM mappings.
Last-listener-query-timer-expiry	Remaining time for the last listener query timer for the IPv6 multicast source and group. 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 on the public network.

<Sysname> display mld group static

Entries in total: 2

(*, FF03::101)

Interface: GE1/0/1

Expires: Never

(2001::101, FF3E::202)

Interface: GE1/0/1

Expires: Never

Table 76 Command output

Field	Description
Entries in total	Total number of the IPv6 multicast groups that hosts have joined statically.
(*, FF03::101)	(*, G) entry.
(2001::101, FF3E::202)	(S, G) entry.
Expires	Remaining lifetime for the IPv6 multicast group. This field always displays Never, which means that the IPv6 multicast group never expires.

Related commands

reset mld group

display mld interface

Use display mld interface to display MLD information for interfaces.

Syntax

display mld [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ proxy ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays MLD information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays MLD information for all interfaces.

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 GigabitEthernet 1/0/1 (non-proxy interface) on the public network.

<Sysname> display mld interface gigabitethernet 1/0/1 verbose

GigabitEthernet1/0/1(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

Authorization: Disabled

Join-by-session: Disabled

User-VLAN-aggregation: Disabled

MLD groups reported in total: 1

# Display detailed MLD information for all MLD proxy interfaces on the public network.

<Sysname> display mld interface proxy verbose

GigabitEthernet1/0/2(FE80::100:CEF:FE01:101):

MLD proxy is enabled.

MLD version: 1

IPv6 multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

Table 77 Command output

Field	Description
GigabitEthernet1/0/1(FE80::200:AFF:FE01:101)	Interface and its IPv6 link-local address. (on a router)
MLD is enabled	MLD is enabled on the interface.
MLD version	Version of MLD that the interface runs.
Query interval for MLD	MLD query interval, in seconds.
Other querier present time for MLD	MLD other querier present interval, in seconds.
Maximum query response time for MLD	Maximum response time for MLD general query messages, in seconds.
Last listener query interval	Interval for sending MLD multicast-address-specific queries or MLD multicast-address-and-source-specific queries, in seconds.
Last listener query count	Number of MLD multicast-address-specific queries or 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.
General query timer expiry	Remaining time for the MLD general query timer. This field displays Off if the timer is disabled.
Querier for MLD	IPv6 link-local address of the MLD querier.
MLD activity: 1 join(s), 0 done(s)	MLD activity statistics: · join(s)—Total number of IPv6 multicast groups that the interface has joined. · done(s)—Total number of IPv6 multicast groups that the interface has left.
IPv6 multicast routing on this interface	Whether IPv6 multicast routing is enabled: Enabled or Disabled.
Robustness	Robustness variable of the MLD querier.
Require-router-alert	Whether the feature of dropping MLD messages without Router-Alert is enabled: Enabled or Disabled.
Fast-leave	Whether fast-leave processing is enabled: Enabled or Disabled.
Startup-query	Whether the MLD querier sends MLD general queries at the startup query interval on startup: · On—The MLD querier performs the above action. · Off—The MLD querier does not perform the above action.
Other-querier-present-timer-expiry	Remaining time for MLD other querier present timer. This field displays Off if the timer is disabled.
Join-by-session	Whether the per-session IPv6 multicast forwarding feature is enabled: Enabled or Disabled. Support for this field depends on the device model.
User-VLAN-aggregation	Whether the IPv6 multicast packet VLAN tagging feature is enabled: Enabled or Disabled. Support for this field depends on the device model.
MLD groups reported in total	Total number of IPv6 multicast groups that the interface has joined dynamically. This field is not displayed if the interface does not join IPv6 multicast groups.
MLD proxy is enabled	MLD proxying is enabled.
Version1-querier-present-timer-expiry	Remaining time for the MLDv1 querier present timer. This field displays Off if the timer is disabled.

display mld proxy group

Use display mld proxy group to display information about IPv6 multicast groups maintained by the MLD proxy.

Syntax

display mld [ vpn-instance vpn-instance-name ] proxy group [ ipv6-group-address | interface interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about IPv6 multicast groups maintained by the MLD proxy on the public network.

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, the 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, the 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 on the public network.

<Sysname> display mld proxy group

MLD proxy group records in total: 2

GigabitEthernet1/0/1(FE80::16:1):

MLD proxy group records in total: 2

Group address: FF1E::1

Member state: Idle

Expires: Off

Group address: FF1E::2

Member state: Idle

Expires: Off

# Display detailed information about IPv6 multicast group FF1E::1 maintained by the MLD proxy on the public network.

<Sysname> display mld proxy group ff1e::1 verbose

GigabitEthernet1/0/1(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

Table 78 Command output

Field	Description
MLD proxy group records in total	Total number of IPv6 multicast group membership entries maintained by the MLD proxy.
GigabitEthernet1/0/1(FE80::16:1)	Interface and its IPv6 address. (on a router)
Pending proxy group	Pending IPv6 multicast group membership entries maintained by the MLD proxy.
Group address/Group	IPv6 multicast group address.
Member state	Member host states: · Delay—The member host has joined a group and started a delay timer. · Idle—The member host has joined a group, but didn't start a delay timer.
Expires	Remaining delay time for a member host to send a responding report. This field displays Off if the timer is disabled.
Group mode	IPv6 multicast source filtering mode: · Include. · Exclude.
Source list (sources in total: 1)	List of IPv6 multicast sources in the group membership database maintained by the MLD proxy, and the total number of the IPv6 multicast sources.

display mld proxy routing-table

Use display mld proxy routing-table to display IPv6 multicast routing entries maintained by the MLD proxy.

Syntax

display mld [ vpn-instance vpn-instance-name ] proxy routing-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] ] * [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IPv6 multicast routing entries maintained by the MLD proxy on the public network.

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, the command displays IPv6 multicast routing entries for all IPv6 multicast groups maintained by the MLD proxy.

prefix-length: Specifies an address prefix length. For an IPv6 multicast source address, the value range for this argument is 0 to 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. The default value is 128.

verbose: Displays detailed information.

Examples

# Display IPv6 multicast routing entries maintained by the MLD proxy on the public network.

<Sysname> display mld proxy routing-table

Total 1 (*, G) entries, 2 (S, G) entries.

(100::1, FF1E::1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: MLD

(*, FF1E::2)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

(2::2, FF1E::2)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

2: GigabitEthernet1/0/2

Protocol: PROXY

# Display detailed information about IPv6 multicast routing entries maintained by the MLD proxy on the public network.

<Sysname> display mld proxy routing-table verbose

Total 1 (*, G) entries, 2 (S, G) entries.

(100::1, FF1E::1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: MLD

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces: None

(*, FF1E::2)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces (1 in total):

1: GigabitEthernet1/0/3

Protocol: MLD

Querier state: Non-querier

Join/Prune state: Join

(2::2, FF1E::2)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

Querier state: Querier

Join/Prune state: Join

2: GigabitEthernet1/0/2

Protocol: PROXY

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces: None

Table 79 Command output

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-downstream interfaces (1 in total)	Non-outgoing interfaces, and the total number of non-outgoing interfaces.
1: GigabitEthernet1/0/2	Index of an outgoing interface and the outgoing interface. (on a router)
Protocol	Protocol type: · MLD—Dynamic MLD. · PROXY—MLD proxy. · STATIC—Static MLD.
Querier state	Querier state: · Querier. · Non-querier.
Join/Prune state	Joined or pruned state of the interface: · NI—Default state. · Join—Joined state. · Prune—Pruned state.

display mld ssm-mapping

Use display mld ssm-mapping to display MLD SSM mappings.

Syntax

display mld [ vpn-instance vpn-instance-name ] ssm-mapping ipv6-group-address

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays MLD SSM mappings on the public network.

Examples

# Display MLD SSM mappings for IPv6 multicast group FF3E::101 on the public network.

<Sysname> display mld ssm-mapping ff3e::101

Group: FF3E::101

Source list:

1::1

1::2

10::1

100::10

Table 80 Command output

Fields	Description
Group	IPv6 multicast group address.
Source list	List of IPv6 multicast source addresses.

last-listener-query-count (MLD view)

Use last-listener-query-count to set the MLD last listener query count globally.

Use undo last-listener-query-count to restore the default.

Syntax

mld last-member-query-count count

undo mld last-member-query-count

Default

The MLD last listener query count equals the MLD querier's robustness variable.

Views

MLD view

Predefined user roles

network-admin

Parameters

Usage guidelines

You can set the MLD last listener 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 last listener query count to 6 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] last-listener-query-count 6

Related commands

mld last-listener-query-count

last-listener-query-interval (MLD view)

Use last-listener-query-interval to set the MLD last listener query interval globally.

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

Syntax

last-listener-query-interval interval

undo last-listener-query-interval

Default

The MLD last listener query interval is 1 second.

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 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] last-listener-query-interval 6

Related commands

mld last-listener-query-interval

max-response-time (MLD view)

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

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

Syntax

max-response-time time

undo max-response-time

Default

The maximum response time for MLD general queries is 10 seconds.

Views

MLD 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 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 maximum response time for MLD general queries to 25 seconds on the public network.

<Sysname> system-view

[Sysname] mld

[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 [ vpn-instance vpn-instance-name ]

undo mld [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command takes effect on the public network.

Examples

# Enter MLD view of the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld]

# Enter MLD view of the VPN instance mvpn.

<Sysname> system-view

[Sysname] mld vpn-instance mvpn

[Sysname-mld-mvpn]

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 on the public network, and enable MLD for GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 send leave notifications to the upstream routers without sending multicast-address-specific or multicast-address-and-source-specific queries after receiving done messages.

When you configure a rule in the IPv6 basic 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-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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld fast-leave

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 IPv6 multicast group policies.

Syntax

mld group-policy ipv6-acl-number [ version-number ]

undo mld group-policy

Default

No IPv6 multicast group policies exist on an interface, and 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 controls the IPv6 multicast groups that the receiver hosts can join by filtering MLD messages. It does not take effect on a static member interface because a static member interface does not send MLD messages.

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.

To match the following MLD reports, set the source source-address source-prefix option to 0::0:

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

Examples

# Configure an IPv6 multicast group policy on GigabitEthernet 1/0/1 so that hosts attached to the interface can join only IPv6 multicast group FF03::101.

<Sysname> system-view

[Sysname] acl ipv6 basic 2005

[Sysname-acl-ipv6-basic-2005] rule permit source ff03::101 128

[Sysname-acl-ipv6-basic-2005] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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.

Examples

# Set the maximum response time for MLD general queries to 25 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

Usage guidelines

The following matrix shows the command and hardware compatibility:

Hardware	Command compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	No
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR5620/5660/5680	Yes

Hardware	Command compatibility
MSR810-LM-GL	No
MSR810-W-LM-GL	No
MSR830-6EI-GL	No
MSR830-10EI-GL	No
MSR830-6HI-GL	No
MSR830-10HI-GL	No
MSR2600-6-X1-GL	No
MSR3600-28-SI-GL	No

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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld other-querier-present-timeout 125

Related commands

other-querier-present-timeout (MLD view)

mld proxy enable

Use mld proxy enable to enable MLD proxying on an interface.

Use undo mld proxy enable to disable MLD proxying on an interface.

Syntax

mld proxy enable

undo mld proxy enable

Default

MLD proxying 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.

Examples

# Enable IPv6 multicast routing on the public network, and enable MLD proxying on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld proxy enable

Related commands

ipv6 multicast routing

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 GigabitEthernet 1/0/1 (non-querier interface).

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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.

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld robust-count 5

Related commands

robust-count (MLD view)

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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not specify an IPv6 multicast source, the 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 GigabitEthernet 1/0/1 as a static group member of IPv6 multicast group FF03::101.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld static-group ff03::101

# Configure GigabitEthernet 1/0/1 as a static group member of IPv6 multicast source and group (2001::101, FF3E::202).

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld static-group ff3e::202 source 2001::101

# Enable per-session IPv6 multicast forwarding on GigabitEthernet 1/0/1.1. Configure the subinterface as a static group member of IPv6 multicast group FF03::101 for users with outer VLAN ID 10 and inner VLAN IDs in the range of 10 to 20.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] mld join-by-session

[Sysname-GigabitEthernet1/0/1.1] mld static-group ff03::101 dot1q vid 10 second-dot1q 10 to 20

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld version 2

other-querier-present-timeout (MLD view)

Use other-querier-present-timeout to set the MLD other querier present timer globally.

Use undo other-querier-present-timeout to restore the default.

Syntax

other-querier-present-timeout time

undo 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

MLD view

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 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] other-querier-present-timeout 125

Related commands

mld other-querier-present-timeout

proxy multipath (MLD view)

Use proxy multipath to enable load splitting on the MLD proxy.

Use undo proxy multipath to disable load splitting on the MLD proxy.

Syntax

proxy multipath

undo proxy multipath

Default

The load splitting feature is disabled on the MLD proxy.

Views

MLD view

Predefined user roles

network-admin

Usage guidelines

Use this feature when the MLD proxy has multiple proxy interfaces. All proxy interfaces on the MLD proxy share IPv6 multicast traffic on a per-group basis. If you do not enable this feature, only the proxy interface with the highest IPv6 address forwards IPv6 multicast traffic.

Examples

# Enable load splitting on the MLD proxy device on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] proxy multipath

query-interval (MLD view)

Use query-interval to set the MLD general query interval globally.

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 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] query-interval 60

Related commands

mld query-interval

reset mld group

Use reset mld group to clear dynamic MLD multicast group entries.

Syntax

reset mld [ vpn-instance vpn-instance-name ] group { all | interface interface-type interface-number { all | ipv6-group-address [ prefix-length ] [ ipv6-source-address [ prefix-length ] ] } }

Views

User view

Predefined user roles

network-admin

Parameters

all: The first all specifies all interfaces, and the second all specifies all MLD multicast groups.

interface-type interface-number: Specifies an interface by its type and number.

ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address. If you do not specify an IPv6 multicast source, the command deletes 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 groups for all interfaces on the public network.

<Sysname> reset mld group all

# Clear all dynamic MLD multicast group entries for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset mld group interface gigabitethernet 1/0/1 all

# Clear the dynamic entry of MLD multicast group FF03::101:10 for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset mld group interface gigabitethernet 1/0/1 ff03::101:10

Related commands

display mld group

robust-count (MLD view)

Use robust-count to set the MLD querier's robustness variable globally.

Use undo robust-count to restore the default.

Syntax

robust-count count

undo robust-count

Default

The MLD querier's robustness variable is 2.

Views

MLD view

Predefined user roles

network-admin

Parameters

Usage guidelines

You can set the MLD querier's robustness variable 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 querier's robustness variable to 5 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] robust-count 5

Related commands

mld robust-count

ssm-mapping (MLD view)

Use ssm-mapping to configure an MLD SSM mapping.

Use undo ssm-mapping to delete MLD SSM mappings.

Syntax

ssm-mapping ipv6-source-address ipv6-acl-number

undo ssm-mapping { ipv6-source-address | all }

Default

No MLD SSM mappings exist.

Views

MLD view

Predefined user roles

network-admin

Parameters

ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address.

ipv6-acl-number : Specifies an IPv6 basic ACL number in the range of 2000 to 2999. In MLD SSM mappings, the specified IPv6 multicast source is associated with IPv6 multicast groups that the ACL permits. The IPv6 multicast source is not associated with any IPv6 multicast groups if the ACL does not exist or does not have valid rules.

all: Specifies all MLD SSM mappings.

Usage guidelines

When you configure a rule in the IPv6 basic 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-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

# Configure an MLD SSM mapping with IPv6 multicast source 1::1 and IPv6 multicast group range FF3E::/64.

<Sysname> system-view

[Sysname] acl ipv6 basic 2001

[Sysname-acl-ipv6-basic-2001] rule permit source ff3e:: 64

[Sysname-acl-ipv6-basic-2001] quit

[Sysname] mld

[Sysname-mld] ssm-mapping 1::1 2001

Related commands

display mld ssm-mapping

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

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 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] startup-query-count 5

Related commands

mld startup-query-count

startup-query-interval (MLD view)

Use startup-query-interval to set the MLD startup query interval globally.

Use undo startup-query-interval to restore the default.

Syntax

startup-query-interval interval

undo startup-query-interval

Default

The MLD startup query interval equals one quarter of the MLD general query interval.

Views

MLD view

Predefined user roles

network-admin

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 on the public network.

<Sysname> system-view

[Sysname] mld

[Sysname-mld] startup-query-interval 100

Related commands

mld startup-query-interval

IPv6 PIM commands

The following matrix shows the feature and hardware compatibility:

Hardware	IPv6 PIM compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	Yes
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR5620/5660/5680	Yes

Hardware	IPv6 PIM compatibility
MSR810-LM-GL	Yes
MSR810-W-LM-GL	Yes
MSR830-6EI-GL	Yes
MSR830-10EI-GL	Yes
MSR830-6HI-GL	Yes
MSR830-10HI-GL	Yes
MSR2600-6-X1-GL	Yes
MSR3600-28-SI-GL	No

anycast rp (IPv6 PIM view)

Use anycast-rp to configure an Anycast RP.

Use undo anycast-rp to remove an Anycast RP.

Syntax

anycast-rp ipv6-anycast-rp-address ipv6-member-address

undo anycast-rp ipv6-anycast-rp-address ipv6-member-address

Default

No Anycast RPs 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.

Usage guidelines

To add multiple RP member addresses to an Anycast RP set, use this command repeatedly with the same Anycast RP address but different RP member addresses.

An RP member address must be different from the Anycast RP address.

Examples

# On the public network, specify 1:1::0 as the Anycast RP address, and specify 1:1::1 and 1:2::1 as member addresses.

<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

bidir-pim enable (IPv6 PIM view)

Use bidir-pim enable to enable IPv6 BIDIR-PIM.

Use undo bidir-pim enable to disable IPv6 BIDIR-PIM.

Syntax

bidir-pim enable

undo bidir-pim enable

Default

IPv6 BIDIR-PIM is disabled.

Views

IPv6 PIM view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IPv6 multicast routing is enabled.

Examples

# Enable IPv6 multicast routing on the public network, and enable IPv6 BIDIR-PIM.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] ipv6 pim

[Sysname-pim6] bidir-pim enable

Related commands

ipv6 multicast routing

bidir-rp-limit (IPv6 PIM view)

Use bidir-rp-limit to set the maximum number of IPv6 BIDIR-PIM RPs.

Use undo bidir-rp-limit to restore the default.

Syntax

bidir-rp-limit limit

undo bidir-rp-limit

Default

The upper limit is 6.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of IPv6 BIDIR-PIM RPs, in the range of 1 to the number allowed by the system.

The following matrix shows the limit argument and hardware compatibility:

Hardware	Argument compatibility	Value range
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No	N/A
MSR2600-6-X1/2600-10-X1	Yes	1 to 64
MSR 2630	Yes	1 to 64
MSR3600-28/3600-51	Yes	1 to 64
MSR3600-28-SI/3600-51-SI	No	N/A
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes	1 to 128
MSR 3610/3620/3620-DP/3640/3660	Yes	1 to 128
MSR5620/5660/5680	Yes	1 to 256

Hardware	Argument compatibility	Value range
MSR810-LM-GL	Yes	1 to 64
MSR810-W-LM-GL	Yes	1 to 64
MSR830-6EI-GL	Yes	1 to 64
MSR830-10EI-GL	Yes	1 to 64
MSR830-6HI-GL	Yes	1 to 64
MSR830-10HI-GL	Yes	1 to 64
MSR2600-6-X1-GL	Yes	1 to 64
MSR3600-28-SI-GL	No	N/A

Usage guidelines

In an IPv6 BIDIR-PIM domain, one DF election per RP is implemented on all IPv6 PIM-enabled interfaces. As a best practice to avoid unnecessary DF elections, do not configure multiple BIDIR-PIM RPs.

This configuration sets a limit on the number of IPv6 BIDIR-PIM RPs. If the number of RPs exceeds the limit, extra RPs do not take effect and can be used only for DF election rather than IPv6 multicast data forwarding.

Examples

# Set the maximum number of IPv6 BIDIR RPs to 3 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] bidir-rp-limit 3

bsm-fragment enable (IPv6 PIM view)

Use bsm-fragment enable to enable bootstrap message (BSM) semantic fragmentation.

Use undo bsm-fragment enable to disable BSM semantic fragmentation.

Syntax

bsm-fragment enable

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 or IPv6 BIDIR-PIM domain contains a device that does not support BSM semantic fragmentation.

Examples

# Disable BSM semantic fragmentation on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] undo bsm-fragment enable

bsm-reflection enable (IPv6 PIM view)

Use bsm-reflection enable to enable the device to forward BSMs out of incoming interfaces.

Use undo bsm-reflection enable to disable the device to forward BSMs out of incoming interfaces.

Syntax

bsm-reflection enable

undo bsm-reflection enable

Default

The device is enabled to forward BSMs out of incoming interfaces.

Views

IPv6 PIM view

Predefined user roles

network-admin

Usage guidelines

Disable this feature if all the routers in the IPv6 PIM-SM or IPv6 BIDIR-PIM domain have consistent routing information.

Examples

# Disable the device to forward BSMs out of incoming interfaces on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] undo bsm-reflection enable

bsr-policy (IPv6 PIM view)

Use bsr-policy to configure a BSR policy to guard against BSR spoofing.

Use undo bsr-policy to restore the default.

Syntax

bsr-policy ipv6-acl-number

undo bsr-policy

Default

No BSR policies exist, 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

When you configure a rule in the IPv6 basic 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-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.

Examples

# On the public network, configure a BSR policy so that only the devices on the subnet of 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)

bsr-rp-mapping rfc2362 (IPv6 PIM view)

Use bsr-rp-mapping rfc2362 to configure the device to use the BSR RP hash algorithm described in RFC 2362.

Use undo bsr-rp-mapping rfc2362 to restore the default.

Syntax

bsr-rp-mapping rfc2362

undo bsr-rp-mapping rfc2362

Default

The device uses the BSR RP hash algorithm described in RFC 4601.

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 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] bsr-rp-mapping rfc2362

c-bsr (IPv6 PIM view)

Use c-bsr to configure a candidate-BSR (C-BSR).

Use undo c-bsr to remove the configuration of a C-BSR.

Syntax

c-bsr ipv6-address [ scope scope-id ] [ hash-length hash-length | priority priority ] *

undo c-bsr ipv6-address [ scope scope-id ]

Default

No C-BSRs exist.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies the IPv6 address of a C-BSR. You must specify the IPv6 address of a local IPv6 PIM interface.

scope scope-id: Specifies an IPv6 admin-scoped zone by its ID in the range of 3 to 15. If you do not specify an IPv6 admin-scoped zone, the command designates the C-BSR to the global-scoped zone.

hash-length hash-length: Specifies a hash mask length in the range of 0 to 128. The default is 126.

priority priority: Specifies a C-BSR priority in the range of 0 to 255. The default 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 the IPv6 address 1101::1 as the C-BSR for the global-scoped zone on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] c-bsr 1101::1

c-rp (IPv6 PIM view)

Use c-rp to configure a candidate-RP (C-RP).

Use undo c-rp to remove the configuration of a C-RP.

Syntax

c-rp ipv6-address [ advertisement-interval adv-interval | { group-policy ipv6-acl-number | scope scope-id } | holdtime hold-time | priority priority ] * [ bidir ]

undo c-rp ipv6-address

Default

No C-RPs exist.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies the IPv6 address of a C-RP. You must specify the IPv6 address of a local IPv6 PIM interface.

advertisement-interval adv-interval: Specifies a C-RP advertisement message interval in the range of 1 to 65535 seconds. The default is 60 seconds.

group-policy ipv6-acl-number: Specifies an IPv6 basic ACL number by its number in the range of 2000 to 2999. If you specify an ACL, the command designates the C-RP to IPv6 multicast groups that the ACL permits. The C-RP is designated to 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.

scope scope-id: Specifies an IPv6 admin-scoped zone by its ID in the range of 3 to 15.

holdtime hold-time: Specifies a C-RP lifetime in the range of 1 to 65535 seconds. The default is 150 seconds.

priority priority: Specifies a C-RP priority in the range of 0 to 255. The default is 192. The greater the value, the lower the priority.

bidir: Specifies IPv6 BIDIR-PIM to which the C-RP is designated. If you do not specify this keyword, the C-RP provides services for IPv6 PIM-SM.

Usage guidelines

When you configure a rule in the IPv6 basic 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-prefix option specifies an IPv6 multicast group range.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

To designate a C-RP to multiple IPv6 multicast group ranges, create multiple rules that specify different IPv6 multicast group ranges in the ACL.

If you execute this command by using the same IPv6 address of a C-RP multiple times, the most recent configuration takes effect.

Examples

# On the public network, 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

crp-policy (IPv6 PIM view)

Use crp-policy to configure a C-RP policy to guard against C-RP spoofing.

Use undo crp-policy to restore the default.

Syntax

crp-policy ipv6-acl-number

undo crp-policy

Default

No C-RP policies exist, and all C-RP messages are regarded as legal.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

ipv6-acl-number: Specifies an IPv6 advanced ACL number in the range of 3000 to 3999.

Usage guidelines

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.

· The source source-address source-prefix option specifies an RP 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.

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 IPv6 multicast group range in a C-RP advertisement message is FF0E:0:1::/96. If the prefix FF0E:0:1:: is in the range specified by the destination field of an ACL rule, the specified C-RPs are designated to this IPv6 multicast group range.

Examples

# On the public network, 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)

display ipv6 pim bsr-info

Use display ipv6 pim bsr-info to display IPv6 PIM BSR information.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] bsr-info

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display IPv6 PIM BSR information on the public network.

<Sysname> display ipv6 pim bsr-info

Scope: non-scoped

State: Accept Preferred

Bootstrap timer: 00:01:44

Elected BSR address: 12:12::1

Priority: 64

Hash mask length: 126

Uptime: 00:21:56

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

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

Table 81 Command output

Field	Description
Bootstrap timer	Aging timer for the BSR.
Scope-zone expiry timer	Aging timer for the scoped zone.
Elected BSR address	Address of the elected BSR.
Candidate BSR address	Address of the C-BSR.
Priority	BSR priority.
Uptime	Length of time the BSR has been up.

display ipv6 pim claimed-route

Use display ipv6 pim claimed-route to display information about all routes that IPv6 PIM uses.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] claimed-route [ ipv6-source-address ]

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, the command displays information about all routes that IPv6 PIM uses.

Examples

# Display information about all routes that IPv6 PIM uses on the public network.

<Sysname> display ipv6 pim claimed-route

RPF-route selecting rule: longest-match

Route/mask: 7:11::/64 (unicast (direct))

RPF interface: GigabitEthernet1/0/1, RPF neighbor: 8::2

Total number of (S,G) or (*,G) dependent on this route entry: 4

(7:11::10, ff1e::1)

(7:11::10, ff1e::2)

(7:11::10, ff1e::3)

(*, ff1e::4)

Route/mask: 7:12::/64 (unicast)

RPF interface: GigabitEthernet1/0/1, RPF neighbor: 8::3,

Total number of (S,G) or (*,G) dependent on this route entry: 2

(7:12::10, ff1e::1)

(7:12::10, ff1e::2)

Table 82 Command output

Field	Description
Route/mask	Route entry. Route types in parentheses include: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Directly connected unicast route. · unicast—Other unicast route, such as static unicast route. · mbgp—IPv6 MBGP route.
RPF interface	Name of the RPF interface.
RPF neighbor	IPv6 address of the RPF neighbor.
Total number of (S,G) or (*,G) dependent on this route entry	Total number (S, G) or (*, G) entries associated with the RPF route and the entry list.

display ipv6 pim c-rp

Use display ipv6 pim c-rp to display C-RP information.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] c-rp [ local ]

Views

Any view

Predefined user roles

network-admin

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 on the public network.

<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

# Display information about the locally configured C-RPs.

<Sysname> display ipv6 pim c-rp local

Candidate RP: 8:12::2(Loop1)

Priority: 192

HoldTime: 150

Advertisement interval: 60

Next advertisement scheduled at: 00:00:46

Table 83 Command output

Field	Description
Group/MaskLen	IPv6 multicast group to which the C-RP is designated.
[B]	The C-RP is an IPv6 BIDIR-PIM RP. This field is not displayed if the C-RP is an IPv6 PIM-SM RP.
C-RP address	IPv6 address of the C-RP. If the C-RP resides on the device where the command is executed, this field displays (local) after the IPv6 address.
Priority	C-RP priority.
HoldTime	C-RP lifetime.
Uptime	Length of time the C-RP has been up: · w—Weeks. · d—Days. · h—Hours.
Expires	Remaining lifetime for the C-RP and the IPv6 multicast group.
Candidate RP	IPv6 address of the locally configured C-RP.
Advertisement interval	Interval between two advertisement messages sent by the locally configured C-RP.
Next advertisement scheduled at	Remaining time for the locally configured C-RP to send the next advertisement message.

display ipv6 pim df-info

Use display ipv6 pim df-info to display IPv6 BIDIR-PIM DF information.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] df-info [ ipv6-rp-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IPv6 BIDIR-PIM DF information on the public network.

ipv6-rp-address: Specifies an IPv6 BIDIR-PIM RP by its IPv6 address.

Examples

# Display IPv6 BIDIR-PIM DF information on the public network.

<Sysname> display ipv6 pim df-info

RP address: 12::12

Interface: GigabitEthernet1/0/4

State : Win DF preference: 10

DF metric : 1562 DF uptime : 00:07:15

DF address: FE80::202:FF:FE00:9 (local)

Interface: Tunnel0, FE80::20:12

State : Lose DF preference: 0

DF metric : 0 DF uptime : 00:07:15

DF address: FE80::20:12

Table 84 Command output

Field	Description
RP address	IP address of the IPv6 BIDIR-PIM RP.
Interface	DF interface. If the interface is an NBMA mode-enabled ADVPN tunnel interface, this field also displays the IPv6 link-local address of the remote end.
State	DF election state: · Win—The interface wins the DF election. · Lose—The interface loses the DF election. · Offer—The interface is in the initial state of the DF election. · Backoff—The interface is acting as the DF, but there are more appropriate devices running for the DF. If the interface does not participate in the DF election, this field displays a hyphen (-).
DF preference	Advertised route preference for DF election.
DF metric	Advertised route metric for DF election.
DF uptime	Length of time the DF has been up.
DF address	IPv6 address of the DF. If the DF resides on the device where the command is executed, this field displays (local) after the IPv6 address.

display ipv6 pim interface

Use display ipv6 pim interface to display IPv6 PIM information for interfaces.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IPv6 PIM information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the 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 on the public network.

<Sysname> display ipv6 pim interface

Interface NbrCnt HelloInt DR-Pri DR-Address

GE1/0/1 1 30 1 FE80::200:5EFF:FE04:8700

Table 85 Command output

Field	Description
Interface	Name of the interface.
NbrCnt	Number of IPv6 PIM neighbors.
HelloInt	Interval for sending hello messages.
DR-Pri	DR priority.
DR-Address	IPv6 address (link-local address) of the DR.

# Display detailed IPv6 PIM information on GigabitEthernet 1/0/1 on the public network.

<Sysname> display ipv6 pim interface gigabitethernet 1/0/1 verbose

Interface: GigabitEthernet1/0/1, FE80::200:5EFF:FE04:8700

PIM version: 2

PIM mode: Sparse

PIM DR: FE80::200:AFF:FE01:101

PIM DR Priority (configured): 1

PIM neighbors count: 1

PIM hello interval: 30 s

PIM LAN delay (negotiated): 500 ms

PIM LAN delay (configured): 500 ms

PIM override interval (negotiated): 2500 ms

PIM override interval (configured): 2500 ms

PIM neighbor tracking (negotiated): disabled

PIM neighbor tracking (configured): disabled

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

Table 86 Command output

Field	Description
Interface	Interface name and IPv6 address (link-local address).
PIM version	Version of the IPv6 PIM protocol
PIM mode	IPv6 PIM mode: dense or sparse.
PIM DR	IPv6 address (link-local address) of the DR.
PIM DR Priority (configured)	Configured DR priority.
PIM neighbor count	Total number of IPv6 PIM neighbors.
PIM hello interval	Interval for sending hello messages.
PIM LAN delay (negotiated)	Negotiated IPv6 message propagation delay.
PIM LAN delay (configured)	Configured IPv6 message propagation delay.
PIM override interval (negotiated)	Negotiated interval for overriding prune messages.
PIM override interval (configured)	Configured interval for overriding prune messages.
PIM neighbor tracking (negotiated)	Negotiated neighbor tracking status: enabled or disabled.
PIM neighbor tracking (configured)	Configured neighbor tracking status: enabled or disabled.
PIM require generation ID	Whether the feature of dropping hello messages without Generation_ID is enabled.
PIM hello hold interval	IPv6 PIM neighbor lifetime.
PIM assert hold interval	Assert holdtime timer.
PIM triggered hello delay	Maximum delay for sending hello messages.
PIM J/P interval	Interval for sending join/prune messages.
PIM J/P hold interval	Joined/pruned state holdtime timer.
PIM BSR domain border	Whether an IPv6 PIM domain border is configured.
PIM BFD	Whether IPv6 PIM is enabled to work with BFD.
PIM passive	Whether IPv6 PIM passive mode is enabled on the interface.
Number of routers on network not using DR priority	Number of routers that do not use the DR priority field on the subnet where the interface resides.
Number of routers on network not using LAN delay	Number of routers that do not use the LAN delay field on the subnet where the interface resides.
Number of routers on network not using neighbor tracking	Number of routers that are not enabled with neighbor tracking on the subnet where the interface resides.

display ipv6 pim nbma-link

Use display ipv6 pim nbma-link to display remote end information maintained by IPv6 PIM for ADVPN tunnel interfaces.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] nbma-link [ interface { interface-type interface-number } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays remote end information maintained by IPv6 PIM for ADVPN tunnel interfaces on the public network.

Examples

# Display remote end information maintained by IPv6 PIM for all ADVPN tunnel interfaces on the public network.

<Sysname> display ipv6 pim nbma-link

Interface: Tunnel1

Number of links: 1

Remote address: FE80::1

Private index : 0XCE000000

Private interface: Multicast-NBMA0

Interface: Tunnel2

Number of links: 1

Remote address: FE80::2

Private index : 0XCE000001

Private interface: Multicast-NBMA1

# Display remote end information maintained by IPv6 PIM for ADVPN interface tunnel1 on the public network.

<Sysname> display ipv6 pim nbma-link interface tunnel 1

Interface: Tunnel1

Number of links: 1

Remote address: FE80::1

Private index : 0XCE000000

Private interface: Multicast-NBMA0

Table 87 Command output

Field	Description
Interface	Interface name of the local tunnel interface.
Number of links	Number of remote ends.
Remote address	IPv6 address of the remote end.
Private index	Index of the remote end.
Private interface	Interface name of the remote end.

display ipv6 pim neighbor

Use display ipv6 pim neighbor to display IPv6 PIM neighbor information.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] neighbor [ipv6-neighbor-address | interface interface-type interface-number | verbose ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IPv6 PIM neighbor information on the public network.

ipv6-neighbor-address: Specifies an IPv6 PIM neighbor by its IPv6 address. If you do not specify an IPv6 PIM neighbor, the command displays information about all IPv6 PIM neighbors.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays information about IPv6 PIM neighbors on all interfaces.

verbose: Displays detailed IPv6 PIM neighbor information. If you do not specify this keyword, the command displays brief IPv6 PIM neighbor information.

Examples

# Display brief information about all IPv6 PIM neighbors on the public network.

<Sysname> display ipv6 pim neighbor

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires DR-Priority Mode

FE80::A01:101:1 GE1/0/1 02:50:49 00:01:31 1 B

FE80::A01:102:1 GE1/0/2 02:49:39 00:01:42 1

# Display detailed information about the IPv6 PIM neighbor with IPv6 address FE80::A01:101:1 on the public network.

<Sysname> display ipv6 pim neighbor fe80::a01:101:1 verbose

Neighbor: FE80::A01:101:1

Interface: GigabitEthernet1/0/3

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

RPF proxy vector: Enabled

Secondary address(es):

1::1

Table 88 Command output

Field	Description
Total Number of Neighbors	Total number of IPv6 PIM neighbors.
Neighbor	Primary IPv6 address (link-local address) of the IPv6 PIM neighbor.
Interface	Interface that connects to the IPv6 PIM neighbor.
Uptime	Length of time the IPv6 PIM neighbor has been up.
Expires/Expiry time	Remaining lifetime for the IPv6 PIM neighbor. If the IPv6 PIM neighbor is always up and reachable, this field displays never.
DR-Priority/DR Priority	DR priority of the IPv6 PIM neighbor.
Mode	IPv6 PIM mode. This field displays B if the IPv6 PIM mode is BIDIR-PIM. This field is empty if an IPv6 PIM mode other than IPv6 BIDIR-PIM is used.
Generation ID	Generation ID of the IPv6 PIM neighbor. (A random value represents a status change of the IPv6 PIM neighbor.)
Holdtime	Lifetime of the IPv6 PIM neighbor. If the IPv6 PIM neighbor is always up and reachable, this field displays forever.
LAN delay	IPv6 PIM message propagation delay on the shared-media LAN.
Override interval	Interval for overriding prune messages.
State refresh interval	Interval for refreshing state. 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.
Bidirectional PIM	Whether IPv6 BIDIR-PIM is enabled.
RPF proxy vector	Whether RPF proxy vector is enabled.
Secondary address(es)	Secondary IPv6 address (non-link-local address) of the IPv6 PIM neighbor.

display ipv6 pim routing-table

Use display ipv6 pim routing-table to display IPv6 PIM routing entries.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] routing-table [ ipv6-group-address [ prefix-length ] | ipv6-source-address [ prefix-length ] | flags flag-value | fsm | incoming-interface interface-type interface-number | mode mode-type | outgoing-interface { exclude | include | match } interface-type interface-number ] *

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, the 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, the 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.

· spt: Specifies IPv6 PIM routing entries on the SPT.

· 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, the command displays IPv6 PIM routing entries in all modes. The available IPv6 PIM modes include:

· bidir: Specifies IPv6 BIDIR-PIM.

· dm: Specifies IPv6 PIM-DM.

· sm: Specifies IPv6 PIM-SM.

· 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, the 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, the command displays IPv6 PIM routing entries that do not contain the specified outgoing interface.

· If you specify an included interface, the command displays IPv6 PIM routing entries that contain the specified outgoing interface.

· If you specify a matching interface, the command displays IPv6 PIM routing entries that contain only the specified outgoing interface.

Examples

# Display IPv6 PIM routing entries on the public network. This example uses an ADVPN network.

<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: Tunnel0, FE80::20:11

Upstream neighbor: FE80::1

RPF prime neighbor: FE80::1

Downstream interface information:

Total number of downstream interfaces: 1

1: Tunnel0, FE80::20:12

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

# Display state machine information for the IPv6 PIM routing table on the public network. This example uses an ADVPN network.

<Sysname> display ipv6 pim routing-table fsm

Total 0 (*, G) entries; 1 (S, G) entries

Abbreviations for FSM states:

NI - no info, J - joined, NJ - not joined, P - pruned,

NP - not pruned, PP - prune pending, W - winner, L - loser,

F - forwarding, AP - ack pending, DR - designated router,

NDR - non-designated router, RCV - downstream receivers

(2001::2, FFE3::101)

RP: FE80::A01:100:1

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: Tunnel0, FE80::20:11

Upstream neighbor: FE80::1

RPF prime neighbor: FE80::1

Join/Prune FSM: [SPT: J] [RPT: NP]

Downstream interface information:

Total number of downstream interfaces: 1

1: Tunnel0, FE80::20:12

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

DR state: [DR]

Join/Prune FSM: [NI]

Assert FSM: [NI]

FSM information for non-downstream interfaces: None

# Display IPv6 PIM routing entries on the public network.

<Sysname> display ipv6 pim routing-table

Total 0 (*, G) entry; 1 (S, G) entry

(2001::2, FFE3::101)

RP: FE80::A01:100:1

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: GigabitEthernet1/0/1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface information:

Total number of downstream interfaces: 1

1: GigabitEthernet1/0/2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

# Display state machine information for the IPv6 PIM routing table on the public network.

<Sysname> display ipv6 pim routing-table fsm

Total 0 (*, G) entries; 1 (S, G) entries

Abbreviations for FSM states:

NI - no info, J - joined, NJ - not joined, P - pruned,

NP - not pruned, PP - prune pending, W - winner, L - loser,

F - forwarding, AP - ack pending, DR - designated router,

NDR - non-designated router, RCV - downstream receivers

(2001::2, FFE3::101)

RP: FE80::A01:100:1

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: GigabitEthernet1/0/1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Join/Prune FSM: [SPT: J] [RPT: NP]

Downstream interface information:

Total number of downstream interfaces: 1

1: GigabitEthernet1/0/2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

DR state: [DR]

Join/Prune FSM: [NI]

Assert FSM: [NI]

FSM information for non-downstream interfaces: None

Table 89 Command output

Field	Description
Total 0 (*, G) entries; 1 (S, G) entries	Total number of (*, G) entries, and the total number of (S, G) entries.
(2001::2, FFE3::101)	(S, G) entry.
RP	IPv6 address of the RP.
Protocol	IPv6 PIM mode: IPv6 PIM-SM or IPv6 PIM-DM.
Flag	Flag of the (S, G) entry or (*, G) entry: · ACT—The entry has been used for routing data. · DEL—The entry will be removed. · EXPRUNE—Some outgoing interfaces are pruned by other IPv6 multicast routing protocols. · EXT—The entry contains outgoing interfaces provided by other multicast routing protocols. · LOC—The entry is on a router directly connected to the same subnet with the IPv6 multicast source. · NIIF—The entry contains unknown incoming interfaces. · NONBR—The entry has an IPv6 PIM neighbor lookup failure. · RPT—The entry is on an RPT branch where (S, G) prunes have been sent to the RP. · SPT—The entry is on the SPT. · SWT—The entry is in the process of RPT-to-SPT switchover. · WC—The entry contains a wildcard.
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. If the upstream interface is an NBMA mode-enabled ADVPN tunnel interface, this field also displays the IPv6 link-local address of the remote end.
Upstream neighbor	Upstream neighbor of the (S, G) entry or (*, G) entry.
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry: · For a (, G) entry, if the RPF neighbor is the RP, the field displays 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.
Downstream interface information	Information about the downstream interfaces: · Total number of downstream interfaces. · Names of the downstream interfaces. · Protocol type on the downstream interfaces. · Uptime of the downstream interfaces. · Expiration time of the downstream interfaces. · IPv6 link-local addresses of the remote ends associated with the downstream ADVPN tunnel interfaces.

display ipv6 pim rp-info

Use display ipv6 pim rp-info to display RP information.

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] 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, the command displays RP information for all IPv6 multicast groups.

Examples

# Display information about the RP for IPv6 multicast group FF0E::101 on the public network.

<Sysname> display ipv6 pim rp-info ff0e::101

BSR RP address is: 7:12::1

Priority: 192

HoldTime: 180

Uptime: 03:01:10

Expires: 00:02:30

Static RP address is: 7:12::1

Preferred: No

Configured ACL: 2003

RP mapping for this group is: 7:12::1 (local host)

Anycast-RP 7:12::1 members:

Member address State

1:1::1 Active

1:1::2 Local

1:2::1 Remote

# Display information about all RPs for all IPv6 multicast groups.

<Sysname> display ipv6 pim rp-info

BSR RP information:

Scope: non-scoped

Group/MaskLen: FF00::/8

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 bidir 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

Table 90 Command output

Field	Description
BSR RP address is	IPv6 address of the RP.
BSR RP information	Information about the RP.
Group/MaskLen	IPv6 multicast group to which the RP is designated.
[B]	The RP is an IPv6 BIDIR-PIM RP. This field is not displayed if the RP is an IPv6 PIM-SM RP.
RP address	IPv6 address of the RP. If the RP resides on the device where the command is executed, this field displays (local) after the IPv6 address.
Priority	Priority of the RP.
HoldTime	RP lifetime.
Uptime	Length of time the RP has been up.
Expires	Remaining time for the RP lifetime.
Static RP address is/RP address	IPv6 address of the static RP.
Preferred	Whether the static RP is preferred.
Configured ACL/ACL	ACL defining the IPv6 multicast groups to which the static RP is designated.
Mode	RP service mode, IPv6 PIM-SM or IPv6 BIDIR-PIM.
RP mapping for this group	IPv6 address of the RP that provides services for the IPv6 multicast group.
Anycast-RP 7:12::1 members	Members of Anycast RP 7:12::1.
Member address	IPv6 address of the Anycast RP member.
State	State of the interface from which the member address originates: · Active—Activated local interface. · Local—Inactivated local interface. · Remote—Remote interface.

display ipv6 pim statistics

Use display ipv6 pim statistics to display statistics for IPv6 PIM packets.

Syntax

display ipv6 pim statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for IPv6 PIM packets.

<Sysname> display ipv6 pim statistics

Received PIM packets: 3295

Sent PIM packets : 5975

Valid Invalid Succeeded Failed

Hello : 3128 0 4333 0

Reg : 14 0 0 0

Reg-stop : 0 0 0 0

JP : 151 0 561 0

BSM : 0 0 1081 0

Assert : 0 0 0 0

Graft : 0 0 0 0

Graft-ACK: 0 0 0 0

C-RP : 0 0 0 0

SRM : 0 0 0 0

DF : 0 0 0 0

Table 91 Command output

Field	Description
Received PIM packets	Total number of received IPv6 PIM packets.
Sent PIM packets	Total number of sent IPv6 PIM protocol packets.
Valid	Number of received legal IPv6 PIM protocol packets.
Invalid	Number of received illegal IPv6 PIM protocol packets.
Succeeded	Number of IPv6 PIM protocol packets that were sent successfully.
Failed	Number of IPv6 PIM protocol packets that failed to be sent.
Hello	Hello message statistics.
Reg	Register message statistics.
Reg-stop	Register-stop message statistics.
JP	Join/prune message statistics.
BSM	Bootstrap message statistics.
Assert	Assert message statistics.
Graft	Graft message statistics.
Graft-ACK	Graft-ACK message statistics.
C-RP	C-RP-Adv message statistics.
SRM	State refresh message statistics.
DF	Designated forwarder statistics.

hello-option dr-priority (IPv6 PIM view)

Use hello-option dr-priority to set the DR priority globally.

Use undo hello-option dr-priority to restore the default.

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

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 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] hello-option dr-priority 3

Related commands

ipv6 pim hello-option dr-priority

hello-option holdtime (IPv6 PIM view)

Use hello-option holdtime to set the IPv6 PIM neighbor lifetime globally.

Use undo hello-option holdtime to restore the default.

Syntax

hello-option holdtime time

undo hello-option holdtime

Default

The IPv6 PIM neighbor lifetime is 105 seconds.

Views

IPv6 PIM 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 neighbors are always reachable.

Usage guidelines

You can set the IPv6 PIM neighbor lifetime 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 IPv6 PIM neighbor lifetime to 120 seconds on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] hello-option holdtime 120

Related commands

ipv6 pim hello-option holdtime

hello-option lan-delay (IPv6 PIM view)

Use hello-option lan-delay to set the IPv6 PIM message propagation delay on a shared-media LAN globally.

Use undo hello-option lan-delay to restore the default.

Syntax

hello-option lan-delay delay

undo hello-option lan-delay

Default

The IPv6 PIM message propagation delay on a shared-media LAN is 500 milliseconds.

Views

IPv6 PIM view

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 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 IPv6 PIM message propagation delay on a shared-media LAN to 200 milliseconds on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] hello-option lan-delay 200

Related commands

hello-option override-interval (IPv6 PIM view)

ipv6 pim hello-option lan-delay

ipv6 pim hello-option override-interval

hello-option neighbor-tracking (IPv6 PIM view)

Use hello-option neighbor-tracking to enable neighbor tracking and disable join message suppression globally.

Use undo hello-option neighbor-tracking to disable neighbor tracking and enable join message suppression globally.

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

Default

Neighbor tracking is disabled, and join message suppression is enabled.

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 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] hello-option neighbor-tracking

Related commands

ipv6 pim hello-option neighbor-tracking

hello-option override-interval (IPv6 PIM view)

Use hello-option override-interval to set the override interval globally.

Use undo hello-option override-interval to restore the default.

Syntax

hello-option override-interval interval

undo hello-option override-interval

Default

The override interval is 2500 milliseconds.

Views

IPv6 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 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 override interval to 2000 milliseconds on the public network.

<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

holdtime join-prune (IPv6 PIM view)

Use holdtime join-prune to set the joined/pruned state holdtime globally.

Use undo holdtime join-prune to restore the default.

Syntax

holdtime join-prune time

undo holdtime join-prune

Default

The joined/pruned state holdtime is 210 seconds.

Views

IPv6 PIM 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 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.

To prevent the upstream neighbors from aging out, you must set the join/prune interval to be less than the joined/pruned state holdtime timer.

Examples

# Set the global joined/pruned state holdtime to 280 seconds on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] holdtime join-prune 280

Related commands

ipv6 pim holdtime join-prune

timer join-prune (IPv6 PIM view)

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 [ vpn-instance vpn-instance-name ]

undo ipv6 pim [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, you enter public network IPv6 PIM view.

Examples

# Enable IPv6 multicast routing on the public network, and enter public network IPv6 PIM view.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] ipv6 pim

[Sysname-pim6]

# Enable IPv6 multicast routing for VPN instance mvpn, and enter IPv6 PIM view of the VPN instance.

<Sysname> system-view

[Sysname] ipv6 multicast routing vpn-instance mvpn

[Sysname-mrib6-mvpn] quit

[Sysname] ipv6 pim vpn-instance mvpn

[Sysname-pim6-mvpn]

ipv6 pim bfd enable

Use ipv6 pim bfd enable to enable BFD for IPv6 PIM.

Use undo ipv6 pim bfd enable to disable BFD for IPv6 PIM.

Syntax

ipv6 pim bfd enable

undo ipv6 pim bfd enable

Default

BFD is disabled for IPv6 PIM.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IPv6 PIM-DM or IPv6 PIM-SM is enabled on the interface.

Examples

# Enable IPv6 multicast routing on the public network. Then, enable IPv6 PIM-DM and BFD for IPv6 PIM on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim dm

[Sysname-GigabitEthernet1/0/1] ipv6 pim bfd enable

Related commands

ipv6 pim dm

ipv6 pim sm

ipv6 pim bsr-boundary

Use ipv6 pim bsr-boundary to configure an IPv6 PIM-SM domain border (a bootstrap message boundary).

Use ipv6 pim bsr-boundary to restore the default.

Syntax

ipv6 pim bsr-boundary

undo ipv6 pim bsr-boundary

Default

An interface is not an IPv6 PIM-SM domain border.

Views

Interface view

Predefined user roles

network-admin

Examples

# Configure GigabitEthernet 1/0/1 as an IPv6 PIM-SM domain border.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim bsr-boundary

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

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 on the public network, and enable IPv6 PIM-DM on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim dm

Related commands

ipv6 multicast routing

ipv6 pim hello-option dr-priority

Use ipv6 pim hello-option dr-priority to set the DR priority on an interface.

Use undo ipv6 pim hello-option dr-priority to restore the default.

Syntax

ipv6 pim hello-option dr-priority priority

undo ipv6 pim hello-option dr-priority

Default

The DR priority is 1.

Views

Interface 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 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 DR priority to 3 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim hello-option dr-priority 3

Related commands

hello-option dr-priority (IPv6 PIM view)

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim hello-option holdtime 120

Related commands

hello-option holdtime (IPv6 PIM view)

ipv6 pim hello-option lan-delay

Use ipv6 pim hello-option lan-delay to set the IPv6 PIM message propagation delay on a shared-media LAN for an interface.

Use undo ipv6 pim hello-option lan-delay to restore the default.

Syntax

ipv6 pim hello-option lan-delay delay

undo ipv6 pim hello-option lan-delay

Default

The IPv6 PIM message propagation delay on a shared-media LAN is 500 milliseconds.

Views

Interface view

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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

ipv6 pim hello-option neighbor-tracking

Use ipv6 pim hello-option neighbor-tracking to enable neighbor tracking and disable join message suppression on an interface.

Use ipv6 pim hello-option neighbor-tracking disable to disable neighbor tracking on an interface when join message suppression is disabled globally.

Use undo ipv6 pim hello-option neighbor-tracking to restore neighbor tracking setting on an interface to be consistent with the global setting.

Syntax

ipv6 pim hello-option neighbor-tracking

ipv6 pim hello-option neighbor-tracking disable

undo ipv6 pim hello-option neighbor-tracking

Default

On an interface, neighbor tracking is disabled, and join message suppression is enabled.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

You can enable neighbor tracking 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

# Enable neighbor tracking on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim hello-option neighbor-tracking

# On the public network, disable neighbor tracking on GigabitEthernet 1/0/1 when neighbor tracking is enabled globally.

<Sysname> system-view

[Sysname]ipv6 pim

[Sysname-pim6]hello-option neighbor-tracking

[Sysname-pim6]quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim hello-option neighbor-tracking disable

Related commands

hello-option neighbor-tracking (IPv6 PIM view)

ipv6 pim hello-option override-interval

Use ipv6 pim hello-option override-interval to set the override interval on an interface.

Use undo ipv6 pim hello-option override-interval to restore the default.

Syntax

ipv6 pim hello-option override-interval interval

undo ipv6 pim hello-option override-interval

Default

The override interval is 2500 milliseconds.

Views

Interface 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 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 override interval to 2000 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim hello-option override-interval 2000

Related commands

hello-option lan-delay (IPv6 PIM view)

hello-option override-interval (IPv6 PIM view)

ipv6 pim hello-option lan-delay

ipv6 pim holdtime join-prune

Use ipv6 pim holdtime join-prune to set the joined/pruned state holdtime on an interface.

Use undo ipv6 pim holdtime join-prune to restore the default.

Syntax

ipv6 pim holdtime join-prune time

undo ipv6 pim holdtime join-prune

Default

The joined/pruned state holdtime is 210 seconds.

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 IPv6 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 timer.

Examples

# Set the joined/pruned state holdtime to 280 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim holdtime join-prune 280

Related commands

holdtime join-prune (IPv6 PIM view)

ipv6 pim timer join-prune

ipv6 pim nbma-mode

Use ipv6 pim nbma-mode to enable NBMA mode on an ADVPN tunnel interface.

Use undo ipv6 pim nbma-mode to disable NBMA mode on an ADVPN tunnel interface.

Syntax

ipv6 pim nbma-mode

undo ipv6 pim nbma-mode

Default

NBMA mode for an ADVPN tunnel interface is disabled.

Views

Tunnel interface view

Predefined user roles

network-admin

Usage guidelines

This command is not available for IPv6 PIM-DM.

This command takes effect only when IPv6 PIM-SM is enabled on the interface.

Examples

# Enable IPv6 multicast routing on the public network, and enable NBMA mode on the ADVPN tunnel interface tunnel0.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib] quit

[Sysname] interface Tunnel 0 mode advpn

[Sysname-Tunnel0] ipv6 pim sm

[Sysname-Tunnel0] ipv6 pim nbma-mode

ipv6 pim neighbor-policy

Use ipv6 pim neighbor-policy to configure an IPv6 PIM hello policy to guard against hello message spoofing.

Use undo ipv6 pim neighbor-policy to restore the default.

Syntax

ipv6 pim neighbor-policy ipv6-acl-number

undo ipv6 pim neighbor-policy

Default

No IPv6 PIM hello policies exist 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

When you configure a rule in the IPv6 basic 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-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.

Examples

# Configure an IPv6 PIM hello policy on GigabitEthernet 1/0/1, so that only the devices on the subnet of FE80:101::101/64 can become PIM neighbors of this router.

<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 gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim neighbor-policy 2000

ipv6 pim non-stop-routing

Use ipv6 pim non-stop-routing to enable IPv6 PIM NSR.

Use undo ipv6 pim non-stop-routing to disable IPv6 PIM NSR.

Syntax

ipv6 pim non-stop-routing

undo ipv6 pim non-stop-routing

Default

IPv6 PIM NSR is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The following matrix shows the command and hardware compatibility:

Hardware	Command compatibility
MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS	No
MSR2600-6-X1/2600-10-X1	No
MSR 2630	Yes
MSR3600-28/3600-51	Yes
MSR3600-28-SI/3600-51-SI	No
MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC	Yes
MSR 3610/3620/3620-DP/3640/3660	Yes
MSR5620/5660/5680	Yes

Hardware	Command compatibility
MSR810-LM-GL	No
MSR810-W-LM-GL	No
MSR830-6EI-GL	No
MSR830-10EI-GL	No
MSR830-6HI-GL	No
MSR830-10HI-GL	No
MSR2600-6-X1-GL	No
MSR3600-28-SI-GL	No

Examples

# Enable IPv6 PIM NSR.

<Sysname> system-view

[Sysname] ipv6 pim non-stop-routing

ipv6 pim passive

Use ipv6 pim passive to enable IPv6 PIM passive mode on an interface.

Use undo ipv6 pim passive to disable IPv6 PIM passive mode on an interface.

Syntax

ipv6 pim passive

undo ipv6 pim passive

Default

IPv6 PIM passive mode is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IPv6 PIM-DM or IPv6 PIM-SM is enabled on the interface.

Examples

# Enable IPv6 multicast routing on the public network. Then, enable IPv6 PIM-DM and IPv6 PIM passive mode on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim dm

[Sysname-GigabitEthernet1/0/1] ipv6 pim passive

ipv6 pim require-genid

Use ipv6 pim require-genid to drop hello messages without the generation ID options.

Use undo ipv6 pim require-genid to restore the default.

Syntax

ipv6 pim require-genid

undo ipv6 pim require-genid

Default

Hello messages without the generation ID options are accepted.

Views

Interface view

Predefined user roles

network-admin

Examples

# Enable GigabitEthernet 1/0/1 to drop hello messages without the generation ID options.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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 on the public network, and enable IPv6 PIM-SM on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] ipv6 multicast routing

[Sysname-mrib6] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim sm

Related commands

ipv6 multicast routing

ipv6 pim state-refresh-capable

Use ipv6 pim state-refresh-capable to enable the state refresh feature on an interface.

Use undo ipv6 pim state-refresh-capable to disable the state refresh feature.

Syntax

ipv6 pim state-refresh-capable

undo ipv6 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] 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)

ipv6 pim timer graft-retry

Use ipv6 pim timer graft-retry to set the graft retry timer.

Use undo ipv6 pim timer graft-retry to restore the default.

Syntax

ipv6 pim timer graft-retry interval

undo ipv6 pim timer graft-retry

Default

The graft retry timer is 3 seconds.

Views

Interface view

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim timer graft-retry 80

ipv6 pim timer hello

Use ipv6 pim timer hello to set the hello interval on an interface.

Use undo ipv6 pim timer hello to restore the default.

Syntax

ipv6 pim timer hello interval

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim timer hello 40

Related commands

timer hello (IPv6 PIM view)

ipv6 pim timer join-prune

Use ipv6 pim timer join-prune to set the join/prune interval on an interface.

Use undo ipv6 pim timer join-prune to restore the default.

Syntax

ipv6 pim timer join-prune interval

undo ipv6 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 IPv6 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 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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim timer join-prune 80

Related commands

ipv6 pim holdtime join-prune

timer join-prune (IPv6 PIM view)

ipv6 pim triggered-hello-delay

Use ipv6 pim triggered-hello-delay to set the triggered hello delay (maximum delay for sending a hello message).

Use undo ipv6 pim triggered-hello-delay to restore the default.

Syntax

ipv6 pim triggered-hello-delay delay

undo ipv6 pim triggered-hello-delay

Default

The triggered hello delay is 5 seconds.

Views

Interface view

Predefined user roles

network-admin

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 GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 pim triggered-hello-delay 3

jp-pkt-size (IPv6 PIM view)

Use jp-pkt-size to set the maximum size of each join/prune message.

Use undo jp-pkt-size to restore the default.

Syntax

jp-pkt-size size

undo jp-pkt-size

Default

The maximum size of a join/prune message is 8100 bytes.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

size: Specifies the maximum size of each join/prune message, in the range of 100 to 64000 bytes.

Examples

# Set the maximum size of each join/prune message to 1500 bytes on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] jp-pkt-size 1500

register-policy (IPv6 PIM view)

Use register-policy to configure an IPv6 PIM register policy.

Use undo register-policy to restore the default.

Syntax

undo register-policy

Default

No IPv6 PIM register policies exist, and all IPv6 PIM register messages are regarded as legal.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

ipv6-acl-number: Specifies an IPv6 advanced ACL number in the range of 3000 to 3999.

Usage guidelines

When you configure a rule in the IPv6 advanced 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-prefix option specifies an IPv6 multicast source address.

· The destination dest-address dest-prefix option specifies an IPv6 multicast group range.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# On the public network, configure an IPv6 PIM register policy to accept register messages from sources on subnet 3:1::/64 to groups in the range of 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

register-suppression-timeout (IPv6 PIM view)

Use register-suppression-timeout to set the register suppression time.

Use undo register-suppression-timeout to restore the default.

Syntax

undo register-suppression-timeout

Default

The register suppression time is 60 seconds.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

interval: Specifies the register suppression time in the range of 1 to 65536 seconds.

Examples

# Set the register suppression time to 70 seconds on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] register-suppression-timeout 70

register-whole-checksum (IPv6 PIM view)

Use register-whole-checksum to configure the device to calculate the checksum based on an entire register message.

Use undo register-whole-checksum to restore the default.

Syntax

undo register-whole-checksum

Default

The device calculates the checksum based on the register message header.

Views

IPv6 PIM view

Predefined user roles

network-admin

Examples

# On the public network, configure the device to calculate the checksum based on an entire register message.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] register-whole-checksum

snmp-agent trap enable pim6

Use snmp-agent trap enable pim6 to enable SNMP notifications for IPv6 PIM.

Use undo snmp-agent trap enable pim6 to disable SNMP notifications for IPv6 PIM.

Syntax

snmp-agent trap enable pim6 [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

undo snmp-agent trap enable pim6 [ candidate-bsr-win-election | elected-bsr-lost-election | neighbor-loss ] *

Default

SNMP notifications for IPv6 PIM are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

candidate-bsr-win-election: Specifies notifications about winning the BSR election.

elected-bsr-lost-election: Specifies notifications about losing the BSR election.

neighbor-loss: Specifies notifications about losing neighbors.

Usage guidelines

If you do not specify an optional keyword, this command enables or disables IPv6 PIM to generate SNMP notifications.

To report critical IPv6 PIM events to an NMS, enable SNMP notifications for IPv6 PIM. For IPv6 PIM event notifications to be sent correctly, you must also configure SNMP as described in Network Management and Monitoring Configuration Guide.

Examples

# Disable SNMP notifications for IPv6 PIM.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable pim6

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 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] source-lifetime 200

source-policy (IPv6 PIM view)

Use source-policy to configure an IPv6 multicast source policy.

Use undo source-policy to restore the default.

Syntax

source-policy ipv6-acl-number

undo source-policy

Default

No IPv6 multicast source policies exist, and all IPv6 multicast data packets are regarded as legal.

Views

IPv6 PIM 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.

Usage guidelines

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

# On the public network, configure an IPv6 multicast source policy to accept the 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

spt-switch-threshold (IPv6 PIM view)

Use spt-switch-threshold to configure a criterion for an RPT-to-SPT switchover.

Use undo spt-switch-threshold to remove criteria for RPT-to-SPT switchovers.

Syntax

spt-switch-threshold { traffic-rate | immediacy | infinity } [ group-policy ipv6-acl-number ]

undo spt-switch-threshold [ traffic-rate | immediacy | infinity ] [ group-policy ipv6-acl-number ]

Default

The first IPv6 multicast data packet triggers an RPT-to-SPT switchover.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

traffic-rate: Specifies a traffic rate threshold for triggering an RPT-to-SPT switchover, in the range of 1 to 4194304 kbps.

immediacy: Triggers an RPT-to-SPT switchover immediately.

infinity: Disables RPT-to-SPT switchover.

group-policy ipv6-acl-number: Specifies an IPv6 basic ACL by its number in the range of 2000 to 2999. If you specify an ACL, the configuration applies to the IPv6 multicast groups that the ACL permits. The configuration applies to 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

CAUTION:

If the device is an RP, disabling RPT-to-SPT switchover might cause multicast traffic forwarding failures on the source-side DR. When disabling RPT-to-SPT switchover, make sure you fully understand its impact on your network.

When you configure a rule in the IPv6 basic 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-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

# Set the traffic rate threshold to 4 kbps for triggering an RPT-to-SPT switchover on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] spt-switch-threshold 4

# Disable RPT-to-SPT switchover on receiver-side DR on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] spt-switch-threshold infinity

ssm-policy (IPv6 PIM view)

Use ssm-policy to configure the IPv6 SSM group range.

Use undo ssm-policy to restore the default.

Syntax

ssm-policy ipv6-acl-number

undo ssm-policy

Default

The IPv6 SSM group range is FF3x::/32, where x can be any valid scope.

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

This command defines an IPv6 multicast group range that is used by IPv6 PIM-SSM. The IPv6 PIM-SSM mode applies to IPv6 multicast packets that are permitted by the ACL. The IPv6 PIM-SM mode applies to IPv6 multicast packets that are not permitted by the ACL.

When you configure a rule in the IPv6 basic 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-prefix option specifies an IPv6 multicast group range.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

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

state-refresh-hoplimit (IPv6 PIM view)

Use state-refresh-hoplimit to set the hop limit for state refresh messages.

Use undo state-refresh-hoplimit to restore the default.

Syntax

state-refresh-hoplimit hoplimit-value

undo state-refresh-hoplimit

Default

The hop limit for state refresh messages is 255.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

hoplimit-value: Specifies the hop limit for state refresh messages, in the range of 1 to 255.

Examples

# Set the hop limit for state refresh messages to 45 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] state-refresh-hoplimit 45

Related commands

ipv6 pim state-refresh-capable

state-refresh-interval (IPv6 PIM view)

state-refresh-rate-limit (IPv6 PIM view)

state-refresh-interval (IPv6 PIM view)

Use state-refresh-interval to set the state refresh interval.

Use undo state-refresh-interval to restore the default.

Syntax

state-refresh-interval interval

undo state-refresh-interval

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 on the public network.

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

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 accepting a new state refresh message.

Views

IPv6 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 on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] state-refresh-rate-limit 45

Related commands

ipv6 pim state-refresh-capable

state-refresh-hoplimit (IPv6 PIM view)

state-refresh-interval (IPv6 PIM view)

static-rp (IPv6 PIM view)

Use static-rp to configure a static RP.

Use undo static-rp to delete a static RP.

Syntax

static-rp ipv6-rp-address [ ipv6-acl-number | bidir | preferred ] *

undo static-rp ipv6-rp-address

Default

No static RPs exist.

Views

IPv6 PIM view

Predefined user roles

network-admin

Parameters

ipv6-rp-address: Specifies the IPv6 address of the static RP. This address must be a valid IPv6 global unicast address.

ipv6-acl-number: Specifies an IPv6 basic ACL number in the range of 2000 to 2999. If you specify an ACL, the static RP is designated only to IPv6 multicast groups that the ACL permits. The static RP is designated to 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.

bidir: Specifies IPv6 BIDIR-PIM to which the static RP is designated. If you do not specify this keyword, the PIM mode is IPv6 PIM-SM.

preferred: Gives priority to the static RP if the static RP and the dynamic RP exist at the same time on the network. The dynamic RP takes effect only when no static RP exists on the network. If you do not specify this keyword, the dynamic RP has priority. The static RP takes effect only when the dynamic RP fails.

Usage guidelines

You do not need to enable IPv6 PIM on an interface that acts as a static RP.

When you configure a rule in the IPv6 basic 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-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.

When rules in the ACL used by a static RP change, new RPs are dynamically elected for all IPv6 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 commands, the most recent configuration 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

# On the public network, 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

timer hello (IPv6 PIM view)

Use timer hello to set the hello interval globally.

Use undo timer hello to restore the default.

Syntax

timer hello interval

undo timer hello

Default

The hello interval is 30 seconds.

Views

IPv6 PIM 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 device does not send hello messages.

Usage guidelines

You can set the hello 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.

Examples

# Set the global hello interval to 40 seconds on the public network.

<Sysname> system-view

[Sysname] ipv6 pim

[Sysname-pim6] timer hello 40

Related commands

ipv6 pim timer hello

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 on the public network.

<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

Index

A B C D E F G H I J L M O P Q R S T V

address-family ipv4,187

address-family ipv4 mdt,188

address-family ipv6,189

anycast rp (IPv6 PIM view),311

anycast rp (PIM view),108

auto-rp enable (PIM view),109

bidir-pim enable (IPv6 PIM view),312

bidir-pim enable (PIM view),109

bidir-rp-limit (IPv6 PIM view),312

bidir-rp-limit (PIM view),110

bsm-fragment enable (IPv6 PIM view),313

bsm-fragment enable (PIM view),111

bsm-reflection enable (IPv6 PIM view),314

bsm-reflection enable (PIM view),111

bsr-policy (IPv6 PIM view),314

bsr-policy (PIM view),112

bsr-rp-mapping rfc2362 (IPv6 PIM view),315

cache-sa-enable,165

c-bsr (IPv6 PIM view),316

c-bsr (PIM view),113

c-rp (IPv6 PIM view),317

c-rp (PIM view),114

crp-policy (IPv6 PIM view),318

crp-policy (PIM view),115

data-delay,189

data-group,190

data-holddown,191

default-group,192

delete ip rpf-route-static,51

display bgp routing-table ipv4 mdt,192

display igmp group,77

display igmp interface,81

display igmp proxy group,83

display igmp proxy routing-table,85

display igmp ssm-mapping,87

display igmp-snooping,1

display igmp-snooping group,3

display igmp-snooping router-port,5

display igmp-snooping static-group,7

display igmp-snooping static-router-port,9

display igmp-snooping statistics,10

display interface register-tunnel,116

display ipv6 l2-multicast fast-forwarding cache,208

display ipv6 l2-multicast ip,210

display ipv6 l2-multicast ip forwarding,212

display ipv6 l2-multicast mac,213

display ipv6 l2-multicast mac forwarding,215

display ipv6 mrib interface,258

display ipv6 multicast boundary,260

display ipv6 multicast fast-forwarding cache,261

display ipv6 multicast forwarding df-info,262

display ipv6 multicast forwarding event,265

display ipv6 multicast forwarding-table,266

display ipv6 multicast forwarding-table df-list,269

display ipv6 multicast routing-table,271

display ipv6 multicast rpf-info,272

display ipv6 pim bsr-info,319

display ipv6 pim claimed-route,320

display ipv6 pim c-rp,321

display ipv6 pim df-info,323

display ipv6 pim interface,324

display ipv6 pim nbma-link,326

display ipv6 pim neighbor,327

display ipv6 pim routing-table,329

display ipv6 pim rp-info,333

display ipv6 pim statistics,335

display l2-multicast fast-forwarding cache,11

display l2-multicast ip,13

display l2-multicast ip forwarding,14

display l2-multicast mac,16

display l2-multicast mac forwarding,17

display mac-address [ multicast ],52

display mld group,280

display mld interface,284

display mld proxy group,286

display mld proxy routing-table,288

display mld ssm-mapping,290

display mld-snooping,216

display mld-snooping group,218

display mld-snooping router-port,220

display mld-snooping static-group,222

display mld-snooping static-router-port,224

display mld-snooping statistics,225

display mrib interface,53

display msdp brief,166

display msdp peer-status,167

display msdp sa-cache,170

display msdp sa-count,171

display multicast boundary,54

display multicast fast-forwarding cache,55

display multicast forwarding df-info,57

display multicast forwarding event,59

display multicast forwarding-table,60

display multicast forwarding-table df-list,63

display multicast routing-table,65

display multicast routing-table static,66

display multicast rpf-info,67

display multicast-domain data-group receive,195

display multicast-domain data-group send,197

display multicast-domain default-group,199

display multicast-domain ipv6 data-group receive,200

display multicast-domain ipv6 data-group send,202

display multicast-domain ipv6 default-group,203

display pim bsr-info,118

display pim claimed-route,119

display pim c-rp,121

display pim df-info,122

display pim interface,123

display pim nbma-link,125

display pim neighbor,126

display pim routing-table,128

display pim rp-info,132

display pim statistics,134

dot1p-priority (IGMP-snooping view),19

dot1p-priority (MLD-snooping view),226

enable (IGMP-snooping view),19

enable (MLD-snooping view),227

encap-data-enable,172

entry-limit (IGMP-snooping view),20

entry-limit (MLD-snooping view),227

fast-leave (IGMP-snooping view),21

fast-leave (MLD-snooping view),228

group-policy (IGMP-snooping view),21

group-policy (MLD-snooping view),229

hello-option dr-priority (IPv6 PIM view),336

hello-option dr-priority (PIM view),135

hello-option holdtime (IPv6 PIM view),337

hello-option holdtime (PIM view),136

hello-option lan-delay (IPv6 PIM view),337

hello-option lan-delay (PIM view),137

hello-option neighbor-tracking (IPv6 PIM view),338

hello-option neighbor-tracking (PIM view),138

hello-option override-interval (IPv6 PIM view),339

hello-option override-interval (PIM view),138

holdtime join-prune (IPv6 PIM view),340

holdtime join-prune (PIM view),139

host-aging-time (IGMP-snooping view),22

host-aging-time (MLD-snooping view),230

igmp,88

igmp enable,88

igmp fast-leave,89

igmp group-policy,90

igmp last-member-query-count,91

igmp last-member-query-interval,92

igmp max-response-time,92

igmp non-stop-routing,93

igmp other-querier-present-interval,94

igmp proxy enable,94

igmp proxy forwarding,95

igmp query-interval,96

igmp robust-count,96

igmp startup-query-count,97

igmp startup-query-interval,98

igmp static-group,98

igmp version,99

igmp-snooping,23

igmp-snooping dot1p-priority,24

igmp-snooping drop-unknown,25

igmp-snooping enable,26

igmp-snooping fast-leave,26

igmp-snooping general-query source-ip,27

igmp-snooping group-limit,28

igmp-snooping group-policy,29

igmp-snooping host-aging-time,30

igmp-snooping host-join,31

igmp-snooping last-member-query-interval,32

igmp-snooping leave source-ip,32

igmp-snooping max-response-time,33

igmp-snooping overflow-replace,34

igmp-snooping querier,35

igmp-snooping query-interval,36

igmp-snooping report source-ip,36

igmp-snooping router-aging-time,37

igmp-snooping router-port-deny,38

igmp-snooping source-deny,39

igmp-snooping special-query source-ip,39

igmp-snooping static-group,40

igmp-snooping static-router-port,41

igmp-snooping version,42

import-source,173

ip rpf-route-static,68

ipv6 multicast boundary,273

ipv6 multicast routing,275

ipv6 pim,340

ipv6 pim bfd enable,341

ipv6 pim bsr-boundary,342

ipv6 pim dm,342

ipv6 pim hello-option dr-priority,343

ipv6 pim hello-option holdtime,344

ipv6 pim hello-option lan-delay,344

ipv6 pim hello-option neighbor-tracking,345

ipv6 pim hello-option override-interval,346

ipv6 pim holdtime join-prune,347

ipv6 pim nbma-mode,347

ipv6 pim neighbor-policy,348

ipv6 pim non-stop-routing,349

ipv6 pim passive,349

ipv6 pim require-genid,350

ipv6 pim sm,351

ipv6 pim state-refresh-capable,351

ipv6 pim timer graft-retry,352

ipv6 pim timer hello,352

ipv6 pim timer join-prune,353

ipv6 pim triggered-hello-delay,354

jp-pkt-size (IPv6 PIM view),354

jp-pkt-size (PIM view),140

last-listener-query-count (MLD view),291

last-listener-query-interval (MLD view),291

last-listener-query-interval (MLD-snooping view),231

last-member-query-count (IGMP view),100

last-member-query-interval (IGMP view),100

last-member-query-interval (IGMP-snooping view),42

load-splitting (IPv6 MRIB view),275

load-splitting (MRIB view),70

log data-group-reuse,204

longest-match (IPv6 MRIB view),276

longest-match (MRIB view),70

mac-address multicast,71

max-response-time (IGMP view),101

max-response-time (IGMP-snooping view),43

max-response-time (MLD view),292

max-response-time (MLD-snooping view),231

mld,293

mld enable,293

mld fast-leave,294

mld group-policy,295

mld last-listener-query-count,296

mld last-listener-query-interval,297

mld max-response-time,297

mld non-stop-routing,298

mld other-querier-present-timeout,299

mld proxy enable,299

mld proxy forwarding,300

mld query-interval,301

mld robust-count,301

mld startup-query-count,302

mld startup-query-interval,303

mld static-group,303

mld version,304

mld-snooping,232

mld-snooping done source-ip,232

mld-snooping dot1p-priority,233

mld-snooping drop-unknown,234

mld-snooping enable,235

mld-snooping fast-leave,236

mld-snooping general-query source-ip,236

mld-snooping group-limit,237

mld-snooping group-policy,238

mld-snooping host-aging-time,239

mld-snooping host-join,240

mld-snooping last-listener-query-interval,241

mld-snooping max-response-time,242

mld-snooping overflow-replace,243

mld-snooping querier,244

mld-snooping query-interval,244

mld-snooping report source-ip,245

mld-snooping router-aging-time,246

mld-snooping router-port-deny,247

mld-snooping source-deny,247

mld-snooping special-query source-ip,248

mld-snooping static-group,249

mld-snooping static-router-port,250

mld-snooping version,250

msdp,174

multicast boundary,72

multicast routing,73

multicast rpf-proxy-vector compatible,205

multicast-domain,205

originating-rp,175

other-querier-present-interval (IGMP view),102

other-querier-present-timeout (MLD view),305

overflow-replace (IGMP-snooping view),44

overflow-replace (MLD-snooping view),251

peer,175

peer description,176

peer mesh-group,176

peer minimum-ttl,177

peer password,178

peer request-sa-enable,178

peer sa-cache-maximum,179

peer sa-policy,180

peer sa-request-policy,181

pim,140

pim bfd enable,141

pim bsr-boundary,141

pim dm,142

pim hello-option dr-priority,143

pim hello-option holdtime,143

pim hello-option lan-delay,144

pim hello-option neighbor-tracking,145

pim hello-option override-interval,146

pim holdtime join-prune,146

pim nbma-mode,147

pim neighbor-policy,148

pim non-stop-routing,148

pim passive,149

pim require-genid,150

pim sm,150

pim state-refresh-capable,151

pim timer graft-retry,151

pim timer hello,152

pim timer join-prune,153

pim triggered-hello-delay,153

proxy multipath (IGMP view),103

proxy multipath (MLD view),305

query-interval (IGMP view),103

query-interval (MLD view),306

report-aggregation (IGMP-snooping view),45

report-aggregation (MLD-snooping view),252

reset igmp group,104

reset igmp-snooping group,45

reset igmp-snooping router-port,46

reset igmp-snooping statistics,46

reset ipv6 l2-multicast fast-forwarding cache,252

reset ipv6 multicast fast-forwarding cache,276

reset ipv6 multicast forwarding event,277

reset ipv6 multicast forwarding-table,278

reset ipv6 multicast routing-table,279

reset l2-multicast fast-forwarding cache,47

reset mld group,307

reset mld-snooping group,253

reset mld-snooping router-port,254

reset mld-snooping statistics,255

reset msdp peer,182

reset msdp sa-cache,182

reset msdp statistics,183

reset multicast fast-forwarding cache,74

reset multicast forwarding event,75

reset multicast forwarding-table,75

reset multicast routing-table,76

robust-count (IGMP view),105

robust-count (MLD view),308

router-aging-time (IGMP-snooping view),48

router-aging-time (MLD-snooping view),255

rpf proxy vector,206

shutdown (MSDP view),183

snmp-agent trap enable pim,156

snmp-agent trap enable pim6,357

source,207

source-deny (IGMP-snooping view),48

source-deny (MLD-snooping view),256

source-lifetime (IPv6 PIM view),357

source-lifetime (PIM view),156

source-policy (IPv6 PIM view),358

source-policy (PIM view),157

spt-switch-threshold (IPv6 PIM view),359

spt-switch-threshold (PIM view),158

ssm-mapping (IGMP view),105

ssm-mapping (MLD view),308

ssm-policy (IPv6 PIM view),360

ssm-policy (PIM view),159

startup-query-count (IGMP view),106

startup-query-count (MLD view),309

startup-query-interval (IGMP view),107

startup-query-interval (MLD view),310

state-refresh-hoplimit (IPv6 PIM view),361

state-refresh-interval (IPv6 PIM view),361

state-refresh-interval (PIM view),160

state-refresh-rate-limit (IPv6 PIM view),362

state-refresh-rate-limit (PIM view),160

state-refresh-ttl (PIM view),161

static-rp (IPv6 PIM view),362

static-rp (PIM view),161

static-rpf-peer,184

timer hello (IPv6 PIM view),364

timer hello (PIM view),163

timer join-prune (IPv6 PIM view),364

timer join-prune (PIM view),163

timer keepalive,185

timer retry,186

version (IGMP-snooping view),49

version (MLD-snooping view),257

09-IP Multicast Command Reference

IGMP snooping commands

display igmp-snooping

dot1p-priority (IGMP-snooping view)

igmp-snooping last-member-query-interval

igmp-snooping leave source-ip

igmp-snooping overflow-replace

overflow-replace (IGMP-snooping view)

display mac-address [ multicast ]

display mrib interface

display multicast forwarding event

reset multicast fast-forwarding cache

reset multicast routing-table

display igmp proxy group

display igmp ssm-mapping

igmp group-policy

igmp last-member-query-count

igmp query-interval

igmp version

last-member-query-count (IGMP view)

PIM commands

auto-rp enable (PIM view)

bidir-rp-limit (PIM view)

bsm-fragment enable (PIM view)

bsr-policy (PIM view)

c-bsr (PIM view)

c-rp (PIM view)

crp-policy (PIM view)

display interface register-tunnel

display pim statistics

hello-option dr-priority (PIM view)

hello-option holdtime (PIM view)

hello-option lan-delay (PIM view)

hello-option neighbor-tracking (PIM view)

hello-option override-interval (PIM view)

holdtime join-prune (PIM view)

jp-pkt-size (PIM view)