display bgp peer (or slow-peer)

Function

The display bgp peer command displays information about BGP peers.

The display bgp slow-peer command displays information about slow BGP peers.

Format

display bgp { peer | slow-peer }

display bgp labeled { peer | slow-peer }

Parameters

Parameter	Description	Value
labeled	Indicates the peer is in the BGP labeled address family.	-

Parameter

Description

Value

labeled

Indicates the peer is in the BGP labeled address family.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bgp	read

Usage Guidelines

Usage Scenario

The display bgp peer command displays BGP peer information. You can implement the following operations based on the command output:

To check the status of BGP connections
To check information about a BGP peer
To check whether a BGP peer is configured using the peer as-number command
To check whether a BGP peer is deleted using the undo peer as-number command
To check information about slow BGP peers, run the display bgp slow-peer command. The information includes the time when a peer began to be identified as a slow peer, the time when a peer last exited from the slow peer state, the number of times a peer has been identified as a slow peer, and the remaining time for a peer to exit from the slow peer state.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display peer information.

<HUAWEI> display bgp peer

 BGP local router ID : 1.2.3.4
 Local AS number : 10
 Total number of peers : 2                 
 Peers in established state : 1

  Peer          V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  1.1.1.1       4   100        0        0     0 00:00:07        Idle       0
  2.2.2.2       4   200       32       35     0 00:17:49 Established       0

**Table 1** Description of the **display bgp peer (or slow-peer)** command output
Item	Description
BGP local router ID	Router ID of the BGP local device. If two ends have the same BGP local router ID, no BGP peer relationship can be established between them. In this situation, run the router id command in the BGP view on either end to change the BGP local router ID. Changing it to the IP address of a loopback interface is recommended.
Local AS number	Local AS number.
AS	AS number.
Total number of peers	Total number of BGP peers.
Peers in established state	Number of BGP peers in Established state.
Peer	IP address of the peer.
V	BGP version used on the peer.
MsgRcvd	Number of received messages.
MsgSent	Number of sent messages.
OutQ	Message to be sent to the specified peer.
Up/Down	Period during which a BGP session keeps the current state. When the duration is shorter than 24 hours, the value is displayed as xx:xx:xx, indicating xx hours xx minutes and xx seconds. When the duration is longer than 24 hours, xxxxhxxm is displayed, indicating xxxx hours and xx minutes.
State	Status of the peer: Idle: indicates that BGP denies any request of entering. This is the initiatory status of BGP. Upon receiving a Start event, BGP initiates a TCP connection request to the remote BGP peer, starts the ConnectRetry Timer with the initial value, listens for a TCP connection request initiated by the remote BGP peer, and changes its state to Connect. Connect: indicates that BGP is waiting for the TCP connection to be set up before it determines whether to perform other operations. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection request to the remote BGP peer, and stays in the Connect state. Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect. If BGP initiates a TCP connection request with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state. OpenSent: indicates that BGP has sent one Open message to its peer and is waiting for the other Open message from the peer. If there are no errors in the Open message received, BGP changes its state to OpenConfirm. If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection request initiated by the remote peer, and changes its state to Active. OpenConfirm: indicates that BGP is waiting for a Notification or Keepalive message. If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle. If BGP receives a Keepalive message, BGP changes its state to Established. Established: indicates that BGP peers can exchange Update, Notification, and Keepalive messages. If BGP receives an Update or a Keepalive message, its state stays in Established. If BGP receives a Notification message, BGP changes its state to Idle. No neg: The address family is not enabled for the BGP peer. In this state, Update messages can be exchanged in other address families whose capabilities have been successfully negotiated. If the address family is enabled for the BGP peer, the local BGP peer receives a Notification message, and the peer relationship is disconnected. Then, the BGP peer changes to the Idle state and re-establishes the peer relationship.
PrefRcv	Number of route prefixes sent from the peer.