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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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 Linux 5.8:
cumulus@switch:~$ nv show router nexthop rib
Installed - Install state
ID Installed UpTime Vrf Valid Via ViaIntf ViaVrf Depends
--- --------- -------- ------- ----- ------------------------- ------------- ------- -------
7 on 00:10:43 default on lo default
8 on 00:13:36 default on eth0 mgmt
9 on 00:13:36 default on eth0 mgmt
10 00:10:43 default on
11 on 00:10:43 default on 192.168.200.1 eth0 mgmt
12 on 00:10:43 default on
15 on 00:10:43 default on
30 on 00:10:43 default on
32 on 00:13:33 default on swp53 default
34 00:13:33 default on swp51 default
36 00:13:33 default on swp52 default
38 00:13:33 default on swp54 default
68 00:10:50 default on peerlink.4094 default
76 on 00:10:48 default on fe80::4ab0:2dff:fe59:eedc peerlink.4094 default
88 00:10:46 default on br_default default
89 00:10:46 default on vlan10v0 RED
90 on 00:10:46 default on vlan10 RED
91 00:10:46 default on vlan10v0 RED
92 00:10:46 default on vlan4024_l3 RED
93 00:10:46 default on vlan20 RED
94 on 00:10:46 default on vlan10 RED
95 on 00:10:46 default on vlan20 RED
96 on 00:10:46 default on vlan30 BLUE
97 00:10:46 default on vlan4036_l3 BLUE
98 on 00:10:46 default on vlan30 BLUE
105 00:10:46 default on vlan4024_l3v0 RED
106 00:10:46 default on vlan20v0 RED
107 00:10:46 default on vlan20v0 RED
108 00:10:46 default on vlan30v0 BLUE
109 00:10:46 default on vlan4036_l3v0 BLUE
110 00:10:46 default on vlan30v0 BLUE
113 00:10:41 default on vxlan48 default
115 on 00:01:57 default on fe80::4ab0:2dff:fe3f:44c1 swp51 default
119 on 00:00:48 default on fe80::4ab0:2dff:fe25:2e13 swp52 default
132 on 00:00:48 default on fe80::4ab0:2dff:fe4e:2c21 swp53 default
138 on 00:00:48 default on fe80::4ab0:2dff:fead:9d3f swp54 default
Cumulus Linux 5.4.0 thru 5.7:
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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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
| Syntax | Description |
|---|---|
<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