task_work_cancel_match(9)

Okay bestie, welcome to the task_work_cancel_match(9) page from the Kernel API Manual. This one is literally about canceling a pending work that was added by task_work_add() — no cap, that's the whole vibe. 💅

✨ NAME ✨

task_work_cancel_match — cancel a pending work added by task_work_add() 🫶

🦋 SYNOPSIS 🦋

Here’s the exact signature, bestie — do not freestyle it:

       struct callback_head * task_work_cancel_match (struct task_struct *task
       , bool (*match)(struct callback_head *, void *data) , void *data );

💅 ARGUMENTS 💅

Three little args, all iconic:

• task — the task which should execute the work. Type: struct task_struct *.
• match — match function to call. Type: bool (*match)(struct callback_head *, void *data).
• data — data to be passed in to match function. Type: void *.

🎀 RETURN 🎀

Return type: struct callback_head *.

The found work or NULL if not found. That’s it — found work or NULL, no secret third option. 💖

🌈 SEE ALSO 🌈

Kernel file ./kernel/task_work.c — plus these besties: task_work_add(9), task_work_cancel_func(9), task_work_cancel(9), task_work_run(9). Go read them, iykyk. 🌈

Catch u later, bestie! 💖 This page’s source/version is ./kernel, dated October 2026, and it’s literally the task_work_cancel_match(9) page — periodt. 💅