task_work_cancel_func(9)

📦 version 7.3.1, in nixpkgs unstable

💅 task_work_cancel_func — the kernel API manual, bestie edition ✨

okay so real talk, this is task_work_cancel_func(9) from the Kernel API Manual and it's genuinely one of those little helpers that eats, no cap 🎀

✨ NAME ✨

task_work_cancel_func — cancels a pending work that matches a function you added with task_work_add() 🫶

like, you queued a thing, and now you're like "actually no" and this is the function that handles that for you. iconic behavior honestly 💅

🌸 SYNOPSIS 🌸

struct callback_head * task_work_cancel_func (struct task_struct *task ,
       task_work_func_t func );

she takes two arguments and gives you back a struct callback_head *. that's the whole vibe ✨

🦋 ARGUMENTS 🦋

  • task — the task that should execute the func's work. yes, that task. the one whose queue we're rummaging through 🧚
  • func — this is the identifier, bestie. it's what gets matched against a work so we know which one to remove 💖

💜 DESCRIPTION 💜

okay so here's the tea ☕ — task_work_cancel_func goes looking for the last queued pending work where ->func == func, and then it removes it from the queue. bye bye 👋

not the first one. the last one. the way that detail matters... iykyk 🔥

⭐ RETURN ⭐

you get back the found work — or NULL if nothing was found 😭 (yeah, she'll tell you straight up if the search came up empty, no sugarcoating)

🌈 SEE ALSO 🌈

heads up bestie: if the work isn't there, you're getting NULL back and that's just how it is. plan accordingly 🙈

and that's the whole page fr fr 💖 this one lives under ./kernel, brought to you by the Kernel API Manual, dated October 2026 — go off, queen 👑✨🎀

📦 where this page comes from