display pim interface

Function

The display pim interface command displays PIM information on an interface.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] interface [ interface-type interface-number | up | down ] [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value must be an existing VPN instance name.
all-instance	Specifies all the instances.	-
interface-type interface-number	Specifies the type and number of an interface.	-
up	Displays PIM information on interfaces in Up state.	-
down	Displays PIM information on interfaces in Down state.	-
verbose	Displays detailed information about a PIM interface.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

An interface with PIM enabled is called a PIM interface. The display pim interface command is used to display information about PIM interfaces, including the PIM state, number of PIM neighbors, interval at which Hello messages are sent, DR priority, and DR address.

When the display pim interface command is used:

If interface-type interface-number is specified, the command displays various PIM state parameters on the specified interface.
If interface-type interface-number is not specified, the command displays state parameters of all the PIM interfaces.
If up is specified in the command, the command displays parameters of the PIM interfaces in the Up stated.
If down is specified in the command, the command displays parameters of the PIM interfaces in the Down state.

Example

# Display information about all the PIM interfaces.

<HUAWEI> display pim interface
 VPN-Instance: public net
 Interface      State   NbrCnt   HelloInt   DR-Pri     DR-Address
 Loop0          up      0        30         1          10.1.0.2    (local)
 Vlanif10       up      1        30         1          10.1.1.2
 Vlanif20       up      0        30         1          10.1.2.2    (local)
 Vlanif30       up      1        30         1          10.1.3.2

**Table 1** Description of the **display pim interface** command output
Item	Description
Interface	Name of the PIM interface.
State	Status of the PIM interface, Up or Down.
NbrCnt	Number of PIM neighbors on the interface.
HelloInt	Interval for sending Hello messages, in seconds.
DR-Pri	DR priority.
DR-Address	DR address.

# Display detailed information about PIM on VLANIF10.

<HUAWEI> display pim interface vlanif 10 verbose
 VPN-Instance: public net
 Interface: Vlanif10, 10.1.1.1
     PIM version: 2
     PIM mode: Sparse
     PIM state: up
     PIM DR: 10.1.1.2
     PIM DR Priority (configured): 1
     PIM neighbor count: 1
     PIM hello interval: 30 s
     PIM LAN delay (negotiated): 500 ms
     PIM LAN delay (configured): 500 ms
     PIM hello override interval (negotiated): 2500 ms
     PIM hello override interval (configured): 2500 ms 
     PIM Silent: disabled 
     PIM neighbor tracking (negotiated): disabled
     PIM neighbor tracking (configured): disabled
     PIM generation ID: 0XF5712241 
     PIM require-GenID: 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: enabled
     PIM dr-switch-delay timer : 20 s
     Number of routers on link not using DR priority: 0
     Number of routers on link not using LAN delay: 0
     Number of routers on link not using neighbor tracking: 2
     ACL of PIM neighbor policy: myacl
     ACL of PIM ASM join policy: 2000
     ACL of PIM SSM join policy: - 
     ACL of PIM join policy: - 
     PIM ipsec: disabled

Choose Columns...

**Table 2** Description of the **display pim interface verbose** command output
Item	Description
Interface	Name and IP address of the PIM interface.
PIM version	PIM version enabled on the interface.
PIM mode	PIM mode used on the interface.
PIM state	Status of the PIM interface, Up or Down.
PIM DR	DR address on the interface.
PIM DR Priority (configured)	DR priority configured on the interface.
PIM neighbor count	Number of PIM neighbors on the interface.
PIM hello interval	Interval for sending PIM Hello messages, in seconds.
PIM LAN delay (negotiated)	Negotiated delay for transmitting packets on the interface, in milliseconds.
PIM LAN delay (configured)	Configured delay for transmitting packets on the interface, in milliseconds.
PIM hello override interval (negotiated)	Negotiated override interval on the interface, in milliseconds.
PIM hello override interval (configured)	Configured override interval on the interface, in milliseconds.
PIM Silent	Whether the interface is set to PIM silent state. enabled: The interface is in the PIM silent state. disabled: The interface is not in the PIM silent state. This function is configured using the pim silent command.
PIM neighbor tracking (negotiated)	Whether PIM neighbor tracking is enabled on the interface after negotiation. enabled: PIM neighbor tracking is enabled on the interface. disabled PIM neighbor tracking is disabled on the interface.
PIM neighbor tracking (configured)	Whether PIM neighbor tracking is configured on the interface. enabled: PIM neighbor tracking is configured on the interface. disabled PIM neighbor tracking is not configured on the interface. This function is configured using the pim hello-option neighbor-tracking command.
PIM generation ID	Generation ID option on the interface.
PIM require-GenID	Whether the switch is enabled to reject Hello messages not carrying the Generation ID. enabled: The switch is enabled to reject Hello messages not carrying the Generation ID. disabled: The switch is disabled from rejecting Hello messages not carrying the Generation ID. This function is configured using the pim require-genid command.
PIM hello hold interval	Interval during which the receiver of the Hello message to keep its neighbor reachable, in seconds.
PIM assert hold interval	Interval for sending Assert messages, in seconds.
PIM triggered hello delay	Maximum random delay for triggering Hello messages, in seconds.
PIM J/P interval	Interval at which the interface sends Join/Prune messages, in seconds.
PIM J/P hold interval	Period for holding the Join/Prune status on the interface, in seconds.
PIM BSR domain border	Whether the BSR boundary is configured on the interface. enabled: The BSR boundary is configured on the interface. disabled: The BSR boundary is not configured on the interface. This function is configured using the multicast boundary command.
PIM BFD	Whether PIM BFD is enabled. enabled: PIM BFD is enabled. disabled: PIM BFD is disabled. This function is configured using the pim bfd enable command.
PIM BFD min-tx-interval	Minimum interval for sending PIM BFD packets. This parameter is configured using the pim bfd min-tx-interval tx-value command.
PIM BFD min-rx-interval	Minimum interval for receiving PIM BFD packets. This parameter is configured using the pim bfd min-rx-interval rx-value command.
PIM BFD detect-multiplier	PIM BFD detection multiplier. This parameter is configured using the pim bfd detect-multiplier multiplier-value command.
PIM dr-switch-delay timer	DR switching delay.
Number of routers on link not using DR priority	Number of switches that do not use DR priority in all the network segments connected to the interface.
Number of routers on link not using LAN delay	Number of switches that do not use LAN delay in all the network segments connected to the interface.
Number of routers on link not using neighbor tracking	Indicates the number of switches that are not enabled with the neighbor tracing function in the network segment where the interface resides.
ACL of PIM neighbor policy	Neighbor filtering policy configured on the interface.
ACL of PIM ASM join policy	ASM Join information filtering policy configured on the interface.
ACL of PIM SSM join policy	SSM Join information filtering policy configured on the interface.
ACL of PIM join policy	Join information filtering policy configured on the interface.
PIM ipsec	Whether PIM IPSec is configured in the PIM view or interface view, and the SA policy name if PIM IPSec is configured. The value can be: PIM ipsec: enabled(sa-name: sa1) Security association sa1 has been configured to authenticate all PIM protocol packets using the ipsec sa (IPv4) command in the PIM view or the pim ipsec sa command in the interface view. If the SA is configured in the interface view, the configuration on the interface is displayed. Otherwise, the configuration in the PIM view is displayed. PIM hello ipsec: enabled(sa-name: sa1) Security association sa1 has been configured to authenticate only PIM Hello packets using the hello ipsec sa (IPv4) command in the PIM view or the pim hello ipsec sa command in the interface view. If the SA is configured in the interface view, the configuration on the interface is displayed. Otherwise, the configuration in the PIM view is displayed. PIM ipsec: disabled PIM IPSec is not configured in the PIM view or interface view.