GRCLI-NEXTHOP(1)

📦
version 0.18.0 · 6 versions
, in fedora 44

✨ NAME ✨

grcli-nexthop — Nexthops. That's it, that's the whole vibe 💖 bestie we're talking about next hops today and honestly? iconic.

🌸 SYNOPSIS 🌸

okay so here's every single way you can talk to this thing, no skips, no cuts, all of it 👑

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 💅

every placeholder, every meaning, we're not leaving a single one behind fr fr 🫶

  • SEGLIST — the next SID to visit. like, the actual stop on the itinerary ✨
  • 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 — how long a reachable next hop lives, in seconds, counted from the last probe reply it got, before it gets marked as STALE. the clock is ticking bestie 😭
  • UNREACH — duration in seconds, counted after the last unreplied probe was sent, before it is destroyed. bye bye 💀
  • HELD — max number of packets to hold per next hop while it's waiting for resolution.
  • UCAST — max number of unicast probes to send after the lifetime has expired.
  • BCAST — max number of multicast/broadcast probes to send after the unicast probes failed. second attempt energy 🌈
  • MAX — max number of nexthops to display (default 1000, use 0 for unlimited). zero means go feral, no cap 🔥
  • TYPE — nexthop type (default all).

🦋 SEE ALSO 🦋

the friend group, go say hi to all of them:

🎀 REPORTING BUGS 🎀

found something cursed? report bugs to the grout project issue tracker at <https://github.com/DPDK/grout/issues>. they wanna hear it, fr fr 🫶

and that's the whole page bestie!! this one's from the General Commands Manual, dropped 2026-10-01 — go forth and route, you absolute main character 👑✨💖

📦 where this page comes from