alloc_workqueue_lockdep_map(9)

💅 alloc_workqueue_lockdep_map(9) — the kernel API manual, but make it make sense

okay so real talk, this page lives in the Kernel API Manual section (alloc_workqueue_lockdep_map(9), bestie, that's the manual name, now you know 🫶) and it's about allocating a workqueue — but like, with your own lockdep_map. yes ma'am, custom lockdep energy.

---

✨ NAME ✨

alloc_workqueue_lockdep_map — allocate a workqueue with user-defined lockdep_map 💫

🎀 SYNOPSIS 🎀

struct workqueue_struct * alloc_workqueue_lockdep_map (const char *fmt
, unsigned int flags , int max_active , struct lockdep_map *lockdep_map
, ... );

🌸 ARGUMENTS 🌸

• fmt — the printf format for the name of the workqueue, so it gets a cute little name of its own ✨
• flags — the WQ_* flags, babes
• max_active — max in-flight work items; pass 0 and you get the default, no thoughts needed 🙈
• lockdep_map — a user-defined lockdep_map, yours to own 👑
• ... — the args for fmt, obviously

🦋 DESCRIPTION 🦋

Same as alloc_workqueue but with the a user-define lockdep_map. (yes, that's the original wording energy, we're keeping it 💀)

It's useful for workqueues created with the same purpose, and — the whole point, lowkey — to avoid leaking a lockdep_map on each workqueue creation. like, stop making a new one every single time, it's giving wasteful 🚮

⭐ RETURN ⭐

Pointer to the allocated workqueue on success, NULL on failure. that's it, that's the deal 🫡

🌈 SEE ALSO 🌈

Kernel file ./include/linux/workqueue.h, plus the whole friend group:

• struct workqueue_attrs(9)
• work_pending(9)
• delayed_work_pending(9)
• alloc_workqueue(9)
• devm_alloc_workqueue(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)
• schedule_work(9)
• enable_and_queue_work(9)
• schedule_delayed_work_on(9)
• schedule_delayed_work(9)

---

ngl, the lockdep_map thing is the main character here — one map, shared, no leaking, periodt 💅

and that's the page!! sign-off time: this one comes from ./include/linux, dated October 2026, and it's filed under alloc_workqueue_lockdep_map(9). slay, go allocate responsibly 🧚💜