Router Nexthop


nv show router nexthop

Shows information about the next hops in the RIB, such as the IP address, VRF, interface, type, and so on.

Add -o json at the end of the command to see the output in a more readable format.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show router nexthop -o json
{
  "rib": {
    "29": {
      "address-family": "ipv4",
      "installed": "on",
      "interface-index": 1,
      "ref-count": 2,
      "resolved-via": {
        "lo": {
          "flags": {
            "active": {},
            "directly-connected": {},
            "installed": {}
          },
          "type": "interface",
          "vrf": "default"
        }
      },
      "type": "zebra",
      "valid": "on",
      "vrf": "default"
    },
    "30": {
      "address-family": "ipv4",
      "installed": "on",
      "interface-index": 2,
      "ref-count": 2,
      "resolved-via": {
        "eth0": {
          "flags": {
            "active": {},
            "directly-connected": {},
            "installed": {}
          },
          "type": "interface",
          "vrf": "mgmt"
        }
      },
      "type": "zebra",
      "valid": "on",
      "vrf": "default"
    },
    "31": {
      "address-family": "ipv4",
      "interface-index": 65,
      "ref-count": 2,
      "resolved-via": {
        "vlan30v0": {
          "flags": {
            "active": {},
            "directly-connected": {},
            "installed": {}
          },
          "type": "interface",
          "vrf": "BLUE"
        }
... 

nv show router nexthop group

Shows the next hop groups in the RIB. Next hop groups are a way to encapsulate ECMP information together.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show router nexthop group

nv show router nexthop group <nexthop-group-id>

Shows information about the specified next hop group in the RIB.

Command Syntax

SyntaxDescription
<nexthop-group-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show router nexthop 1

nv show router nexthop group <nexthop-group-id> via

Shows information about the next hop addresses for the specified next hop group.

Command Syntax

SyntaxDescription
<nexthop-group-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show router nexthop 1 via

nv show router nexthop group <nexthop-group-id> via <via-id>

Shows details of a particular next hop group specified by the next hop address.

Command Syntax

SyntaxDescription
<nexthop-group-id>The next hop group ID.
<via-id>The IP address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv show router nexthop 10 via fe80::a00:27ff:fea6:b9fe

nv show router nexthop rib

Shows information about the next hops in the RIB, such as the IP address, VRF, interface, type, and so on.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib
Nexthop-group  address-family  installed  interface-index  ref-count  type   valid  vrf      Summary           
-------------  --------------  ---------  ---------------  ---------  -----  -----  -------  ------------------
...
75             ipv4            on         74               2          zebra  on     default                    
76             ipv4            on         74               2          zebra  on     default                    
77             unspecified     on                          2          zebra  on     default  Nexthop-group:  78
                                                                                             Nexthop-group:  79
                                                                                             Nexthop-group:  78
                                                                                             Nexthop-group:  79
78             ipv4            on         67               3          zebra  on     default                    
79             ipv4            on         67               3          zebra  on     default                    
90             ipv6            on         55               8          zebra  on     default                    
96             ipv6            on         54               8          zebra  on     default                    
108            unspecified     on                          6          zebra  on     default  Nexthop-group: 109
                                                                                             Nexthop-group:  65
                                                                                             Nexthop-group:  90
                                                                                             Nexthop-group:  96
                                                                                             Nexthop-group: 109
                                                                                             Nexthop-group:  65
                                                                                             Nexthop-group:  90
                                                                                             Nexthop-group:  96
...

nv show router nexthop rib <nhg-id>

Shows information about the specified next hop in the RIB.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 108
                operational  applied
--------------  -----------  -------
address-family  unspecified         
installed       on                  
ref-count       6                   
type            zebra               
valid           on                  
vrf             default             

resolved-via
===============
    Nexthop                    type        vrf      weight  Summary         
    -------------------------  ----------  -------  ------  ----------------
    fe80::4ab0:2dff:fe60:910e  ip-address  default  1       Interface: swp54
    fe80::4ab0:2dff:fea7:7852  ip-address  default  1       Interface: swp53
    fe80::4ab0:2dff:fec8:8fb9  ip-address  default  1       Interface: swp52
    fe80::4ab0:2dff:feff:e147  ip-address  default  1       Interface: swp51

resolved-via-backup
======================

depends
==========
    Nexthop-group
    -------------
    65           
    90           
    96           
    109          

dependents
=============

nv show router nexthop rib <nhg-id> depends

Shows information about the next hops on which a specific next hop relies.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 39 depends

nv show router nexthop rib <nhg-id> dependents

Shows information about the next hop dependents on which a specific next hop relies.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 10 dependents

nv show router nexthop rib <nhg-id> resolved-via

Shows details about the next hop address for a particular next hop.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$  nv show router nexthop rib 39 resolved-via
Nexthop  type       vrf      weight  Summary
-------  ---------  -------  ------  -------
vxlan99  interface  default 

nv show router nexthop rib <nhg-id> resolved-via <resolved-via-id>

Shows details of a particular next hop specified by the next hop IP address.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.
<resolved-via-id>The next hop IP address.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 39 resolved-via vxlan99
      operational  applied  pending
----  -----------  -------  -------
type  interface                    
vrf   default                      

interface
============

nv show router nexthop rib <nhg-id> resolved-via-backup

Shows information about the backup next hops for the specified next hop.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 39 resolved-via-backup

nv show router nexthop rib <nhg-id> resolved-via-backup <resolved-via-id>

Shows information about a specific backup next hop.

Command Syntax

SyntaxDescription
<nhg-id>The next hop group ID.
<resolved-via-id>The IP address.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show router nexthop rib 20 resolved-via-backup 

nv show vrf <vrf-id> router nexthop-tracking

Shows the IPv4 and IPv6 next hop tracking information for the specified VRF. Next hop tracking is an optimization feature that reduces the processing time involved in the BGP bestpath algorithm by monitoring changes to the routing table.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking
      resolved-via-default  Summary                              
----  --------------------  -------------------------------------
ipv4                        ip-address:                10.10.10.2
                            ip-address:                10.10.10.3
                            ip-address:                10.10.10.4
                            ip-address:              192.168.0.22
ipv6                        ip-address: fe80::4ab0:2dff:fe08:9898
                            ip-address: fe80::4ab0:2dff:fed8:67cb

nv show vrf <vrf-id> router nexthop-tracking <afi>

Shows the IPv4 or IPv6 next hop tracking information for the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<afi>The address family (IPv4 or IPv6).

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking ipv4
              operational   applied  pending
------------  ------------  -------  -------
[ip-address]  10.10.10.2                    
[ip-address]  10.10.10.3                    
[ip-address]  10.10.10.4                    
[ip-address]  192.168.0.22

nv show vrf <vrf-id> router nexthop-tracking <afi> route-map

Shows the IPv4 or IPv6 next hop tracking information for all route maps in the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<afi>The address family (IPv4 or IPv6).

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking ipv4 route-map ROUTEMAP1

nv show vrf <vrf-id> router nexthop-tracking <afi> route-map <nht-routemap-id>

Shows the IPv4 or IPv6 next hop tracking information for a specific route map in the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<afi>The address family (IPv4 or IPv6).
<nht-routemap-id>The next hop tracking route map name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking ipv4 route-map ROUTEMAP1

nv show vrf <vrf-id> router nexthop-tracking <afi> route-map <nht-routemap-id> protocol

Shows the IPv4 or IPv6 next hop tracking information for all protocols in the route map in the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<afi>The address family (IPv4 or IPv6).
<nht-routemap-id>The next hop tracking route map name.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking ipv4 route-map ROUTEMAP1

nv show vrf <vrf-id> router nexthop-tracking <afi> route-map <nht-routemap-id> protocol <nht-protocol-id>

Shows the IPv4 or IPv6 next hop tracking information for a specific route map protocol for the specified VRF.

Command Syntax

SyntaxDescription
<vrf-id>The VRF name.
<afi>The address family (IPv4 or IPv6).
<nht-routemap-id>The next hop tracking route map name.
<nht-protocol-id>The protocol: bgp, ospf, ospf6, or static.

Version History

Introduced in Cumulus Linux 5.3.0

Example

cumulus@switch:~$ nv show vrf default router nexthop-tracking ipv4 route-map ROUTEMAP1 bgp