{"id":3739,"date":"2022-12-20T17:19:55","date_gmt":"2022-12-20T20:19:55","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/ipnexthop-man8\/"},"modified":"2022-12-20T17:19:55","modified_gmt":"2022-12-20T20:19:55","slug":"ipnexthop-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/ipnexthop-man8\/","title":{"rendered":"IP−NEXTHOP (man8)"},"content":{"rendered":"

IP\u2212NEXTHOP<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
EXAMPLES<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

ip-nexthop \u2212 nexthop object management<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

ip<\/b> [ ip-OPTIONS<\/i> ] nexthop<\/b> { COMMAND<\/i> | help<\/b> }<\/p>\n

ip nexthop<\/b> { show<\/b> | flush<\/b> } SELECTOR<\/i><\/p>\n

ip nexthop<\/b> { add<\/b> | replace<\/b> } id ID NH<\/i><\/p>\n

ip nexthop<\/b> { get<\/b> | del<\/b> } id ID<\/i><\/p>\n

ip nexthop bucket list<\/b> BUCKET_SELECTOR<\/i><\/p>\n

ip nexthop bucket get<\/b> id ID<\/i> index INDEX<\/i><\/p>\n

SELECTOR<\/i> := [ id<\/b> ID<\/i> ] [ dev<\/b> DEV<\/i> ] [ vrf<\/b> NAME<\/i> ] [ master<\/b> DEV<\/i> ] [ groups<\/b> ] [ fdb<\/b> ]<\/p>\n

BUCKET_SELECTOR<\/i> := SELECTOR<\/i> | [ nhid<\/b> ID<\/i> ]<\/p>\n

NH<\/i> := { blackhole<\/b> | [ via<\/b> ADDRESS<\/i> ] [ dev<\/b> DEV<\/i> ] [ onlink<\/b> ] [ encap<\/b> ENCAP<\/i> ] [ fdb<\/b> ] | group<\/b> GROUP<\/i> [ fdb<\/b> ] [ type<\/b> TYPE<\/i> [ TYPE_ARGS<\/i> ] ] }<\/p>\n

ENCAP<\/i> := [ ENCAP_MPLS<\/i> ]<\/p>\n

ENCAP_MPLS<\/i> := mpls<\/b> [ LABEL<\/i> ] [ ttl<\/b> TTL<\/i> ]<\/p>\n

GROUP<\/i> := id<\/b>[,weight<\/b>[\/…]<\/p>\n

TYPE<\/i> := { mpath<\/b> | resilient<\/b> }<\/p>\n

TYPE_ARGS<\/i> := [ RESILIENT_ARGS<\/i> ]<\/p>\n

RESILIENT_ARGS<\/i> := [ buckets<\/b> BUCKETS<\/i> ] [ idle_timer<\/b> IDLE<\/i> ] [ unbalanced_timer<\/b> UNBALANCED<\/i> ]<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

ip nexthop<\/b> is used to manipulate entries in the kernel\u2019s nexthop tables.
ip nexthop add id ID<\/p>\n

add new nexthop entry<\/p>\n

ip nexthop replace id ID<\/p>\n

change the configuration of a nexthop or add new one
via<\/b> [ FAMILY ] ADDRESS<\/i><\/p>\n

the address of the nexthop router, in the address family FAMILY. Address family must match address family of nexthop instance.<\/p>\n

dev<\/b> NAME<\/i><\/p>\n

is the output device.<\/p>\n\n\n
<\/td>\n\n

onlink<\/b><\/p>\n<\/td>\n

<\/td>\n\n

pretend that the nexthop is directly attached to this link, even if it does not match any interface prefix.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

encap<\/b> ENCAPTYPE ENCAPHDR<\/i><\/p>\n

attach tunnel encapsulation attributes to this route.<\/p>\n

ENCAPTYPE<\/i> is a string specifying the supported encapsulation type. Namely:<\/p>\n

mpls<\/b> – encapsulation type MPLS<\/p>\n

ENCAPHDR<\/i> is a set of encapsulation attributes specific to the ENCAPTYPE.<\/i><\/p>\n

mpls<\/b><\/p>\n

MPLSLABEL<\/i> – mpls label stack with labels separated by \/<\/i><\/p>\n

ttl<\/b> TTL<\/i> – TTL to use for MPLS header or 0 to inherit from IP header<\/p>\n

group<\/b> GROUP [<\/i> type<\/b> TYPE [ TYPE_ARGS ] ]<\/i><\/p>\n

create a nexthop group. Group specification is id with an optional weight (id,weight) and a \u2019\/\u2019 as a separator between entries.<\/p>\n

TYPE<\/i> is a string specifying the nexthop group type. Namely:<\/p>\n

mpath<\/b> – Multipath nexthop group backed by the hash-threshold algorithm. The default when the type is unspecified.<\/p>\n

resilient<\/b> – Resilient nexthop group. Group is resilient to addition and deletion of nexthops.<\/p>\n

TYPE_ARGS<\/i> is a set of attributes specific to the TYPE.<\/i><\/p>\n

resilient<\/b><\/p>\n

buckets<\/b> BUCKETS<\/i> – Number of nexthop buckets. Cannot be changed for an existing group<\/p>\n

idle_timer<\/b> IDLE<\/i> – Time in seconds in which a nexthop bucket does not see traffic and is therefore considered idle. Default is 120 seconds<\/p>\n

unbalanced_timer<\/b> UNBALANCED<\/i> – Time in seconds in which a nexthop group is unbalanced and is therefore considered unbalanced. The kernel will try to rebalance unbalanced groups, which might result in some flows being reset. A value of 0 means that no rebalancing will take place. Default is 0 seconds<\/p>\n

blackhole<\/b><\/p>\n

create a blackhole nexthop<\/p>\n\n\n
<\/td>\n\n

fdb<\/b><\/p>\n<\/td>\n

<\/td>\n\n

nexthop and nexthop groups for use with layer-2 fdb entries. A fdb nexthop group can only have fdb nexthops. Example: Used to represent a vxlan remote vtep ip. layer-2 vxlan fdb entry pointing to an ecmp nexthop group containing multiple remote vtep ips.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

ip nexthop delete id ID<\/p>\n

delete nexthop with given id.<\/p>\n

ip nexthop show<\/p>\n

show the contents of the nexthop table or the nexthops selected by some criteria.
dev<\/b> DEV<\/i><\/p>\n

show the nexthops using the given device.<\/p>\n

vrf<\/b> NAME<\/i><\/p>\n

show the nexthops using devices associated with the vrf name<\/p>\n

master<\/b> DEV<\/i><\/p>\n

show the nexthops using devices enslaved to given master device<\/p>\n\n\n\n
<\/td>\n\n

groups<\/b><\/p>\n<\/td>\n

<\/td>\n\n

show only nexthop groups<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

fdb<\/b><\/p>\n<\/td>\n

<\/td>\n\n

show only fdb nexthops and nexthop groups<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

ip nexthop flush<\/p>\n

flushes nexthops selected by some criteria. Criteria options are the same as show.<\/p>\n

ip nexthop get id ID<\/p>\n

get a single nexthop by id<\/p>\n

ip nexthop bucket show<\/p>\n

show the contents of the nexthop bucket table or the nexthop buckets selected by some criteria.<\/p>\n\n\n
<\/td>\n\n

id<\/b> ID<\/i><\/p>\n<\/td>\n

<\/td>\n\n

show the nexthop buckets that belong to a nexthop group with a given id<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

nhid<\/b> ID<\/i><\/p>\n

show the nexthop buckets that hold a nexthop with a given id<\/p>\n

dev<\/b> DEV<\/i><\/p>\n

show the nexthop buckets using the given device<\/p>\n

vrf<\/b> NAME<\/i><\/p>\n

show the nexthop buckets using devices associated with the vrf name<\/p>\n

master<\/b> DEV<\/i><\/p>\n

show the nexthop buckets using devices enslaved to given master device<\/p>\n

ip nexthop bucket get id ID index INDEX<\/p>\n

get a single nexthop bucket by nexthop group id and bucket index<\/p>\n

EXAMPLES <\/a> <\/h2>\n

ip nexthop ls<\/p>\n

Show all nexthop entries in the kernel.<\/p>\n

ip nexthop add id 1 via 192.168.1.1 dev eth0<\/p>\n

Adds an IPv4 nexthop with id 1 using the gateway 192.168.1.1 out device eth0.<\/p>\n

ip nexthop add id 2 encap mpls 200\/300 via 10.1.1.1 dev eth0<\/p>\n

Adds an IPv4 nexthop with mpls encapsulation attributes attached to it.<\/p>\n

ip nexthop add id 3 group 1\/2<\/p>\n

Adds a nexthop with id 3. The nexthop is a group using nexthops with ids 1 and 2 at equal weight.<\/p>\n

ip nexthop add id 4 group 1,5\/2,11<\/p>\n

Adds a nexthop with id 4. The nexthop is a group using nexthops with ids 1 and 2 with nexthop 1 at weight 5 and nexthop 2 at weight 11.<\/p>\n

ip nexthop add id 5 via 192.168.1.2 fdb<\/p>\n

Adds a fdb nexthop with id 5.<\/p>\n

ip nexthop add id 7 group 5\/6 fdb<\/p>\n

Adds a fdb nexthop group with id 7. A fdb nexthop group can only have fdb nexthops.<\/p>\n

ip nexthop add id 10 group 1\/2 type resilient buckets 32<\/p>\n

Add a resilient nexthop group with id 10 and 32 nexthop buckets.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

ip<\/b>(8)<\/p>\n

AUTHOR <\/a> <\/h2>\n

Original Manpage by David Ahern <\/p>\n

\n","protected":false},"excerpt":{"rendered":"

ip-nexthop \u2212 nexthop object management <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,845,4],"class_list":["post-3739","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-ip-nexthop","tag-man8"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3739","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3739"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3739\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3739"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3739"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3739"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}