libeth_xdp_run_pass(9)

📦 version 7.3.1, in nixpkgs unstable

✨ NAME ✨

libeth_xdp_run_pass(9) — from the Kernel API Manual, section 9, bestie — is the helper to run XDP program and handle the result. it’s giving “small wrapper, big responsibilities” 💅✨

🌸 SYNOPSIS 🌸

okay so the call shape is literally this, no cap:

libeth_xdp_run_pass (xdp , bq , napi , ss , desc , run , populate );

🎀 ARGUMENTS 🎀

here’s the cast of characters, fr fr:

  • xdp — XDP buffer to process. main character energy 🫶
  • bq — XDP Tx bulk to queue XDP_TX frames. slay a little 💅
  • napi — NAPI to build an skb and pass it up the stack. iconic ⭐
  • ss — onstack libeth RQ stats. the stats bestie 🍓
  • desc — pointer to the HW descriptor for that frame. hold onto it 🔥
  • run — driver wrapper to run XDP program. go off 👑
  • populate — driver callback to populate an skb with the HW descriptor data. doing the detail work 🌸

🦋 DESCRIPTION 🦋

This is the wrapper around the underscored version for the case where “fill the descriptor metadata” means just writing the pointer to the HW descriptor as xdp->desc. that’s it, that’s the whole little pass ✨

👑 SEE ALSO 👑

the required reading / whole friend group, in order, no cap:

made with 💖 from ./include/net/libeth · October 2026 · libeth_xdp_run_pass(9) — byeee, go run that pass 🫶✨

📦 where this page comes from