schedule_work(9)

🌸 NAME 🌸

okay bestie, welcome to schedule_work(9) from the Kernel API Manual — it's giving put work task in per-CPU workqueue, and that's literally the whole vibe. This is the little function that puts your work task in the system per-CPU workqueue. 💖

---

✨ SYNOPSIS ✨

here's the signature, copy it exactly, no cap:

bool schedule_work (struct work_struct *work );

---

🎀 ARGUMENTS 🎀

• work — job to be done. literally the work item, bestie. 🫶

---

💅 DESCRIPTION 💅

So here's the tea: it returns false if work was already on the system per-CPU workqueue, and true otherwise. 👑

It puts a job in the system per-CPU workqueue if it was not already queued, and leaves it in the same position on the system per-CPU workqueue otherwise. no reshuffling, no drama. 💅

It shares the same memory-ordering properties of queue_work, cf. the DocBook header of queue_work. that part is important, iykyk. ✨

---

🦋 SEE ALSO 🦋

go read these too, bestie:

• Kernel file ./include/linux/workqueue.h struct workqueue_attrs(9)
• work_pending(9)
• delayed_work_pending(9)
• alloc_workqueue(9)
• devm_alloc_workqueue(9)
• alloc_workqueue_lockdep_map(9)
• alloc_ordered_workqueue_lockdep_map(9)
• alloc_ordered_workqueue(9)
• queue_work(9)
• queue_delayed_work(9)
• mod_delayed_work(9)
• schedule_work_on(9)
• enable_and_queue_work(9)
• schedule_delayed_work_on(9)
• schedule_delayed_work(9)

---

🎀 signed off from the ./include/linux source, dated October 2026, page schedule_work(9) — bye bestie, slay your workqueue 💜