display pim bfd session

Function

The display pim bfd session command displays the information about PIM BFD sessions.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] bfd session statistics

display pim [ vpn-instance vpn-instance-name | all-instance ] bfd session [ interface interface-type interface-number | neighbor neighbor-address ] ^*

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies a VPN instance. The vpn-instance-name specifies the name of the VPN instance.	The value must be an existing VPN instance name.
all-instance	Indicates all the instances.	-
statistics	Displays PIM BFD statistics.	-
interface interface-type interface-number	Specifies an interface to be displayed. interface-type interface-number specifies the type and number of the interface.	-
neighbor neighbor-address	Specifies the IP address of a PIM neighbor to be displayed.	The address is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When the display pim bfd session command, the following situations occur:

If vpn-instance or all-instance is not specified, the PIM BFD sessions of the public network instance are displayed.
If interface or neighbor is not specified, the PIM BFD sessions on the all the interfaces of a specified instance are displayed.

Example

# Display PIM BFD sessions in all instances and those on all interfaces.

<sysname> display pim all-instance bfd session
 All-instance: Total 4 BFD sessions Created

 VPN-Instance: public net
 Total 4 BFD sessions Created

 GigabitEthernet0/0/1 (10.1.2.2): Total 2 BFD sessions Created

 Neighbor     ActTx(ms)     ActRx(ms)     ActMulti     Local/Remote     State
 10.1.2.3     20            20            5             8756/8652       Up
 10.1.2.4     30            30            3             8754/8423       Up
 
 GigabitEthernet0/0/10 (10.20.1.20): Total 2 BFD sessions Created

 Neighbor     ActTx(ms)     ActRx(ms)     ActMulti     Local/Remote     State
 10.20.1.30   30            30            5             8327/8891       Up
 10.20.1.40   50            50            3             8358/8942       Up

# Display PIM BFD sessions on GE 1/0/1 in the public network instance.

<sysname> display pim bfd session interface GigabitEthernet 0/0/1
 VPN-Instance: public net

 GigabitEthernet0/0/1 (10.1.2.2): Total 2 BFD sessions Created

 Neighbor     ActTx(ms)     ActRx(ms)     ActMulti     Local/Remote     State
 10.1.2.3     20            20            5             8756/8652       Up
 10.1.2.4     30            10            3             8754/8423       Up

# Display PIM BFD sessions on GE 1/0/1 in the public network instance when the FW is not enabled with global BFD.

<sysname> display pim bfd session interface GigabitEthernet 0/0/1
 VPN-Instance: public net 
                                                                                
 GigabitEthernet0/0/1 (10.1.2.2): Total 1 BFD session Created 
                                                                                
 Neighbor    ActTx(ms)    ActRx(ms)    ActMulti    Local/Remote           State 
 10.1.2.1    --           --           --              0/0                BFD global disable

# Display the statistics of a PIM BFD session.

<sysname> display pim bfd session statistics
 VPN-Instance: public net
  Total 1 PIM BFD session in this instance.

   Total 0 PIM BFD session up.
   Total 1 PIM BFD session down.

# Display information about PIM BFD sessions of the public network instance neighbor 10.1.2.3.

<sysname> display pim bfd session neighbor 10.1.2.3

VPN-Instance: public net

 Ethernet1/0/1 (10.1.2.2)  

Neighbor     ActTx(ms)     ActRx(ms)     ActMulti     Local/Remote     State
 10.1.2.3     20             20              5         8756/8652          Up

**Table 1** Description of the **display pim bfd session** command output
Item	Description
VPN-Instance	Indicates the VPN instance to which PIM BFD session information belongs.
GigabitEthernet0/0/1 (10.1.2.2)	Indicates the PIM interface name (the IP address).
Neighbor	Indicates the IP address of a neighbor.
ActTx (ms)	Indicates the actual minimum transmission interval, in milliseconds.
ActRx (ms)	Indicates the actual minimum receiving interval, in milliseconds.
ActMulti	Indicates the actual local detection multiple.
Local/Remote	Indicates the local and remote discriminators.
State	Indicates the status of the PIM BFD session. Up: indicates that the BFD session is set up successfully and detection packets are periodically exchanged. Init: indicates that the local end can communicate with the remote end and wants the session status to be Up. Admin down: indicates that the session is in the administratively Down state (The shutdown command is run in the BFD session view). BFD global disable: indicates that BFD is globally disabled. BFD session number exceed: indicates that the number of BFD session discriminators is out of the range. Detect down: indicates that no BFD packets are not received when the detection time expires. Neighbour down: indicates that the packets with the State field being Down are received from neighbors. Receive admin down: indicates that the packets with the State field being AdminDown are received from neighbors.
Total 1 PIM BFD session in this instance	Indicates the total number of PIM BFD sessions.
Total 0 PIM BFD session up	Indicates the number of PIM BFD sessions in the Up state.
Total 1 PIM BFD session down	Indicates the number of PIM BFD sessions in the Down state, that is, all PIM BFD sessions except the PIM BFD sessions in the Up state.