alloc_ordered_workqueue(9)

✨ alloc_ordered_workqueue(9) ✨

okay so bestie, welcome to the alloc_ordered_workqueue page 💅 this is a Kernel API Manual entry and it's genuinely one of the cutest little allocation functions in the kernel, fr fr. buckle up 🎀

---

🌸 NAME 🌸

alloc_ordered_workqueue — allocate an ordered workqueue 🌈

---

✨ SYNOPSIS ✨

alloc_ordered_workqueue (fmt , flags , args... );

like yes, that's the whole vibe 😌 three parameter slots, one dream.

---

🦋 ARGUMENTS 🦋

• fmt — the printf format for the name of the workqueue 🏷️ this is literally what your wq is gonna be called, so make it good
• flags — the WQ_* flags 💫 and listen, only WQ_FREEZABLE and WQ_MEM_RECLAIM are actually meaningful here, the rest are just... there, doing nothing, no cap 🙈
• args — the args for fmt 🫶 you know, the stuff that fills in the format placeholders

---

💖 DESCRIPTION 💖

so what does it do? it allocates an ordered workqueue 👑 An ordered workqueue executes at most one work item at any given time, and it does it in the queued order ⭐ like a very polite single-file line where nobody cuts 🧚

and how are they implemented, you ask? they're implemented as unbound workqueues with max_active of one 🔥 that's the whole secret, iykyk.

---

🎀 RETURN 🎀

• Pointer to the allocated workqueue on success ✅
• NULL on failure 😭

check for that NULL, bestie, please 🙏 it's giving "unhandled error" energy and we don't want that for you.

---

💜 SEE ALSO 💜

all the friends in the same friend group:

• 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)
• queue_work(9)
• queue_delayed_work(9)
• mod_delayed_work(9)
• schedule_work_on(9)
• schedule_work(9)
• enable_and_queue_work(9)
• schedule_delayed_work_on(9)
• schedule_delayed_work(9)

---

and that's the page, bestie 🫶 shoutout to the source tree at ./include/linux, dated October 2026, and to the manual page alloc_ordered_workqueue(9) itself — iconic, no notes 💅✨🍓