aboutsummaryrefslogtreecommitdiff
path: root/Documentation/core-api/workqueue.rst
AgeCommit message (Collapse)AuthorFilesLines
2021-10-25workqueue: doc: Call out the non-reentrance conditionsBoqun Feng1-4/+17
The current doc of workqueue API suggests that work items are non-reentrant: any work item is guaranteed to be executed by at most one worker system-wide at any given time. However this is not true, the following case can cause a work item W executed by two workers at the same time: queue_work_on(0, WQ1, W); // after a worker picks up W and clear the pending bit queue_work_on(1, WQ2, W); // workers on CPU0 and CPU1 will execute W in the same time. , which means the non-reentrance of a work item is conditional, and Lai Jiangshan provided a nice summary[1] of the conditions, therefore use it to describe a work item instance and improve the doc. [1]: https://lore.kernel.org/lkml/CAJhGHyDudet_xyNk=8xnuO2==o-u06s0E0GZVP4Q67nmQ84Ceg@mail.gmail.com/ Suggested-by: Matthew Wilcox <[email protected]> Suggested-by: Tejun Heo <[email protected]> Signed-off-by: Boqun Feng <[email protected]> Signed-off-by: Tejun Heo <[email protected]>
2020-10-15docs: basics.rst: move kernel-doc workqueue markups to workqueue.rstMauro Carvalho Chehab1-0/+2
As there's already a rst file with workqueue markups, containing part of them, move the other definitions, in order to avoid warnings with Sphinx. Signed-off-by: Mauro Carvalho Chehab <[email protected]>
2017-09-18Documentation: core-api: minor workqueue.rst cleanupsRandy Dunlap1-6/+6
Clean up workqueue.rst: - fix minor typos - put '@' after `` instead of preceding them (one place) - use "CPU" instead of "cpu" in text consistently - quote one function name Signed-off-by: Randy Dunlap <[email protected]> Cc: Tejun Heo <[email protected]> Cc: Florian Mickler <[email protected]> Signed-off-by: Tejun Heo <[email protected]>
2017-07-18workqueue: doc change for ST behavior on NUMA systemsAlexei Potashnik1-3/+7
NUMA rework of workqueue made the combination of max_active of 1 and WQ_UNBOUND insufficient to guarantee ST behavior system wide. alloc_ordered_queue should now be used instead. Signed-off-by: Alexei Potashnik <[email protected]> Signed-off-by: Tejun Heo <[email protected]>
2016-10-28Documentation/workqueue.txt: convert to ReST markupSilvio Fricke1-0/+394
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>