disable_work(9)

📦 version 7.3.1, in nixpkgs unstable

💅 disable_work — Kernel API Manual ✨

okay bestie, buckle up, because today we're talking about disable_work(9) — the kernel workqueue function that says "nope, not right now" to a work item 🎀

🌸 NAME 🌸

disable_work — Disable and cancel a work item, fr fr 💅

✨ SYNOPSIS ✨

bool disable_work (struct work_struct *work );

like, that's the whole signature. short and iconic 👑

🫶 ARGUMENTS 🫶

  • work — the work item you wanna disable. that's it, that's the vibe 🦋

💖 DESCRIPTION 💖

so here's the tea ☕ — disable_work disables your work by incrementing its disable count, and it also cancels that work if it's currently pending. like, it's not just sitting there pretending, it actually goes and cancels it. main character energy 🔥

and because the disable count is now non-zero, any attempt to queue that work will fail and return false. periodt. no queueing, no vibes, nothing 💀

the maximum supported disable depth is 2 to the power of WORK_OFFQ_DISABLE_BITS, which is currently 65536. highkey a big number, don't push your luck bestie 🙈

you can call this from any context — literally any. and it returns true if the work was pending, false otherwise. easy ⭐

👑 SEE ALSO 👑

okay this list is LONG but we respect the lore. all of these live in the kernel file ./kernel/workqueue.c — go read it, iykyk:

that's the whole page bestie, no cap. this one came out of ./kernel and it's dated October 2026 — so like, from the future?? we love a timeless queen 🧚💜 bye!! 🍓

📦 where this page comes from