IP-NEXTHOP(8)                        Linux                       IP-NEXTHOP(8)

<?><?><?> (NAME)
       ip-nexthop - <?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> (nexthop)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       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 [  hw_stats {  on | off }  ] [
               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 ]


<?><?><?><?><?><?><?> (DESCRIPTION)
       ip nexthop <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> (nexthop) <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       ip nexthop add id ID
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?>

       ip nexthop replace id ID
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?>

              via [ FAMILY ] ADDRESS
                     <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?> FAMILY.
                     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?>.

              dev NAME
                     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              onlink <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
                     <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
                     <?><?><?><?>.

              encap ENCAPTYPE ENCAPHDR
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
                     <?><?><?> <?><?><?><?>.

                     ENCAPTYPE <?><?><?><?><?><?><?> <?><?><?> <?><?>
                     <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?>:

                             mpls - <?><?><?>
                             <?><?><?><?><?><?><?><?><?><?><?> MPLS

                     ENCAPHDR <?><?><?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     ENCAPTYPE <?><?><?>.

                             mpls
                               MPLSLABEL - <?><?><?><?>
                               <?><?><?><?><?><?><?><?><?> mpls <?><?>
                               <?><?><?><?><?><?><?><?> <?><?> / <?><?> <?><?>
                               <?><?><?> <?><?><?><?><?><?><?>


                               ttl TTL - <?><?><?><?><?> TTL <?><?><?><?>
                               <?><?><?><?><?><?><?> <?><?> <?><?><?> MPLS
                               <?><?> <?><?><?><?><?> 0 <?><?><?><?> <?><?>
                               <?><?><?> <?><?><?><?> <?><?> <?><?><?> IP


              group GROUP [ type TYPE [ TYPE_ARGS ] ]
                     <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
                     <?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?> id <?><?> <?><?><?>
                     <?><?><?><?><?><?><?> (id,weight) <?> <?><?> '/'
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

                     TYPE <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
                     <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?>:

                             mpath - <?><?><?><?> <?><?><?> <?><?><?><?>
                             <?><?><?><?><?><?><?><?> (Multipath)
                             <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
                             hash-threshold. <?><?> <?><?><?><?><?> <?><?>
                             <?><?><?> <?><?><?><?> <?><?><?><?>
                             <?><?><?><?><?> <?><?><?> <?><?><?><?>
                             <?><?><?><?><?><?><?> <?><?><?>.

                             resilient - <?><?><?><?> <?><?><?> <?><?><?><?>
                             <?><?><?><?><?> (Resilient). <?><?><?>
                             <?><?><?><?> <?><?> <?><?><?><?><?>
                             <?><?><?><?><?><?> <?> <?><?><?>
                             <?><?><?><?><?><?><?> <?><?><?><?>
                             <?><?><?><?><?> <?><?><?>.


                     TYPE_ARGS <?><?><?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> TYPE
                     <?><?><?>.

                             resilient
                               buckets BUCKETS - <?><?><?><?><?>
                               <?><?><?><?><?><?><?><?> <?><?><?>
                               <?><?><?><?>. <?><?><?><?> <?><?> <?><?><?><?>
                               <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                               <?><?><?><?>


                               idle_timer IDLE - <?><?><?><?> <?><?> <?><?><?>
                               <?><?><?><?><?> <?><?> <?><?><?> <?><?>
                               <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
                               <?><?><?><?> <?><?><?><?><?><?><?>
                               <?><?><?><?><?><?> <?><?><?><?><?><?><?> (idle)
                               <?><?> <?><?><?> <?><?><?><?><?>
                               <?><?><?><?><?><?>. <?><?><?><?><?>
                               <?><?><?><?><?><?><?> 120 <?><?><?><?><?>
                               <?><?><?>

                               unbalanced_timer UNBALANCED - <?><?><?><?>
                               <?><?> <?><?><?> <?><?><?><?><?> <?><?>
                               <?><?><?> <?><?> <?><?><?><?> <?><?><?>
                               <?><?><?><?> <?><?><?><?><?><?><?><?>
                               <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
                               <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
                               <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                               <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
                               <?><?><?><?><?><?><?><?> <?><?>
                               <?><?><?><?><?><?> <?><?><?><?><?><?>
                               <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
                               <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
                               <?><?><?><?> <?><?><?><?><?><?><?><?>
                               <?><?><?>. <?><?><?><?><?> 0 <?><?> <?><?><?>
                               <?><?><?><?> <?><?><?> <?><?> <?><?><?>
                               <?><?><?><?><?> <?><?><?><?><?> <?><?>
                               <?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?>
                               <?><?><?><?><?><?><?> 0 <?><?><?><?><?>
                               <?><?><?>


              blackhole
                     <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?><?> (blackhole)

              fdb    <?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?>
                     <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> fdb
                     <?><?><?><?> <?>.  <?><?> <?><?><?><?> <?><?><?>
                     <?><?><?><?> fdb <?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> fdb
                     <?><?><?><?>.  <?><?><?><?>: <?><?><?><?> <?><?><?><?><?>
                     <?><?> IP <?><?><?> <?><?><?> VTEP <?><?> vxlan
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
                     fdb <?><?><?><?> <?> <?><?><?><?><?><?> vxlan <?><?>
                     <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> ecmp
                     <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?><?><?> IP <?><?><?> <?><?><?> vtep <?><?><?>.


       ip nexthop delete id ID
              <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.


       ip nexthop show
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?>.

              dev DEV
                     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
                     <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

              vrf NAME
                     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?> <?><?><?> vrf <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?>

              master DEV
                     <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
                     <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
                     <?><?><?><?><?><?> <?><?><?><?> (master)
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?>

              groups <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?> <?><?><?><?>

              fdb    <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> fdb

       ip nexthop flush
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              show <?><?><?><?><?>.


       ip nexthop get id ID
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?>


       ip nexthop bucket show
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?>.

              id ID
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
                     <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?>

              nhid ID
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?>
                     <?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?>

              dev DEV
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?>

              vrf NAME
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?> <?><?><?> vrf
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>

              master DEV
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
                     (master) <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?>


       ip nexthop bucket get id ID index INDEX
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>


<?><?><?><?><?><?> (EXAMPLES)
       ip nexthop ls
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?>.

       ip nexthop add id 1 via 192.168.1.1 dev eth0
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> IPv4 <?><?>
           <?><?><?><?><?> 1 <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> 192.168.1.1 <?><?> <?><?><?><?> <?><?><?><?><?><?>
           eth0.

       ip nexthop add id 2 encap mpls 200/300 via 10.1.1.1 dev eth0
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> IPv4 <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> mpls
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?>.

       ip nexthop add id 3 group 1/2
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> 3. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> 1 <?> 2 <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       ip nexthop add id 4 group 1,5/2,11
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> 4. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> 1 <?> 2 <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> 1
           <?><?> <?><?><?> 5 <?> <?><?><?> <?><?><?><?> 2 <?><?> <?><?><?> 11
           <?><?><?>.

       ip nexthop add id 5 via 192.168.1.2 fdb
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> fdb <?><?>
           <?><?><?><?><?> 5.

       ip nexthop add id 7 group 5/6 fdb
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> fdb
           <?><?> <?><?><?><?><?> 7. <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?> fdb <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> fdb <?><?><?><?>.

       ip nexthop add id 10 group 1/2 type resilient buckets 32
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> (resilient) <?><?>
           <?><?><?><?><?> 10 <?> 32 <?><?><?><?> <?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       ip(8)


<?><?><?><?><?><?><?> (AUTHOR)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> David
       Ahern <dsahern@kernel.org> <?><?><?><?><?> <?><?><?> <?><?><?>.

iproute2                          30 May 2019                    IP-NEXTHOP(8)