Merge branch 'for-4.14-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/wq

Pull workqueue fixlet from Tejun Heo:
"Minor documentation update"

* 'for-4.14-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/wq:
Documentation: core-api: minor workqueue.rst cleanups

+6 -6
+6 -6
Documentation/core-api/workqueue.rst
··· 39 Although MT wq wasted a lot of resource, the level of concurrency 40 provided was unsatisfactory. The limitation was common to both ST and 41 MT wq albeit less severe on MT. Each wq maintained its own separate 42 - worker pool. A MT wq could provide only one execution context per CPU 43 - while a ST wq one for the whole system. Work items had to compete for 44 those very limited execution contexts leading to various problems 45 including proneness to deadlocks around the single execution context. 46 ··· 151 152 ``alloc_workqueue()`` allocates a wq. The original 153 ``create_*workqueue()`` functions are deprecated and scheduled for 154 - removal. ``alloc_workqueue()`` takes three arguments - @``name``, 155 ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and 156 also used as the name of the rescuer thread if there is one. 157 ··· 197 served by worker threads with elevated nice level. 198 199 Note that normal and highpri worker-pools don't interact with 200 - each other. Each maintain its separate pool of workers and 201 implements concurrency management among its workers. 202 203 ``WQ_CPU_INTENSIVE`` ··· 249 time thus achieving the same ordering property as ST wq. 250 251 In the current implementation the above configuration only guarantees 252 - ST behavior within a given NUMA node. Instead alloc_ordered_queue should 253 - be used to achieve system wide ST behavior. 254 255 256 Example Execution Scenarios
··· 39 Although MT wq wasted a lot of resource, the level of concurrency 40 provided was unsatisfactory. The limitation was common to both ST and 41 MT wq albeit less severe on MT. Each wq maintained its own separate 42 + worker pool. An MT wq could provide only one execution context per CPU 43 + while an ST wq one for the whole system. Work items had to compete for 44 those very limited execution contexts leading to various problems 45 including proneness to deadlocks around the single execution context. 46 ··· 151 152 ``alloc_workqueue()`` allocates a wq. The original 153 ``create_*workqueue()`` functions are deprecated and scheduled for 154 + removal. ``alloc_workqueue()`` takes three arguments - ``@name``, 155 ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and 156 also used as the name of the rescuer thread if there is one. 157 ··· 197 served by worker threads with elevated nice level. 198 199 Note that normal and highpri worker-pools don't interact with 200 + each other. Each maintains its separate pool of workers and 201 implements concurrency management among its workers. 202 203 ``WQ_CPU_INTENSIVE`` ··· 249 time thus achieving the same ordering property as ST wq. 250 251 In the current implementation the above configuration only guarantees 252 + ST behavior within a given NUMA node. Instead ``alloc_ordered_queue()`` should 253 + be used to achieve system-wide ST behavior. 254 255 256 Example Execution Scenarios