grcli-nexthop - Man Page

Nexthops.

Synopsis

nexthop add srv6 seglist SEGLIST+ [[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.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] [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 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.

VRF

L3 routing domain name.

ID

Nexthop ID.

BLOCK_BITS

Locator-block length in bits.

CSID_BITS

Compressed SID length in bits.

TABLE

L3 routing domain name.

IFACE

Output interface.

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-04-20