display ip routing-table ip-prefix

Function

The display mbgp routing-table command displays Multicast BGP (MBGP) routes.

The display ip routing-table ip-prefix command displays information about routes with a specified IP prefix list.

Format

display ip routing-table [ vpn-instance vpn-instance-name ] ip-prefix ip-prefix-name [ verbose ]

display mbgp routing-table [ ipv4-address [ [ mask ] | [ mask-length ] ] [ longer-match ] ] [ verbose ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Displays information about the routing table of an IPv4 address family-enabled 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.
ip-prefix ip-prefix-name	Displays information about routes with a specified IP prefix list.	The name is a string of 1 to 169 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
verbose	Displays detailed information about active and inactive routes. If the parameter verbose is not specified, brief information about active routes is displayed.	-
mbgp	Indicates a multicast BGP routing table. (When topology topology-name is specified, the MBGP routing table cannot be displayed.).	-
ipv4-address	Specifies the destination IP address in dotted decimal notation.	The value is in dotted decimal notation.
mask	Specifies mask in dotted decimal notation.	The value is in dotted decimal notation.
mask-length	Specifies mask-length.	The value is an integer that ranges from 0 to 32.
longer-match	Displays only the routes that match the specified network or prefix.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
route-base	read

Usage Guidelines

Usage Scenario

When the verbose parameter is not specified, information about only one route is displayed in each line. The contents include the destination address, mask length, protocol, priority, route cost, route flag, next hop, and outbound interface. This command displays only the preferred routes.

Precautions

After learning the ARP entry of a peer end, VLANIF interfaces, QinQ interfaces and Dot1q VLAN Tag Termination Sub-Interfaces generate a 32-bit ARP Vlink direct route, and the route is displayed in the command output. Regular physical interfaces do not generate a 32-bit ARP Vlink direct route in this case.

Example

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

# Display information about all MBGP routes.

<HUAWEI> display mbgp routing-table
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
Routing Table: MBGP
         Destinations : 1        Routes : 1
 
Destination/Mask  Proto  Pre  Cost  Flags  NextHop  Interface
 
  5.5.5.1/32     MBGP  255     0     R    1.1.1.1   GigabitEthernet0/1/0

# Display the detailed information of the specified routes.

<HUAWEI> display mbgp routing-table 5.5.5.1 verbose
Routing Table : MBGP
Summary Count : 1

  Destination: 5.5.5.1/32
     Protocol: MBGP              Process ID: 0
   Preference: 255                     Cost: 0
      NextHop: 1.1.1.1            Neighbour: 0.0.0.0
        State: Active Adv GotQ          Age: 00h43m25s
          Tag: 0                   Priority: 0
        Label: NULL                 QoSInfo: 0x0
 RelayNextHop: 0.0.0.0            Interface: GigabitEthernet0/1/8
     TunnelID: 0x0                    Flags: R
   RouteColor: 0

# Display the IPv4 routes that match the IP prefixes in the specified IP prefix list.

<HUAWEI> display ip routing-table ip-prefix aa
Route Flags: R - relay, D - download to fib, T - to vpn-instance, B - black hole route
------------------------------------------------------------------------------
Routes Matched by Prefix-list aa:
         Destinations : 1        Routes : 1        

Destination/Mask    Proto  Pre  Cost        Flags NextHop         Interface

       1.1.1.0/24   Static 22   0             D  0.0.0.0         NULL0

**Table 1** Description of the **display ip routing-table ip-prefix** command output
Item	Description
Route Flags	Indicates the route flag: R: indicates a recursive route. D: indicates that the route is downloaded to the Forwarding Information Base (FIB) table.
Routing Table: MBGP	Indicates an MBGP routing table.
Routing Table	Routing Table.
Destinations	Indicates the total number of destination networks or hosts.
Routes	Indicates the total number of routes.
Destination/Mask	Indicates the address and mask length of the destination network or host.
Proto	Indicates the protocol through which routes are learned.
Pre	Indicates the preference.
Cost	Indicates the route cost.
Flags	Indicates the route flag, that is, Route Flags in the header of the routing table.
NextHop	Indicates the next hop.
Interface	Indicates the outbound interface through which the next hop is reachable.
Protocol	Indicates the routing protocol.
Preference	Indicates the preference of the route.
Summary Count	Number of summary routes.
Process ID	Indicates the process ID of the routing protocol.
Destination	Indicates the address and mask length of the destination network or host.
Neighbour	Indicates the neighbor.
State	Indicates the status of routes: Active: indicates active routes. Invalid: indicates invalid routes. Inactive: indicates inactive routes. NoAdv: indicates the routes that cannot be advertised. Adv: indicates the routes that can be advertised. Del: indicates the routes to be deleted. GotQ: indicates the route that finds the next hop and outbound interface or the route that finds the tunnel. WaitQ: indicates the route that does not find the next hop or outbound interface or the route that does not find the tunnel. Stale.: indicates the routes with the stale flag. The routes are used in GR.
Age	Indicates the lifetime of the route.
Tag	Indicates the administrative tag for routes.
Priority	Indicates the priority.
Label	Indicates the allocated MPLS label.
QoSInfo	Indicates QoS information.
RelayNextHop	Indicates the relay next hop.
TunnelID	Tunnel ID. The value 0x0 indicates that no tunnel is used or no tunnel has been set up.
RouteColor	Route color value.