grcli-nexthop - Man Page

Nexthops.​

Synopsis

nexthop add srv6 seglist SEGLIST+ [[src SRC] [vrf VRF] [id ID] [encap (h.​encaps|h.​encaps.​red)]]

Add SRv6 encap nexthop.​

nexthop add srv6-local behavior (end [[block-bits BLOCK_BITS] [csid-bits CSID_BITS] [flavor [[usd next-csid psp]]]]|end.​x nexthop ADDR iface IFACE [[block-bits BLOCK_BITS] [csid-bits CSID_BITS] [flavor [[usd next-csid psp]]]]|end.​t [[block-bits BLOCK_BITS] [csid-bits CSID_BITS] [flavor [[usd next-csid psp]]]] table TABLE|(end.​dt6|end.​dt46|end.​dt4) [table TABLE]) [[id ID] [vrf VRF]]

Create a new local endpoint.​

nexthop add l3 iface IFACE [[address IP] [mac MAC] remote [id ID]]

Add a new L3 nexthop.​

nexthop add (blackhole|reject) [[id ID] [vrf VRF]]

Add a new blackhole nexthop.​

nexthop add group [id ID] member NHID [weight WEIGHT]+

Add a new nexthop group.​

nexthop config set [lifetime LIFE] [unreachable UNREACH] [held-packets HELD] [ucast-probes UCAST] [bcast-probes BCAST] [max MAX]

Change the nexthop configuration.​

nexthop config show

Show the current nexthop configuration.​

nexthop del ID

Delete a next hop.​

nexthop flush origin (learn|static)

Flush all nexthops with the given origin.​

nexthop show ([id ID]|[[type TYPE] internal [max MAX] [vrf VRF]])

Show next hops, or a single next hop by ID.​

Options

SEGLIST

Next SID to visit.​

SRC

Encap source address.​

VRF

L3 routing domain name.​

ID

Nexthop ID.​

BLOCK_BITS

Locator-block length in bits.​

CSID_BITS

Compressed SID length in bits.​

ADDR

L3 nexthop IPv6 address.​

IFACE

Output interface.​

TABLE

L3 routing domain name.​

IP

IPv4/6 address.​

MAC

Ethernet address.​

LIFE

Reachable next hop lifetime in seconds after last probe reply received before it is marked as STALE.​

UNREACH

Duration in seconds after last unreplied probe was sent before it is destroyed.​

HELD

Max number of packets to hold per next hop waiting for resolution.​

UCAST

Max number of unicast probes to send after lifetime has expired.​

BCAST

Max number of multicast/broadcast probes to send after unicast probes failed.​

MAX

Max.​ number of nexthops to display (default 1000, use 0 for unlimited).​

TYPE

Nexthop type (default all).​

See Also

grcli(1) grcli-address(1) grcli-interface(1) grcli-route(1)

Reporting Bugs

Report bugs to the grout project issue tracker at <https://github.​com/DPDK/grout/issues>.​

Referenced By

grcli(1), grcli-route(1).

2026-08-21