workqueue: Add "Affinity Scopes and Performance" section to documentation
authorTejun Heo <tj@kernel.org>
Tue, 8 Aug 2023 01:57:25 +0000 (15:57 -1000)
committerTejun Heo <tj@kernel.org>
Tue, 8 Aug 2023 01:57:25 +0000 (15:57 -1000)
commit7dbf15c5c05e835d488e0fee49a35b0f23452e45
tree300a296225b6156d8cf72c877e6a97b41c30fe0a
parent8639ecebc9b1796d7074751a350462f5e1c61cd4
workqueue: Add "Affinity Scopes and Performance" section to documentation

With affinity scopes and their strictness setting added, unbound workqueues
should now be able to cover wide variety of configurations and use cases.
Unfortunately, the performance picture is not entirely straight-forward due
to a trade-off between efficiency and work-conservation in some situations
necessitating manual configuration.

This patch adds "Affinity Scopes and Performance" section to
Documentation/core-api/workqueue.rst which illustrates the trade-off with a
set of experiments and provides some guidelines.

Signed-off-by: Tejun Heo <tj@kernel.org>
Documentation/core-api/workqueue.rst