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

 

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: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. If you do not specify a VLAN, this command displays PIM snooping neighbor information on 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. (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 display pim-snooping neighbor to display PIM snooping neighbor information.

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 Command output

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. If the PIM snooping neighbor never expires, this field displays Never.
Option Flags	Possible values: ·     LAN Prune Delay—The PIM hello messages received from the neighbor carry the LAN_Prune_Delay option. ·     LAN Prune Delay(T)—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: Specifies a VLAN. The value range for the vlan-id argument is 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 MPU. (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 MPUs 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 display pim-snooping routing-table to display the PIM snooping routing entries.

·     In standalone mode:

¡     To display the Upstream port field of an upstream interface that is not on the MPU, you must specify the slot slot-number option for the interface.

¡     To display the Expires and FSM fields of a non-aggregate interface that is not on the MPU, you must specify slot slot-number option for the interface. There is no such restriction for aggregate interfaces.

·     In IRF mode:

¡     To display the Upstream port field of an upstream interface that is not on the MPU, you must specify chassis chassis-number slot slot-number option for the interface.

¡     To display the Expires and FSM fields of a non-aggregate interface that is not on the MPU, you must specify slot slot-number option for the interface. There is no such restriction for aggregate interfaces.

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

Table 2 Command output

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)	(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 display pim-snooping statistics to display statistics for PIM messages learned through PIM snooping.

Examples

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

 

pim-snooping enable

Syntax

pim-snooping enable

undo pim-snooping enable

View

VLAN view

Default level

2: System level

Parameters

None

Description

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

Use undo pim-snooping enable 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 take effect 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 reset pim-snooping statistics to clear statistics for PIM messages learned through PIM snooping.

Examples

# Clear statistics for PIM messages learned through PIM snooping.

<Sysname> reset pim-snooping statistics