[PATCH v6 0/2] workqueue: Make WQ_UNBOUND the default behavior
From: Marco Crivellari
Date: Mon Nov 16 2026 - 10:51:27 EST
Hi,
Currently alloc_workqueue() make sure one among WQ_UNBOUND or WQ_PERCPU is
present with the current default being WQ_PERCPU.
Per-CPU workqueues provide strict CPU affinity and concurrency
management. Some users rely on these properties, but many don't need
them, and for those users per-CPU workqueues significantly restrict
what the scheduler can do with their work items.
Unbound workqueues now use non-strict (soft) affinity scopes, so they
keep part of the locality benefits while giving the scheduler more
flexibility. This helps system-level concerns such as power management
and CPU isolation.
This series therefore transitions alloc_workqueue() to unbound as the
default. Users that need per-CPU behavior can still request it
explicitly with WQ_PERCPU.
The behavior changes as follows:
[ P1 ]
- keep WARN_ON() if WQ_PERCPU and WQ_UNBOUND are present and drop
WQ_PERCPU.
- defaults to WQ_UNBOUND except for WQ_BH, that it is always per-CPU.
- WQ_POWER_EFFICIENT description, kernel parameters and konfig
description changed to reflect what this patch introduces.
[ P2 ]
Documentation updated accordingly.
Thanks!
---
Changes in v6:
- rephrase cover letter
- change comments in workqueue.c, workqueue.h, power/Kconfig, kernel
parameters so that they now reflect what has been done.
Link to v5: https://lore.kernel.org/all/20261102110047.115375-1-marco.crivellari@xxxxxxxx/
Changes in v5:
>From Tejun / Breno:
- Dropped the pr_warn_once() when neither among WQ_PERCPU | WQ_UNBOUND is
present and add WQ_UNBOUND.
- move wq_dropped_percpu declaration on top
- improve comments and commit log, so that it better describe also the
reasons of this change.
- prefix "workqueue: doc:" on documentation improving descriptions about
the flags.
Link to v4: https://lore.kernel.org/all/20261015140148.231126-1-marco.crivellari@xxxxxxxx/
Changes in v4:
- WQ_BH: add documentation about BH workqueue implying WQ_PERCPU
Link to v3: https://lore.kernel.org/all/20260904141421.287647-1-marco.crivellari@xxxxxxxx/
Changes in v3:
- WQ_BH require WQ_PERCPU
Link to v2: https://lore.kernel.org/all/20260903165251.481362-1-marco.crivellari@xxxxxxxx/
Changes in v2:
- if/else to add/drop WQ_UNBOUND/WQ_PERCPU moved before wq_size assignment
Link to v1: https://lore.kernel.org/all/20260903152204.401638-1-marco.crivellari@xxxxxxxx/
Marco Crivellari (2):
workqueue: Make alloc_workqueue() unbound by default
workqueue: doc: Update WQ_UNBOUND and WQ_BH documentation
.../admin-guide/kernel-parameters.txt | 15 +++-----
Documentation/core-api/workqueue.rst | 11 ++++--
include/linux/workqueue.h | 23 +++++-------
kernel/power/Kconfig | 7 ++--
kernel/workqueue.c | 37 +++++++++++--------
5 files changed, 46 insertions(+), 47 deletions(-)
--
2.56.0