vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays PIM snooping neighbor information for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping neighbor information for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping neighbor information on the active MPU. (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 PIM snooping neighbor information on the global active MPU. (In IRF mode.)

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

Examples

# Display detailed information about PIM snooping neighbors for VLAN 2.

<Sysname> display pim-snooping neighbor vlan 2 verbose

Total 2 neighbors.

VLAN 2: Total 2 neighbors.

10.1.1.2

Slots (0 in total):

Ports (1 in total):

XGE3/1/1 (02:02:23) LAN Prune Delay(T)

10.1.1.3

Slots (0 in total):

Ports (1 in total):

XGE3/1/2 (02:02:25)

# Display PIM snooping neighbor information for VSI aaa.

<Sysname> display pim-snooping neighbor vsi aaa

Total 2 neighbors.

VSI aaa: Total 2 neighbors.

10.0.0.1

Slots (0 in total):

Ports (1 in total):

AC (VSI index 0 Link ID 2) (00:01:32)

10.0.0.4

Slots (0 in total):

Ports (1 in total):

AC (VSI index 0 Link ID 1) (00:01:41)

Table 1 Command output

Field	Description
Total 2 neighbors	Total number of PIM snooping neighbors.
VLAN 2: Total 2 neighbors	Total number of PIM snooping neighbors in VLAN 2.
VSI aaa: Total 2 neighbors	Total number of PIM snooping neighbors in VSI aaa.
10.1.1.2	IP address of the PIM snooping neighbor.
Slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have the neighbor, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the neighbor, except for the specified card or the global active MPU when no card is specified.
Ports (1 in total)	Ports where the PIM snooping neighbors reside, and the total number of the ports.
(02:02:23)	Remaining aging timer for a PIM snooping neighbor on the port. This field is always displayed for global ports (such as Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs). (In standalone mode.) For a non-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. (In IRF mode.) For a non-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.
LAN Prune Delay	The PIM hello message sent by the PIM snooping neighbor has the LAN_Prune_Delay option.
(T)	The join message suppression feature has been disabled for the PIM snooping neighbor.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.

display pim-snooping router-port

Use display pim-snooping router-port to display PIM snooping router port information.

Syntax

In standalone mode:

display pim-snooping router-port [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ]

In IRF mode:

display pim-snooping router-port [ vlan vlan-id | vsi vsi-name ] [ 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. If you do not specify a VLAN, this command displays PIM snooping router port information for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping router port information for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping router port information on the active MPU. (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 PIM snooping router port information on the global active MPU. (In IRF mode.)

Usage guidelines

PIM snooping router port information is available only when the device receives fragmented PIM Join messages from PIM snooping neighbor ports.

Examples

# Display PIM snooping router port information for VLAN 2.

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

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

XGE3/1/1 (00:01:30)

XGE3/1/2 (00:01:32)

# Display PIM snooping router port information for VSI aaa.

<Sysname> display pim-snooping router-port vsi aaa

VSI aaa:

Router slots (0 in total):

Router ports (2 in total):

AC (VSI index 0 Link ID 0) (00:02:50)

AC (VSI index 0 Link ID 1) (00:02:59)

Table 2 Command output

Field	Description
VLAN 2	VLAN ID.
VSI aaa	VSI name.
Router slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have router ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have router ports, except for the specified card or the global active MPU when no card is specified.
Router ports (2 in total)	Router ports and total number of router ports.
(00:01:30)	Remaining aging time for the router port. For a global port, this field is always displayed. (In standalone mode.) For a non-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. (In IRF mode.) For a non-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.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.

display pim-snooping routing-table

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

Syntax

In standalone mode:

display pim-snooping routing-table [ vlan vlan-id | vsi vsi-name ] [ verbose ] [ slot slot-number ]

In IRF mode:

display pim-snooping routing-table [ vlan vlan-id | vsi vsi-name ] [ verbose ] [ 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. If you do not specify a VLAN, this command displays PIM snooping routing entries for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays PIM snooping routing entries for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays PIM snooping routing entries on the active MPU. (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 PIM snooping routing entries on the global active MPU. (In IRF mode.)

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

Examples

# Display detailed information about PIM snooping routing entries for VLAN 2.

<Sysname> display pim-snooping routing-table vlan 2 verbose

Total 1 entries.

FSM Flag: NI-no info, J-join, PP-prune pending

VLAN 2: Total 1 entries.

(172.10.10.1, 225.1.1.1)

FSM information: normal

Upstream neighbor: 20.1.1.1

Upstream Slots (0 in total):

Upstream Ports (1 in total):

XGE3/1/1

Downstream Slots (0 in total):

Downstream Ports (2 in total):

XGE3/1/2

Expires: 00:03:01, FSM: J

Downstream Neighbors (2 in total):

7.1.1.1

Expires: 00:59:19, FSM: J

7.1.1.11

Expires: 00:59:20, FSM: J

XGE3/1/3

Expires: 00:02:21, FSM: PP

# Display PIM snooping routing entries for VSI aaa.

<Sysname> display pim-snooping routing-table vsi aaa

Total 1 entries.

FSM Flag: NI-no info, J-join, PP-prune pending

VSI aaa: Total 1 entries.

(172.10.10.1, 225.1.1.1)

Upstream neighbor: 20.1.1.1

Upstream Slots (0 in total):

Upstream Ports (1 in total):

AC (VSI index 0 Link ID 0)

Downstream Slots (0 in total):

Downstream Ports (1 in total):

AC (VSI index 0 Link ID 1)

Expires: 00:03:23, FSM: J

Table 3 Command output

Field	Description
Total 1 entries	Total number of (S, G) entries and (*, G) entries.
FSM Flag: NI-no info, J-join, PP-prune pending	State machine flag of the downstream port: · NI—Initial state. · J—Join. · PP—Prune pending.
VLAN 2: Total 1 entries	Total number of (S, G) entries and (*, G) entries in VLAN 2.
VSI aaa: Total 1 entries	Total number of (S, G) entries and (*, G) entries in VSI aaa.
(172.10.10.1, 225.1.1.1)	(S, G) entry.
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.
Upstream neighbor	Upstream neighbor of the (S, G) or (*, G) entry.
Upstream Slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have the upstream neighbor, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the upstream neighbor, except for the specified card or the global active MPU when no card is specified.
Upstream Ports (1 in total)	Upstream ports, and the total number of upstream ports. (In standalone mode.) 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. (In IRF mode.) 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.
Downstream Slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have downstream ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have downstream ports, except for the specified card or the global active MPU when no card is specified.
Downstream Ports (2 in total)	Downstream ports of the upstream neighbor, and the total number of the downstream ports.
Downstream Neighbors (2 in total)	Downstream neighbors of the downstream port, and the total number of the downstream neighbors.
Expires: 00:03:01, FSM: J	Remaining aging time for the downstream port or downstream neighbor, and the finite state machine information. For a global port, this field is always displayed. (In standalone mode.) For a non-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. (In IRF mode.) For a non-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.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.

display pim-snooping statistics

Use display pim-snooping statistics to display statistics for the PIM messages learned through PIM snooping.

Syntax

display pim-snooping statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for the PIM messages learned through PIM snooping.

<Sysname> display pim-snooping statistics

Received PIMv2 hello: 100

Received PIMv2 join/prune: 100

Received PIMv2 error: 0

Received PIMv2 messages in total: 200

Received PIMv1 messages in total: 0

Table 4 Command output

Field	Description
Received PIMv2 hello	Number of received PIMv2 hello messages.
Received PIMv2 join/prune	Number of received PIMv2 join/prune messages.
Received PIMv2 error	Number of received PIMv2 messages with errors.
Received PIMv2 messages in total	Total number of received PIMv2 messages.
Received PIMv1 messages in total	Total number of received PIMv1 messages.

Related commands

reset pim-snooping statistics

pim-snooping enable

Use pim-snooping enable to enable PIM snooping for a VLAN or VSI.

Use undo pim-snooping enable to disable PIM snooping for a VLAN or VSI.

Syntax

pim-snooping enable

undo pim-snooping enable

Default

PIM snooping is disabled for a VLAN or VSI.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping feature and enable IGMP snooping for a VLAN or VSI before you enable PIM snooping for the VLAN or VSI.

PIM snooping does not take effect on sub-VLANs of a multicast VLAN.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping and PIM snooping for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] pim-snooping enable

# Enable IGMP snooping globally, and enable IGMP snooping and PIM snooping for VSI aaa.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] pim-snooping enable

Related commands

igmp-snooping

igmp-snooping enable

pim-snooping graceful-restart join-aging-time

Use pim-snooping graceful-restart join-aging-time to set the aging time for global downstream ports and global router ports after an active/standby switchover.

Use undo pim-snooping graceful-restart join-aging-time to restore the default.

Syntax

pim-snooping graceful-restart join-aging-time seconds

undo pim-snooping graceful-restart join-aging-time

Default

The aging time is 210 seconds for global neighbor ports after an active/standby switchover.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging time in the range of 210 to 18000 seconds.

Usage guidelines

You must enable PIM snooping for a VLAN or VSI before you execute this command.

For a global router port or global downstream port, the set aging time does not take effect when the port receives a PIM join message after an active/standby switchover. The aging time for the port is determined by the aging time in the PIM join message.

Examples

# In VLAN 2, set the aging time to 600 seconds for global downstream ports and global router ports after an active/standby switchover.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] pim-snooping enable

[Sysname-vlan2] pim-snooping graceful-restart join-aging-time 600

# In VSI aaa, set the aging time to 600 seconds for global downstream ports and global router ports after an active/standby switchover.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] pim-snooping enable

[Sysname-vsi-aaa] pim-snooping graceful-restart join-aging-time 600

Related commands

pim-snooping enable

pim-snooping graceful-restart neighbor-aging-time

Use pim-snooping graceful-restart neighbor-aging-time to set the aging time for global neighbor ports after an active/standby switchover.

Use undo pim-snooping graceful-restart neighbor-aging-time to restore the default.

Syntax

pim-snooping graceful-restart neighbor-aging-time seconds

undo pim-snooping graceful-restart neighbor-aging-time

Default

The aging time is 105 seconds for global neighbor ports after an active/standby switchover.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging time in the range of 105 to 18000 seconds.

Usage guidelines

You must enable PIM snooping in a VLAN or VSI before you execute this command.

For a global neighbor port, the set aging time does not take effect when the global neighbor port receives a PIM hello message after an active/standby switchover. The aging time for the global port is determined by the aging time in the PIM hello message.

Examples

# In VLAN 2, set the aging time to 300 seconds for global neighbor ports after an active/standby switchover.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] pim-snooping enable

[Sysname-vlan2] pim-snooping graceful-restart neighbor-aging-time 300

# In VSI aaa, set the aging time to 300 seconds for global neighbor ports after an active/standby switchover.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] pim-snooping enable

[Sysname-vsi-aaa] pim-snooping graceful-restart neighbor-aging-time 300

Related commands

pim-snooping enable

reset pim-snooping statistics

Use reset pim-snooping statistics to clear statistics for the PIM messages learned through PIM snooping.

Syntax

reset pim-snooping statistics

Views

User view

Predefined user roles

network-admin

Examples

# Clear statistics for the PIM messages learned through PIM snooping.

<Sysname> reset pim-snooping statistics

Related commands

display pim-snooping statistics

08-IP Multicast Command Reference

PIM snooping commands

display pim-snooping neighbor

display pim-snooping router-port

display pim-snooping routing-table

display pim-snooping statistics

pim-snooping enable

pim-snooping graceful-restart join-aging-time

pim-snooping graceful-restart neighbor-aging-time

reset pim-snooping statistics

Cloud & AI

InterConnect

Intelligent Computing

Security

SMB Products

Intelligent Terminal Products

Industry Solutions

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Training & Certification

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Online Exhibition Center

Contact Us