PIM snooping configuration commands 1

display pim-snooping neighbor 1

display pim-snooping routing-table· 2

display pim-snooping statistics 3

pim-snooping enable· 4

reset pim-snooping statistics 5

 

display pim-snooping neighbor

Syntax

display pim-snooping neighbor [ vlan vlan-id ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays the PIM snooping neighbor information of the specified VLAN. The vlan-id argument is in the range of 1 to 4094. If you do not specify a VLAN, this command displays the PIM snooping neighbor information of all VLANs.

slot slot-number: Displays the PIM snooping neighbor information of the card specified by its slot number. If no slot is specified, the command displays the PIM snooping neighbor information of all cards.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display pim-snooping neighbor command to display PIM snooping neighbor information.

Examples

# Display PIM snooping neighbor information about VLAN 2.

<Sysname> display pim-snooping neighbor vlan 2

  Total number of neighbors: 2

 

  VLAN ID: 2

    Total number of neighbors: 2

    Neighbor        Port                     Expires   Option Flags

    10.1.1.2        GE3/1/1                   02:02:23  LAN Prune Delay(T)

    20.1.1.2        GE3/1/2                   03:00:05  LAN Prune Delay

Table 1 Output description

Field	Description
Total number of neighbors	Total number of PIM snooping neighbors.
Neighbor	IP address of the PIM snooping neighbor.
Port	Name of the port that connects to the PIM snooping neighbor.
Expires	Remaining time before the PIM snooping neighbor expires. Never means the PIM snooping neighbor never expires.
Option Flags	Possible values includes the following items: ·       LAN Prune Delay—Indicates that the PIM hello messages received from the neighbor carry the LAN_Prune_Delay option. ·       LAN Prune Delay(T)—Indicates that the PIM hello messages received from the neighbor carry the LAN_Prune_Delay option, and the join suppression function has been enabled

 

display pim-snooping routing-table

Syntax

display pim-snooping routing-table [ vlan vlan-id ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan vlan-id: Displays the PIM snooping routing entries of the specified VLAN. The vlan-id argument is in the range of 1 to 4094. If you do not specify a VLAN, this command displays the PIM snooping routing entries in all VLANs.

slot slot-number: Displays  the PIM snooping routing entries on the card specified by its slot number. If no slot is specified, the command displays information about the PIM snooping routing entries on the main board.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the PIM snooping routing entries of VLAN 2.

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

  Total 1 entry(ies)

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

 

  VLAN ID: 2

    Total 1 entry(ies)

    (172.10.10.1, 225.1.1.1)

      Upstream neighbor: 20.1.1.1

        Total number of downstream ports: 2

          1: GE3/1/3

             Expires: 00:03:01, FSM: J

          2: GE3/1/4

      Upstream neighbor: 10.1.1.1

        Total number of downstream ports: 1

          1: GE3/1/5

 

NOTE: ·       To determine the Upstream port field of an upstream interface that is not on the main board, you must specify the slot number of the card that the interface belongs to. ·       To determine the Expires and FSM fields of a non-aggregate interface that is not on the main board, you must specify the slot number of the card that the interface belongs to. For aggregate interfaces, the Expires and FSM fields are displayed, whether the slot number is specified or not.

 

Table 2 Output description

Field	Description
Total 1 entry(ies)	Total number of (S, G) entries and (*, G) entries in the PIM snooping routing table.
FSM Flag: NI-no info, J-join, PP-prune pending	State machine flag of the downstream port. Possible values include: ·       NI—Initial state. ·       J—Join. ·       PP—Prune pending.
(172.10.10.1, 225.1.1.1)	An (S, G) entry.
Upstream neighbor	Upstream neighbor of the (S, G) or (*, G) entry.
Upstream port	Upstream port of the (S, G) entry or (*, G) entry).
FSM	State machine flag of the downstream port.

 

display pim-snooping statistics

Syntax

display pim-snooping statistics [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use the display pim-snooping statistics command to display the statistics for received PIM messages.

Examples

# Display the statistics for received PIM messages.

<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 3 Output description

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

 

pim-snooping enable

Syntax

pim-snooping enable

undo pim-snooping enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use the pim-snooping enable command to enable PIM snooping in a VLAN.

Use the undo pim-snooping enable command to disable PIM snooping in a VLAN.

By default, PIM snooping is disabled.

Before you enable PIM snooping in a VLAN, be sure to enable IGMP snooping globally and specifically in the VLAN.

PIM snooping does not work in a sub-VLAN of a multicast VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping and PIM snooping in 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

reset pim-snooping statistics

Syntax

reset pim-snooping statistics

View

User view

Default level

2: System level

Parameters

None

Description

Use the reset pim-snooping statistics command to clear the statistics for received PIM messages.

Examples

# Clear the statistics for received PIM messages.

<Sysname> reset pim-snooping statistics