display pim interface

Function

The display pim interface command displays information about PIM 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 a VPN instance. vpn-instance-name indicates the name of the VPN instance.	The name is a string of 1 to 31 characters.
all-instance	Specifies all the instances.	-
interface-type interface-number	Indicates the type and number of an FW interface.	-
up	Indicates that the IP status is Up on the PIM interface.	-
down	Indicates that the IP status is Down on the PIM interface.	-
verbose	Indicates detailed information about a PIM interface.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

Configuration Impact

When the display pim interface command is used, the following situations occur:

If vpn-instance or all-instance is not specified, only the public network instance is displayed.
If interface-type interface-number is specified, the information about various PIM state parameters on the interface is displayed.
If interface-type interface-number is not specified, the information about the state parameters of all the PIM interfaces in the current instance is displayed.
If up is set in the command, the information about the parameters of the PIM interface in the Up state is displayed.
If down is set in the command, the information about the parameters of the PIM interfaces in the Down state is displayed.

Example

# Display all the PIM interfaces in the public network instance.

<sysname> display pim interface
 VPN-Instance: public net
 Interface      State   NbrCnt   HelloInt   DR-Pri     DR-Address
 GE0/0/1        up      1        30         1          10.1.1.2
 GE0/0/2        up      0        30         1          192.168.0.2    (local)
 GE0/0/3        up      1        30         1          10.2.1.2
 Loopback0      up      0        30         1          1.1.1.1        (local)

**Table 1** Description of the **display pim interface** command output
Item	Description
VPN-Instance	VPN instance to which the PIM interface belongs
Interface	Name of the PIM interface
State	Status of the PIM interface. up: The interface starts normally. down: An error occurs on the physical link of the interface.
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 GE 1/0/1 of the public network instance.

<sysname> display pim interface GigabitEthernet 0/0/1 verbose
 VPN-Instance: public net                                                       
 Interface: GigabitEthernet0/0/1, 10.1.1.1                                      
     PIM version: 2                                                             
     PIM mode: Sparse                                                           
     PIM state: down                                                            
     PIM DR: 10.1.1.2                                                           
     PIM DR Priority (configured): 1                                            
     PIM neighbor count: 1                                                      
     PIM hello interval: 30 s                                                   
     PIM LAN delay (negotiated): -                                              
     PIM LAN delay (configured): 500 ms                                         
     PIM hello override interval (negotiated): -                                
     PIM hello override interval (configured): 2500 ms                          
     PIM Silent: disabled                                                       
     PIM neighbor tracking (negotiated): -                                      
     PIM neighbor tracking (configured): disabled                               
     PIM join attribute (negotiated): -                                         
     PIM generation ID: -                                                       
     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: disabled
     PIM BFD min-tx-interval: 10 ms
     PIM BFD min-rx-interval: 10 ms
     PIM BFD detect-multiplier: 3
     PIM dr-switch-delay timer: not configured                                  
     Number of routers on link not using DR priority: -                         
     Number of routers on link not using LAN delay: -                           
     Number of routers on link not using neighbor tracking: -                   
     ACL of PIM neighbor policy: -                                              
     ACL of PIM ASM join policy: -                                              
     ACL of PIM SSM join policy: -                                              
     ACL of PIM join policy: -                                                  
     PIM ipsec: disabled

**Table 2** Description of the **display pim interface** **verbose** command output
Item	Description
VPN-Instance	Indicates the VPN instance to which the PIM interface belongs.
Interface	Name of the PIM interface.
PIM version	Indicates the version number of PIM enabled on the interface.
PIM mode	Indicates the PIM mode, that is, dense or sparse.
PIM state	Indicates the status of the PIM interface. up: The interface starts normally. down: An error occurs on the physical link of the interface.
PIM DR	Indicates the DR address on the interface.
PIM DR Priority (configured)	Indicates the configured DR priority on the interface.
PIM neighbor count	Indicates the number of PIM neighbors on the interface.
PIM hello interval	Indicates the interval for sending PIM Hello messages, in seconds.
PIM LAN delay (negotiated)	Indicates the negotiated delay for transmitting packets on the interface, in milliseconds.
PIM LAN delay (configured)	Indicates the configured delay for transmitting packets on the interface, in milliseconds.
PIM hello override interval (negotiated)	Indicates the negotiated override interval on the interface, in milliseconds.
PIM hello override interval (configured)	Indicates the configured override interval on the interface, in milliseconds.
PIM Silent	Indicates whether the PIM Silent function is enabled on the interface.
PIM neighbor tracking (negotiated)	Indicates whether the PIM neighbor tracking function is enabled on the interface after negotiation.
PIM neighbor tracking (configured)	Indicates whether the PIM neighbor tracking function is configured on the interface.
PIM join attribute (negotiated)	Indicates whether the join attribute function is enabled on an interface through negotiation
PIM generation ID	Indicates the generation ID option on the interface.
PIM require-GenID	Indicates whether the function of rejecting the Hello messages without the Generation ID option is enabled.
PIM hello hold interval	Indicates the interval for the receiver of the Hello message to keep its neighbor reachable, in seconds.
PIM assert hold interval	Indicates the interval for sending Assert messages, in seconds.
PIM triggered hello delay	Indicates the maximum random delay for triggering Hello messages, in seconds.
PIM J/P interval	Indicates the interval for the interface to send Join/Prune messages, in seconds.
PIM J/P hold interval	Indicates the period for holding the Join/Prune status on the interface, in seconds.
PIM BSR domain border	Indicates whether the BootStrap router (BSR) domain border is configured on the interface.
PIM BFD	Indicates whether PIM BFD is enabled.
PIM BFD min-tx-interval	Indicates the minimum interval for sending BFD packets.
PIM BFD min-rx-interval	Indicates the minimum interval for receiving BFD packets.
PIM BFD detect-multiplier	Indicates the PIM BFD detection multiple.
PIM dr-switch-delay timer	Indicates the DR switching delay.
Number of routers on link not using DR priority	Indicates the number of FW that do not use DR priority in all the network segments connected to the interface.
Number of routers on link not using LAN delay	Indicates the number of FW 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 routers that are not enabled with the neighbor tracing function in the network segment where the interface resides.
Number of routers on link not using join attribute	Indicates the number of routers where the join attribute function has not been enabled in the network segment where the interface resides.
ACL of PIM neighbor policy	Indicates the neighbor filtering policy configured on the interface.
ACL of PIM ASM join policy	Indicates the Any-Source Multicast (ASM) Join information filtering policy configured on the interface.
ACL of PIM SSM join policy	Indicates the Source-Specific Multicast (SSM) Join information filtering policy configured on the interface.
ACL of PIM join policy	Indicates the Join information filtering policy configured on the interface.
PIM ipsec	Whether IPSec authentication for IPv4 PIM messages is configured on an interface.