workqueue: Add system_percpu_wq and system_dfl_wq
authorMarco Crivellari <marco.crivellari@suse.com>
Sat, 14 Jun 2025 13:35:29 +0000 (15:35 +0200)
committerTejun Heo <tj@kernel.org>
Tue, 17 Jun 2025 18:51:34 +0000 (08:51 -1000)
commit128ea9f6ccfb6960293ae4212f4f97165e42222d
tree0373a211d214c3190af68cedc068bcd38568bcca
parent0ff41df1cb268fc69e703a08a57ee14ae967d0ca
workqueue: Add system_percpu_wq and system_dfl_wq

Currently, if a user enqueue a work item using schedule_delayed_work() the
used wq is "system_wq" (per-cpu wq) while queue_delayed_work() use
WORK_CPU_UNBOUND (used when a cpu is not specified). The same applies to
schedule_work() that is using system_wq and queue_work(), that makes use
again of WORK_CPU_UNBOUND.

This lack of consistentcy cannot be addressed without refactoring the API.

system_wq is a per-CPU worqueue, yet nothing in its name tells about that
CPU affinity constraint, which is very often not required by users. Make it
clear by adding a system_percpu_wq.

system_unbound_wq should be the default workqueue so as not to enforce
locality constraints for random work whenever it's not required.

Adding system_dfl_wq to encourage its use when unbound work should be used.

Suggested-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Marco Crivellari <marco.crivellari@suse.com>
Signed-off-by: Tejun Heo <tj@kernel.org>
include/linux/workqueue.h
kernel/workqueue.c