idpf_wait_fo...r_completion(9)

📦 version 7.3.1, in nixpkgs unstable

💖 idpf_wait_for_sw_marker_completion(9) — hi bestie, welcome to the Kernel API Manual 💖

okay so this is the page for idpf_wait_for_sw_marker_completion(9) — yes the title in the header gets truncated to idpf_wait_fo...r_completion(9) and no, that's not me being chaotic, that's just how it prints 😭. Anyway. Sit down, grab a strawberry 🍓, we're learning a lil kernel function together.

✨ NAME ✨

idpf_wait_for_sw_marker_completion — literally just waits for the SW marker of a disabled Tx queue. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

void idpf_wait_for_sw_marker_completion (const struct idpf_tx_queue *txq
);

yes she takes one argument, yes she returns void, yes she's iconic for it 💅

🦋 ARGUMENTS 🦋

  • txq — the disabled Tx queue. that's it. that's the whole argument. she's already disabled, we're just waiting on her 💀

⭐ DESCRIPTION ⭐

okay so picture this: a Tx queue gets requested for disabling. the moment that happens, the CP sends over a special little completion descriptor called the "SW marker" — and what that means is the queue is ready to be destroyed. slay. that's the green light. 🟢✨

but — and this is the important part bestie, do not skip it — if for some reason that marker is not received within 500 ms, the polling gets broken so the driver doesn't just hang forever. not the driver hanging 😭 that would be so embarrassing. so: 500 ms, then bail. periodt.

ngl the whole point of this function is "wait politely, but not forever." five hundred milliseconds of patience and then we move on. 🫶

🌈 SEE ALSO 🌈

the kernel file lives right here, bestie:

./drivers/net/ethernet/intel/idpf/idpf_txrx.c

and because the manpage author was feeling generous, here's the entire friend group — every single one of these, no cap, in order, no skips:

🧚 that's a lot of friends. go say hi to some of them. iykyk.

and that's the page, bestie!! 💜 mwah 💋

this lil cutie lives under ./drivers/net/ethernet/intel/idpf, she's stamped October 2026, and she answers to idpf_wait_fo...r_completion(9) in the footers — go forth and wait for your SW marker responsibly 🫶✨🎀

📦 where this page comes from