RIB Operational commands

Display Routes

The show route command displays information on routes.

Syntax:

show route <option>

Option Description

Option	Description
`-`	Without any option, the command shows the information for all routes for all instances.
`detail`	Shows detailed route information.
`import`	The commands show all the routes imported from another instance. For information about route import command options, see section Show Route Import.
`incoming interface` <name>	Shows the information of the specified interface through which the routes enter to the router.
`instance` <name>	Shows routing table information for a specified instance.
`hierarchy`	Shows routing information in a hierarchical
`ipv4`	Shows route information for the IPv4 routing table.
`ipv6`	Shows route information for the IPv6 routing table.
`l2vpn`	Shows route information for the L2VPN routing table. For information about l2vpn command options, see section Show Route L2VPN.
`mpls`	Shows route information for the MPLS routing table.
`prefix` <value>	Shows route information for a specified destination prefix.
`prefix-length-distribution`	Shows the number of routes with the same prefix length for the sources.
`service`	Shows the number of routes with the same service label.
`source`	Shows routes from a specified source.
`summary`	Shows the number of routes selected by RIB for each source.
`summary platform`	Shows BCM status counts for hardware platforms and VPP status counts for virtual platforms. The `platform` option is available wherever `summary` option is supported for the `show route` command.

-

Without any option, the command shows the information for all routes for all instances.

detail

Shows detailed route information.

import

The commands show all the routes imported from another instance. For information about route import command options, see section Show Route Import.

incoming interface <name>

Shows the information of the specified interface through which the routes enter to the router.

instance <name>

Shows routing table information for a specified instance.

hierarchy

Shows routing information in a hierarchical

ipv4

Shows route information for the IPv4 routing table.

ipv6

Shows route information for the IPv6 routing table.

l2vpn

Shows route information for the L2VPN routing table. For information about l2vpn command options, see section Show Route L2VPN.

mpls

Shows route information for the MPLS routing table.

prefix <value>

Shows route information for a specified destination prefix.

prefix-length-distribution

Shows the number of routes with the same prefix length for the sources.

service

Shows the number of routes with the same service label.

source

Shows routes from a specified source.

summary

Shows the number of routes selected by RIB for each source.

summary platform

Shows BCM status counts for hardware platforms and VPP status counts for virtual platforms. The platform option is available wherever summary option is supported for the show route command.

Example: The following example shows route information.

supervisor@rtbrick: op> show route
Flags: & - Imported
Instance: ce1-vrf, AFI: ipv4, SAFI: unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                                    Outgoing Interface
       198.51.100.201/32                           direct                  0  198.51.100.201                              lo-0/0/3/0
       198.51.100.202/32                           direct                  0  198.51.100.202                              lo-0/0/3/1
       198.51.100.221/32                           bgp                    20  198.51.100.21                               ifl-0/0/2/0
       198.51.100.222/32                           bgp                    20  198.51.100.21                               ifl-0/0/2/0
Instance: ce1-vrf, AFI: ipv6, SAFI: unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                                    Outgoing Interface
       2001:db8:0:1::201/128                       direct                  0  2001:db8:0:1::201                           lo-0/0/3/0
       2001:db8:0:1::202/128                       direct                  0  2001:db8:0:1::202                           lo-0/0/3/1
       2001:db8:0:1::221/128                       bgp                    20  198.51.100.21                               ifl-0/0/2/0
       2001:db8:0:1::222/128                       bgp                    20  198.51.100.21                               ifl-0/0/2/0
Instance: default, AFI: ipv4, SAFI: unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                                    Outgoing Interface
       192.0.2.1/32                                direct                  0  192.0.2.1                                   ifl-0/0/2/0
       192.0.2.0/30                                direct                  0  192.0.2.0                                   ifl-0/0/2/0
       192.0.2.2/32                                arp-nd                  6  192.0.2.2                                   ifl-0/0/2/0
       192.0.2.5/32                                direct                  0  192.0.2.5                                   ifl-0/0/2/100
       192.0.2.4/30                                direct                  0  192.0.2.4                                   ifl-0/0/2/100
       198.51.100.11/32                            direct                  0  198.51.100.11                               lo-0/0/0/0
       198.51.100.12/32                            direct                  0  198.51.100.12                               lo-0/0/0/1
       198.51.100.21/32                            bgp                    20  192.0.2.2                                   ifl-0/0/2/0
       198.51.100.22/32                            bgp                    20  192.0.2.2                                   ifl-0/0/2/0
Instance: default, AFI: ipv4, SAFI: labeled-unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                       Label        Outgoing Interface
       192.0.2.1/32                                direct                  0  192.0.2.1                      -            ifl-0/0/2/0
       192.0.2.0/30                                direct                  0  192.0.2.0                      -            ifl-0/0/2/0
       192.0.2.2/32                                arp-nd                  6  192.0.2.2                      -            ifl-0/0/2/0
       192.0.2.5/32                                direct                  0  192.0.2.5                      -            ifl-0/0/2/100
       192.0.2.4/30                                direct                  0  192.0.2.4                      -            ifl-0/0/2/100
       198.51.100.11/32                            direct                  0  198.51.100.11                  -            lo-0/0/0/0
       198.51.100.12/32                            direct                  0  198.51.100.12                  -            lo-0/0/0/1
       198.51.100.21/32                            bgp                    20  192.0.2.2                      -            ifl-0/0/2/0
       198.51.100.22/32                            bgp                    20  192.0.2.2                      -            ifl-0/0/2/0
Instance: default, AFI: ipv6, SAFI: unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                                    Outgoing Interface
       2001:db8:0:1::11/128                        direct                  0  2001:db8:0:1::11                            lo-0/0/0/0
       2001:db8:0:1::12/128                        direct                  0  2001:db8:0:1::12                            lo-0/0/0/1
       2001:db8:0:1::21/128                        bgp                    20  192.0.2.2                                   ifl-0/0/2/0
       2001:db8:0:1::22/128                        bgp                    20  192.0.2.2                                   ifl-0/0/2/0
       2001:db8:1:1::1/128                         direct                  0  2001:db8:1:1::1                             ifl-0/0/2/0
       2001:db8:1:1::/64                           direct                  0  2001:db8:1:1::                              ifl-0/0/2/0
       2001:db8:2:1::1/128                         direct                  0  2001:db8:2:1::1                             ifl-0/0/2/100
       2001:db8:2:1::/64                           direct                  0  2001:db8:2:1::                              ifl-0/0/2/100
Instance: default, AFI: ipv6, SAFI: labeled-unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                       Label        Outgoing Interface
       2001:db8:0:1::11/128                        direct                  0  2001:db8:0:1::11               -            lo-0/0/0/0
       2001:db8:0:1::12/128                        direct                  0  2001:db8:0:1::12               -            lo-0/0/0/1
       2001:db8:0:1::21/128                        bgp                    20  192.0.2.2                      -            ifl-0/0/2/0
       2001:db8:0:1::22/128                        bgp                    20  192.0.2.2                      -            ifl-0/0/2/0
       2001:db8:1:1::1/128                         direct                  0  2001:db8:1:1::1                -            ifl-0/0/2/0
       2001:db8:1:1::/64                           direct                  0  2001:db8:1:1::                 -            ifl-0/0/2/0
       2001:db8:2:1::1/128                         direct                  0  2001:db8:2:1::1                -            ifl-0/0/2/100
       2001:db8:2:1::/64                           direct                  0  2001:db8:2:1::                 -            ifl-0/0/2/100
Instance: default, AFI: mpls, SAFI: unicast
Flags  Prefix/Label                                Source               Pref  Next Hop                                    Outgoing Interface
       519936,bos:1                                bgp                   170  -                                           -
       519937,bos:1                                bgp                   170  -                                           -
       519938                                      bgp                   170  192.0.2.2                                   ifl-0/0/2/0
       519939                                      bgp                   170  192.0.2.2                                   ifl-0/0/2/0
       519940,bos:1                                bgp                   170  198.51.100.21                               ifl-0/0/2/0
       519941,bos:1                                bgp                   170  198.51.100.21                               ifl-0/0/2/0

Example: A route summary is shown in the following example.

supervisor@rtbrick: op> show route summary
Instance: ce1-vrf
  Source                 Routes
  bgp                         4
  direct                      4
  Total Routes                8
Instance: default
  Source                 Routes
  arp-nd                      2
  bgp                        14
  direct                     24
  Total Routes               40

Example: This example shows routes with IPv4 prefixes of the same length

supervisor@rtbrick: op> show route prefix-length-distribution
Instance: ce1-vrf
  Prefix Length      Count
            /32          4
           /128          4
            Sum          8
Instance: default
  Prefix Length      Count
            /30          4
            /32         14
            /64          4
           /128         12
            Sum         34

The following example displays a summary of routes across all routing instances, including route sources and platform-specific route programming status counts for BCM.

supervisor@rtbrick.net: cfg> show route summary platform
Instance: default
  Source                                 Routes
  arp-nd                                      8
  bgp                                        32
  direct                                     40
  Total Routes                               80

  BCM Status                              Count
  Download success                           40
  Check cross connect table                   8
Instance: new_instance
  Source                                 Routes
  arp-nd                                      4
  direct                                     20
  Total Routes                               24

  BCM Status                              Count
  Download success                           24
Instance: vrf-blue
  Source                                 Routes
  bgp                                         4
  direct                                      4
  Total Routes                                8

  BCM Status                              Count
  Download success                            8
Instance: vrf1-evpn-vpws
  Source                                 Routes
  bgp                                         1
  Total Routes                                1

  BCM Status                              Count
  Download success                            0
  Check cross connect table                   1
Instance: vrf1-vpls-vpws
  Source                                 Routes
  bgp                                         3
  Total Routes                                3

  BCM Status                              Count
  Download success                            0
  Check cross connect table                   3
Instance: vrf2-evpn-vpws
  Source                                 Routes
  bgp                                         2
  Total Routes                                2

  BCM Status                              Count
  Download success                            0
  Check cross connect table                   2
Instance: vrf3-evpn-vpws
  Source                                 Routes
  bgp                                         2
  Total Routes                                2

  BCM Status                              Count
  Download success                            0
  Check cross connect table                   2

The following example displays route source statistics and platform-specific route programming status counts for the specified routing instance.

supervisor@rtbrick.net: cfg> show route instance default summary platform
Instance: default
  Source                                 Routes
  arp-nd                                      8
  bgp                                        32
  direct                                     40
  Total Routes                               80

  BCM Status                              Count
  Download success                           40
  Check cross connect table                   8

The following example displays a summary of imported routes along with their platform-specific route programming status counts for BCM.

supervisor@rtbrick.net: cfg> show route import summary platform
Instance: new_instance
  Source                                 Routes
  arp-nd                                      4
  direct                                     20
  Total Routes                               24
  BCM Status                              Count
  Download success                           24

Show Route Hierarchy

The show route hierarchy command provides the complete information of a prefix at a given afi, safi, instance from its source, RIBD, and FIBD.

Syntax:

show route hierarchy <option>

Option Description

Option	Description
`instance <instance_name>`	Name fof the instance.
`<afi>`	To show only the routes for a specific network protocol, such as IPv4 or IPv6.
`<safi>`	To view specific types of routes, such as IPv4 unicast or IPv6 multicast,received from neighbors.
`<afi> <safi> detail`	Shows information in detail for a specified afi or safi.
`<afi> <safi> instance <instance-name>`	Filter route entries for specified instance for a specifc afi and safi.
`label`	Filters route entries by a specific MPLS label.
`prefix`	Filters route entries by a specified IP prefix.

instance <instance_name>

Name fof the instance.

<afi>

To show only the routes for a specific network protocol, such as IPv4 or IPv6.

<safi>

To view specific types of routes, such as IPv4 unicast or IPv6 multicast,received from neighbors.

<afi> <safi> detail

Shows information in detail for a specified afi or safi.

<afi> <safi> instance <instance-name>

Filter route entries for specified instance for a specifc afi and safi.

label

Filters route entries by a specific MPLS label.

prefix

Filters route entries by a specified IP prefix.

Example:

supervisor@rtbrick: op> show route hierarchy ipv4 unicast instance default prefix 198.51.100.21/32
bgp:
  prefix: 198.51.100.21/32
  preference: 20
    nexthop set hash: 2e55b7ee0226a90d80b6162cb3fc99b80820d75920227ca2
      nexthop hash: 943dee060e61ee157d00bb93d5405802c3ee1bcf701d4d07
        nexthop4: 192.0.2.2
ribd:
  prefix: 198.51.100.21/32
  preference: 20
  source: bgp
    adjacency set hash: 2e55b7ee0226a90d80b6162cb3fc99b80820d75920227ca2
      nexthop hash: 943dee060e61ee157d00bb93d5405802c3ee1bcf701d4d07
        nexthop4: 192.0.2.2, exit interface: ifl-0/0/2/0
        mac address: 98:19:2c:99:47:2d
fibd:
  prefix: 198.51.100.21/32
  preference:  20
  source: bgp
  route status: |VPP Route ADD|-|-|-|-|-|-|-|-|-|-|-|-|-|BCM Route ADD|-|-|-|-|-|-|-|-|BCM Route Adj Fec Update|-
  bcm status: Download success
  vpp status: Add Processed
    adjacency set hash: 2e55b7ee0226a90d80b6162cb3fc99b80820d75920227ca2
      nexthop hash: 943dee060e61ee157d00bb93d5405802c3ee1bcf701d4d07
        nexthop4: 192.0.2.2, exit interface: ifl-0/0/2/0
        mac address: 98:19:2c:99:47:2d

Show Route Import

Syntax:

show route import <option>

Option Description

Option	Description
`import`	The command shows all the routes imported from another instance.
`detail`	Shows detailed information for imported routes.
`instance`	Shows routing table information for a specific instance for imported routes.
`ipv4`	Shows route information for the IPv4 routing table for imported routes.
`ipv6`	Shows route information for the IPv4 routing table for imported routes.
`source`	Shows source of the routing information for the specified source.
`summary`	Shows the number of imported routes selected by RIB for each source.

import

The command shows all the routes imported from another instance.

detail

Shows detailed information for imported routes.

instance

Shows routing table information for a specific instance for imported routes.

ipv4

Shows route information for the IPv4 routing table for imported routes.

ipv6

Shows route information for the IPv4 routing table for imported routes.

source

Shows source of the routing information for the specified source.

summary

Shows the number of imported routes selected by RIB for each source.

Show Route L2VPN

Syntax:

show route l2vpn <option>

Option Description

Option	Description
`l2vpn`	Without any option, the commands display all the L2VPN routes.
`detail`	Shows detailed information for l2vpn routes.
`evpn-vpws`	Shows routing table information for the EVPN-VPWS address family.
`instance`	Shows L2VPN routing table information for a specific instance
`label <label>`	Shows L2VPN routing table information for destination label.
`prefix`	Shows L2VPN routing table information for the destination prefix.
`source`	Shows source information for the L2VPN routes.
`summary`	Shows the number of L2VPN routes selected by RIBD for each source.
`vpls-vpws`	Shows the L2VPN routes from VPLS-VPWS address specified.

l2vpn

Without any option, the commands display all the L2VPN routes.

detail

Shows detailed information for l2vpn routes.

evpn-vpws

Shows routing table information for the EVPN-VPWS address family.

instance

Shows L2VPN routing table information for a specific instance

label <label>

Shows L2VPN routing table information for destination label.

prefix

Shows L2VPN routing table information for the destination prefix.

source

Shows source information for the L2VPN routes.

summary

Shows the number of L2VPN routes selected by RIBD for each source.

vpls-vpws

Shows the L2VPN routes from VPLS-VPWS address specified.

Show Route Resolution

The show route-resolution command displays the routes that were requested to be resolved for their nexthops. Otherwise, it shows the route is unresolved.

Syntax:

show route-resolution <options>

Option Description

Option	Description
`-`	Without any option, the command shows the information for all requests and response tables side by side.
`destination-instance`	Shows the information for all requests and responses for a destination instance.
`look-up instance`	Shows lookup instance routes.
`prefix`	Shows routes for prefix 4 or prefix 6.
`resolved`	Shows resolved routes.
`source`	Shows source of requested source.
`unresolved`	Shows unresolved routes.

-

Without any option, the command shows the information for all requests and response tables side by side.

destination-instance

Shows the information for all requests and responses for a destination instance.

look-up instance

Shows lookup instance routes.

prefix

Shows routes for prefix 4 or prefix 6.

resolved

Shows resolved routes.

source

Shows source of requested source.

unresolved

Shows unresolved routes.

Example 1: Below is an example of the route resolution requested by the protocol BGP.

supervisor@rtbrick: op> show route-resolution source bgp
Prefix: 192.0.2.2, Source: bgp
  Destination instance: default, AFI: ipv4, SAFI: unicast
  Lookup instance: default, AFI: ipv4, SAFI: unicast
  Covering Prefix: 192.0.2.2/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
Prefix: 192.0.2.2, Source: bgp
  Destination instance: default, AFI: ipv4, SAFI: labeled-unicast
  Lookup instance: default, AFI: ipv4, SAFI: labeled-unicast
  Covering Prefix: 192.0.2.2/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
Prefix: 192.0.2.2, Source: bgp
  Destination instance: default, AFI: ipv6, SAFI: unicast
  Lookup instance: default, AFI: ipv4, SAFI: unicast
  Covering Prefix: 192.0.2.2/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
Prefix: 192.0.2.2, Source: bgp
  Destination instance: default, AFI: ipv6, SAFI: labeled-unicast
  Lookup instance: default, AFI: ipv4, SAFI: labeled-unicast
  Covering Prefix: 192.0.2.2/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
Prefix: 198.51.100.21, Source: bgp
  Destination instance: default, AFI: ipv4, SAFI: vpn-unicast
  Lookup instance: default, AFI: ipv4, SAFI: labeled-unicast
  Covering Prefix: 198.51.100.21/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
Prefix: 198.51.100.21, Source: bgp
  Destination instance: default, AFI: ipv6, SAFI: vpn-unicast
  Lookup instance: default, AFI: ipv4, SAFI: labeled-unicast
  Covering Prefix: 198.51.100.21/32
  Interface        MAC Address         Nexthop
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2
  ifl-0/0/2/0      98:19:2c:99:47:2d   192.0.2.2

Example 2: Below is an example of the unresolved route resolution.

supervisor@rtbrick>ufi07.q2c.u21.r4.nbg.rtbrick.net: cfg> show route-resolution unresolved
192.168.16.128, Source: radius
  Lookup      instance: inband_mgmt, AFI: ipv4, SAFI: unicast
  Covering Prefix: None, 7 resolution attempts
198.18.73.251, Source: pim
  Lookup      instance: ip2, AFI: ipv4, SAFI: unicast
  Covering Prefix: None, 7 resolution attempts

Show Route rib-in

The show route rib-in command shows all advertised routes' information received and stored in the inbound RIB (Routing Information Base). These commands allow you to view routes based on specific criteria such as instance, source, address family (AFI), subsequent address family identifier (SAFI) and so on.

Syntax:

show route rib-in <options>

Option Description

Option	Description
`-`	Without any option, the command shows the information for all routes in the routing information base.
`detail`	Provides a detailed view of routes matching the specified prefix in the inbound RIB.
`<afi>`	To show only the routes for a specific network protocol, such as IPv4 or IPv6.
`<safi>`	To view specific types of routes, such as IPv4 unicast or IPv6 multicast, received from neighbors.
`instance <instance>`	Shows the routes in the inbound RIB of a specific routing instance.
`source <source>`	Shows the routes in the inbound RIB from a specific neighbor.
`summary`	Provides a summary view of all routes in the inbound RIB.

-

Without any option, the command shows the information for all routes in the routing information base.

detail

Provides a detailed view of routes matching the specified prefix in the inbound RIB.

<afi>

To show only the routes for a specific network protocol, such as IPv4 or IPv6.

<safi>

To view specific types of routes, such as IPv4 unicast or IPv6 multicast, received from neighbors.

instance <instance>

Shows the routes in the inbound RIB of a specific routing instance.

source <source>

Shows the routes in the inbound RIB from a specific neighbor.

summary

Provides a summary view of all routes in the inbound RIB.

Show Route Prefix

The show route prefix command shows all advertised routes' information received and stored in the inbound RIB (Routing Information Base).

Syntax:

show route prefix <options>

Option Description

Option	Description
`-`	Without any option, the command shows the information for all routes in the routing information base.
`prefix <value>`	Specify the prefix. This is to see if a specific route with a particular prefix has been received from a neighbor.
`rib-in`	Shows all routes currently stored in the routing information base without any filtering.
`detail`	Provides a detailed view of routes matching the specified prefix in the inbound RIB.

-

Without any option, the command shows the information for all routes in the routing information base.

prefix <value>

Specify the prefix. This is to see if a specific route with a particular prefix has been received from a neighbor.

rib-in

Shows all routes currently stored in the routing information base without any filtering.

detail

Provides a detailed view of routes matching the specified prefix in the inbound RIB.