display msdp peer-status

Function

The display msdp peer-status command displays detailed information about MSDP peers.

Format

display msdp [ vpn-instance vpn-instance-name | all-instance ] peer-status [ peer-address ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.	The name is a string of 1 to 31 characters.
all-instance	Indicates all the instances.	-
peer-address	Specifies the address of a remote MSDP peer.	The address is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After MSDP peers establish a TCP connection, the display msdp peer-status command can be used to display detailed information about a specified MSDP peer, such as the interface status, interface configuration, policy for filtering messages, and message statistics.

Precautions

When the display msdp peer-status command is used, the following situations occur:

If vpn-instance or all-instance is not specified, only the public network instance is displayed.
If peer-address is specified, detailed information about the MSDP peer relationship set up with the peer specified by peer-address is displayed.
If peer-address is not specified, detailed information of all MSDP peer relationships set up on the FW is displayed.

Example

# Display the detailed information about MSDP peer 10.110.11.11 in the public network instance

<sysname> display msdp peer-status 10.110.11.11
MSDP Peer Information of VPN-Instance: public net
MSDP Peer 10.110.11.11, AS 100
  Description:
  Information about connection status:
    State: Up
    Up/down time: 14:41:08
    Resets: 0
    Connection interface: LoopBack0 (10.110.11.22)
    Number of sent/received messages: 867/947
    Number of discarded output messages: 0
    Elapsed time since last connection or counters clear: 14:42:40
  Information about (Source, Group)-based SA filtering policy:
    Import policy: none
    Export policy: none
  Information about SA-Requests:
    Policy to accept SA-Request messages: none
    Sending SA-Requests status: disable
  Minimum TTL to forward SA with encapsulated data: 0
  SAs learned from this peer: 0, SA-cache maximum for the peer: none
  Input queue size: 0, Output queue size: 0
  Counters for MSDP message:
    Count of RPF check failure: 0
    Incoming/outgoing SA messages: 0/0
    Incoming/outgoing SA requests: 0/0
    Incoming/outgoing SA responses: 0/0
    Incoming/outgoing data packets: 0/0
    Peer authentication: configured
    Peer authentication type: KeyChain

**Table 1** Description of the **display msdp peer-status** command output
Item	Description
MSDP Peer Information of VPN-Instance	Indicates the VPN instance to which MSDP peer information belongs.
MSDP Peer	Indicates the address of the peer.
AS	Indicates the AS number of the MSDP peer. "?" indicates that the AS number cannot be obtained.
Description	Description of the verbose information.
Information about connection status	Indicates the information of connection status.
State	Indicates the status of the MSDP session. Up: indicates the connection is set up and is in the Up state. Listen: indicates the local host acts as the server and is in the Listen state. The connection is set up. Connect: indicates the local host acts as the client and is in the Connect state. The connection is not set up. Shutdown: indicates the MSDP peer is in the Shutdown state. Down: indicates the connection fails.
Up/down time	Indicates the time when the session becomes Up or Down. The time format is as follows: Time that is shorter than or equal to 24 hours: hour: minute: second Time that is longer than 24 hours but shorter than one week: day: hour Time that is longer than one week: week: day
Resets	Indicates resetting times.
Connection interface	Indicates the address of a connect-interface that is used to set up the TCP connection with the peer address.
Number of sent/received messages	Indicates the number of MSDP messages received or sent through the connection.
Number of discarded output messages	Indicates the number of discarded messages.
Elapsed time since last connection or counters clear	Indicates the period from the time of the latest resetting of the statistics, and inputting and outputting the statistics to the current time.
Information about (Source, Group)-based SA filtering policy	Import policy: is used to receive the filtering list of the Source Active (SA) messages of a specified MSDP peer. You can configure the policy by using the peer sa-policy import command and remove the policy by using the undo peer sa-policy import command. Export policy: is used to forward the filtering list of the SA messages of a specified MSDP peer. You can configure the policy by using the peer sa-policy export command and remove the policy by using the undo peer sa-policy export command. By default, the received and forwarded messages are not filtered. The MSDP peer receives and forwards all the SA messages. The default value is expressed by none.
Information about SA-Requests	Policy to accept SA-Request messages: restricts the SA request messages received from an MSDP peer by the FW. You can set the policy by using the peer sa-request-policy command and remove the configuration by using the undo peer sa-request-policy command. By default, the FW receives all SA request messages sent by the MSDP peer. The default value is expressed by none. Sending SA-Requests status: enables or disables the FW to send SA request messages to a specified MSDP peer when the FW receives a Join message. You can configure the function by using the peer request-sa-enable command and remove the function by using the undo peer sa-request-policy command. By default, when receiving a Join message, the FW does not send the SA request message to its MSDP peers, but waits for the next SA message.
Minimum TTL to forward SA with encapsulated data	If the SA message received is encapsulated with the multicast data packet, the FW forwards the SA message to other peers only when the TTL of the packet is not smaller than the minimum TTL. You can configure the function by using the peer minimum-ttl command and remove the function by using the undo peer minimum-ttl command.
SAs learned from this peer	Indicates the SA messages that pass through the MSDP peer and number of SA entries in the cache.
SA-cache maximum for the peer	Indicates the maximum number of (S, G) entries in the cache when the FW receives the SA message from an MSDP peer. You can configure the maximum number of (S, G) entries in the cache by using the peer sa-cache-maximum command and remove the configuration by using the undo peer sa-cache-maximum command. By default, the number of (S, G) entries in the SA cache is 8192.
Input queue size	Indicates the length of the data added to the cache.
Output queue size	Indicates the length of the data removed from the cache.
Counters for MSDP message	Count of RPF check failure: indicates the number of SA messages discarded because of the RPF check failure. Incoming/outgoing SA messages: indicates the number of sent or received SA messages. Incoming/outgoing SA requests: indicates the number of sent or received SA-Request messages. Incoming/outgoing SA responses: indicates the number of sent or received SA-Response messages. Incoming/outgoing data packets: indicates the number of sent or received SA messages that are encapsulated with multicast data packets.
Peer authentication	Indicates whether MSDP authentication is configured.
Peer authentication type	Indicates MSDP authentication modes, including: none: indicates authentication is not configured. MD5: indicates MD5 authentication. Key-Chain: indicates Key-Chain authentication.