PIM snooping configuration commands 1

display pim-snooping neighbor 1

display pim-snooping routing-table· 2

display pim-snooping statistics 4

pim-snooping enable· 5

reset pim-snooping statistics 6

 

 

NOTE: The switch operates in IRF or standalone (the default) mode. For more information about the IRF mode, see IRF Configuration Guide.

 

display pim-snooping neighbor

Syntax

In standalone mode:

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

In IRF mode:

display pim-snooping neighbor [ vlan vlan-id ] [ chassis chassis-number 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. vlan-id is in the range of 1 to 4094.

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. (In standalone mode)

chassis chassis-number slot slot-number: Displays the PIM snooping neighbor information of a card in an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the number of the slot that holds the card. If this option is not specified, the command displays the PIM snooping neighbor information of all cards in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode)

|: 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. If you do not specify a VLAN, this command displays PIM snooping neighbor information on all VLANs.

Examples

# Display the PIM snooping neighbor information of 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/0/1                   02:02:23  LAN Prune Delay(T)

    20.1.1.2        GE3/0/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 disabled

 

display pim-snooping routing-table

Syntax

In standalone mode:

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

In IRF mode:

display pim-snooping routing-table [ vlan vlan-id ] [ chassis chassis-number 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. vlan-id is in the range of 1 to 4094.

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. (In standalone mode)

chassis chassis-number slot slot-number: Displays the PIM snooping routing entries on a card in an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the number of the slot that holds the card. If this option is not specified, the command displays the PIM snooping routing entries on all active main boards in the IRF member devices. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode)

|: 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. If you do not specify a VLAN, this command displays the PIM snooping routing entries in all VLANs.

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

        Upstream port: GE3/0/1

        Total number of downstream ports: 2

          1: GE3/0/3

          2: GE3/0/4

      Upstream neighbor: 10.1.1.1

        Upstream port: GE3/0/2

        Total number of downstream ports: 1

          1: GE3/0/5

 

NOTE: ·       In standalone mode, 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. ·       In IRF mode, to determine the Upstream port field of an upstream interface that is not on the main board, you must specify the chassis number and slot number of the card that the interface belongs to. ·       In standalone mode, 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. ·       In IRF mode, to determine the Expires and FSM fields of a non-aggregate interface that is not on the main board, you must specify the chassis number and slot number of the card that the interface belongs to. For aggregate interfaces, the Expires and FSM fields are displayed, whether the chassis number and slot number are 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)
Total number of downstream ports	Total number of downstream ports contained in the upstream neighbor of the (S, G) 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 PIM messages learned through PIM snooping.

Examples

# Display the statistics for 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 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 PIM messages learned through PIM snooping.

Examples

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

<Sysname> reset pim-snooping statistics