IP-NEXTHOP(8) | Linux | IP-NEXTHOP(8) |
ip-nexthop - nexthop object management
ip [ ip-OPTIONS ] nexthop { COMMAND | help }
ip nexthop { show | flush } SELECTOR
ip nexthop { add | replace } id ID NH
ip nexthop { get | del } id ID
ip nexthop bucket list BUCKET_SELECTOR
ip nexthop bucket get id ID index INDEX
SELECTOR := [ id ID ] [ dev DEV ] [ vrf NAME ] [ master DEV ] [ groups ] [ fdb ]
BUCKET_SELECTOR := SELECTOR | [ nhid ID ]
NH := { blackhole | [ via ADDRESS ] [ dev DEV ] [ onlink ] [ encap ENCAP ] [ fdb ] | group GROUP [ fdb ] [ type TYPE [ TYPE_ARGS ] ] }
ENCAP := [ ENCAP_MPLS ]
ENCAP_MPLS := mpls [ LABEL ] [ ttl TTL ]
GROUP := id[,weight[/...]
TYPE := { mpath | resilient }
TYPE_ARGS := [ RESILIENT_ARGS ]
RESILIENT_ARGS := [ buckets BUCKETS ] [ idle_timer IDLE ] [ unbalanced_timer UNBALANCED ]
ip nexthop is used to manipulate entries in the kernel's nexthop tables.
ENCAPTYPE is a string specifying the supported encapsulation type. Namely:
mpls - encapsulation type MPLS
ENCAPHDR is a set of encapsulation attributes specific to the
ENCAPTYPE.
mpls
MPLSLABEL - mpls label stack with labels separated by /
ttl TTL - TTL to use for MPLS header or 0 to
inherit from IP header
TYPE is a string specifying the nexthop group type. Namely:
mpath - Multipath nexthop group backed by the hash-threshold
algorithm. The default when the type is unspecified.
resilient - Resilient nexthop group. Group is resilient to addition and deletion of nexthops.
TYPE_ARGS is a set of attributes specific to the TYPE.
resilient
buckets BUCKETS - Number of nexthop buckets. Cannot be
changed for an existing group
idle_timer IDLE - Time in seconds in which a nexthop bucket does not see traffic and is therefore considered idle. Default is 120 seconds
unbalanced_timer UNBALANCED - 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
ip nexthop ls
ip nexthop add id 1 via 192.168.1.1 dev eth0
ip nexthop add id 2 encap mpls 200/300 via 10.1.1.1 dev eth0
ip nexthop add id 3 group 1/2
ip nexthop add id 4 group 1,5/2,11
ip nexthop add id 5 via 192.168.1.2 fdb
ip nexthop add id 7 group 5/6 fdb
ip nexthop add id 10 group 1/2 type resilient buckets 32
Original Manpage by David Ahern <dsahern@kernel.org>
30 May 2019 | iproute2 |