display static-route

Function

The display static-route command displays static routes.

Format

display static-route routing-table [ vpn-instance vpn-instance-name | topology topology-name ] [ destination-address [ mask-length ] ]

display static-route ipv6 routing-table [ vpn-instance vpn-instance-name | topology topology-name ] [ ipv6-destination-address [ prefix-length ] ]

display static-route multicast routing-table [ vpn-instance vpn-instance-name ] [ destination-address [ mask-length ] ]

display static-route statistics

Parameters

Parameter	Description	Value
destination-address	Specifies a destination IP address.	The value is in dotted decimal notation.
mask-length	Specifies the mask length of a destination IP address.	The value is an integer ranging from 0 to 32.
multicast	Display multicast static routes.	-
routing-table	Displays the information of static routes.	-
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. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string.
topology topology-name	Specifies the name of a topology.	The value is a string of 1 to 31 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive) and can contain numbers, hyphens (-), or underlines (_). When double quotation marks are used around the string, spaces are allowed in the string.
ipv6	Display IPv6 unicast static routes.	-
ipv6-destination-address	Specifies a destination IPv6 address.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
prefix-length	Specifies the mask length of a destination IPv6 address.	The value ranges from 0 to 128.
statistics	Display the maximum number of static routes that can be configured and the number of existing static routes.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
route-base	read

Usage Guidelines

Usage Scenario

To check configured static routes, run the display static-route routing-table command.

To check the maximum number of static routes that can be configured and the number of existing static routes, run the display static-route statistics command.

Example

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

# Display the multicast static routes that match a specified destination IP address.

<HUAWEI> display static-route multicast routing-table 10.1.1.1 24
Multicast Routing Table
Routes : 1

 Mroute 1.1.1.1/32
          Interface = NULL0         RPF Neighbor = 3.3.3.3
          Preference = 1
 Running Configuration = ip rpf-route-static 1.1.1.1 32 3.3.3.3

# Display the IPv6 unicast static routes that match a destination IPv6 address and mask length in a specified VPN.

<HUAWEI> display static-route ipv6 routing-table vpn-instance vrf1 4000::1 64
Summary Count : 1

Destination   : 4000::/64
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0x10                                    RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

# Display the maximum number of static routes that can be configured and the number of existing static routes.

<HUAWEI> display static-route statistics
--------------------------------------------------------------------------------
Max IPv4 route number                : 100000
Max IPv6 route number                : 100000
Current configured IPv4 route number : 1
Current configured IPv6 route number : 0

# Display IPv6 unicast static routes in the base topology of the public network.

<HUAWEI> display static-route ipv6 routing-table
Summary Destinations : 3        Routes : 3

Destination   : 1000::/64
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0xE                                     RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

Destination   : 2000::/64
Preference    : 60                                      Tag            : 0
Interface     : --                                      InterfaceState : --
OriginNextHop : 100::2                                  BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0xF                                     RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 1
DestVrf       : public                                  DestTopo       : base
RelayNextHop  : 100::2                                  RelayInterface : GigabitEthernet0/1/0
TunnelID      : --                                      

Destination   : 3000::/64
Preference    : 60                                      Tag            : 0
Interface     : GigabitEthernet0/1/0                    InterfaceState : UP
OriginNextHop : FE80::1                                 BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0xD                                     RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 0
LocalAddress  : FE80::3A67:CFF:FE10:1100
RemoteIp      : ::

# Display IPv4 unicast static routes in the base topology of the public network.

<HUAWEI> display static-route ip routing-table
Summary Destinations : 1        Routes : 1

Destination   : 1.1.1.1/32
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : 0.0.0.0                                 BfdDetect      : Disable
BfdSession    : 0                                       
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : Disable                                 Label          : NULL
EFMDetect     : Disable                                 EfmInterface   : --
State         : Active Primary                          TunnelPolicy   : 0
Cost          : 0                                       
IndirectID    : 0x10000CD                               RelayType      : NO
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : 0.0.0.0
RemoteIp      : 0.0.0.0
SourceVrfName : --
UserInfo      : 0
DownReason    : 0x0

# Display VPN multicast static routes.

<HUAWEI> display static-route multicast routing-table vpn-instance vrf1
Multicast Routing Table
Routes : 1

 Mroute 1.1.1.1/32
          Interface = NULL0         RPF Neighbor = 4.4.4.4
          Preference = 1
 Running Configuration = ip rpf-route-static vpn-instance vrf1 1.1.1.1 32 4.4.4.4

# Display IPv4 multicast static routes in the base topology of the public network.

<HUAWEI> display static-route multicast routing-table
Multicast Routing Table
Routes : 1

 Mroute 1.1.1.1/32
          Interface = NULL0         RPF Neighbor = 2.2.2.2
          Preference = 1
 Running Configuration = ip rpf-route-static 1.1.1.1 32 2.2.2.2

# Display all IPv6 unicast static routes in a specified VPN.

<HUAWEI> display static-route ipv6 routing-table vpn-instance vrf1
Summary Destinations : 2        Routes : 2

Destination   : 4000::/64
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0x10                                    RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

Destination   : 5000::/64
Preference    : 60                                      Tag            : 0
Interface     : --                                      InterfaceState : --
OriginNextHop : 100::2                                  BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Inactive Invalid                        
IndirectID    : 0x11                                    RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 0
DestVrf       : vrf1

# Display the IPv6 unicast static routes that match a destination IPv6 address and mask length in a specified topology.

<HUAWEI> display static-route ipv6 routing-table topology top1 6000::1 100
Summary Count : 2

Destination   : 6000::/100
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0x12                                    RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

Destination   : 6000::/100
Preference    : 60                                      Tag            : 0
Interface     : --                                      InterfaceState : --
OriginNextHop : 100::2                                  BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Inactive Invalid                        
IndirectID    : 0x13                                    RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 0
DestVrf       : public

**Table 1** Description of the **display static-route** command output
Item	Description
Routes	Total number of routes.
Interface	Outbound interface configured for a route. If no outbound interface is configured for a route, this item is displayed as "-".
RPF Neighbor	The address of RPF neighbor.
Preference	Route priority.
Summary Destinations	Total number of destination network prefixes or host prefixes.
Summary Count	Number of summary routes.
Destination	Destination address/mask length.
Tag	Administrative tag of a route.
InterfaceState	Interface status. If no interface is configured, this item is displayed as "-".
OriginNextHop	Next hop configured for a route. If no next hop is configured for a route, this item is displayed as "::".
BfdDetect	BFD detection result: Disable: indicates that the BFD detection is not enabled. UP: indicates that the BFD session is Up and that routing entries can be delivered. DOWN: indicates that the detection result is Down and that routing entries cannot be delivered. unknown: indicates that the detection result is unknown and that routing entries cannot be delivered. unknown(AdminStatus=Down): indicates that the detection result is unknown, the administration status is Down, and that routing entries can be delivered.
BfdSession	Name of the BFD session.
BfdType	Type of the BFD session: STATIC: static BFD detection. DYNAMIC: dynamic BFD detection.
NQAAdminName	Administrator of an NQA test instance.
NQATestName	Name of an NQA test instance.
NQADetect	Result of the NQA detection: Disable: indicates that the NQA detection is not enabled. UP: indicates that the detection result is Up and that routing entries can be delivered. DOWN: indicates that the detection result is Down and that routing entries cannot be delivered. UNKNOWN: indicates that the detection result is unknown and that routing entries can be delivered.
Label	Label.
State	Route selection result: Active Primary: indicates an active primary route. Active Backup: indicates an active backup route. Inactive Valid: indicates a route that takes part in the route selection but is not preferred. Inactive Invalid: indicates a route that cannot take part in the route selection.
IndirectID	Keyword of indirect next hop.
RelayTunnel	Whether routes can recurse to tunnels.
IIDFlags	Keyword flags of indirect next hop, including BlackHole and GateWay.
RelayDepth	Recursion depth.
LocalAddress	IPv6 address of the local interface. If no IPv6 address is configured for the local interface, this item is displayed as "::". This item is displayed only when the outbound interface of the corresponding route is configured.
RemoteIp	IPv6 address of the remote P2P interface. If no IPv6 address is configured for the remote P2P interface, this item is displayed as "::". This item is displayed only when the outbound interface of the corresponding route is configured.
Max IPv4 route number	Maximum number of static IPv4 routes that can be configured.
Max IPv6 route number	Maximum number of static IPv6 routes that can be configured.
Current configured IPv4 route number	Number of existing static IPv4 routes.
Current configured IPv6 route number	Number of existing static IPv6 routes.
DestVrf	Name of the VPN instance to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.
DestTopo	Name of the destination topology to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.
RelayNextHop	Recursive next hop address. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as "::". This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.
RelayInterface	Name of a recursive outbound interface. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as a tunnel name. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.
TunnelID	ID of a tunnel.
EFMDetect	Possible values are as follows: Disable: indicates that EFM detection is not enabled. UP: indicates that the detection result is Up and the routing entry can be delivered. DOWN: indicates that the detection result is Down and the routing entry cannot be delivered. --: indicates that the detection result is unknown and the routing entry can be delivered.
EfmInterface	Interface to which EFM is bound.
TunnelPolicy	Indicates that the ID of the tunnel policy used by the routes. The value of routes that are not iterated to tunnels is 0.
Cost	Route cost.
RelayType	Indicates the actual iteration type: IP: Indicates that routes are iterated to IP addresses. NO: Indicates that routes are not iterated.
SourceVrfName	VPN instance name.
UserInfo	Service information.
DownReason	Reason why the static route is inactive: 0x0: initializing. 0x1: The interface is Down. 0x2: The NQA session is Down. 0x4: The BFD session is Down. 0x8: The EFM session is Down. 0x10: The iteration depth exceeds the upper limit. 0x20: The route is iterated to the default route. 0x40: The route is iterated to a supernet route. 0x80: No IIDs are obtained. 0x100: The LDP session is Down. 0x200: The route fails to be iterated to another route or tunnel. 0x400: The route is iterated to a local host route. 0x800: The static route is reachable but is not selected as the optimal route according to the route selection rules. 0x1000: The route is iterated to a non-host route. 0xFFFFFFFF: The route is inactive due to an unknown reason.