display mpls route-state

Function

The display mpls route-state command displays routing information about a dynamic label switched path (LSP).

Format

display mpls route-state [ vpn-instance vpn-instance-name ] [ { exclude | include } { idle | ready | settingup } * | destination-address mask-length ] [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
exclude	Displays routing information excluding the specified route.	-
include	Displays information about a specified route.	-
idle	Indicates that a route is not used to establish an LSP.	-
ready	Indicates that a route has been used to establish an LSP.	-
settingup	Indicates that a signaling protocol is creating an LSP.	-
destination-address	Specifies the destination address.	-
mask-length	Specifies the mask length of a specified destination address.	An integer ranging from 0 to 32
verbose	Displays detailed routing information about an LSP.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If no destination address or mask is not specified, all routing information is displayed.

Precautions

Only routing states of the LSPs that are set up based on dynamic signaling protocols can be changed. Therefore, the display mpls route-state command displays only routing states of dynamic LSPs, but not routing information about static LSPs.

Example

# Display all routing states related to an LSP.

<sysname>display mpls route-state verbose

Codes: B(BGP), I(IGP), L(Public Label BGP), O(Original BGP), U(Unknow)
--------------------------------------------------------------------------------
Dest/Mask         Next-Hop       Out-Interface        State    LSP   VRF Type
-------------------------------------------------------------------------------
10.10.10.1/32    10.21.22.21    GigabitEthernet0/0/0   READY  2     0   I
     LspIndex: 30720,    InLabel: NULL,     OutLabel: 3
     LspIndex: 32728,    InLabel: 1024,     OutLabel: 3

**Table 1** Description of the **display mpls route-state verbose** command output
Item	Description
Dest/Mask	Destination IP address and mask length
Next-Hop	Next-hop IP address
Out-Interface	Outgoing interface
State	Routing state of the MPLS control plane: IDLE: The route is not used to establish an LSP. SETTINGUP: A signaling protocol is creating an LSP. READY: The route has been used to establish an LSP.
LSP	Number of LSPs reachable to the destination address
VRF	Index of a VPN instance The value 0 indicates the public network.
Type	Route type: B: BGP routes I: IGP routes L: labeled BGP routes of a public network O: original BGP routes U: unidentified routes
LspIndex	Index of an LSP established using the route.
InLabel	Incoming label of an LSP established using the route
OutLabel	Outgoing label of an LSP established using the route