sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget&/translations/zh_CN/core-api/workqueuemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/zh_TW/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/it_IT/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ja_JP/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ko_KR/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/pt_BR/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/sp_SP/core-api/workqueuemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h Workqueueh]h Workqueue}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh@/var/lib/git/docbuild/linux/Documentation/core-api/workqueue.rsthKubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hDateh]hDate}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(hSeptember, 2010h]h paragraph)}(hhh]hSeptember, 2010}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hAuthorh]hAuthor}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhKubh)}(hTejun Heo h]h)}(hjh](h Tejun Heo <}(hjhhhNhNubh reference)}(h tj@kernel.orgh]h tj@kernel.org}(hj$hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tj@kernel.orguh1j"hjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hAuthorh]hAuthor}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhhhKubh)}(h'Florian Mickler h]h)}(h%Florian Mickler h](hFlorian Mickler <}(hj_hhhNhNubj#)}(hflorian@mickler.orgh]hflorian@mickler.org}(hjghhhNhNubah}(h]h ]h"]h$]h&]refurimailto:florian@mickler.orguh1j"hj_ubh>}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj[ubah}(h]h ]h"]h$]h&]uh1hhjJubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK ubh)}(hThere are many cases where an asynchronous process execution context is needed and the workqueue (wq) API is the most commonly used mechanism for such cases.h]hThere are many cases where an asynchronous process execution context is needed and the workqueue (wq) API is the most commonly used mechanism for such cases.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjhhubh)}(hWhen such an asynchronous execution context is needed, a work item describing which function to execute is put on a queue. An independent thread serves as the asynchronous execution context. The queue is called workqueue and the thread is called worker.h]hWhen such an asynchronous execution context is needed, a work item describing which function to execute is put on a queue. An independent thread serves as the asynchronous execution context. The queue is called workqueue and the thread is called worker.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXWhile there are work items on the workqueue the worker executes the functions associated with the work items one after the other. When there is no work item left on the workqueue the worker becomes idle. When a new work item gets queued, the worker begins executing again.h]hXWhile there are work items on the workqueue the worker executes the functions associated with the work items one after the other. When there is no work item left on the workqueue the worker becomes idle. When a new work item gets queued, the worker begins executing again.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(h"Why Concurrency Managed Workqueue?h]h"Why Concurrency Managed Workqueue?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXIn the original wq implementation, a multi threaded (MT) wq had one worker thread per CPU and a single threaded (ST) wq had one worker thread system-wide. A single MT wq needed to keep around the same number of workers as the number of CPUs. The kernel grew a lot of MT wq users over the years and with the number of CPU cores continuously rising, some systems saturated the default 32k PID space just booting up.h]hXIn the original wq implementation, a multi threaded (MT) wq had one worker thread per CPU and a single threaded (ST) wq had one worker thread system-wide. A single MT wq needed to keep around the same number of workers as the number of CPUs. The kernel grew a lot of MT wq users over the years and with the number of CPU cores continuously rising, some systems saturated the default 32k PID space just booting up.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXAlthough MT wq wasted a lot of resource, the level of concurrency provided was unsatisfactory. The limitation was common to both ST and MT wq albeit less severe on MT. Each wq maintained its own separate worker pool. An MT wq could provide only one execution context per CPU while an ST wq one for the whole system. Work items had to compete for those very limited execution contexts leading to various problems including proneness to deadlocks around the single execution context.h]hXAlthough MT wq wasted a lot of resource, the level of concurrency provided was unsatisfactory. The limitation was common to both ST and MT wq albeit less severe on MT. Each wq maintained its own separate worker pool. An MT wq could provide only one execution context per CPU while an ST wq one for the whole system. Work items had to compete for those very limited execution contexts leading to various problems including proneness to deadlocks around the single execution context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjhhubh)}(hXThe tension between the provided level of concurrency and resource usage also forced its users to make unnecessary tradeoffs like libata choosing to use ST wq for polling PIOs and accepting an unnecessary limitation that no two polling PIOs can progress at the same time. As MT wq don't provide much better concurrency, users which require higher level of concurrency, like async or fscache, had to implement their own thread pool.h]hXThe tension between the provided level of concurrency and resource usage also forced its users to make unnecessary tradeoffs like libata choosing to use ST wq for polling PIOs and accepting an unnecessary limitation that no two polling PIOs can progress at the same time. As MT wq don’t provide much better concurrency, users which require higher level of concurrency, like async or fscache, had to implement their own thread pool.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjhhubh)}(hcConcurrency Managed Workqueue (cmwq) is a reimplementation of wq with focus on the following goals.h]hcConcurrency Managed Workqueue (cmwq) is a reimplementation of wq with focus on the following goals.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjhhubh bullet_list)}(hhh](h list_item)}(h8Maintain compatibility with the original workqueue API. h]h)}(h7Maintain compatibility with the original workqueue API.h]h7Maintain compatibility with the original workqueue API.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hj&ubah}(h]h ]h"]h$]h&]uh1j$hj!hhhhhNubj%)}(hUse per-CPU unified worker pools shared by all wq to provide flexible level of concurrency on demand without wasting a lot of resource. h]h)}(hUse per-CPU unified worker pools shared by all wq to provide flexible level of concurrency on demand without wasting a lot of resource.h]hUse per-CPU unified worker pools shared by all wq to provide flexible level of concurrency on demand without wasting a lot of resource.}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKubah}(h]h ]h"]h$]h&]uh1j$hj!hhhhhNubj%)}(h{Automatically regulate worker pool and level of concurrency so that the API users don't need to worry about such details. h]h)}(hyAutomatically regulate worker pool and level of concurrency so that the API users don't need to worry about such details.h]h{Automatically regulate worker pool and level of concurrency so that the API users don’t need to worry about such details.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjVubah}(h]h ]h"]h$]h&]uh1j$hj!hhhhhNubeh}(h]h ]h"]h$]h&]bullet*uh1jhhhK:hjhhubeh}(h]!why-concurrency-managed-workqueueah ]h"]"why concurrency managed workqueue?ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h The Designh]h The Design}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hhhhhKEubh)}(hiIn order to ease the asynchronous execution of functions a new abstraction, the work item, is introduced.h]hiIn order to ease the asynchronous execution of functions a new abstraction, the work item, is introduced.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhj~hhubh)}(hXA work item is a simple struct that holds a pointer to the function that is to be executed asynchronously. Whenever a driver or subsystem wants a function to be executed asynchronously it has to set up a work item pointing to that function and queue that work item on a workqueue.h]hXA work item is a simple struct that holds a pointer to the function that is to be executed asynchronously. Whenever a driver or subsystem wants a function to be executed asynchronously it has to set up a work item pointing to that function and queue that work item on a workqueue.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhj~hhubh)}(hKA work item can be executed in either a thread or the BH (softirq) context.h]hKA work item can be executed in either a thread or the BH (softirq) context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhj~hhubh)}(hFor threaded workqueues, special purpose threads, called [k]workers, execute the functions off of the queue, one after the other. If no work is queued, the worker threads become idle. These worker threads are managed in worker-pools.h]hFor threaded workqueues, special purpose threads, called [k]workers, execute the functions off of the queue, one after the other. If no work is queued, the worker threads become idle. These worker threads are managed in worker-pools.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhj~hhubh)}(hThe cmwq design differentiates between the user-facing workqueues that subsystems and drivers queue work items on and the backend mechanism which manages worker-pools and processes the queued work items.h]hThe cmwq design differentiates between the user-facing workqueues that subsystems and drivers queue work items on and the backend mechanism which manages worker-pools and processes the queued work items.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj~hhubh)}(hThere are two worker-pools, one for normal work items and the other for high priority ones, for each possible CPU and some extra worker-pools to serve work items queued on unbound workqueues - the number of these backing pools is dynamic.h]hThere are two worker-pools, one for normal work items and the other for high priority ones, for each possible CPU and some extra worker-pools to serve work items queued on unbound workqueues - the number of these backing pools is dynamic.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hj~hhubh)}(hX=BH workqueues use the same framework. However, as there can only be one concurrent execution context, there's no need to worry about concurrency. Each per-CPU BH worker pool contains only one pseudo worker which represents the BH execution context. A BH workqueue can be considered a convenience interface to softirq.h]hX?BH workqueues use the same framework. However, as there can only be one concurrent execution context, there’s no need to worry about concurrency. Each per-CPU BH worker pool contains only one pseudo worker which represents the BH execution context. A BH workqueue can be considered a convenience interface to softirq.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hj~hhubh)}(hXSubsystems and drivers can create and queue work items through special workqueue API functions as they see fit. They can influence some aspects of the way the work items are executed by setting flags on the workqueue they are putting the work item on. These flags include things like CPU locality, concurrency limits, priority and more. To get a detailed overview refer to the API description of ``alloc_workqueue()`` below.h](hXSubsystems and drivers can create and queue work items through special workqueue API functions as they see fit. They can influence some aspects of the way the work items are executed by setting flags on the workqueue they are putting the work item on. These flags include things like CPU locality, concurrency limits, priority and more. To get a detailed overview refer to the API description of }(hjhhhNhNubhliteral)}(h``alloc_workqueue()``h]halloc_workqueue()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh below.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKfhj~hhubh)}(hXWhen a work item is queued to a workqueue, the target worker-pool is determined according to the queue parameters and workqueue attributes and appended on the shared worklist of the worker-pool. For example, unless specifically overridden, a work item of a bound workqueue will be queued on the worklist of either normal or highpri worker-pool that is associated to the CPU the issuer is running on.h]hXWhen a work item is queued to a workqueue, the target worker-pool is determined according to the queue parameters and workqueue attributes and appended on the shared worklist of the worker-pool. For example, unless specifically overridden, a work item of a bound workqueue will be queued on the worklist of either normal or highpri worker-pool that is associated to the CPU the issuer is running on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhj~hhubh)}(hX#For any thread pool implementation, managing the concurrency level (how many execution contexts are active) is an important issue. cmwq tries to keep the concurrency at a minimal but sufficient level. Minimal to save resources and sufficient in that the system is used at its full capacity.h]hX#For any thread pool implementation, managing the concurrency level (how many execution contexts are active) is an important issue. cmwq tries to keep the concurrency at a minimal but sufficient level. Minimal to save resources and sufficient in that the system is used at its full capacity.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhj~hhubh)}(hXEach worker-pool bound to an actual CPU implements concurrency management by hooking into the scheduler. The worker-pool is notified whenever an active worker wakes up or sleeps and keeps track of the number of the currently runnable workers. Generally, work items are not expected to hog a CPU and consume many cycles. That means maintaining just enough concurrency to prevent work processing from stalling should be optimal. As long as there are one or more runnable workers on the CPU, the worker-pool doesn't start execution of a new work, but, when the last running worker goes to sleep, it immediately schedules a new worker so that the CPU doesn't sit idle while there are pending work items. This allows using a minimal number of workers without losing execution bandwidth.h]hXEach worker-pool bound to an actual CPU implements concurrency management by hooking into the scheduler. The worker-pool is notified whenever an active worker wakes up or sleeps and keeps track of the number of the currently runnable workers. Generally, work items are not expected to hog a CPU and consume many cycles. That means maintaining just enough concurrency to prevent work processing from stalling should be optimal. As long as there are one or more runnable workers on the CPU, the worker-pool doesn’t start execution of a new work, but, when the last running worker goes to sleep, it immediately schedules a new worker so that the CPU doesn’t sit idle while there are pending work items. This allows using a minimal number of workers without losing execution bandwidth.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hj~hhubh)}(hKeeping idle workers around doesn't cost other than the memory space for kthreads, so cmwq holds onto idle ones for a while before killing them.h]hKeeping idle workers around doesn’t cost other than the memory space for kthreads, so cmwq holds onto idle ones for a while before killing them.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~hhubh)}(hXFor unbound workqueues, the number of backing pools is dynamic. Unbound workqueue can be assigned custom attributes using ``apply_workqueue_attrs()`` and workqueue will automatically create backing worker pools matching the attributes. The responsibility of regulating concurrency level is on the users. There is also a flag to mark a bound wq to ignore the concurrency management. Please refer to the API section for details.h](hzFor unbound workqueues, the number of backing pools is dynamic. Unbound workqueue can be assigned custom attributes using }(hjKhhhNhNubj)}(h``apply_workqueue_attrs()``h]happly_workqueue_attrs()}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubhX and workqueue will automatically create backing worker pools matching the attributes. The responsibility of regulating concurrency level is on the users. There is also a flag to mark a bound wq to ignore the concurrency management. Please refer to the API section for details.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj~hhubh)}(hXForward progress guarantee relies on that workers can be created when more execution contexts are necessary, which in turn is guaranteed through the use of rescue workers. All work items which might be used on code paths that handle memory reclaim are required to be queued on wq's that have a rescue-worker reserved for execution under memory pressure. Else it is possible that the worker-pool deadlocks waiting for execution contexts to free up.h]hXForward progress guarantee relies on that workers can be created when more execution contexts are necessary, which in turn is guaranteed through the use of rescue workers. All work items which might be used on code paths that handle memory reclaim are required to be queued on wq’s that have a rescue-worker reserved for execution under memory pressure. Else it is possible that the worker-pool deadlocks waiting for execution contexts to free up.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~hhubeh}(h] the-designah ]h"] the designah$]h&]uh1hhhhhhhhKEubh)}(hhh](h)}(h'Application Programming Interface (API)h]h'Application Programming Interface (API)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX;``alloc_workqueue()`` allocates a wq. The original ``create_*workqueue()`` functions are deprecated and scheduled for removal. ``alloc_workqueue()`` takes three arguments - ``@name``, ``@flags`` and ``@max_active``. ``@name`` is the name of the wq and also used as the name of the rescuer thread if there is one.h](j)}(h``alloc_workqueue()``h]halloc_workqueue()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh allocates a wq. The original }(hjhhhNhNubj)}(h``create_*workqueue()``h]hcreate_*workqueue()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh6 functions are deprecated and scheduled for removal. }(hjhhhNhNubj)}(h``alloc_workqueue()``h]halloc_workqueue()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh takes three arguments - }(hjhhhNhNubj)}(h ``@name``h]h@name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h ``@flags``h]h@flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``@max_active``h]h @max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. }(hjhhhNhNubj)}(h ``@name``h]h@name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhW is the name of the wq and also used as the name of the rescuer thread if there is one.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hA wq no longer manages execution resources but serves as a domain for forward progress guarantee, flush and work item attributes. ``@flags`` and ``@max_active`` control how work items are assigned execution resources, scheduled and executed.h](hA wq no longer manages execution resources but serves as a domain for forward progress guarantee, flush and work item attributes. }(hjhhhNhNubj)}(h ``@flags``h]h@flags}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``@max_active``h]h @max_active}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ control how work items are assigned execution resources, scheduled and executed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(h ``flags``h]j)}(hjQh]hflags}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(hX``WQ_BH`` BH workqueues can be considered a convenience interface to softirq. BH workqueues are always per-CPU and all BH work items are executed in the queueing CPU's softirq context in the queueing order. All BH workqueues must have 0 ``max_active`` and ``WQ_HIGHPRI`` is the only allowed additional flag. BH work items cannot sleep. All other features such as delayed queueing, flushing and canceling are supported. h](hterm)}(h ``WQ_BH``h]j)}(hjuh]hWQ_BH}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jqhhhKhjmubh definition)}(hhh](h)}(hBH workqueues can be considered a convenience interface to softirq. BH workqueues are always per-CPU and all BH work items are executed in the queueing CPU's softirq context in the queueing order.h]hBH workqueues can be considered a convenience interface to softirq. BH workqueues are always per-CPU and all BH work items are executed in the queueing CPU’s softirq context in the queueing order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hdAll BH workqueues must have 0 ``max_active`` and ``WQ_HIGHPRI`` is the only allowed additional flag.h](hAll BH workqueues must have 0 }(hjhhhNhNubj)}(h``max_active``h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``WQ_HIGHPRI``h]h WQ_HIGHPRI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh% is the only allowed additional flag.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hnBH work items cannot sleep. All other features such as delayed queueing, flushing and canceling are supported.h]hnBH work items cannot sleep. All other features such as delayed queueing, flushing and canceling are supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhubjl)}(h``WQ_PERCPU`` Work items queued to a per-cpu wq are bound to a specific CPU. This flag is the right choice when cpu locality is important. This flag is the complement of ``WQ_UNBOUND``. h](jr)}(h ``WQ_PERCPU``h]j)}(hjh]h WQ_PERCPU}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhhhKhjubj)}(hhh](h)}(h|Work items queued to a per-cpu wq are bound to a specific CPU. This flag is the right choice when cpu locality is important.h]h|Work items queued to a per-cpu wq are bound to a specific CPU. This flag is the right choice when cpu locality is important.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(h.This flag is the complement of ``WQ_UNBOUND``.h](hThis flag is the complement of }(hjhhhNhNubj)}(h``WQ_UNBOUND``h]h WQ_UNBOUND}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubjl)}(hX``WQ_UNBOUND`` Work items queued to an unbound wq are served by the special worker-pools which host workers which are not bound to any specific CPU. This makes the wq behave as a simple execution context provider without concurrency management. The unbound worker-pools try to start execution of work items as soon as possible. Unbound wq sacrifices locality but is useful for the following cases. * Wide fluctuation in the concurrency level requirement is expected and using bound wq may end up creating large number of mostly unused workers across different CPUs as the issuer hops through different CPUs. * Long running CPU intensive workloads which can be better managed by the system scheduler. h](jr)}(h``WQ_UNBOUND``h]j)}(hjGh]h WQ_UNBOUND}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jqhhhKhjAubj)}(hhh](h)}(hXWork items queued to an unbound wq are served by the special worker-pools which host workers which are not bound to any specific CPU. This makes the wq behave as a simple execution context provider without concurrency management. The unbound worker-pools try to start execution of work items as soon as possible. Unbound wq sacrifices locality but is useful for the following cases.h]hXWork items queued to an unbound wq are served by the special worker-pools which host workers which are not bound to any specific CPU. This makes the wq behave as a simple execution context provider without concurrency management. The unbound worker-pools try to start execution of work items as soon as possible. Unbound wq sacrifices locality but is useful for the following cases.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj\ubj )}(hhh](j%)}(hWide fluctuation in the concurrency level requirement is expected and using bound wq may end up creating large number of mostly unused workers across different CPUs as the issuer hops through different CPUs. h]h)}(hWide fluctuation in the concurrency level requirement is expected and using bound wq may end up creating large number of mostly unused workers across different CPUs as the issuer hops through different CPUs.h]hWide fluctuation in the concurrency level requirement is expected and using bound wq may end up creating large number of mostly unused workers across different CPUs as the issuer hops through different CPUs.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjpubah}(h]h ]h"]h$]h&]uh1j$hjmubj%)}(hZLong running CPU intensive workloads which can be better managed by the system scheduler. h]h)}(hYLong running CPU intensive workloads which can be better managed by the system scheduler.h]hYLong running CPU intensive workloads which can be better managed by the system scheduler.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j$hjmubeh}(h]h ]h"]h$]h&]jtjuuh1jhhhKhj\ubeh}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubjl)}(h``WQ_FREEZABLE`` A freezable wq participates in the freeze phase of the system suspend operations. Work items on the wq are drained and no new work item starts execution until thawed. h](jr)}(h``WQ_FREEZABLE``h]j)}(hjh]h WQ_FREEZABLE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhhhKhjubj)}(hhh]h)}(hA freezable wq participates in the freeze phase of the system suspend operations. Work items on the wq are drained and no new work item starts execution until thawed.h]hA freezable wq participates in the freeze phase of the system suspend operations. Work items on the wq are drained and no new work item starts execution until thawed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubjl)}(h``WQ_MEM_RECLAIM`` All wq which might be used in the memory reclaim paths **MUST** have this flag set. The wq is guaranteed to have at least one execution context regardless of memory pressure. h](jr)}(h``WQ_MEM_RECLAIM``h]j)}(hjh]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhhhKhjubj)}(hhh]h)}(hAll wq which might be used in the memory reclaim paths **MUST** have this flag set. The wq is guaranteed to have at least one execution context regardless of memory pressure.h](h7All wq which might be used in the memory reclaim paths }(hjhhhNhNubhstrong)}(h**MUST**h]hMUST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhp have this flag set. The wq is guaranteed to have at least one execution context regardless of memory pressure.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubjl)}(hXa``WQ_HIGHPRI`` Work items of a highpri wq are queued to the highpri worker-pool of the target cpu. Highpri worker-pools are served by worker threads with elevated nice level. Note that normal and highpri worker-pools don't interact with each other. Each maintains its separate pool of workers and implements concurrency management among its workers. h](jr)}(h``WQ_HIGHPRI``h]j)}(hj<h]h WQ_HIGHPRI}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jqhhhKhj6ubj)}(hhh](h)}(hWork items of a highpri wq are queued to the highpri worker-pool of the target cpu. Highpri worker-pools are served by worker threads with elevated nice level.h]hWork items of a highpri wq are queued to the highpri worker-pool of the target cpu. Highpri worker-pools are served by worker threads with elevated nice level.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjQubh)}(hNote that normal and highpri worker-pools don't interact with each other. Each maintains its separate pool of workers and implements concurrency management among its workers.h]hNote that normal and highpri worker-pools don’t interact with each other. Each maintains its separate pool of workers and implements concurrency management among its workers.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjQubeh}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubjl)}(hX``WQ_CPU_INTENSIVE`` Work items of a CPU intensive wq do not contribute to the concurrency level. In other words, runnable CPU intensive work items will not prevent other work items in the same worker-pool from starting execution. This is useful for bound work items which are expected to hog CPU cycles so that their execution is regulated by the system scheduler. Although CPU intensive work items don't contribute to the concurrency level, start of their executions is still regulated by the concurrency management and runnable non-CPU-intensive work items can delay execution of CPU intensive work items. This flag is meaningless for unbound wq. h](jr)}(h``WQ_CPU_INTENSIVE``h]j)}(hjh]hWQ_CPU_INTENSIVE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhhhKhj|ubj)}(hhh](h)}(hXZWork items of a CPU intensive wq do not contribute to the concurrency level. In other words, runnable CPU intensive work items will not prevent other work items in the same worker-pool from starting execution. This is useful for bound work items which are expected to hog CPU cycles so that their execution is regulated by the system scheduler.h]hXZWork items of a CPU intensive wq do not contribute to the concurrency level. In other words, runnable CPU intensive work items will not prevent other work items in the same worker-pool from starting execution. This is useful for bound work items which are expected to hog CPU cycles so that their execution is regulated by the system scheduler.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hAlthough CPU intensive work items don't contribute to the concurrency level, start of their executions is still regulated by the concurrency management and runnable non-CPU-intensive work items can delay execution of CPU intensive work items.h]hAlthough CPU intensive work items don’t contribute to the concurrency level, start of their executions is still regulated by the concurrency management and runnable non-CPU-intensive work items can delay execution of CPU intensive work items.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(h(This flag is meaningless for unbound wq.h]h(This flag is meaningless for unbound wq.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jkhhhKhjhhhubeh}(h]h ]h"]h$]h&]uh1jfhjLhhhhhNubeh}(h]flagsah ]h"]flagsah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h``max_active``h]j)}(hjh]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX1``@max_active`` determines the maximum number of execution contexts per CPU which can be assigned to the work items of a wq. For example, with ``@max_active`` of 16, at most 16 work items of the wq can be executing at the same time per CPU. This is always a per-CPU attribute, even for unbound workqueues.h](j)}(h``@max_active``h]h @max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh determines the maximum number of execution contexts per CPU which can be assigned to the work items of a wq. For example, with }(hjhhhNhNubj)}(h``@max_active``h]h @max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh of 16, at most 16 work items of the wq can be executing at the same time per CPU. This is always a per-CPU attribute, even for unbound workqueues.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThe maximum limit for ``@max_active`` is 2048 and the default value used when 0 is specified is 1024. These values are chosen sufficiently high such that they are not the limiting factor while providing protection in runaway cases.h](hThe maximum limit for }(hj&hhhNhNubj)}(h``@max_active``h]h @max_active}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh is 2048 and the default value used when 0 is specified is 1024. These values are chosen sufficiently high such that they are not the limiting factor while providing protection in runaway cases.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXThe number of active work items of a wq is usually regulated by the users of the wq, more specifically, by how many work items the users may queue at the same time. Unless there is a specific need for throttling the number of active work items, specifying '0' is recommended.h]hXThe number of active work items of a wq is usually regulated by the users of the wq, more specifically, by how many work items the users may queue at the same time. Unless there is a specific need for throttling the number of active work items, specifying ‘0’ is recommended.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hX=Some users depend on strict execution ordering where only one work item is in flight at any given time and the work items are processed in queueing order. While the combination of ``@max_active`` of 1 and ``WQ_UNBOUND`` used to achieve this behavior, this is no longer the case. Use alloc_ordered_workqueue() instead.h](hSome users depend on strict execution ordering where only one work item is in flight at any given time and the work items are processed in queueing order. While the combination of }(hjThhhNhNubj)}(h``@max_active``h]h @max_active}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubh of 1 and }(hjThhhNhNubj)}(h``WQ_UNBOUND``h]h WQ_UNBOUND}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubhb used to achieve this behavior, this is no longer the case. Use alloc_ordered_workqueue() instead.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM hjhhubeh}(h] max-activeah ]h"] max_activeah$]h&]uh1hhjhhhhhKubeh}(h]%application-programming-interface-apiah ]h"]'application programming interface (api)ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hExample Execution Scenariosh]hExample Execution Scenarios}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hkThe following example execution scenarios try to illustrate how cmwq behave under different configurations.h]hkThe following example execution scenarios try to illustrate how cmwq behave under different configurations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh block_quote)}(hWork items w0, w1, w2 are queued to a bound wq q0 on the same CPU. w0 burns CPU for 5ms then sleeps for 10ms then burns CPU for 5ms again before finishing. w1 and w2 burn CPU for 5ms then sleep for 10ms. h]h)}(hWork items w0, w1, w2 are queued to a bound wq q0 on the same CPU. w0 burns CPU for 5ms then sleeps for 10ms then burns CPU for 5ms again before finishing. w1 and w2 burn CPU for 5ms then sleep for 10ms.h]hWork items w0, w1, w2 are queued to a bound wq q0 on the same CPU. w0 burns CPU for 5ms then sleeps for 10ms then burns CPU for 5ms again before finishing. w1 and w2 burn CPU for 5ms then sleep for 10ms.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jhhhMhjhhubh)}(hIgnoring all other tasks, works and processing overhead, and assuming simple FIFO scheduling, the following is one highly simplified version of possible sequences of events with the original wq. ::h]hIgnoring all other tasks, works and processing overhead, and assuming simple FIFO scheduling, the following is one highly simplified version of possible sequences of events with the original wq.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh literal_block)}(hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 starts and burns CPU 25 w1 sleeps 35 w1 wakes up and finishes 35 w2 starts and burns CPU 40 w2 sleeps 50 w2 wakes up and finishesh]hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 starts and burns CPU 25 w1 sleeps 35 w1 wakes up and finishes 35 w2 starts and burns CPU 40 w2 sleeps 50 w2 wakes up and finishes}hjsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1jhhhMhjhhubh)}(h+And with cmwq with ``@max_active`` >= 3, ::h](hAnd with cmwq with }(hjhhhNhNubj)}(h``@max_active``h]h @max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh >= 3,}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM+hjhhubj)}(hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 starts and burns CPU 10 w1 sleeps 10 w2 starts and burns CPU 15 w2 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 25 w2 wakes up and finishesh]hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 starts and burns CPU 10 w1 sleeps 10 w2 starts and burns CPU 15 w2 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 25 w2 wakes up and finishes}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhM-hjhhubh)}(hIf ``@max_active`` == 2, ::h](hIf }(hjhhhNhNubj)}(h``@max_active``h]h @max_active}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh == 2,}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM9hjhhubj)}(hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 starts and burns CPU 10 w1 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 20 w2 starts and burns CPU 25 w2 sleeps 35 w2 wakes up and finishesh]hXhTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 starts and burns CPU 10 w1 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 20 w2 starts and burns CPU 25 w2 sleeps 35 w2 wakes up and finishes}hj=sbah}(h]h ]h"]h$]h&]jjuh1jhhhM;hjhhubh)}(hbNow, let's assume w1 and w2 are queued to a different wq q1 which has ``WQ_CPU_INTENSIVE`` set, ::h](hHNow, let’s assume w1 and w2 are queued to a different wq q1 which has }(hjKhhhNhNubj)}(h``WQ_CPU_INTENSIVE``h]hWQ_CPU_INTENSIVE}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh set,}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMGhjhhubj)}(hXFTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 and w2 start and burn CPU 10 w1 sleeps 15 w2 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 25 w2 wakes up and finishesh]hXFTIME IN MSECS EVENT 0 w0 starts and burns CPU 5 w0 sleeps 5 w1 and w2 start and burn CPU 10 w1 sleeps 15 w2 sleeps 15 w0 wakes up and burns CPU 20 w0 finishes 20 w1 wakes up and finishes 25 w2 wakes up and finishes}hjksbah}(h]h ]h"]h$]h&]jjuh1jhhhMJhjhhubeh}(h]example-execution-scenariosah ]h"]example execution scenariosah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(h Guidelinesh]h Guidelines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMWubj )}(hhh](j%)}(hXMDo not forget to use ``WQ_MEM_RECLAIM`` if a wq may process work items which are used during memory reclaim. Each wq with ``WQ_MEM_RECLAIM`` set has an execution context reserved for it. If there is dependency among multiple work items used during memory reclaim, they should be queued to separate wq each with ``WQ_MEM_RECLAIM``. h]h)}(hXLDo not forget to use ``WQ_MEM_RECLAIM`` if a wq may process work items which are used during memory reclaim. Each wq with ``WQ_MEM_RECLAIM`` set has an execution context reserved for it. If there is dependency among multiple work items used during memory reclaim, they should be queued to separate wq each with ``WQ_MEM_RECLAIM``.h](hDo not forget to use }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhT if a wq may process work items which are used during memory reclaim. Each wq with }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh set has an execution context reserved for it. If there is dependency among multiple work items used during memory reclaim, they should be queued to separate wq each with }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMYhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hCUnless strict ordering is required, there is no need to use ST wq. h]h)}(hBUnless strict ordering is required, there is no need to use ST wq.h]hBUnless strict ordering is required, there is no need to use ST wq.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM`hjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hUnless there is a specific need, using 0 for @max_active is recommended. In most use cases, concurrency level usually stays well under the default limit. h]h)}(hUnless there is a specific need, using 0 for @max_active is recommended. In most use cases, concurrency level usually stays well under the default limit.h]hUnless there is a specific need, using 0 for @max_active is recommended. In most use cases, concurrency level usually stays well under the default limit.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMbhjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hXA wq serves as a domain for forward progress guarantee (``WQ_MEM_RECLAIM``), flush and work item attributes. Work items which are not involved in memory reclaim and don't need to be flushed as a part of a group of work items, and don't require any special attribute, can use one of the system wq. There is no difference in execution characteristics between using a dedicated wq and a system wq. Note: If something may generate more than @max_active outstanding work items (do stress test your producers), it may saturate a system wq and potentially lead to deadlock. It should utilize its own dedicated workqueue rather than the system wq. h](h)}(hXA wq serves as a domain for forward progress guarantee (``WQ_MEM_RECLAIM``), flush and work item attributes. Work items which are not involved in memory reclaim and don't need to be flushed as a part of a group of work items, and don't require any special attribute, can use one of the system wq. There is no difference in execution characteristics between using a dedicated wq and a system wq.h](h8A wq serves as a domain for forward progress guarantee (}(hj hhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhXF), flush and work item attributes. Work items which are not involved in memory reclaim and don’t need to be flushed as a part of a group of work items, and don’t require any special attribute, can use one of the system wq. There is no difference in execution characteristics between using a dedicated wq and a system wq.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMfhj ubh)}(hNote: If something may generate more than @max_active outstanding work items (do stress test your producers), it may saturate a system wq and potentially lead to deadlock. It should utilize its own dedicated workqueue rather than the system wq.h]hNote: If something may generate more than @max_active outstanding work items (do stress test your producers), it may saturate a system wq and potentially lead to deadlock. It should utilize its own dedicated workqueue rather than the system wq.}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMnhj ubeh}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hUnless work items are expected to consume a huge amount of CPU cycles, using a bound wq is usually beneficial due to the increased level of locality in wq operations and work item execution. h]h)}(hUnless work items are expected to consume a huge amount of CPU cycles, using a bound wq is usually beneficial due to the increased level of locality in wq operations and work item execution.h]hUnless work items are expected to consume a huge amount of CPU cycles, using a bound wq is usually beneficial due to the increased level of locality in wq operations and work item execution.}(hjO hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMshjK ubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubeh}(h]h ]h"]h$]h&]jtjuuh1jhhhMYhjhhubeh}(h] guidelinesah ]h"] guidelinesah$]h&]uh1hhhhhhhhMWubh)}(hhh](h)}(hAffinity Scopesh]hAffinity Scopes}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjq hhhhhMyubh)}(hXAn unbound workqueue groups CPUs according to its affinity scope to improve cache locality. For example, if a workqueue is using the default affinity scope of "cache_shard", it will group CPUs into sub-LLC shards. A work item queued on the workqueue will be assigned to a worker on one of the CPUs within the same shard as the issuing CPU. Once started, the worker may or may not be allowed to move outside the scope depending on the ``affinity_strict`` setting of the scope.h](hXAn unbound workqueue groups CPUs according to its affinity scope to improve cache locality. For example, if a workqueue is using the default affinity scope of “cache_shard”, it will group CPUs into sub-LLC shards. A work item queued on the workqueue will be assigned to a worker on one of the CPUs within the same shard as the issuing CPU. Once started, the worker may or may not be allowed to move outside the scope depending on the }(hj hhhNhNubj)}(h``affinity_strict``h]haffinity_strict}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh setting of the scope.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM{hjq hhubh)}(h;Workqueue currently supports the following affinity scopes.h]h;Workqueue currently supports the following affinity scopes.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjq hhubjg)}(hhh](jl)}(h``default`` Use the scope in module parameter ``workqueue.default_affinity_scope`` which is always set to one of the scopes below. h](jr)}(h ``default``h]j)}(hj h]hdefault}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj ubj)}(hhh]h)}(hvUse the scope in module parameter ``workqueue.default_affinity_scope`` which is always set to one of the scopes below.h](h"Use the scope in module parameter }(hj hhhNhNubj)}(h$``workqueue.default_affinity_scope``h]h workqueue.default_affinity_scope}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh0 which is always set to one of the scopes below.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj ubjl)}(h``cpu`` CPUs are not grouped. A work item issued on one CPU is processed by a worker on the same CPU. This makes unbound workqueues behave as per-cpu workqueues without concurrency management. h](jr)}(h``cpu``h]j)}(hj h]hcpu}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj ubj)}(hhh]h)}(hCPUs are not grouped. A work item issued on one CPU is processed by a worker on the same CPU. This makes unbound workqueues behave as per-cpu workqueues without concurrency management.h]hCPUs are not grouped. A work item issued on one CPU is processed by a worker on the same CPU. This makes unbound workqueues behave as per-cpu workqueues without concurrency management.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubjl)}(h``smt`` CPUs are grouped according to SMT boundaries. This usually means that the logical threads of each physical CPU core are grouped together. h](jr)}(h``smt``h]j)}(hj; h]hsmt}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9 ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj5 ubj)}(hhh]h)}(hCPUs are grouped according to SMT boundaries. This usually means that the logical threads of each physical CPU core are grouped together.h]hCPUs are grouped according to SMT boundaries. This usually means that the logical threads of each physical CPU core are grouped together.}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjP ubah}(h]h ]h"]h$]h&]uh1jhj5 ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubjl)}(h``cache`` CPUs are grouped according to cache boundaries. Which specific cache boundary is used is determined by the arch code. L3 is used in a lot of cases. h](jr)}(h ``cache``h]j)}(hjs h]hcache}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq ubah}(h]h ]h"]h$]h&]uh1jqhhhMhjm ubj)}(hhh]h)}(hCPUs are grouped according to cache boundaries. Which specific cache boundary is used is determined by the arch code. L3 is used in a lot of cases.h]hCPUs are grouped according to cache boundaries. Which specific cache boundary is used is determined by the arch code. L3 is used in a lot of cases.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhjm ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubjl)}(hX``cache_shard`` CPUs are grouped into sub-LLC shards of at most ``wq_cache_shard_size`` cores (default 8, tunable via the ``workqueue.cache_shard_size`` boot parameter). Shards are always split on core (SMT group) boundaries. This is the default affinity scope. h](jr)}(h``cache_shard``h]j)}(hj h]h cache_shard}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj ubj)}(hhh]h)}(hCPUs are grouped into sub-LLC shards of at most ``wq_cache_shard_size`` cores (default 8, tunable via the ``workqueue.cache_shard_size`` boot parameter). Shards are always split on core (SMT group) boundaries. This is the default affinity scope.h](h0CPUs are grouped into sub-LLC shards of at most }(hj hhhNhNubj)}(h``wq_cache_shard_size``h]hwq_cache_shard_size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh# cores (default 8, tunable via the }(hj hhhNhNubj)}(h``workqueue.cache_shard_size``h]hworkqueue.cache_shard_size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhm boot parameter). Shards are always split on core (SMT group) boundaries. This is the default affinity scope.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubjl)}(h8``numa`` CPUs are grouped according to NUMA boundaries. h](jr)}(h``numa``h]j)}(hj h]hnuma}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj ubj)}(hhh]h)}(h.CPUs are grouped according to NUMA boundaries.h]h.CPUs are grouped according to NUMA boundaries.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubjl)}(h``system`` All CPUs are put in the same group. Workqueue makes no effort to process a work item on a CPU close to the issuing CPU. h](jr)}(h ``system``h]j)}(hj? h]hsystem}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj= ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj9 ubj)}(hhh]h)}(hwAll CPUs are put in the same group. Workqueue makes no effort to process a work item on a CPU close to the issuing CPU.h]hwAll CPUs are put in the same group. Workqueue makes no effort to process a work item on a CPU close to the issuing CPU.}(hjW hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjT ubah}(h]h ]h"]h$]h&]uh1jhj9 ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubeh}(h]h ]h"]h$]h&]uh1jfhjq hhhhhNubh)}(hThe default affinity scope can be changed with the module parameter ``workqueue.default_affinity_scope`` and a specific workqueue's affinity scope can be changed using ``apply_workqueue_attrs()``.h](hDThe default affinity scope can be changed with the module parameter }(hjw hhhNhNubj)}(h$``workqueue.default_affinity_scope``h]h workqueue.default_affinity_scope}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjw ubhB and a specific workqueue’s affinity scope can be changed using }(hjw hhhNhNubj)}(h``apply_workqueue_attrs()``h]happly_workqueue_attrs()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjw ubh.}(hjw hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjq hhubh)}(hIf ``WQ_SYSFS`` is set, the workqueue will have the following affinity scope related interface files under its ``/sys/devices/virtual/workqueue/WQ_NAME/`` directory.h](hIf }(hj hhhNhNubj)}(h ``WQ_SYSFS``h]hWQ_SYSFS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh` is set, the workqueue will have the following affinity scope related interface files under its }(hj hhhNhNubj)}(h+``/sys/devices/virtual/workqueue/WQ_NAME/``h]h'/sys/devices/virtual/workqueue/WQ_NAME/}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh directory.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjq hhubjg)}(hhh](jl)}(h``affinity_scope`` Read to see the current affinity scope. Write to change. When default is the current scope, reading this file will also show the current effective scope in parentheses, for example, ``default (cache)``. h](jr)}(h``affinity_scope``h]j)}(hj h]haffinity_scope}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj ubj)}(hhh](h)}(h8Read to see the current affinity scope. Write to change.h]h8Read to see the current affinity scope. Write to change.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubh)}(hWhen default is the current scope, reading this file will also show the current effective scope in parentheses, for example, ``default (cache)``.h](h}When default is the current scope, reading this file will also show the current effective scope in parentheses, for example, }(hj hhhNhNubj)}(h``default (cache)``h]hdefault (cache)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj ubjl)}(hX``affinity_strict`` 0 by default indicating that affinity scopes are not strict. When a work item starts execution, workqueue makes a best-effort attempt to ensure that the worker is inside its affinity scope, which is called repatriation. Once started, the scheduler is free to move the worker anywhere in the system as it sees fit. This enables benefiting from scope locality while still being able to utilize other CPUs if necessary and available. If set to 1, all workers of the scope are guaranteed always to be in the scope. This may be useful when crossing affinity scopes has other implications, for example, in terms of power consumption or workload isolation. Strict NUMA scope can also be used to match the workqueue behavior of older kernels. h](jr)}(h``affinity_strict``h]j)}(hj< h]haffinity_strict}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj: ubah}(h]h ]h"]h$]h&]uh1jqhhhMhj6 ubj)}(hhh](h)}(hX0 by default indicating that affinity scopes are not strict. When a work item starts execution, workqueue makes a best-effort attempt to ensure that the worker is inside its affinity scope, which is called repatriation. Once started, the scheduler is free to move the worker anywhere in the system as it sees fit. This enables benefiting from scope locality while still being able to utilize other CPUs if necessary and available.h]hX0 by default indicating that affinity scopes are not strict. When a work item starts execution, workqueue makes a best-effort attempt to ensure that the worker is inside its affinity scope, which is called repatriation. Once started, the scheduler is free to move the worker anywhere in the system as it sees fit. This enables benefiting from scope locality while still being able to utilize other CPUs if necessary and available.}(hjT hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjQ ubh)}(hX/If set to 1, all workers of the scope are guaranteed always to be in the scope. This may be useful when crossing affinity scopes has other implications, for example, in terms of power consumption or workload isolation. Strict NUMA scope can also be used to match the workqueue behavior of older kernels.h]hX/If set to 1, all workers of the scope are guaranteed always to be in the scope. This may be useful when crossing affinity scopes has other implications, for example, in terms of power consumption or workload isolation. Strict NUMA scope can also be used to match the workqueue behavior of older kernels.}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjQ ubeh}(h]h ]h"]h$]h&]uh1jhj6 ubeh}(h]h ]h"]h$]h&]uh1jkhhhMhj hhubeh}(h]h ]h"]h$]h&]uh1jfhjq hhhhhNubeh}(h]affinity-scopesah ]h"]affinity scopesah$]h&]uh1hhhhhhhhMyubh)}(hhh](h)}(hAffinity Scopes and Performanceh]hAffinity Scopes and Performance}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hX%It'd be ideal if an unbound workqueue's behavior is optimal for vast majority of use cases without further tuning. Unfortunately, in the current kernel, there exists a pronounced trade-off between locality and utilization necessitating explicit configurations when workqueues are heavily used.h]hX)It’d be ideal if an unbound workqueue’s behavior is optimal for vast majority of use cases without further tuning. Unfortunately, in the current kernel, there exists a pronounced trade-off between locality and utilization necessitating explicit configurations when workqueues are heavily used.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXcHigher locality leads to higher efficiency where more work is performed for the same number of consumed CPU cycles. However, higher locality may also cause lower overall system utilization if the work items are not spread enough across the affinity scopes by the issuers. The following performance testing with dm-crypt clearly illustrates this trade-off.h]hXcHigher locality leads to higher efficiency where more work is performed for the same number of consumed CPU cycles. However, higher locality may also cause lower overall system utilization if the work items are not spread enough across the affinity scopes by the issuers. The following performance testing with dm-crypt clearly illustrates this trade-off.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXThe tests are run on a CPU with 12-cores/24-threads split across four L3 caches (AMD Ryzen 9 3900x). CPU clock boost is turned off for consistency. ``/dev/dm-0`` is a dm-crypt device created on NVME SSD (Samsung 990 PRO) and opened with ``cryptsetup`` with default settings.h](hThe tests are run on a CPU with 12-cores/24-threads split across four L3 caches (AMD Ryzen 9 3900x). CPU clock boost is turned off for consistency. }(hj hhhNhNubj)}(h ``/dev/dm-0``h]h /dev/dm-0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhL is a dm-crypt device created on NVME SSD (Samsung 990 PRO) and opened with }(hj hhhNhNubj)}(h``cryptsetup``h]h cryptsetup}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh with default settings.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hhh](h)}(h=Scenario 1: Enough issuers and work spread across the machineh]h=Scenario 1: Enough issuers and work spread across the machine}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hThe command used: ::h]hThe command used:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(h$ fio --filename=/dev/dm-0 --direct=1 --rw=randrw --bs=32k --ioengine=libaio \ --iodepth=64 --runtime=60 --numjobs=24 --time_based --group_reporting \ --name=iops-test-job --verify=sha512h]h$ fio --filename=/dev/dm-0 --direct=1 --rw=randrw --bs=32k --ioengine=libaio \ --iodepth=64 --runtime=60 --numjobs=24 --time_based --group_reporting \ --name=iops-test-job --verify=sha512}hj sbah}(h]h ]h"]h$]h&]jjuh1jhhhMhj hhubh)}(hXThere are 24 issuers, each issuing 64 IOs concurrently. ``--verify=sha512`` makes ``fio`` generate and read back the content each time which makes execution locality matter between the issuer and ``kcryptd``. The following are the read bandwidths and CPU utilizations depending on different affinity scope settings on ``kcryptd`` measured over five runs. Bandwidths are in MiBps, and CPU util in percents.h](h8There are 24 issuers, each issuing 64 IOs concurrently. }(hj hhhNhNubj)}(h``--verify=sha512``h]h--verify=sha512}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh makes }(hj hhhNhNubj)}(h``fio``h]hfio}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhk generate and read back the content each time which makes execution locality matter between the issuer and }(hj hhhNhNubj)}(h ``kcryptd``h]hkcryptd}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubho. The following are the read bandwidths and CPU utilizations depending on different affinity scope settings on }(hj hhhNhNubj)}(h ``kcryptd``h]hkcryptd}(hjT hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhL measured over five runs. Bandwidths are in MiBps, and CPU util in percents.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jv hjs ubjw )}(hhh]h}(h]h ]h"]h$]h&]j Kuh1jv hjs ubjw )}(hhh]h}(h]h ]h"]h$]h&]j Kuh1jv hjs ubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hAffinityh]hAffinity}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hBandwidth (MiBps)h]hBandwidth (MiBps)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h CPU util (%)h]h CPU util (%)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubah}(h]h ]h"]h$]h&]uh1j hjs ubhtbody)}(hhh](j )}(hhh](j )}(hhh]h)}(hsystemh]hsystem}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h1159.40 ±1.34h]h1159.40 ±1.34}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h 99.31 ±0.02h]h 99.31 ±0.02}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj'ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hcacheh]hcache}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjGubah}(h]h ]h"]h$]h&]uh1j hjDubj )}(hhh]h)}(h1166.40 ±0.89h]h1166.40 ±0.89}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj^ubah}(h]h ]h"]h$]h&]uh1j hjDubj )}(hhh]h)}(h 99.34 ±0.01h]h 99.34 ±0.01}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjuubah}(h]h ]h"]h$]h&]uh1j hjDubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hcache (strict)h]hcache (strict)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(h1166.00 ±0.71h]h1166.00 ±0.71}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(h 99.35 ±0.01h]h 99.35 ±0.01}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hjs ubeh}(h]h ]h"]h$]h&]colsKuh1jq hjn ubah}(h]h ]colwidths-givenah"]h$]h&]uh1jl hj hhhNhNubh)}(hWith enough issuers spread across the system, there is no downside to "cache", strict or otherwise. All three configurations saturate the whole machine but the cache-affine ones outperform by 0.6% thanks to improved locality.h]hWith enough issuers spread across the system, there is no downside to “cache”, strict or otherwise. All three configurations saturate the whole machine but the cache-affine ones outperform by 0.6% thanks to improved locality.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]hjubah}(h]h ]h"]h$]h&]uh1j hjdubeh}(h]h ]h"]h$]h&]uh1j hjaubah}(h]h ]h"]h$]h&]uh1j hjCubj )}(hhh](j )}(hhh](j )}(hhh]h)}(hsystemh]hsystem}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM@hjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(h 993.60 ±1.82h]h 993.60 ±1.82}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMAhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(h 75.49 ±0.06h]h 75.49 ±0.06}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMBhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh](j )}(hhh]h)}(hcacheh]hcache}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h 973.40 ±1.52h]h 973.40 ±1.52}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMEhj#ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h 74.90 ±0.07h]h 74.90 ±0.07}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMFhj:ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh](j )}(hhh]h)}(hcache (strict)h]hcache (strict)}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMHhjZubah}(h]h ]h"]h$]h&]uh1j hjWubj )}(hhh]h)}(h 828.20 ±4.49h]h 828.20 ±4.49}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMIhjqubah}(h]h ]h"]h$]h&]uh1j hjWubj )}(hhh]h)}(h 66.84 ±0.29h]h 66.84 ±0.29}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMJhjubah}(h]h ]h"]h$]h&]uh1j hjWubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjCubeh}(h]h ]h"]h$]h&]colsKuh1jq hj@ubah}(h]h ]jah"]h$]h&]uh1jl hjhhhNhNubh)}(hNow, the tradeoff between locality and utilization is clearer. "cache" shows 2% bandwidth loss compared to "system" and "cache (struct)" whopping 20%.h]hNow, the tradeoff between locality and utilization is clearer. “cache” shows 2% bandwidth loss compared to “system” and “cache (struct)” whopping 20%.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhjhhubeh}(h]9scenario-3-even-fewer-issuers-not-enough-work-to-saturateah ]h"];scenario 3: even fewer issuers, not enough work to saturateah$]h&]uh1hhj hhhhhM,ubh)}(hhh](h)}(hConclusion and Recommendationsh]hConclusion and Recommendations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMQubh)}(hXIn the above experiments, the efficiency advantage of the "cache" affinity scope over "system" is, while consistent and noticeable, small. However, the impact is dependent on the distances between the scopes and may be more pronounced in processors with more complex topologies.h]hXIn the above experiments, the efficiency advantage of the “cache” affinity scope over “system” is, while consistent and noticeable, small. However, the impact is dependent on the distances between the scopes and may be more pronounced in processors with more complex topologies.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMShjhhubh)}(hWhile the loss of work-conservation in certain scenarios hurts, it is a lot better than "cache (strict)" and maximizing workqueue utilization is unlikely to be the common case anyway. As such, "cache" is the default affinity scope for unbound pools.h]hXWhile the loss of work-conservation in certain scenarios hurts, it is a lot better than “cache (strict)” and maximizing workqueue utilization is unlikely to be the common case anyway. As such, “cache” is the default affinity scope for unbound pools.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMXhjhhubj )}(hhh](j%)}(hAs there is no one option which is great for most cases, workqueue usages that may consume a significant amount of CPU are recommended to configure the workqueues using ``apply_workqueue_attrs()`` and/or enable ``WQ_SYSFS``. h]h)}(hAs there is no one option which is great for most cases, workqueue usages that may consume a significant amount of CPU are recommended to configure the workqueues using ``apply_workqueue_attrs()`` and/or enable ``WQ_SYSFS``.h](hAs there is no one option which is great for most cases, workqueue usages that may consume a significant amount of CPU are recommended to configure the workqueues using }(hjhhhNhNubj)}(h``apply_workqueue_attrs()``h]happly_workqueue_attrs()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and/or enable }(hjhhhNhNubj)}(h ``WQ_SYSFS``h]hWQ_SYSFS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM]hjubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hAn unbound workqueue with strict "cpu" affinity scope behaves the same as ``WQ_CPU_INTENSIVE`` per-cpu workqueue. There is no real advanage to the latter and an unbound workqueue provides a lot more flexibility. h]h)}(hAn unbound workqueue with strict "cpu" affinity scope behaves the same as ``WQ_CPU_INTENSIVE`` per-cpu workqueue. There is no real advanage to the latter and an unbound workqueue provides a lot more flexibility.h](hNAn unbound workqueue with strict “cpu” affinity scope behaves the same as }(hj>hhhNhNubj)}(h``WQ_CPU_INTENSIVE``h]hWQ_CPU_INTENSIVE}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubhu per-cpu workqueue. There is no real advanage to the latter and an unbound workqueue provides a lot more flexibility.}(hj>hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMbhj:ubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hrAffinity scopes are introduced in Linux v6.5. To emulate the previous behavior, use strict "numa" affinity scope. h]h)}(hqAffinity scopes are introduced in Linux v6.5. To emulate the previous behavior, use strict "numa" affinity scope.h]huAffinity scopes are introduced in Linux v6.5. To emulate the previous behavior, use strict “numa” affinity scope.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMfhjdubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubj%)}(hXRThe loss of work-conservation in non-strict affinity scopes is likely originating from the scheduler. There is no theoretical reason why the kernel wouldn't be able to do the right thing and maintain work-conservation in most cases. As such, it is possible that future scheduler improvements may make most of these tunables unnecessary. h]h)}(hXPThe loss of work-conservation in non-strict affinity scopes is likely originating from the scheduler. There is no theoretical reason why the kernel wouldn't be able to do the right thing and maintain work-conservation in most cases. As such, it is possible that future scheduler improvements may make most of these tunables unnecessary.h]hXRThe loss of work-conservation in non-strict affinity scopes is likely originating from the scheduler. There is no theoretical reason why the kernel wouldn’t be able to do the right thing and maintain work-conservation in most cases. As such, it is possible that future scheduler improvements may make most of these tunables unnecessary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMihj|ubah}(h]h ]h"]h$]h&]uh1j$hjhhhhhNubeh}(h]h ]h"]h$]h&]jtjuuh1jhhhM]hjhhubeh}(h]conclusion-and-recommendationsah ]h"]conclusion and recommendationsah$]h&]uh1hhj hhhhhMQubeh}(h]affinity-scopes-and-performanceah ]h"]affinity scopes and performanceah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hExamining Configurationh]hExamining Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMqubh)}(hUse tools/workqueue/wq_dump.py to examine unbound CPU affinity configuration, worker pools and how workqueues map to the pools: ::h]hUse tools/workqueue/wq_dump.py to examine unbound CPU affinity configuration, worker pools and how workqueues map to the pools:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMshjhhubj)}(hXb$ tools/workqueue/wq_dump.py Affinity Scopes =============== wq_unbound_cpumask=0000000f CPU nr_pods 4 pod_cpus [0]=00000001 [1]=00000002 [2]=00000004 [3]=00000008 pod_node [0]=0 [1]=0 [2]=1 [3]=1 cpu_pod [0]=0 [1]=1 [2]=2 [3]=3 SMT nr_pods 4 pod_cpus [0]=00000001 [1]=00000002 [2]=00000004 [3]=00000008 pod_node [0]=0 [1]=0 [2]=1 [3]=1 cpu_pod [0]=0 [1]=1 [2]=2 [3]=3 CACHE (default) nr_pods 2 pod_cpus [0]=00000003 [1]=0000000c pod_node [0]=0 [1]=1 cpu_pod [0]=0 [1]=0 [2]=1 [3]=1 NUMA nr_pods 2 pod_cpus [0]=00000003 [1]=0000000c pod_node [0]=0 [1]=1 cpu_pod [0]=0 [1]=0 [2]=1 [3]=1 SYSTEM nr_pods 1 pod_cpus [0]=0000000f pod_node [0]=-1 cpu_pod [0]=0 [1]=0 [2]=0 [3]=0 Worker Pools ============ pool[00] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 0 pool[01] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 0 pool[02] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 1 pool[03] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 1 pool[04] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 2 pool[05] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 2 pool[06] ref= 1 nice= 0 idle/workers= 3/ 3 cpu= 3 pool[07] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 3 pool[08] ref=42 nice= 0 idle/workers= 6/ 6 cpus=0000000f pool[09] ref=28 nice= 0 idle/workers= 3/ 3 cpus=00000003 pool[10] ref=28 nice= 0 idle/workers= 17/ 17 cpus=0000000c pool[11] ref= 1 nice=-20 idle/workers= 1/ 1 cpus=0000000f pool[12] ref= 2 nice=-20 idle/workers= 1/ 1 cpus=00000003 pool[13] ref= 2 nice=-20 idle/workers= 1/ 1 cpus=0000000c Workqueue CPU -> pool ===================== [ workqueue \ CPU 0 1 2 3 dfl] events percpu 0 2 4 6 events_highpri percpu 1 3 5 7 events_long percpu 0 2 4 6 events_unbound unbound 9 9 10 10 8 events_freezable percpu 0 2 4 6 events_power_efficient percpu 0 2 4 6 events_freezable_pwr_ef percpu 0 2 4 6 rcu_gp percpu 0 2 4 6 rcu_par_gp percpu 0 2 4 6 slub_flushwq percpu 0 2 4 6 netns ordered 8 8 8 8 8 ...h]hXb$ tools/workqueue/wq_dump.py Affinity Scopes =============== wq_unbound_cpumask=0000000f CPU nr_pods 4 pod_cpus [0]=00000001 [1]=00000002 [2]=00000004 [3]=00000008 pod_node [0]=0 [1]=0 [2]=1 [3]=1 cpu_pod [0]=0 [1]=1 [2]=2 [3]=3 SMT nr_pods 4 pod_cpus [0]=00000001 [1]=00000002 [2]=00000004 [3]=00000008 pod_node [0]=0 [1]=0 [2]=1 [3]=1 cpu_pod [0]=0 [1]=1 [2]=2 [3]=3 CACHE (default) nr_pods 2 pod_cpus [0]=00000003 [1]=0000000c pod_node [0]=0 [1]=1 cpu_pod [0]=0 [1]=0 [2]=1 [3]=1 NUMA nr_pods 2 pod_cpus [0]=00000003 [1]=0000000c pod_node [0]=0 [1]=1 cpu_pod [0]=0 [1]=0 [2]=1 [3]=1 SYSTEM nr_pods 1 pod_cpus [0]=0000000f pod_node [0]=-1 cpu_pod [0]=0 [1]=0 [2]=0 [3]=0 Worker Pools ============ pool[00] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 0 pool[01] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 0 pool[02] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 1 pool[03] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 1 pool[04] ref= 1 nice= 0 idle/workers= 4/ 4 cpu= 2 pool[05] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 2 pool[06] ref= 1 nice= 0 idle/workers= 3/ 3 cpu= 3 pool[07] ref= 1 nice=-20 idle/workers= 2/ 2 cpu= 3 pool[08] ref=42 nice= 0 idle/workers= 6/ 6 cpus=0000000f pool[09] ref=28 nice= 0 idle/workers= 3/ 3 cpus=00000003 pool[10] ref=28 nice= 0 idle/workers= 17/ 17 cpus=0000000c pool[11] ref= 1 nice=-20 idle/workers= 1/ 1 cpus=0000000f pool[12] ref= 2 nice=-20 idle/workers= 1/ 1 cpus=00000003 pool[13] ref= 2 nice=-20 idle/workers= 1/ 1 cpus=0000000c Workqueue CPU -> pool ===================== [ workqueue \ CPU 0 1 2 3 dfl] events percpu 0 2 4 6 events_highpri percpu 1 3 5 7 events_long percpu 0 2 4 6 events_unbound unbound 9 9 10 10 8 events_freezable percpu 0 2 4 6 events_power_efficient percpu 0 2 4 6 events_freezable_pwr_ef percpu 0 2 4 6 rcu_gp percpu 0 2 4 6 rcu_par_gp percpu 0 2 4 6 slub_flushwq percpu 0 2 4 6 netns ordered 8 8 8 8 8 ...}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhMvhjhhubh)}(h-See the command's help message for more info.h]h/See the command’s help message for more info.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]examining-configurationah ]h"]examining configurationah$]h&]uh1hhhhhhhhMqubh)}(hhh](h)}(h Monitoringh]h Monitoring}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hEUse tools/workqueue/wq_monitor.py to monitor workqueue operations: ::h]hBUse tools/workqueue/wq_monitor.py to monitor workqueue operations:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(hX$ tools/workqueue/wq_monitor.py events total infl CPUtime CPUhog CMW/RPR mayday rescued events 18545 0 6.1 0 5 - - events_highpri 8 0 0.0 0 0 - - events_long 3 0 0.0 0 0 - - events_unbound 38306 0 0.1 - 7 - - events_freezable 0 0 0.0 0 0 - - events_power_efficient 29598 0 0.2 0 0 - - events_freezable_pwr_ef 10 0 0.0 0 0 - - sock_diag_events 0 0 0.0 0 0 - - total infl CPUtime CPUhog CMW/RPR mayday rescued events 18548 0 6.1 0 5 - - events_highpri 8 0 0.0 0 0 - - events_long 3 0 0.0 0 0 - - events_unbound 38322 0 0.1 - 7 - - events_freezable 0 0 0.0 0 0 - - events_power_efficient 29603 0 0.2 0 0 - - events_freezable_pwr_ef 10 0 0.0 0 0 - - sock_diag_events 0 0 0.0 0 0 - - ...h]hX$ tools/workqueue/wq_monitor.py events total infl CPUtime CPUhog CMW/RPR mayday rescued events 18545 0 6.1 0 5 - - events_highpri 8 0 0.0 0 0 - - events_long 3 0 0.0 0 0 - - events_unbound 38306 0 0.1 - 7 - - events_freezable 0 0 0.0 0 0 - - events_power_efficient 29598 0 0.2 0 0 - - events_freezable_pwr_ef 10 0 0.0 0 0 - - sock_diag_events 0 0 0.0 0 0 - - total infl CPUtime CPUhog CMW/RPR mayday rescued events 18548 0 6.1 0 5 - - events_highpri 8 0 0.0 0 0 - - events_long 3 0 0.0 0 0 - - events_unbound 38322 0 0.1 - 7 - - events_freezable 0 0 0.0 0 0 - - events_power_efficient 29603 0 0.2 0 0 - - events_freezable_pwr_ef 10 0 0.0 0 0 - - sock_diag_events 0 0 0.0 0 0 - - ...}hj sbah}(h]h ]h"]h$]h&]jjuh1jhhhMhjhhubh)}(h-See the command's help message for more info.h]h/See the command’s help message for more info.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h] monitoringah ]h"] monitoringah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(h Debuggingh]h Debugging}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hhhhhMubh)}(hBecause the work functions are executed by generic worker threads there are a few tricks needed to shed some light on misbehaving workqueue users.h]hBecause the work functions are executed by generic worker threads there are a few tricks needed to shed some light on misbehaving workqueue users.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubh)}(h1Worker threads show up in the process list as: ::h]h.Worker threads show up in the process list as:}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubj)}(hX;root 5671 0.0 0.0 0 0 ? S 12:07 0:00 [kworker/0:1] root 5672 0.0 0.0 0 0 ? S 12:07 0:00 [kworker/1:2] root 5673 0.0 0.0 0 0 ? S 12:12 0:00 [kworker/0:0] root 5674 0.0 0.0 0 0 ? S 12:13 0:00 [kworker/1:0]h]hX;root 5671 0.0 0.0 0 0 ? S 12:07 0:00 [kworker/0:1] root 5672 0.0 0.0 0 0 ? S 12:07 0:00 [kworker/1:2] root 5673 0.0 0.0 0 0 ? S 12:12 0:00 [kworker/0:0] root 5674 0.0 0.0 0 0 ? S 12:13 0:00 [kworker/1:0]}hj]sbah}(h]h ]h"]h$]h&]jjuh1jhhhMhj0hhubh)}(h[If kworkers are going crazy (using too much cpu), there are two types of possible problems:h]h[If kworkers are going crazy (using too much cpu), there are two types of possible problems:}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubj)}(hh1. Something being scheduled in rapid succession 2. A single work item that consumes lots of cpu cycles h]henumerated_list)}(hhh](j%)}(h-Something being scheduled in rapid successionh]h)}(hjh]h-Something being scheduled in rapid succession}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(h4A single work item that consumes lots of cpu cycles h]h)}(h3A single work item that consumes lots of cpu cyclesh]h3A single work item that consumes lots of cpu cycles}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j}hjyubah}(h]h ]h"]h$]h&]uh1jhhhMhj0hhubh)}(h.The first one can be tracked using tracing: ::h]h+The first one can be tracked using tracing:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubj)}(h$ echo workqueue:workqueue_queue_work > /sys/kernel/tracing/set_event $ cat /sys/kernel/tracing/trace_pipe > out.txt (wait a few secs) ^Ch]h$ echo workqueue:workqueue_queue_work > /sys/kernel/tracing/set_event $ cat /sys/kernel/tracing/trace_pipe > out.txt (wait a few secs) ^C}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhMhj0hhubh)}(hIf something is busy looping on work queueing, it would be dominating the output and the offender can be determined with the work item function.h]hIf something is busy looping on work queueing, it would be dominating the output and the offender can be determined with the work item function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubh)}(hvFor the second type of problems it should be possible to just check the stack trace of the offending worker thread. ::h]hsFor the second type of problems it should be possible to just check the stack trace of the offending worker thread.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubj)}(h'$ cat /proc/THE_OFFENDING_KWORKER/stackh]h'$ cat /proc/THE_OFFENDING_KWORKER/stack}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhMhj0hhubh)}(hHThe work item's function should be trivially visible in the stack trace.h]hJThe work item’s function should be trivially visible in the stack trace.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0hhubeh}(h] debuggingah ]h"] debuggingah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hNon-reentrance Conditionsh]hNon-reentrance Conditions}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubh)}(hzWorkqueue guarantees that a work item cannot be re-entrant if the following conditions hold after a work item gets queued:h]hzWorkqueue guarantees that a work item cannot be re-entrant if the following conditions hold after a work item gets queued:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(h1. The work function hasn't been changed. 2. No one queues the work item to another workqueue. 3. The work item hasn't been reinitiated. h]j~)}(hhh](j%)}(h&The work function hasn't been changed.h]h)}(hjFh]h(The work function hasn’t been changed.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjDubah}(h]h ]h"]h$]h&]uh1j$hjAubj%)}(h1No one queues the work item to another workqueue.h]h)}(hj]h]h1No one queues the work item to another workqueue.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj[ubah}(h]h ]h"]h$]h&]uh1j$hjAubj%)}(h'The work item hasn't been reinitiated. h]h)}(h&The work item hasn't been reinitiated.h]h(The work item hasn’t been reinitiated.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjrubah}(h]h ]h"]h$]h&]uh1j$hjAubeh}(h]h ]h"]h$]h&]jjjhjjuh1j}hj=ubah}(h]h ]h"]h$]h&]uh1jhhhM hjhhubh)}(hIn other words, if the above conditions hold, the work item is guaranteed to be executed by at most one worker system-wide at any given time.h]hIn other words, if the above conditions hold, the work item is guaranteed to be executed by at most one worker system-wide at any given time.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hNote that requeuing the work item (to the same queue) in the self function doesn't break these conditions, so it's safe to do. Otherwise, caution is required when breaking the conditions inside a work function.h]hNote that requeuing the work item (to the same queue) in the self function doesn’t break these conditions, so it’s safe to do. Otherwise, caution is required when breaking the conditions inside a work function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]non-reentrance-conditionsah ]h"]non-reentrance conditionsah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(h&Kernel Inline Documentations Referenceh]h&Kernel Inline Documentations Reference}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singleworkqueue_attrs (C struct)c.workqueue_attrshNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(hworkqueue_attrsh]hdesc_signature_line)}(hstruct workqueue_attrsh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(hworkqueue_attrsh]h desc_sig_name)}(hjh]hworkqueue_attrs}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]jjuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]jj add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(h"A struct for workqueue attributes.h]h"A struct for workqueue attributes.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjDhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhKubeh}(h]h ](cstructeh"]h$]h&]domainj_objtypej`desctypej`noindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(hX**Definition**:: struct workqueue_attrs { int nice; cpumask_var_t cpumask; cpumask_var_t __pod_cpumask; bool affn_strict; enum wq_affn_scope affn_scope; bool ordered; }; **Members** ``nice`` nice level ``cpumask`` allowed CPUs Work items in this workqueue are affine to these CPUs and not allowed to execute on other CPUs. A pool serving a workqueue must have the same **cpumask**. ``__pod_cpumask`` internal attribute used to create per-pod pools Internal use only. Per-pod unbound worker pools are used to improve locality. Always a subset of ->cpumask. A workqueue can be associated with multiple worker pools with disjoint **__pod_cpumask**'s. Whether the enforcement of a pool's **__pod_cpumask** is strict depends on **affn_strict**. ``affn_strict`` affinity scope is strict If clear, workqueue will make a best-effort attempt at starting the worker inside **__pod_cpumask** but the scheduler is free to migrate it outside. If set, workers are only allowed to run inside **__pod_cpumask**. ``affn_scope`` unbound CPU affinity scope CPU pods are used to improve execution locality of unbound work items. There are multiple pod types, one for each wq_affn_scope, and every CPU in the system belongs to one pod in every pod type. CPUs that belong to the same pod share the worker pool. For example, selecting ``WQ_AFFN_NUMA`` makes the workqueue use a separate worker pool for each NUMA node. ``ordered`` work items must be executed one by one in queueing orderh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubh:}(hjphhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjlubj)}(hstruct workqueue_attrs { int nice; cpumask_var_t cpumask; cpumask_var_t __pod_cpumask; bool affn_strict; enum wq_affn_scope affn_scope; bool ordered; };h]hstruct workqueue_attrs { int nice; cpumask_var_t cpumask; cpumask_var_t __pod_cpumask; bool affn_strict; enum wq_affn_scope affn_scope; bool ordered; };}hjsbah}(h]h ]h"]h$]h&]jjuh1jh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjlubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjlubjg)}(hhh](jl)}(h``nice`` nice level h](jr)}(h``nice``h]j)}(hjh]hnice}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubj)}(hhh]h)}(h nice levelh]h nice level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubjl)}(h``cpumask`` allowed CPUs Work items in this workqueue are affine to these CPUs and not allowed to execute on other CPUs. A pool serving a workqueue must have the same **cpumask**. h](jr)}(h ``cpumask``h]j)}(hjh]hcpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubj)}(hhh](h)}(h allowed CPUsh]h allowed CPUs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhj ubh)}(hWork items in this workqueue are affine to these CPUs and not allowed to execute on other CPUs. A pool serving a workqueue must have the same **cpumask**.h](hWork items in this workqueue are affine to these CPUs and not allowed to execute on other CPUs. A pool serving a workqueue must have the same }(hjhhhNhNubj)}(h **cpumask**h]hcpumask}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj hKhjubjl)}(hXh``__pod_cpumask`` internal attribute used to create per-pod pools Internal use only. Per-pod unbound worker pools are used to improve locality. Always a subset of ->cpumask. A workqueue can be associated with multiple worker pools with disjoint **__pod_cpumask**'s. Whether the enforcement of a pool's **__pod_cpumask** is strict depends on **affn_strict**. h](jr)}(h``__pod_cpumask``h]j)}(hjQh]h __pod_cpumask}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjKubj)}(hhh](h)}(h/internal attribute used to create per-pod poolsh]h/internal attribute used to create per-pod pools}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjgubh)}(hInternal use only.h]hInternal use only.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjgubh)}(hXPer-pod unbound worker pools are used to improve locality. Always a subset of ->cpumask. A workqueue can be associated with multiple worker pools with disjoint **__pod_cpumask**'s. Whether the enforcement of a pool's **__pod_cpumask** is strict depends on **affn_strict**.h](hPer-pod unbound worker pools are used to improve locality. Always a subset of ->cpumask. A workqueue can be associated with multiple worker pools with disjoint }(hjhhhNhNubj)}(h**__pod_cpumask**h]h __pod_cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh,’s. Whether the enforcement of a pool’s }(hjhhhNhNubj)}(h**__pod_cpumask**h]h __pod_cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is strict depends on }(hjhhhNhNubj)}(h**affn_strict**h]h affn_strict}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjgubeh}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jkhjfhKhjubjl)}(hX``affn_strict`` affinity scope is strict If clear, workqueue will make a best-effort attempt at starting the worker inside **__pod_cpumask** but the scheduler is free to migrate it outside. If set, workers are only allowed to run inside **__pod_cpumask**. h](jr)}(h``affn_strict``h]j)}(hjh]h affn_strict}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubj)}(hhh](h)}(haffinity scope is stricth]haffinity scope is strict}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubh)}(hIf clear, workqueue will make a best-effort attempt at starting the worker inside **__pod_cpumask** but the scheduler is free to migrate it outside.h](hRIf clear, workqueue will make a best-effort attempt at starting the worker inside }(hjhhhNhNubj)}(h**__pod_cpumask**h]h __pod_cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh1 but the scheduler is free to migrate it outside.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubh)}(hAIf set, workers are only allowed to run inside **__pod_cpumask**.h](h/If set, workers are only allowed to run inside }(hj(hhhNhNubj)}(h**__pod_cpumask**h]h __pod_cpumask}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubh.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubjl)}(hX``affn_scope`` unbound CPU affinity scope CPU pods are used to improve execution locality of unbound work items. There are multiple pod types, one for each wq_affn_scope, and every CPU in the system belongs to one pod in every pod type. CPUs that belong to the same pod share the worker pool. For example, selecting ``WQ_AFFN_NUMA`` makes the workqueue use a separate worker pool for each NUMA node. h](jr)}(h``affn_scope``h]j)}(hjZh]h affn_scope}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjTubj)}(hhh](h)}(hunbound CPU affinity scopeh]hunbound CPU affinity scope}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjpubh)}(hXeCPU pods are used to improve execution locality of unbound work items. There are multiple pod types, one for each wq_affn_scope, and every CPU in the system belongs to one pod in every pod type. CPUs that belong to the same pod share the worker pool. For example, selecting ``WQ_AFFN_NUMA`` makes the workqueue use a separate worker pool for each NUMA node.h](hXCPU pods are used to improve execution locality of unbound work items. There are multiple pod types, one for each wq_affn_scope, and every CPU in the system belongs to one pod in every pod type. CPUs that belong to the same pod share the worker pool. For example, selecting }(hjhhhNhNubj)}(h``WQ_AFFN_NUMA``h]h WQ_AFFN_NUMA}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhC makes the workqueue use a separate worker pool for each NUMA node.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjpubeh}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jkhjohKhjubjl)}(hD``ordered`` work items must be executed one by one in queueing orderh](jr)}(h ``ordered``h]j)}(hjh]hordered}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubj)}(hhh]h)}(h8work items must be executed one by one in queueing orderh]h8work items must be executed one by one in queueing order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubeh}(h]h ]h"]h$]h&]uh1jfhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjhhubh)}(h>This can be used to change attributes of an unbound workqueue.h]h>This can be used to change attributes of an unbound workqueue.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwork_pending (C macro)c.work_pendinghNtauh1jhjhhhNhNubj)}(hhh](j)}(h work_pendingh]j)}(h work_pendingh]j)}(h work_pendingh]j)}(hj0h]h work_pending}(hj:hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj6ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj2hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMaubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj.hhhjMhMaubah}(h]j)ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjMhMahj+hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhj+hhhjMhMaubeh}(h]h ](j_macroeh"]h$]h&]jdj_jejfjfjfjgjhjiuh1jhhhjhNhNubh)}(h``work_pending (work)``h]j)}(hjlh]hwork_pending (work)}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMchjhhubj)}(h2Find out whether a work item is currently pending h]h)}(h1Find out whether a work item is currently pendingh]h1Find out whether a work item is currently pending}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMahjubah}(h]h ]h"]h$]h&]uh1jhjhMahjhhubjk)}(h4**Parameters** ``work`` The work item in questionh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMehjubjg)}(hhh]jl)}(h"``work`` The work item in questionh](jr)}(h``work``h]j)}(hjh]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMghjubj)}(hhh]h)}(hThe work item in questionh]hThe work item in question}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMbhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMghjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdelayed_work_pending (C macro)c.delayed_work_pendinghNtauh1jhjhhhNhNubj)}(hhh](j)}(hdelayed_work_pendingh]j)}(hdelayed_work_pendingh]j)}(hdelayed_work_pendingh]j)}(hjh]hdelayed_work_pending}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhj1hMhubah}(h]j ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj1hMhhjhhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhjhhhj1hMhubeh}(h]h ](j_macroeh"]h$]h&]jdj_jejJjfjJjgjhjiuh1jhhhjhNhNubh)}(h``delayed_work_pending (w)``h]j)}(hjPh]hdelayed_work_pending (w)}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMjhjhhubj)}(h limits the number of in-flight work items for each CPU. e.g. }(hjhhhNhNubj)}(h**max_active**h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhW of 1 indicates that each CPU can be executing at most one work item for the workqueue.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hFor unbound workqueues, **max_active** limits the number of in-flight work items for the whole system. e.g. **max_active** of 16 indicates that there can be at most 16 work items executing for the workqueue in the whole system.h](hFor unbound workqueues, }(hjhhhNhNubj)}(h**max_active**h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF limits the number of in-flight work items for the whole system. e.g. }(hjhhhNhNubj)}(h**max_active**h]h max_active}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhi of 16 indicates that there can be at most 16 work items executing for the workqueue in the whole system.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hAs sharing the same active counter for an unbound workqueue across multiple NUMA nodes can be expensive, **max_active** is distributed to each NUMA node according to the proportion of the number of online CPUs and enforced independently.h](hiAs sharing the same active counter for an unbound workqueue across multiple NUMA nodes can be expensive, }(hjIhhhNhNubj)}(h**max_active**h]h max_active}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubhv is distributed to each NUMA node according to the proportion of the number of online CPUs and enforced independently.}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hXDepending on online CPU distribution, a node may end up with per-node max_active which is significantly lower than **max_active**, which can lead to deadlocks if the per-node concurrency limit is lower than the maximum number of interdependent work items for the workqueue.h](hsDepending on online CPU distribution, a node may end up with per-node max_active which is significantly lower than }(hjjhhhNhNubj)}(h**max_active**h]h max_active}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubh, which can lead to deadlocks if the per-node concurrency limit is lower than the maximum number of interdependent work items for the workqueue.}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hX0To guarantee forward progress regardless of online CPU distribution, the concurrency limit on every node is guaranteed to be equal to or greater than min_active which is set to min(**max_active**, ``WQ_DFL_MIN_ACTIVE``). This means that the sum of per-node max_active's may be larger than **max_active**.h](hTo guarantee forward progress regardless of online CPU distribution, the concurrency limit on every node is guaranteed to be equal to or greater than min_active which is set to min(}(hjhhhNhNubj)}(h**max_active**h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h``WQ_DFL_MIN_ACTIVE``h]hWQ_DFL_MIN_ACTIVE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhI). This means that the sum of per-node max_active’s may be larger than }(hjhhhNhNubj)}(h**max_active**h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hbFor detailed information on ``WQ_``\* flags, please refer to Documentation/core-api/workqueue.rst.h](hFor detailed information on }(hjhhhNhNubj)}(h``WQ_``h]hWQ_}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh?* flags, please refer to Documentation/core-api/workqueue.rst.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubh)}(hCPointer to the allocated workqueue on success, ``NULL`` on failure.h](h/Pointer to the allocated workqueue on success, }(hj hhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh on failure.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!devm_alloc_workqueue (C function)c.devm_alloc_workqueuehNtauh1jhjhhhNhNubj)}(hhh](j)}(h}struct workqueue_struct * devm_alloc_workqueue (struct device *dev, const char *fmt, unsigned int flags, int max_active, ...)h]j)}(h{struct workqueue_struct *devm_alloc_workqueue(struct device *dev, const char *fmt, unsigned int flags, int max_active, ...)h](j)}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM ubj)}(h h]h }(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFhhhjWhM ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjihhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjkmodnameN classnameNj7j:)}j=]j@)}j3devm_alloc_workqueuesbc.devm_alloc_workqueueasbuh1hhjFhhhjWhM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFhhhjWhM ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjFhhhjWhM ubj)}(hdevm_alloc_workqueueh]j)}(hjh]hdevm_alloc_workqueue}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjFhhhjWhM ubj|)}(hN(struct device *dev, const char *fmt, unsigned int flags, int max_active, ...)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdeviceh]hdevice}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.devm_alloc_workqueueasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdevh]hdev}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hconst char *fmth](j)}(hjh]hconst}(hj4 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0 ubj)}(h h]h }(hjA hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0 ubj)}(hcharh]hchar}(hjO hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0 ubj)}(h h]h }(hj] hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0 ubjU)}(hjuh]h*}(hjk hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj0 ubj)}(hfmth]hfmt}(hjx hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj0 ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubj)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubj)}(hflagsh]hflags}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint max_activeh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubj)}(h max_activeh]h max_active}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h...h]jU)}(hjph]h...}(hj!hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj!ubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjFhhhjWhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjBhhhjWhM ubah}(h]j=ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjWhM hj?hhubjC)}(hhh]h)}(h%Resource-managed allocate a workqueueh]h%Resource-managed allocate a workqueue}(hj@!hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM hj=!hhubah}(h]h ]h"]h$]h&]uh1jBhj?hhhjWhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejX!jfjX!jgjhjiuh1jhhhjhNhNubjk)}(hX=**Parameters** ``struct device *dev`` Device to allocate workqueue for ``const char *fmt`` printf format for the name of the workqueue ``unsigned int flags`` WQ_* flags ``int max_active`` max in-flight work items, 0 for default ``...`` args for **fmt** **Description** Resource managed workqueue, see alloc_workqueue() for details. The workqueue will be automatically destroyed on driver detach. Typically this should be used in drivers already relying on devm interafaces. **Return** Pointer to the allocated workqueue on success, ``NULL`` on failure.h](h)}(h**Parameters**h]j)}(hjb!h]h Parameters}(hjd!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`!ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubjg)}(hhh](jl)}(h8``struct device *dev`` Device to allocate workqueue for h](jr)}(h``struct device *dev``h]j)}(hj!h]hstruct device *dev}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM hj{!ubj)}(hhh]h)}(h Device to allocate workqueue forh]h Device to allocate workqueue for}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM hj!ubah}(h]h ]h"]h$]h&]uh1jhj{!ubeh}(h]h ]h"]h$]h&]uh1jkhj!hM hjx!ubjl)}(h@``const char *fmt`` printf format for the name of the workqueue h](jr)}(h``const char *fmt``h]j)}(hj!h]hconst char *fmt}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM hj!ubj)}(hhh]h)}(h+printf format for the name of the workqueueh]h+printf format for the name of the workqueue}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM hj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jkhj!hM hjx!ubjl)}(h"``unsigned int flags`` WQ_* flags h](jr)}(h``unsigned int flags``h]j)}(hj!h]hunsigned int flags}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM hj!ubj)}(hhh]h)}(h WQ_* flagsh]h WQ_* flags}(hj "hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hM hj "ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jkhj"hM hjx!ubjl)}(h;``int max_active`` max in-flight work items, 0 for default h](jr)}(h``int max_active``h]j)}(hj,"h]hint max_active}(hj."hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*"ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj&"ubj)}(hhh]h)}(h'max in-flight work items, 0 for defaulth]h'max in-flight work items, 0 for default}(hjE"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjA"hMhjB"ubah}(h]h ]h"]h$]h&]uh1jhj&"ubeh}(h]h ]h"]h$]h&]uh1jkhjA"hMhjx!ubjl)}(h``...`` args for **fmt** h](jr)}(h``...``h]j)}(hje"h]h...}(hjg"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjc"ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj_"ubj)}(hhh]h)}(hargs for **fmt**h](h args for }(hj~"hhhNhNubj)}(h**fmt**h]hfmt}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~"ubeh}(h]h ]h"]h$]h&]uh1hhjz"hMhj{"ubah}(h]h ]h"]h$]h&]uh1jhj_"ubeh}(h]h ]h"]h$]h&]uh1jkhjz"hMhjx!ubeh}(h]h ]h"]h$]h&]uh1jfhj\!ubh)}(h**Description**h]j)}(hj"h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubh)}(h>Resource managed workqueue, see alloc_workqueue() for details.h]h>Resource managed workqueue, see alloc_workqueue() for details.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubh)}(hThe workqueue will be automatically destroyed on driver detach. Typically this should be used in drivers already relying on devm interafaces.h]hThe workqueue will be automatically destroyed on driver detach. Typically this should be used in drivers already relying on devm interafaces.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubh)}(h **Return**h]j)}(hj"h]hReturn}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubh)}(hCPointer to the allocated workqueue on success, ``NULL`` on failure.h](h/Pointer to the allocated workqueue on success, }(hj"hhhNhNubj)}(h``NULL``h]hNULL}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubh on failure.}(hj"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj\!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(alloc_workqueue_lockdep_map (C function)c.alloc_workqueue_lockdep_maphNtauh1jhjhhhNhNubj)}(hhh](j)}(hstruct workqueue_struct * alloc_workqueue_lockdep_map (const char *fmt, unsigned int flags, int max_active, struct lockdep_map *lockdep_map, ...)h]j)}(hstruct workqueue_struct *alloc_workqueue_lockdep_map(const char *fmt, unsigned int flags, int max_active, struct lockdep_map *lockdep_map, ...)h](j)}(hjh]hstruct}(hj;#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7#hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM!ubj)}(h h]h }(hjI#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7#hhhjH#hM!ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjZ#hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjW#ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj\#modnameN classnameNj7j:)}j=]j@)}j3alloc_workqueue_lockdep_mapsbc.alloc_workqueue_lockdep_mapasbuh1hhj7#hhhjH#hM!ubj)}(h h]h }(hj{#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7#hhhjH#hM!ubjU)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj7#hhhjH#hM!ubj)}(halloc_workqueue_lockdep_maph]j)}(hjx#h]halloc_workqueue_lockdep_map}(hj#hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj#ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj7#hhhjH#hM!ubj|)}(h[(const char *fmt, unsigned int flags, int max_active, struct lockdep_map *lockdep_map, ...)h](j)}(hconst char *fmth](j)}(hjh]hconst}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj#ubj)}(hcharh]hchar}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj#ubjU)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj#ubj)}(hfmth]hfmt}(hj#hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj#ubj)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj $hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubj)}(hinth]hint}(hj.$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj<$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubj)}(hflagsh]hflags}(hjJ$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj#ubj)}(hint max_activeh](j)}(hinth]hint}(hjc$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_$ubj)}(h h]h }(hjq$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj_$ubj)}(h max_activeh]h max_active}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj_$ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj#ubj)}(hstruct lockdep_map *lockdep_maph](j)}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(h lockdep_maph]h lockdep_map}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj$modnameN classnameNj7j:)}j=]jv#c.alloc_workqueue_lockdep_mapasbuh1hhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubjU)}(hjuh]h*}(hj$hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj$ubj)}(h lockdep_maph]h lockdep_map}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj#ubj)}(h...h]jU)}(hjph]h...}(hj%hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj%ubah}(h]h ]h"]h$]h&]noemphjjuh1jhj#ubeh}(h]h ]h"]h$]h&]jjuh1j{hj7#hhhjH#hM!ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj3#hhhjH#hM!ubah}(h]j.#ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjH#hM!hj0#hhubjC)}(hhh]h)}(h2allocate a workqueue with user-defined lockdep_maph]h2allocate a workqueue with user-defined lockdep_map}(hj1%hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM!hj.%hhubah}(h]h ]h"]h$]h&]uh1jBhj0#hhhjH#hM!ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejI%jfjI%jgjhjiuh1jhhhjhNhNubjk)}(hX&**Parameters** ``const char *fmt`` printf format for the name of the workqueue ``unsigned int flags`` WQ_* flags ``int max_active`` max in-flight work items, 0 for default ``struct lockdep_map *lockdep_map`` user-defined lockdep_map ``...`` args for **fmt** **Description** Same as alloc_workqueue but with the a user-define lockdep_map. Useful for workqueues created with the same purpose and to avoid leaking a lockdep_map on each workqueue creation. **Return** Pointer to the allocated workqueue on success, ``NULL`` on failure.h](h)}(h**Parameters**h]j)}(hjS%h]h Parameters}(hjU%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ%ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM%hjM%ubjg)}(hhh](jl)}(h@``const char *fmt`` printf format for the name of the workqueue h](jr)}(h``const char *fmt``h]j)}(hjr%h]hconst char *fmt}(hjt%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp%ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM"hjl%ubj)}(hhh]h)}(h+printf format for the name of the workqueueh]h+printf format for the name of the workqueue}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hM"hj%ubah}(h]h ]h"]h$]h&]uh1jhjl%ubeh}(h]h ]h"]h$]h&]uh1jkhj%hM"hji%ubjl)}(h"``unsigned int flags`` WQ_* flags h](jr)}(h``unsigned int flags``h]j)}(hj%h]hunsigned int flags}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM#hj%ubj)}(hhh]h)}(h WQ_* flagsh]h WQ_* flags}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hM#hj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jkhj%hM#hji%ubjl)}(h;``int max_active`` max in-flight work items, 0 for default h](jr)}(h``int max_active``h]j)}(hj%h]hint max_active}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM$hj%ubj)}(hhh]h)}(h'max in-flight work items, 0 for defaulth]h'max in-flight work items, 0 for default}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hM$hj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jkhj%hM$hji%ubjl)}(h=``struct lockdep_map *lockdep_map`` user-defined lockdep_map h](jr)}(h#``struct lockdep_map *lockdep_map``h]j)}(hj&h]hstruct lockdep_map *lockdep_map}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM%hj&ubj)}(hhh]h)}(huser-defined lockdep_maph]huser-defined lockdep_map}(hj6&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2&hM%hj3&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jkhj2&hM%hji%ubjl)}(h``...`` args for **fmt** h](jr)}(h``...``h]j)}(hjV&h]h...}(hjX&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT&ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM&hjP&ubj)}(hhh]h)}(hargs for **fmt**h](h args for }(hjo&hhhNhNubj)}(h**fmt**h]hfmt}(hjw&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo&ubeh}(h]h ]h"]h$]h&]uh1hhjk&hM&hjl&ubah}(h]h ]h"]h$]h&]uh1jhjP&ubeh}(h]h ]h"]h$]h&]uh1jkhjk&hM&hji%ubeh}(h]h ]h"]h$]h&]uh1jfhjM%ubh)}(h**Description**h]j)}(hj&h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM(hjM%ubh)}(hSame as alloc_workqueue but with the a user-define lockdep_map. Useful for workqueues created with the same purpose and to avoid leaking a lockdep_map on each workqueue creation.h]hSame as alloc_workqueue but with the a user-define lockdep_map. Useful for workqueues created with the same purpose and to avoid leaking a lockdep_map on each workqueue creation.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM'hjM%ubh)}(h **Return**h]j)}(hj&h]hReturn}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM+hjM%ubh)}(hCPointer to the allocated workqueue on success, ``NULL`` on failure.h](h/Pointer to the allocated workqueue on success, }(hj&hhhNhNubj)}(h``NULL``h]hNULL}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh on failure.}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM,hjM%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-alloc_ordered_workqueue_lockdep_map (C macro)%c.alloc_ordered_workqueue_lockdep_maphNtauh1jhjhhhNhNubj)}(hhh](j)}(h#alloc_ordered_workqueue_lockdep_maph]j)}(h#alloc_ordered_workqueue_lockdep_maph]j)}(h#alloc_ordered_workqueue_lockdep_maph]j)}(hj'h]h#alloc_ordered_workqueue_lockdep_map}(hj!'hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj'ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj'hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM4ubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj'hhhj4'hM4ubah}(h]j'ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj4'hM4hj'hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhj'hhhj4'hM4ubeh}(h]h ](j_macroeh"]h$]h&]jdj_jejM'jfjM'jgjhjiuh1jhhhjhNhNubh)}(hJ``alloc_ordered_workqueue_lockdep_map (fmt, flags, lockdep_map, args...)``h]j)}(hjS'h]hFalloc_ordered_workqueue_lockdep_map (fmt, flags, lockdep_map, args...)}(hjU'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ'ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM6hjhhubj)}(h,ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubjg)}(hhh](jl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj_,h]hstruct workqueue_struct *wq}(hja,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj],ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjY,ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjx,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt,hMhju,ubah}(h]h ]h"]h$]h&]uh1jhjY,ubeh}(h]h ]h"]h$]h&]uh1jkhjt,hMhjV,ubjl)}(h+``struct work_struct *work`` work to queue h](jr)}(h``struct work_struct *work``h]j)}(hj,h]hstruct work_struct *work}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj,ubj)}(hhh]h)}(h work to queueh]h work to queue}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jkhj,hMhjV,ubeh}(h]h ]h"]h$]h&]uh1jfhj:,ubh)}(h**Description**h]j)}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubh)}(hIReturns ``false`` if **work** was already on a queue, ``true`` otherwise.h](hReturns }(hj,hhhNhNubj)}(h ``false``h]hfalse}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubh if }(hj,hhhNhNubj)}(h**work**h]hwork}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubh was already on a queue, }(hj,hhhNhNubj)}(h``true``h]htrue}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubh otherwise.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubh)}(hoWe queue the work to the CPU on which it was submitted, but if the CPU dies it can be processed by another CPU.h]hoWe queue the work to the CPU on which it was submitted, but if the CPU dies it can be processed by another CPU.}(hj.-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubh)}(hMemory-ordering properties: If it returns ``true``, guarantees that all stores preceding the call to queue_work() in the program order will be visible from the CPU which will execute **work** by the time such work executes, e.g.,h](h+Memory-ordering properties: If it returns }(hj=-hhhNhNubj)}(h``true``h]htrue}(hjE-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=-ubh, guarantees that all stores preceding the call to queue_work() in the program order will be visible from the CPU which will execute }(hj=-hhhNhNubj)}(h**work**h]hwork}(hjW-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=-ubh& by the time such work executes, e.g.,}(hj=-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubh)}(h{ x is initially 0 }h]h{ x is initially 0 }}(hjp-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubj)}(hCPU0 CPU1 WRITE_ONCE(x, 1); [ **work** is being executed ] r0 = queue_work(wq, work); r1 = READ_ONCE(x); h](h)}(h'CPU0 CPU1h]h'CPU0 CPU1}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj-ubh)}(hyWRITE_ONCE(x, 1); [ **work** is being executed ] r0 = queue_work(wq, work); r1 = READ_ONCE(x);h](h%WRITE_ONCE(x, 1); [ }(hj-hhhNhNubj)}(h**work**h]hwork}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubhL is being executed ] r0 = queue_work(wq, work); r1 = READ_ONCE(x);}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhj:,ubh)}(hForbids: r0 == true && r1 == 0h]hForbids: r0 == true && r1 == 0}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj:,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jqueue_delayed_work (C function)c.queue_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hfbool queue_delayed_work (struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h]j)}(hebool queue_delayed_work(struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMubj)}(h h]h }(hj-hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj-hhhj-hMubj)}(hqueue_delayed_workh]j)}(hqueue_delayed_workh]hqueue_delayed_work}(hj.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj.ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj-hhhj-hMubj|)}(hN(struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj$.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj .ubj)}(h h]h }(hj1.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj .ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjB.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?.ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjD.modnameN classnameNj7j:)}j=]j@)}j3j .sbc.queue_delayed_workasbuh1hhj .ubj)}(h h]h }(hjb.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj .ubjU)}(hjuh]h*}(hjp.hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj .ubj)}(hwqh]hwq}(hj}.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj .ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj.ubj)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj.ubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hj.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj.modnameN classnameNj7j:)}j=]j^.c.queue_delayed_workasbuh1hhj.ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj.ubjU)}(hjuh]h*}(hj.hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj.ubj)}(hdworkh]hdwork}(hj.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj.ubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ubj)}(hlongh]hlong}(hj"/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj0/hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ubj)}(hdelayh]hdelay}(hj>/hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj.ubeh}(h]h ]h"]h$]h&]jjuh1j{hj-hhhj-hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj-hhhj-hMubah}(h]j-ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj-hMhj-hhubjC)}(hhh]h)}(h%queue work on a workqueue after delayh]h%queue work on a workqueue after delay}(hjh/hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhje/hhubah}(h]h ]h"]h$]h&]uh1jBhj-hhhj-hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej/jfj/jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` workqueue to use ``struct delayed_work *dwork`` delayable work to queue ``unsigned long delay`` number of jiffies to wait before queueing **Description** Equivalent to queue_delayed_work_on() but tries to use the local CPU.h](h)}(h**Parameters**h]j)}(hj/h]h Parameters}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj/ubjg)}(hhh](jl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj/h]hstruct workqueue_struct *wq}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj/ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMhj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jkhj/hMhj/ubjl)}(h7``struct delayed_work *dwork`` delayable work to queue h](jr)}(h``struct delayed_work *dwork``h]j)}(hj/h]hstruct delayed_work *dwork}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj/ubj)}(hhh]h)}(hdelayable work to queueh]hdelayable work to queue}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMhj/ubah}(h]h ]h"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]uh1jkhj/hMhj/ubjl)}(hB``unsigned long delay`` number of jiffies to wait before queueing h](jr)}(h``unsigned long delay``h]j)}(hj0h]hunsigned long delay}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj0ubj)}(hhh]h)}(h)number of jiffies to wait before queueingh]h)number of jiffies to wait before queueing}(hj40hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj00hMhj10ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jkhj00hMhj/ubeh}(h]h ]h"]h$]h&]uh1jfhj/ubh)}(h**Description**h]j)}(hjV0h]h Description}(hjX0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjT0ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj/ubh)}(hEEquivalent to queue_delayed_work_on() but tries to use the local CPU.h]hEEquivalent to queue_delayed_work_on() but tries to use the local CPU.}(hjl0hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj/ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jmod_delayed_work (C function)c.mod_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hdbool mod_delayed_work (struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h]j)}(hcbool mod_delayed_work(struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMubj)}(h h]h }(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0hhhj0hMubj)}(hmod_delayed_workh]j)}(hmod_delayed_workh]hmod_delayed_work}(hj0hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj0ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj0hhhj0hMubj|)}(hN(struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(h h]h }(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj0hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj0modnameN classnameNj7j:)}j=]j@)}j3j0sbc.mod_delayed_workasbuh1hhj0ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0ubjU)}(hjuh]h*}(hj#1hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj0ubj)}(hwqh]hwq}(hj01hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj0ubj)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjI1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjE1ubj)}(h h]h }(hjV1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjE1ubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjg1hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjd1ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetji1modnameN classnameNj7j:)}j=]j1c.mod_delayed_workasbuh1hhjE1ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjE1ubjU)}(hjuh]h*}(hj1hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjE1ubj)}(hdworkh]hdwork}(hj1hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjE1ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj0ubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1ubj)}(hlongh]hlong}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1ubj)}(hdelayh]hdelay}(hj1hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj0ubeh}(h]h ]h"]h$]h&]jjuh1j{hj0hhhj0hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj0hhhj0hMubah}(h]j0ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj0hMhj0hhubjC)}(hhh]h)}(h'modify delay of or queue a delayed workh]h'modify delay of or queue a delayed work}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj2hhubah}(h]h ]h"]h$]h&]uh1jBhj0hhhj0hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej32jfj32jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct workqueue_struct *wq`` workqueue to use ``struct delayed_work *dwork`` work to queue ``unsigned long delay`` number of jiffies to wait before queueing **Description** mod_delayed_work_on() on local CPU.h](h)}(h**Parameters**h]j)}(hj=2h]h Parameters}(hj?2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;2ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj72ubjg)}(hhh](jl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj\2h]hstruct workqueue_struct *wq}(hj^2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ2ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjV2ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hju2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjq2hMhjr2ubah}(h]h ]h"]h$]h&]uh1jhjV2ubeh}(h]h ]h"]h$]h&]uh1jkhjq2hMhjS2ubjl)}(h-``struct delayed_work *dwork`` work to queue h](jr)}(h``struct delayed_work *dwork``h]j)}(hj2h]hstruct delayed_work *dwork}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj2ubj)}(hhh]h)}(h work to queueh]h work to queue}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hMhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jkhj2hMhjS2ubjl)}(hB``unsigned long delay`` number of jiffies to wait before queueing h](jr)}(h``unsigned long delay``h]j)}(hj2h]hunsigned long delay}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj2ubj)}(hhh]h)}(h)number of jiffies to wait before queueingh]h)number of jiffies to wait before queueing}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hMhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jkhj2hMhjS2ubeh}(h]h ]h"]h$]h&]uh1jfhj72ubh)}(h**Description**h]j)}(hj 3h]h Description}(hj 3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj72ubh)}(h#mod_delayed_work_on() on local CPU.h]h#mod_delayed_work_on() on local CPU.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj72ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jschedule_work_on (C function)c.schedule_work_onhNtauh1jhjhhhNhNubj)}(hhh](j)}(h9bool schedule_work_on (int cpu, struct work_struct *work)h]j)}(h8bool schedule_work_on(int cpu, struct work_struct *work)h](j)}(hj*h]hbool}(hjN3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ3hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMubj)}(h h]h }(hj\3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJ3hhhj[3hMubj)}(hschedule_work_onh]j)}(hschedule_work_onh]hschedule_work_on}(hjn3hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjj3ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjJ3hhhj[3hMubj|)}(h#(int cpu, struct work_struct *work)h](j)}(hint cpuh](j)}(hinth]hint}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3ubj)}(hcpuh]hcpu}(hj3hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj3ubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3ubh)}(hhh]j)}(h work_structh]h work_struct}(hj3hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj3modnameN classnameNj7j:)}j=]j@)}j3jp3sbc.schedule_work_onasbuh1hhj3ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3ubjU)}(hjuh]h*}(hj 4hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj3ubj)}(hworkh]hwork}(hj4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj3ubeh}(h]h ]h"]h$]h&]jjuh1j{hjJ3hhhj[3hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjF3hhhj[3hMubah}(h]jA3ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj[3hMhjC3hhubjC)}(hhh]h)}(hput work task on a specific cpuh]hput work task on a specific cpu}(hjB4hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj?4hhubah}(h]h ]h"]h$]h&]uh1jBhjC3hhhj[3hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejZ4jfjZ4jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``int cpu`` cpu to put the work task on ``struct work_struct *work`` job to be done **Description** This puts a job on a specific cpuh](h)}(h**Parameters**h]j)}(hjd4h]h Parameters}(hjf4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjb4ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj^4ubjg)}(hhh](jl)}(h(``int cpu`` cpu to put the work task on h](jr)}(h ``int cpu``h]j)}(hj4h]hint cpu}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj}4ubj)}(hhh]h)}(hcpu to put the work task onh]hcpu to put the work task on}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj}4ubeh}(h]h ]h"]h$]h&]uh1jkhj4hMhjz4ubjl)}(h,``struct work_struct *work`` job to be done h](jr)}(h``struct work_struct *work``h]j)}(hj4h]hstruct work_struct *work}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj4ubj)}(hhh]h)}(hjob to be doneh]hjob to be done}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jkhj4hMhjz4ubeh}(h]h ]h"]h$]h&]uh1jfhj^4ubh)}(h**Description**h]j)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj^4ubh)}(h!This puts a job on a specific cpuh]h!This puts a job on a specific cpu}(hj 5hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj^4ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jschedule_work (C function)c.schedule_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h-bool schedule_work (struct work_struct *work)h]j)}(h,bool schedule_work(struct work_struct *work)h](j)}(hj*h]hbool}(hj<5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj85hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMubj)}(h h]h }(hjJ5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj85hhhjI5hMubj)}(h schedule_workh]j)}(h schedule_workh]h schedule_work}(hj\5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjX5ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj85hhhjI5hMubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjx5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjt5ubh)}(hhh]j)}(h work_structh]h work_struct}(hj5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj5modnameN classnameNj7j:)}j=]j@)}j3j^5sbc.schedule_workasbuh1hhjt5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjt5ubjU)}(hjuh]h*}(hj5hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjt5ubj)}(hworkh]hwork}(hj5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjt5ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjp5ubah}(h]h ]h"]h$]h&]jjuh1j{hj85hhhjI5hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj45hhhjI5hMubah}(h]j/5ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjI5hMhj15hhubjC)}(hhh]h)}(h"put work task in per-CPU workqueueh]h"put work task in per-CPU workqueue}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj5hhubah}(h]h ]h"]h$]h&]uh1jBhj15hhhjI5hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej6jfj6jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` job to be done **Description** Returns ``false`` if **work** was already on the system per-CPU workqueue and ``true`` otherwise. This puts a job in the system per-CPU workqueue if it was not already queued and leaves it in the same position on the system per-CPU workqueue otherwise. Shares the same memory-ordering properties of queue_work(), cf. the DocBook header of queue_work().h](h)}(h**Parameters**h]j)}(hj6h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj6ubjg)}(hhh]jl)}(h,``struct work_struct *work`` job to be done h](jr)}(h``struct work_struct *work``h]j)}(hj<6h]hstruct work_struct *work}(hj>6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:6ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj66ubj)}(hhh]h)}(hjob to be doneh]hjob to be done}(hjU6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQ6hMhjR6ubah}(h]h ]h"]h$]h&]uh1jhj66ubeh}(h]h ]h"]h$]h&]uh1jkhjQ6hMhj36ubah}(h]h ]h"]h$]h&]uh1jfhj6ubh)}(h**Description**h]j)}(hjw6h]h Description}(hjy6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhju6ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj6ubh)}(haReturns ``false`` if **work** was already on the system per-CPU workqueue and ``true`` otherwise.h](hReturns }(hj6hhhNhNubj)}(h ``false``h]hfalse}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh if }(hj6hhhNhNubj)}(h**work**h]hwork}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh1 was already on the system per-CPU workqueue and }(hj6hhhNhNubj)}(h``true``h]htrue}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh otherwise.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj6ubh)}(hThis puts a job in the system per-CPU workqueue if it was not already queued and leaves it in the same position on the system per-CPU workqueue otherwise.h]hThis puts a job in the system per-CPU workqueue if it was not already queued and leaves it in the same position on the system per-CPU workqueue otherwise.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj6ubh)}(hcShares the same memory-ordering properties of queue_work(), cf. the DocBook header of queue_work().h]hcShares the same memory-ordering properties of queue_work(), cf. the DocBook header of queue_work().}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"enable_and_queue_work (C function)c.enable_and_queue_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hRbool enable_and_queue_work (struct workqueue_struct *wq, struct work_struct *work)h]j)}(hQbool enable_and_queue_work(struct workqueue_struct *wq, struct work_struct *work)h](j)}(hj*h]hbool}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 7hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj 7hhhj7hMubj)}(henable_and_queue_workh]j)}(henable_and_queue_workh]henable_and_queue_work}(hj07hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj,7ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj 7hhhj7hMubj|)}(h7(struct workqueue_struct *wq, struct work_struct *work)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjL7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH7ubj)}(h h]h }(hjY7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjH7ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjg7ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjl7modnameN classnameNj7j:)}j=]j@)}j3j27sbc.enable_and_queue_workasbuh1hhjH7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjH7ubjU)}(hjuh]h*}(hj7hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjH7ubj)}(hwqh]hwq}(hj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjH7ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjD7ubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7ubh)}(hhh]j)}(h work_structh]h work_struct}(hj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj7modnameN classnameNj7j:)}j=]j7c.enable_and_queue_workasbuh1hhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7ubjU)}(hjuh]h*}(hj8hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj7ubj)}(hworkh]hwork}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjD7ubeh}(h]h ]h"]h$]h&]jjuh1j{hj 7hhhj7hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj7hhhj7hMubah}(h]j7ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj7hMhj7hhubjC)}(hhh]h)}(h4Enable and queue a work item on a specific workqueueh]h4Enable and queue a work item on a specific workqueue}(hj?8hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj<8hhubah}(h]h ]h"]h$]h&]uh1jBhj7hhhj7hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejW8jfjW8jgjhjiuh1jhhhjhNhNubjk)}(hX **Parameters** ``struct workqueue_struct *wq`` The target workqueue ``struct work_struct *work`` The work item to be enabled and queued **Description** This function combines the operations of enable_work() and queue_work(), providing a convenient way to enable and queue a work item in a single call. It invokes enable_work() on **work** and then queues it if the disable depth reached 0. Returns ``true`` if the disable depth reached 0 and **work** is queued, and ``false`` otherwise. Note that **work** is always queued when disable depth reaches zero. If the desired behavior is queueing only if certain events took place while **work** is disabled, the user should implement the necessary state tracking and perform explicit conditional queueing after enable_work().h](h)}(h**Parameters**h]j)}(hja8h]h Parameters}(hjc8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_8ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj[8ubjg)}(hhh](jl)}(h5``struct workqueue_struct *wq`` The target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj8h]hstruct workqueue_struct *wq}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~8ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhjz8ubj)}(hhh]h)}(hThe target workqueueh]hThe target workqueue}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj8ubah}(h]h ]h"]h$]h&]uh1jhjz8ubeh}(h]h ]h"]h$]h&]uh1jkhj8hMhjw8ubjl)}(hD``struct work_struct *work`` The work item to be enabled and queued h](jr)}(h``struct work_struct *work``h]j)}(hj8h]hstruct work_struct *work}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj8ubj)}(hhh]h)}(h&The work item to be enabled and queuedh]h&The work item to be enabled and queued}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jkhj8hMhjw8ubeh}(h]h ]h"]h$]h&]uh1jfhj[8ubh)}(h**Description**h]j)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj[8ubh)}(hXNThis function combines the operations of enable_work() and queue_work(), providing a convenient way to enable and queue a work item in a single call. It invokes enable_work() on **work** and then queues it if the disable depth reached 0. Returns ``true`` if the disable depth reached 0 and **work** is queued, and ``false`` otherwise.h](hThis function combines the operations of enable_work() and queue_work(), providing a convenient way to enable and queue a work item in a single call. It invokes enable_work() on }(hj 9hhhNhNubj)}(h**work**h]hwork}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 9ubh< and then queues it if the disable depth reached 0. Returns }(hj 9hhhNhNubj)}(h``true``h]htrue}(hj$9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 9ubh$ if the disable depth reached 0 and }(hj 9hhhNhNubj)}(h**work**h]hwork}(hj69hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 9ubh is queued, and }(hj 9hhhNhNubj)}(h ``false``h]hfalse}(hjH9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj 9ubh otherwise.}(hj 9hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj[8ubh)}(hXNote that **work** is always queued when disable depth reaches zero. If the desired behavior is queueing only if certain events took place while **work** is disabled, the user should implement the necessary state tracking and perform explicit conditional queueing after enable_work().h](h Note that }(hja9hhhNhNubj)}(h**work**h]hwork}(hji9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja9ubh is always queued when disable depth reaches zero. If the desired behavior is queueing only if certain events took place while }(hja9hhhNhNubj)}(h**work**h]hwork}(hj{9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja9ubh is disabled, the user should implement the necessary state tracking and perform explicit conditional queueing after enable_work().}(hja9hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMhj[8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%schedule_delayed_work_on (C function)c.schedule_delayed_work_onhNtauh1jhjhhhNhNubj)}(hhh](j)}(hXbool schedule_delayed_work_on (int cpu, struct delayed_work *dwork, unsigned long delay)h]j)}(hWbool schedule_delayed_work_on(int cpu, struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM@ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj9hhhj9hM@ubj)}(hschedule_delayed_work_onh]j)}(hschedule_delayed_work_onh]hschedule_delayed_work_on}(hj9hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj9hhhj9hM@ubj|)}(h:(int cpu, struct delayed_work *dwork, unsigned long delay)h](j)}(hint cpuh](j)}(hinth]hint}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj9ubj)}(hcpuh]hcpu}(hj :hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj9ubj)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hj%:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!:ubj)}(h h]h }(hj2:hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj!:ubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjC:hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj@:ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjE:modnameN classnameNj7j:)}j=]j@)}j3j9sbc.schedule_delayed_work_onasbuh1hhj!:ubj)}(h h]h }(hjc:hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj!:ubjU)}(hjuh]h*}(hjq:hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj!:ubj)}(hdworkh]hdwork}(hj~:hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj!:ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj9ubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj:ubj)}(hlongh]hlong}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubj)}(h h]h }(hj:hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj:ubj)}(hdelayh]hdelay}(hj:hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj9ubeh}(h]h ]h"]h$]h&]jjuh1j{hj9hhhj9hM@ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj9hhhj9hM@ubah}(h]j9ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj9hM@hj9hhubjC)}(hhh]h)}(h2queue work in per-CPU workqueue on CPU after delayh]h2queue work in per-CPU workqueue on CPU after delay}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhM@hj:hhubah}(h]h ]h"]h$]h&]uh1jBhj9hhhj9hM@ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej;jfj;jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` cpu to use ``struct delayed_work *dwork`` job to be done ``unsigned long delay`` number of jiffies to wait **Description** After waiting for a given time this puts a job in the system per-CPU workqueue on the specified CPU.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMDhj;ubjg)}(hhh](jl)}(h``int cpu`` cpu to use h](jr)}(h ``int cpu``h]j)}(hj:;h]hint cpu}(hj<;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8;ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMAhj4;ubj)}(hhh]h)}(h cpu to useh]h cpu to use}(hjS;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO;hMAhjP;ubah}(h]h ]h"]h$]h&]uh1jhj4;ubeh}(h]h ]h"]h$]h&]uh1jkhjO;hMAhj1;ubjl)}(h.``struct delayed_work *dwork`` job to be done h](jr)}(h``struct delayed_work *dwork``h]j)}(hjs;h]hstruct delayed_work *dwork}(hju;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjq;ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMBhjm;ubj)}(hhh]h)}(hjob to be doneh]hjob to be done}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hMBhj;ubah}(h]h ]h"]h$]h&]uh1jhjm;ubeh}(h]h ]h"]h$]h&]uh1jkhj;hMBhj1;ubjl)}(h2``unsigned long delay`` number of jiffies to wait h](jr)}(h``unsigned long delay``h]j)}(hj;h]hunsigned long delay}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMChj;ubj)}(hhh]h)}(hnumber of jiffies to waith]hnumber of jiffies to wait}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hMChj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jkhj;hMChj1;ubeh}(h]h ]h"]h$]h&]uh1jfhj;ubh)}(h**Description**h]j)}(hj;h]h Description}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMEhj;ubh)}(hdAfter waiting for a given time this puts a job in the system per-CPU workqueue on the specified CPU.h]hdAfter waiting for a given time this puts a job in the system per-CPU workqueue on the specified CPU.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMDhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"schedule_delayed_work (C function)c.schedule_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hLbool schedule_delayed_work (struct delayed_work *dwork, unsigned long delay)h]j)}(hKbool schedule_delayed_work(struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hj,<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(<hhh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMOubj)}(h h]h }(hj:<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj(<hhhj9<hMOubj)}(hschedule_delayed_workh]j)}(hschedule_delayed_workh]hschedule_delayed_work}(hjL<hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjH<ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj(<hhhj9<hMOubj|)}(h1(struct delayed_work *dwork, unsigned long delay)h](j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjh<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd<ubj)}(h h]h }(hju<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjd<ubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hj<hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj<modnameN classnameNj7j:)}j=]j@)}j3jN<sbc.schedule_delayed_workasbuh1hhjd<ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjd<ubjU)}(hjuh]h*}(hj<hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjd<ubj)}(hdworkh]hdwork}(hj<hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjd<ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj`<ubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj<ubj)}(hlongh]hlong}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj<ubj)}(hdelayh]hdelay}(hj=hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj`<ubeh}(h]h ]h"]h$]h&]jjuh1j{hj(<hhhj9<hMOubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj$<hhhj9<hMOubah}(h]j<ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj9<hMOhj!<hhubjC)}(hhh]h)}(h.put work task in per-CPU workqueue after delayh]h.put work task in per-CPU workqueue after delay}(hj<=hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMOhj9=hhubah}(h]h ]h"]h$]h&]uh1jBhj!<hhhj9<hMOubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejT=jfjT=jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct delayed_work *dwork`` job to be done ``unsigned long delay`` number of jiffies to wait or 0 for immediate execution **Description** After waiting for a given time this puts a job in the system per-CPU workqueue.h](h)}(h**Parameters**h]j)}(hj^=h]h Parameters}(hj`=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\=ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMShjX=ubjg)}(hhh](jl)}(h.``struct delayed_work *dwork`` job to be done h](jr)}(h``struct delayed_work *dwork``h]j)}(hj}=h]hstruct delayed_work *dwork}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{=ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMPhjw=ubj)}(hhh]h)}(hjob to be doneh]hjob to be done}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMPhj=ubah}(h]h ]h"]h$]h&]uh1jhjw=ubeh}(h]h ]h"]h$]h&]uh1jkhj=hMPhjt=ubjl)}(hO``unsigned long delay`` number of jiffies to wait or 0 for immediate execution h](jr)}(h``unsigned long delay``h]j)}(hj=h]hunsigned long delay}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jqh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMQhj=ubj)}(hhh]h)}(h6number of jiffies to wait or 0 for immediate executionh]h6number of jiffies to wait or 0 for immediate execution}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMQhj=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jkhj=hMQhjt=ubeh}(h]h ]h"]h$]h&]uh1jfhjX=ubh)}(h**Description**h]j)}(hj=h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMShjX=ubh)}(hOAfter waiting for a given time this puts a job in the system per-CPU workqueue.h]hOAfter waiting for a given time this puts a job in the system per-CPU workqueue.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:793: ./include/linux/workqueue.hhMRhjX=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jfor_each_pool (C macro)c.for_each_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h for_each_poolh]j)}(h for_each_poolh]j)}(h for_each_poolh]j)}(hj0>h]h for_each_pool}(hj:>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj6>ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj2>hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM?ubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj.>hhhjM>hM?ubah}(h]j)>ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjM>hM?hj+>hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhj+>hhhjM>hM?ubeh}(h]h ](j_macroeh"]h$]h&]jdj_jejf>jfjf>jgjhjiuh1jhhhjhNhNubh)}(h``for_each_pool (pool, pi)``h]j)}(hjl>h]hfor_each_pool (pool, pi)}(hjn>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjj>ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhjhhubj)}(h/iterate through all worker_pools in the system h]h)}(h.iterate through all worker_pools in the systemh]h.iterate through all worker_pools in the system}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM?hj>ubah}(h]h ]h"]h$]h&]uh1jhj>hM?hjhhubjk)}(hXz**Parameters** ``pool`` iteration cursor ``pi`` integer used for iteration **Description** This must be called either with wq_pool_mutex held or RCU read locked. If the pool needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pool stays online. The if/else clause exists only for the lockdep assertion and can be ignored.h](h)}(h**Parameters**h]j)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMChj>ubjg)}(hhh](jl)}(h``pool`` iteration cursor h](jr)}(h``pool``h]j)}(hj>h]hpool}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM@hj>ubj)}(hhh]h)}(hiteration cursorh]hiteration cursor}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hM@hj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jkhj>hM@hj>ubjl)}(h"``pi`` integer used for iteration h](jr)}(h``pi``h]j)}(hj>h]hpi}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhj>ubj)}(hhh]h)}(hinteger used for iterationh]hinteger used for iteration}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hMAhj?ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jkhj?hMAhj>ubeh}(h]h ]h"]h$]h&]uh1jfhj>ubh)}(h**Description**h]j)}(hj4?h]h Description}(hj6?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2?ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMChj>ubh)}(hThis must be called either with wq_pool_mutex held or RCU read locked. If the pool needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pool stays online.h]hThis must be called either with wq_pool_mutex held or RCU read locked. If the pool needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pool stays online.}(hjJ?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMBhj>ubh)}(hLThe if/else clause exists only for the lockdep assertion and can be ignored.h]hLThe if/else clause exists only for the lockdep assertion and can be ignored.}(hjY?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMFhj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jfor_each_pool_worker (C macro)c.for_each_pool_workerhNtauh1jhjhhhNhNubj)}(hhh](j)}(hfor_each_pool_workerh]j)}(hfor_each_pool_workerh]j)}(hfor_each_pool_workerh]j)}(hj?h]hfor_each_pool_worker}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj?hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMPubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj?hhhj?hMPubah}(h]j{?ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj?hMPhj}?hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhj}?hhhj?hMPubeh}(h]h ](j_macroeh"]h$]h&]jdj_jej?jfj?jgjhjiuh1jhhhjhNhNubh)}(h'``for_each_pool_worker (worker, pool)``h]j)}(hj?h]h#for_each_pool_worker (worker, pool)}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMRhjhhubj)}(h-iterate through all workers of a worker_pool h]h)}(h,iterate through all workers of a worker_poolh]h,iterate through all workers of a worker_pool}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMPhj?ubah}(h]h ]h"]h$]h&]uh1jhj?hMPhjhhubjk)}(h**Parameters** ``worker`` iteration cursor ``pool`` worker_pool to iterate workers of **Description** This must be called with wq_pool_attach_mutex. The if/else clause exists only for the lockdep assertion and can be ignored.h](h)}(h**Parameters**h]j)}(hj?h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMThj?ubjg)}(hhh](jl)}(h``worker`` iteration cursor h](jr)}(h ``worker``h]j)}(hj@h]hworker}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQhj @ubj)}(hhh]h)}(hiteration cursorh]hiteration cursor}(hj+@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'@hMQhj(@ubah}(h]h ]h"]h$]h&]uh1jhj @ubeh}(h]h ]h"]h$]h&]uh1jkhj'@hMQhj @ubjl)}(h+``pool`` worker_pool to iterate workers of h](jr)}(h``pool``h]j)}(hjK@h]hpool}(hjM@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI@ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMRhjE@ubj)}(hhh]h)}(h!worker_pool to iterate workers ofh]h!worker_pool to iterate workers of}(hjd@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`@hMRhja@ubah}(h]h ]h"]h$]h&]uh1jhjE@ubeh}(h]h ]h"]h$]h&]uh1jkhj`@hMRhj @ubeh}(h]h ]h"]h$]h&]uh1jfhj?ubh)}(h**Description**h]j)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMThj?ubh)}(h.This must be called with wq_pool_attach_mutex.h]h.This must be called with wq_pool_attach_mutex.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMShj?ubh)}(hLThe if/else clause exists only for the lockdep assertion and can be ignored.h]hLThe if/else clause exists only for the lockdep assertion and can be ignored.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMUhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jfor_each_pwq (C macro)c.for_each_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(h for_each_pwqh]j)}(h for_each_pwqh]j)}(h for_each_pwqh]j)}(hj@h]h for_each_pwq}(hj@hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj@ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj@hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM_ubah}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj@hhhj@hM_ubah}(h]j@ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj@hM_hj@hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhj@hhhj@hM_ubeh}(h]h ](j_macroeh"]h$]h&]jdj_jej Ajfj Ajgjhjiuh1jhhhjhNhNubh)}(h``for_each_pwq (pwq, wq)``h]j)}(hjAh]hfor_each_pwq (pwq, wq)}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMahjhhubj)}(h?iterate through all pool_workqueues of the specified workqueue h]h)}(h>iterate through all pool_workqueues of the specified workqueueh]h>iterate through all pool_workqueues of the specified workqueue}(hj*AhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM_hj&Aubah}(h]h ]h"]h$]h&]uh1jhj8AhM_hjhhubjk)}(hXl**Parameters** ``pwq`` iteration cursor ``wq`` the target workqueue **Description** This must be called either with wq->mutex held or RCU read locked. If the pwq needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pwq stays online. The if/else clause exists only for the lockdep assertion and can be ignored.h](h)}(h**Parameters**h]j)}(hjEAh]h Parameters}(hjGAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCAubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMchj?Aubjg)}(hhh](jl)}(h``pwq`` iteration cursor h](jr)}(h``pwq``h]j)}(hjdAh]hpwq}(hjfAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbAubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM`hj^Aubj)}(hhh]h)}(hiteration cursorh]hiteration cursor}(hj}AhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyAhM`hjzAubah}(h]h ]h"]h$]h&]uh1jhj^Aubeh}(h]h ]h"]h$]h&]uh1jkhjyAhM`hj[Aubjl)}(h``wq`` the target workqueue h](jr)}(h``wq``h]j)}(hjAh]hwq}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMahjAubj)}(hhh]h)}(hthe target workqueueh]hthe target workqueue}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhMahjAubah}(h]h ]h"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]uh1jkhjAhMahj[Aubeh}(h]h ]h"]h$]h&]uh1jfhj?Aubh)}(h**Description**h]j)}(hjAh]h Description}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMchj?Aubh)}(hThis must be called either with wq->mutex held or RCU read locked. If the pwq needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pwq stays online.h]hThis must be called either with wq->mutex held or RCU read locked. If the pwq needs to be used beyond the locking in effect, the caller is responsible for guaranteeing that the pwq stays online.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMbhj?Aubh)}(hLThe if/else clause exists only for the lockdep assertion and can be ignored.h]hLThe if/else clause exists only for the lockdep assertion and can be ignored.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMfhj?Aubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"worker_pool_assign_id (C function)c.worker_pool_assign_idhNtauh1jhjhhhNhNubj)}(hhh](j)}(h4int worker_pool_assign_id (struct worker_pool *pool)h]j)}(h3int worker_pool_assign_id(struct worker_pool *pool)h](j)}(hinth]hint}(hj,BhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(BhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj;BhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj(Bhhhj:BhMubj)}(hworker_pool_assign_idh]j)}(hworker_pool_assign_idh]hworker_pool_assign_id}(hjMBhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjIBubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj(Bhhhj:BhMubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjiBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeBubj)}(h h]h }(hjvBhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeBubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjBhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjBmodnameN classnameNj7j:)}j=]j@)}j3jOBsbc.worker_pool_assign_idasbuh1hhjeBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeBubjU)}(hjuh]h*}(hjBhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjeBubj)}(hpoolh]hpool}(hjBhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjeBubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjaBubah}(h]h ]h"]h$]h&]jjuh1j{hj(Bhhhj:BhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj$Bhhhj:BhMubah}(h]jBah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj:BhMhj!BhhubjC)}(hhh]h)}(h%allocate ID and assign it to **pool**h](hallocate ID and assign it to }(hjBhhhNhNubj)}(h**pool**h]hpool}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjBhhubah}(h]h ]h"]h$]h&]uh1jBhj!Bhhhj:BhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejCjfjCjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker_pool *pool`` the pool pointer of interest **Description** Returns 0 if ID in [0, WORK_OFFQ_POOL_NONE) is allocated and assigned successfully, -errno on failure.h](h)}(h**Parameters**h]j)}(hjCh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCubjg)}(hhh]jl)}(h:``struct worker_pool *pool`` the pool pointer of interest h](jr)}(h``struct worker_pool *pool``h]j)}(hj;Ch]hstruct worker_pool *pool}(hj=ChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9Cubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj5Cubj)}(hhh]h)}(hthe pool pointer of interesth]hthe pool pointer of interest}(hjTChhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPChMhjQCubah}(h]h ]h"]h$]h&]uh1jhj5Cubeh}(h]h ]h"]h$]h&]uh1jkhjPChMhj2Cubah}(h]h ]h"]h$]h&]uh1jfhjCubh)}(h**Description**h]j)}(hjvCh]h Description}(hjxChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtCubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCubh)}(hfReturns 0 if ID in [0, WORK_OFFQ_POOL_NONE) is allocated and assigned successfully, -errno on failure.h]hfReturns 0 if ID in [0, WORK_OFFQ_POOL_NONE) is allocated and assigned successfully, -errno on failure.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&unbound_effective_cpumask (C function)c.unbound_effective_cpumaskhNtauh1jhjhhhNhNubj)}(hhh](j)}(hHstruct cpumask * unbound_effective_cpumask (struct workqueue_struct *wq)h]j)}(hFstruct cpumask *unbound_effective_cpumask(struct workqueue_struct *wq)h](j)}(hjh]hstruct}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjChhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjChhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjChhhjChMubh)}(hhh]j)}(hcpumaskh]hcpumask}(hjChhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjCmodnameN classnameNj7j:)}j=]j@)}j3unbound_effective_cpumasksbc.unbound_effective_cpumaskasbuh1hhjChhhjChMubj)}(h h]h }(hjChhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjChhhjChMubjU)}(hjuh]h*}(hj DhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjChhhjChMubj)}(hunbound_effective_cpumaskh]j)}(hjCh]hunbound_effective_cpumask}(hjDhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjDubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjChhhjChMubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj5DhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1Dubj)}(h h]h }(hjBDhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1Dubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjSDhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjPDubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjUDmodnameN classnameNj7j:)}j=]jCc.unbound_effective_cpumaskasbuh1hhj1Dubj)}(h h]h }(hjqDhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1DubjU)}(hjuh]h*}(hjDhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj1Dubj)}(hwqh]hwq}(hjDhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj1Dubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj-Dubah}(h]h ]h"]h$]h&]jjuh1j{hjChhhjChMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjChhhjChMubah}(h]jCah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjChMhjChhubjC)}(hhh]h)}(h)effective cpumask of an unbound workqueueh]h)effective cpumask of an unbound workqueue}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDhhubah}(h]h ]h"]h$]h&]uh1jBhjChhhjChMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejDjfjDjgjhjiuh1jhhhjhNhNubjk)}(hX8**Parameters** ``struct workqueue_struct *wq`` workqueue of interest **Description** **wq->attrs->cpumask** contains the cpumask requested by the user which is masked with wq_unbound_cpumask to determine the effective cpumask. The default pwq is always mapped to the pool with the current effective cpumask.h](h)}(h**Parameters**h]j)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDubjg)}(hhh]jl)}(h6``struct workqueue_struct *wq`` workqueue of interest h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjDh]hstruct workqueue_struct *wq}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDubj)}(hhh]h)}(hworkqueue of interesth]hworkqueue of interest}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj EhMhj Eubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jkhj EhMhjDubah}(h]h ]h"]h$]h&]uh1jfhjDubh)}(h**Description**h]j)}(hj2Eh]h Description}(hj4EhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0Eubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDubh)}(h**wq->attrs->cpumask** contains the cpumask requested by the user which is masked with wq_unbound_cpumask to determine the effective cpumask. The default pwq is always mapped to the pool with the current effective cpumask.h](j)}(h**wq->attrs->cpumask**h]hwq->attrs->cpumask}(hjLEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHEubh contains the cpumask requested by the user which is masked with wq_unbound_cpumask to determine the effective cpumask. The default pwq is always mapped to the pool with the current effective cpumask.}(hjHEhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jget_work_pool (C function)c.get_work_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h=struct worker_pool * get_work_pool (struct work_struct *work)h]j)}(h;struct worker_pool *get_work_pool(struct work_struct *work)h](j)}(hjh]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMuubj)}(h h]h }(hjEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjEhhhjEhMuubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjEhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjEmodnameN classnameNj7j:)}j=]j@)}j3 get_work_poolsbc.get_work_poolasbuh1hhjEhhhjEhMuubj)}(h h]h }(hjEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjEhhhjEhMuubjU)}(hjuh]h*}(hjEhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjEhhhjEhMuubj)}(h get_work_poolh]j)}(hjEh]h get_work_pool}(hjEhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjEubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjEhhhjEhMuubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(h h]h }(hj FhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjEubh)}(hhh]j)}(h work_structh]h work_struct}(hjFhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjFmodnameN classnameNj7j:)}j=]jEc.get_work_poolasbuh1hhjEubj)}(h h]h }(hj;FhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjEubjU)}(hjuh]h*}(hjIFhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjEubj)}(hworkh]hwork}(hjVFhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjEubah}(h]h ]h"]h$]h&]jjuh1j{hjEhhhjEhMuubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj}EhhhjEhMuubah}(h]jxEah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjEhMuhjzEhhubjC)}(hhh]h)}(h7return the worker_pool a given work was associated withh]h7return the worker_pool a given work was associated with}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMuhj}Fhhubah}(h]h ]h"]h$]h&]uh1jBhjzEhhhjEhMuubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejFjfjFjgjhjiuh1jhhhjhNhNubjk)}(hXi**Parameters** ``struct work_struct *work`` the work item of interest **Description** Pools are created and destroyed under wq_pool_mutex, and allows read access under RCU read lock. As such, this function should be called under wq_pool_mutex or inside of a rcu_read_lock() region. All fields of the returned pool are accessible as long as the above mentioned locking is in effect. If the returned pool needs to be used beyond the critical section, the caller is responsible for ensuring the returned pool is and stays online. **Return** The worker_pool **work** was last associated with. ``NULL`` if none.h](h)}(h**Parameters**h]j)}(hjFh]h Parameters}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMyhjFubjg)}(hhh]jl)}(h7``struct work_struct *work`` the work item of interest h](jr)}(h``struct work_struct *work``h]j)}(hjFh]hstruct work_struct *work}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMvhjFubj)}(hhh]h)}(hthe work item of interesth]hthe work item of interest}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhMvhjFubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jkhjFhMvhjFubah}(h]h ]h"]h$]h&]uh1jfhjFubh)}(h**Description**h]j)}(hjFh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMxhjFubh)}(hPools are created and destroyed under wq_pool_mutex, and allows read access under RCU read lock. As such, this function should be called under wq_pool_mutex or inside of a rcu_read_lock() region.h]hPools are created and destroyed under wq_pool_mutex, and allows read access under RCU read lock. As such, this function should be called under wq_pool_mutex or inside of a rcu_read_lock() region.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMwhjFubh)}(hAll fields of the returned pool are accessible as long as the above mentioned locking is in effect. If the returned pool needs to be used beyond the critical section, the caller is responsible for ensuring the returned pool is and stays online.h]hAll fields of the returned pool are accessible as long as the above mentioned locking is in effect. If the returned pool needs to be used beyond the critical section, the caller is responsible for ensuring the returned pool is and stays online.}(hj!GhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM{hjFubh)}(h **Return**h]j)}(hj2Gh]hReturn}(hj4GhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0Gubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjFubh)}(hEThe worker_pool **work** was last associated with. ``NULL`` if none.h](hThe worker_pool }(hjHGhhhNhNubj)}(h**work**h]hwork}(hjPGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHGubh was last associated with. }(hjHGhhhNhNubj)}(h``NULL``h]hNULL}(hjbGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHGubh if none.}(hjHGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjFubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jworker_set_flags (C function)c.worker_set_flagshNtauh1jhjhhhNhNubj)}(hhh](j)}(hAvoid worker_set_flags (struct worker *worker, unsigned int flags)h]j)}(h@void worker_set_flags(struct worker *worker, unsigned int flags)h](j)}(hvoidh]hvoid}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjGhhhjGhMubj)}(hworker_set_flagsh]j)}(hworker_set_flagsh]hworker_set_flags}(hjGhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjGubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjGhhhjGhMubj|)}(h+(struct worker *worker, unsigned int flags)h](j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(h h]h }(hjGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjGubh)}(hhh]j)}(hworkerh]hworker}(hjGhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjGmodnameN classnameNj7j:)}j=]j@)}j3jGsbc.worker_set_flagsasbuh1hhjGubj)}(h h]h }(hjHhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjGubjU)}(hjuh]h*}(hj$HhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjGubj)}(hworkerh]hworker}(hj1HhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjGubj)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjJHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFHubj)}(h h]h }(hjXHhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFHubj)}(hinth]hint}(hjfHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFHubj)}(h h]h }(hjtHhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFHubj)}(hflagsh]hflags}(hjHhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjFHubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjGubeh}(h]h ]h"]h$]h&]jjuh1j{hjGhhhjGhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjGhhhjGhMubah}(h]jGah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjGhMhjGhhubjC)}(hhh]h)}(h2set worker flags and adjust nr_running accordinglyh]h2set worker flags and adjust nr_running accordingly}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHhhubah}(h]h ]h"]h$]h&]uh1jBhjGhhhjGhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejHjfjHjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker *worker`` self ``unsigned int flags`` flags to set **Description** Set **flags** in **worker->flags** and adjust nr_running accordingly.h](h)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHubjg)}(hhh](jl)}(h``struct worker *worker`` self h](jr)}(h``struct worker *worker``h]j)}(hjHh]hstruct worker *worker}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHubj)}(hhh]h)}(hselfh]hself}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jkhjIhMhjHubjl)}(h$``unsigned int flags`` flags to set h](jr)}(h``unsigned int flags``h]j)}(hj&Ih]hunsigned int flags}(hj(IhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$Iubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj Iubj)}(hhh]h)}(h flags to seth]h flags to set}(hj?IhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;IhMhjflags** and adjust nr_running accordingly.h](hSet }(hjwIhhhNhNubj)}(h **flags**h]hflags}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwIubh in }(hjwIhhhNhNubj)}(h**worker->flags**h]h worker->flags}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwIubh# and adjust nr_running accordingly.}(hjwIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jworker_clr_flags (C function)c.worker_clr_flagshNtauh1jhjhhhNhNubj)}(hhh](j)}(hAvoid worker_clr_flags (struct worker *worker, unsigned int flags)h]j)}(h@void worker_clr_flags(struct worker *worker, unsigned int flags)h](j)}(hvoidh]hvoid}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjIhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjIhhhjIhMubj)}(hworker_clr_flagsh]j)}(hworker_clr_flagsh]hworker_clr_flags}(hjIhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjIubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjIhhhjIhMubj|)}(h+(struct worker *worker, unsigned int flags)h](j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubh)}(hhh]j)}(hworkerh]hworker}(hj%JhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj"Jubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj'JmodnameN classnameNj7j:)}j=]j@)}j3jIsbc.worker_clr_flagsasbuh1hhjJubj)}(h h]h }(hjEJhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubjU)}(hjuh]h*}(hjSJhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjJubj)}(hworkerh]hworker}(hj`JhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjIubj)}(hunsigned int flagsh](j)}(hunsignedh]hunsigned}(hjyJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjuJubj)}(hinth]hint}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjuJubj)}(hflagsh]hflags}(hjJhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjuJubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjIubeh}(h]h ]h"]h$]h&]jjuh1j{hjIhhhjIhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjIhhhjIhMubah}(h]jIah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjIhMhjIhhubjC)}(hhh]h)}(h4clear worker flags and adjust nr_running accordinglyh]h4clear worker flags and adjust nr_running accordingly}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjJhhubah}(h]h ]h"]h$]h&]uh1jBhjIhhhjIhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejJjfjJjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker *worker`` self ``unsigned int flags`` flags to clear **Description** Clear **flags** in **worker->flags** and adjust nr_running accordingly.h](h)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjJubjg)}(hhh](jl)}(h``struct worker *worker`` self h](jr)}(h``struct worker *worker``h]j)}(hjKh]hstruct worker *worker}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjKubj)}(hhh]h)}(hselfh]hself}(hj5KhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1KhMhj2Kubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jkhj1KhMhjKubjl)}(h&``unsigned int flags`` flags to clear h](jr)}(h``unsigned int flags``h]j)}(hjUKh]hunsigned int flags}(hjWKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSKubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjOKubj)}(hhh]h)}(hflags to clearh]hflags to clear}(hjnKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjKhMhjkKubah}(h]h ]h"]h$]h&]uh1jhjOKubeh}(h]h ]h"]h$]h&]uh1jkhjjKhMhjKubeh}(h]h ]h"]h$]h&]uh1jfhjJubh)}(h**Description**h]j)}(hjKh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjJubh)}(hGClear **flags** in **worker->flags** and adjust nr_running accordingly.h](hClear }(hjKhhhNhNubj)}(h **flags**h]hflags}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh in }(hjKhhhNhNubj)}(h**worker->flags**h]h worker->flags}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubh# and adjust nr_running accordingly.}(hjKhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jworker_enter_idle (C function)c.worker_enter_idlehNtauh1jhjhhhNhNubj)}(hhh](j)}(h.void worker_enter_idle (struct worker *worker)h]j)}(h-void worker_enter_idle(struct worker *worker)h](j)}(hvoidh]hvoid}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjLhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjKhhhjLhMubj)}(hworker_enter_idleh]j)}(hworker_enter_idleh]hworker_enter_idle}(hjLhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjLubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjKhhhjLhMubj|)}(h(struct worker *worker)h]j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hj6LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Lubj)}(h h]h }(hjCLhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj2Lubh)}(hhh]j)}(hworkerh]hworker}(hjTLhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjQLubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjVLmodnameN classnameNj7j:)}j=]j@)}j3jLsbc.worker_enter_idleasbuh1hhj2Lubj)}(h h]h }(hjtLhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj2LubjU)}(hjuh]h*}(hjLhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj2Lubj)}(hworkerh]hworker}(hjLhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj2Lubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj.Lubah}(h]h ]h"]h$]h&]jjuh1j{hjKhhhjLhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjKhhhjLhMubah}(h]jKah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjLhMhjKhhubjC)}(hhh]h)}(henter idle stateh]henter idle state}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLhhubah}(h]h ]h"]h$]h&]uh1jBhjKhhhjLhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejLjfjLjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker *worker`` worker which is entering idle state **Description** **worker** is entering idle state. Update stats and idle timer if necessary. LOCKING: raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLubjg)}(hhh]jl)}(h>``struct worker *worker`` worker which is entering idle state h](jr)}(h``struct worker *worker``h]j)}(hjLh]hstruct worker *worker}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLubj)}(hhh]h)}(h#worker which is entering idle stateh]h#worker which is entering idle state}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjMubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jkhjMhMhjLubah}(h]h ]h"]h$]h&]uh1jfhjLubh)}(h**Description**h]j)}(hj5Mh]h Description}(hj7MhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3Mubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLubh)}(hM**worker** is entering idle state. Update stats and idle timer if necessary.h](j)}(h **worker**h]hworker}(hjOMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKMubhC is entering idle state. Update stats and idle timer if necessary.}(hjKMhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLubh)}(h'LOCKING: raw_spin_lock_irq(pool->lock).h]h'LOCKING: raw_spin_lock_irq(pool->lock).}(hjhMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jworker_leave_idle (C function)c.worker_leave_idlehNtauh1jhjhhhNhNubj)}(hhh](j)}(h.void worker_leave_idle (struct worker *worker)h]j)}(h-void worker_leave_idle(struct worker *worker)h](j)}(hvoidh]hvoid}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMhhhjMhM5ubj)}(hworker_leave_idleh]j)}(hworker_leave_idleh]hworker_leave_idle}(hjMhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjMhhhjMhM5ubj|)}(h(struct worker *worker)h]j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hjMhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMubh)}(hhh]j)}(hworkerh]hworker}(hjMhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjMmodnameN classnameNj7j:)}j=]j@)}j3jMsbc.worker_leave_idleasbuh1hhjMubj)}(h h]h }(hjNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMubjU)}(hjuh]h*}(hj NhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjMubj)}(hworkerh]hworker}(hj-NhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjMubah}(h]h ]h"]h$]h&]jjuh1j{hjMhhhjMhM5ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjMhhhjMhM5ubah}(h]jMah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjMhM5hjMhhubjC)}(hhh]h)}(hleave idle stateh]hleave idle state}(hjWNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5hjTNhhubah}(h]h ]h"]h$]h&]uh1jBhjMhhhjMhM5ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejoNjfjoNjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker *worker`` worker which is leaving idle state **Description** **worker** is leaving idle state. Update stats. LOCKING: raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hjyNh]h Parameters}(hj{NhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjsNubjg)}(hhh]jl)}(h=``struct worker *worker`` worker which is leaving idle state h](jr)}(h``struct worker *worker``h]j)}(hjNh]hstruct worker *worker}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM6hjNubj)}(hhh]h)}(h"worker which is leaving idle stateh]h"worker which is leaving idle state}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhM6hjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jkhjNhM6hjNubah}(h]h ]h"]h$]h&]uh1jfhjsNubh)}(h**Description**h]j)}(hjNh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM8hjsNubh)}(h0**worker** is leaving idle state. Update stats.h](j)}(h **worker**h]hworker}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh& is leaving idle state. Update stats.}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM7hjsNubh)}(h'LOCKING: raw_spin_lock_irq(pool->lock).h]h'LOCKING: raw_spin_lock_irq(pool->lock).}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjsNubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'find_worker_executing_work (C function)c.find_worker_executing_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h_struct worker * find_worker_executing_work (struct worker_pool *pool, struct work_struct *work)h]j)}(h]struct worker *find_worker_executing_work(struct worker_pool *pool, struct work_struct *work)h](j)}(hjh]hstruct}(hj5OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1OhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMIubj)}(h h]h }(hjCOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1OhhhjBOhMIubh)}(hhh]j)}(hworkerh]hworker}(hjTOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjQOubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjVOmodnameN classnameNj7j:)}j=]j@)}j3find_worker_executing_worksbc.find_worker_executing_workasbuh1hhj1OhhhjBOhMIubj)}(h h]h }(hjuOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1OhhhjBOhMIubjU)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj1OhhhjBOhMIubj)}(hfind_worker_executing_workh]j)}(hjrOh]hfind_worker_executing_work}(hjOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj1OhhhjBOhMIubj|)}(h4(struct worker_pool *pool, struct work_struct *work)h](j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjOmodnameN classnameNj7j:)}j=]jpOc.find_worker_executing_workasbuh1hhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOubjU)}(hjuh]h*}(hjOhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjOubj)}(hpoolh]hpool}(hjPhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjOubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubj)}(h h]h }(hj,PhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjPubh)}(hhh]j)}(h work_structh]h work_struct}(hj=PhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj:Pubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj?PmodnameN classnameNj7j:)}j=]jpOc.find_worker_executing_workasbuh1hhjPubj)}(h h]h }(hj[PhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjPubjU)}(hjuh]h*}(hjiPhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjPubj)}(hworkh]hwork}(hjvPhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjOubeh}(h]h ]h"]h$]h&]jjuh1j{hj1OhhhjBOhMIubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj-OhhhjBOhMIubah}(h]j(Oah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjBOhMIhj*OhhubjC)}(hhh]h)}(h%find worker which is executing a workh]h%find worker which is executing a work}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMIhjPhhubah}(h]h ]h"]h$]h&]uh1jBhj*OhhhjBOhMIubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejPjfjPjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct worker_pool *pool`` pool of interest ``struct work_struct *work`` work to find worker for **Description** Find a worker which is executing **work** on **pool** by searching **pool->busy_hash** which is keyed by the address of **work**. For a worker to match, its current execution should match the address of **work** and its work function. This is to avoid unwanted dependency between unrelated work executions through a work item being recycled while still being executed. This is a bit tricky. A work item may be freed once its execution starts and nothing prevents the freed area from being recycled for another work item. If the same work item address ends up being reused before the original execution finishes, workqueue will identify the recycled work item as currently executing and make it wait until the current execution finishes, introducing an unwanted dependency. This function checks the work item address and work function to avoid false positives. Note that this isn't complete as one may construct a work function which can introduce dependency onto itself through a recycled work item. Well, if somebody wants to shoot oneself in the foot that badly, there's only so much we can do, and if such deadlock actually occurs, it should be easy to locate the culprit work function. **Context** raw_spin_lock_irq(pool->lock). **Return** Pointer to worker which is executing **work** if found, ``NULL`` otherwise.h](h)}(h**Parameters**h]j)}(hjPh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMMhjPubjg)}(hhh](jl)}(h.``struct worker_pool *pool`` pool of interest h](jr)}(h``struct worker_pool *pool``h]j)}(hjPh]hstruct worker_pool *pool}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMJhjPubj)}(hhh]h)}(hpool of interesth]hpool of interest}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMJhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jkhjPhMJhjPubjl)}(h5``struct work_struct *work`` work to find worker for h](jr)}(h``struct work_struct *work``h]j)}(hjQh]hstruct work_struct *work}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMKhjQubj)}(hhh]h)}(hwork to find worker forh]hwork to find worker for}(hj3QhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/QhMKhj0Qubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jkhj/QhMKhjPubeh}(h]h ]h"]h$]h&]uh1jfhjPubh)}(h**Description**h]j)}(hjUQh]h Description}(hjWQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSQubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMMhjPubh)}(hXrFind a worker which is executing **work** on **pool** by searching **pool->busy_hash** which is keyed by the address of **work**. For a worker to match, its current execution should match the address of **work** and its work function. This is to avoid unwanted dependency between unrelated work executions through a work item being recycled while still being executed.h](h!Find a worker which is executing }(hjkQhhhNhNubj)}(h**work**h]hwork}(hjsQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkQubh on }(hjkQhhhNhNubj)}(h**pool**h]hpool}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkQubh by searching }(hjkQhhhNhNubj)}(h**pool->busy_hash**h]hpool->busy_hash}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkQubh" which is keyed by the address of }(hjkQhhhNhNubj)}(h**work**h]hwork}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkQubhL. For a worker to match, its current execution should match the address of }(hjkQhhhNhNubj)}(h**work**h]hwork}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkQubh and its work function. This is to avoid unwanted dependency between unrelated work executions through a work item being recycled while still being executed.}(hjkQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMLhjPubh)}(hXThis is a bit tricky. A work item may be freed once its execution starts and nothing prevents the freed area from being recycled for another work item. If the same work item address ends up being reused before the original execution finishes, workqueue will identify the recycled work item as currently executing and make it wait until the current execution finishes, introducing an unwanted dependency.h]hXThis is a bit tricky. A work item may be freed once its execution starts and nothing prevents the freed area from being recycled for another work item. If the same work item address ends up being reused before the original execution finishes, workqueue will identify the recycled work item as currently executing and make it wait until the current execution finishes, introducing an unwanted dependency.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMShjPubh)}(hXThis function checks the work item address and work function to avoid false positives. Note that this isn't complete as one may construct a work function which can introduce dependency onto itself through a recycled work item. Well, if somebody wants to shoot oneself in the foot that badly, there's only so much we can do, and if such deadlock actually occurs, it should be easy to locate the culprit work function.h]hXThis function checks the work item address and work function to avoid false positives. Note that this isn’t complete as one may construct a work function which can introduce dependency onto itself through a recycled work item. Well, if somebody wants to shoot oneself in the foot that badly, there’s only so much we can do, and if such deadlock actually occurs, it should be easy to locate the culprit work function.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMZhjPubh)}(h **Context**h]j)}(hjQh]hContext}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMahjPubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hj RhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMbhjPubh)}(h **Return**h]j)}(hjRh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMdhjPubh)}(hKPointer to worker which is executing **work** if found, ``NULL`` otherwise.h](h%Pointer to worker which is executing }(hj1RhhhNhNubj)}(h**work**h]hwork}(hj9RhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1Rubh if found, }(hj1RhhhNhNubj)}(h``NULL``h]hNULL}(hjKRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1Rubh otherwise.}(hj1RhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMehjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jmove_linked_works (C function)c.move_linked_workshNtauh1jhjhhhNhNubj)}(hhh](j)}(hevoid move_linked_works (struct work_struct *work, struct list_head *head, struct work_struct **nextp)h]j)}(hdvoid move_linked_works(struct work_struct *work, struct list_head *head, struct work_struct **nextp)h](j)}(hvoidh]hvoid}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM~ubj)}(h h]h }(hjRhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjRhhhjRhM~ubj)}(hmove_linked_worksh]j)}(hmove_linked_worksh]hmove_linked_works}(hjRhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjRubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjRhhhjRhM~ubj|)}(hN(struct work_struct *work, struct list_head *head, struct work_struct **nextp)h](j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h work_structh]h work_struct}(hjRhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjRmodnameN classnameNj7j:)}j=]j@)}j3jRsbc.move_linked_worksasbuh1hhjRubj)}(h h]h }(hjRhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjRubjU)}(hjuh]h*}(hj ShhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjRubj)}(hworkh]hwork}(hjShhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjRubj)}(hstruct list_head *headh](j)}(hjh]hstruct}(hj3ShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/Subj)}(h h]h }(hj@ShhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/Subh)}(hhh]j)}(h list_headh]h list_head}(hjQShhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjNSubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjSSmodnameN classnameNj7j:)}j=]jRc.move_linked_worksasbuh1hhj/Subj)}(h h]h }(hjoShhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/SubjU)}(hjuh]h*}(hj}ShhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj/Subj)}(hheadh]hhead}(hjShhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj/Subeh}(h]h ]h"]h$]h&]noemphjjuh1jhjRubj)}(hstruct work_struct **nextph](j)}(hjh]hstruct}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjSubh)}(hhh]j)}(h work_structh]h work_struct}(hjShhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjSmodnameN classnameNj7j:)}j=]jRc.move_linked_worksasbuh1hhjSubj)}(h h]h }(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjSubjU)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjSubjU)}(hjuh]h*}(hjShhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjSubj)}(hnextph]hnextp}(hjThhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjRubeh}(h]h ]h"]h$]h&]jjuh1j{hjRhhhjRhM~ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj|RhhhjRhM~ubah}(h]jwRah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjRhM~hjyRhhubjC)}(hhh]h)}(hmove linked works to a listh]hmove linked works to a list}(hj1ThhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM~hj.Thhubah}(h]h ]h"]h$]h&]uh1jBhjyRhhhjRhM~ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejITjfjITjgjhjiuh1jhhhjhNhNubjk)}(hX **Parameters** ``struct work_struct *work`` start of series of works to be scheduled ``struct list_head *head`` target list to append **work** to ``struct work_struct **nextp`` out parameter for nested worklist walking **Description** Schedule linked works starting from **work** to **head**. Work series to be scheduled starts at **work** and includes any consecutive work with WORK_STRUCT_LINKED set in its predecessor. See assign_work() for details on **nextp**. **Context** raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hjSTh]h Parameters}(hjUThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQTubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjMTubjg)}(hhh](jl)}(hF``struct work_struct *work`` start of series of works to be scheduled h](jr)}(h``struct work_struct *work``h]j)}(hjrTh]hstruct work_struct *work}(hjtThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpTubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjlTubj)}(hhh]h)}(h(start of series of works to be scheduledh]h(start of series of works to be scheduled}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjlTubeh}(h]h ]h"]h$]h&]uh1jkhjThMhjiTubjl)}(h=``struct list_head *head`` target list to append **work** to h](jr)}(h``struct list_head *head``h]j)}(hjTh]hstruct list_head *head}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubj)}(hhh]h)}(h!target list to append **work** toh](htarget list to append }(hjThhhNhNubj)}(h**work**h]hwork}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubh to}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjThMhjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jkhjThMhjiTubjl)}(hI``struct work_struct **nextp`` out parameter for nested worklist walking h](jr)}(h``struct work_struct **nextp``h]j)}(hjTh]hstruct work_struct **nextp}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubj)}(hhh]h)}(h)out parameter for nested worklist walkingh]h)out parameter for nested worklist walking}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj UhMhj Uubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jkhj UhMhjiTubeh}(h]h ]h"]h$]h&]uh1jfhjMTubh)}(h**Description**h]j)}(hj1Uh]h Description}(hj3UhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/Uubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjMTubh)}(hSchedule linked works starting from **work** to **head**. Work series to be scheduled starts at **work** and includes any consecutive work with WORK_STRUCT_LINKED set in its predecessor. See assign_work() for details on **nextp**.h](h$Schedule linked works starting from }(hjGUhhhNhNubj)}(h**work**h]hwork}(hjOUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGUubh to }(hjGUhhhNhNubj)}(h**head**h]hhead}(hjaUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGUubh(. Work series to be scheduled starts at }(hjGUhhhNhNubj)}(h**work**h]hwork}(hjsUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGUubht and includes any consecutive work with WORK_STRUCT_LINKED set in its predecessor. See assign_work() for details on }(hjGUhhhNhNubj)}(h **nextp**h]hnextp}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGUubh.}(hjGUhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjMTubh)}(h **Context**h]j)}(hjUh]hContext}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjMTubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjMTubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jassign_work (C function) c.assign_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h^bool assign_work (struct work_struct *work, struct worker *worker, struct work_struct **nextp)h]j)}(h]bool assign_work(struct work_struct *work, struct worker *worker, struct work_struct **nextp)h](j)}(hj*h]hbool}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjUhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjUhhhjUhMubj)}(h assign_workh]j)}(h assign_workh]h assign_work}(hjVhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjVubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjUhhhjUhMubj|)}(hM(struct work_struct *work, struct worker *worker, struct work_struct **nextp)h](j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hj!VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hj.VhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjVubh)}(hhh]j)}(h work_structh]h work_struct}(hj?VhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjXubj)}(hhh]h)}(h)out parameter for nested worklist walkingh]h)out parameter for nested worklist walking}(hj]XhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYXhMhjZXubah}(h]h ]h"]h$]h&]uh1jhj>Xubeh}(h]h ]h"]h$]h&]uh1jkhjYXhMhjWubeh}(h]h ]h"]h$]h&]uh1jfhjWubh)}(h**Description**h]j)}(hjXh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}Xubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjWubh)}(hAssign **work** and its linked work items to **worker**. If **work** is already being executed by another worker in the same pool, it'll be punted there.h](hAssign }(hjXhhhNhNubj)}(h**work**h]hwork}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh and its linked work items to }(hjXhhhNhNubj)}(h **worker**h]hworker}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh. If }(hjXhhhNhNubj)}(h**work**h]hwork}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubhW is already being executed by another worker in the same pool, it’ll be punted there.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjWubh)}(hIf **nextp** is not NULL, it's updated to point to the next work of the last scheduled work. This allows assign_work() to be nested inside list_for_each_entry_safe().h](hIf }(hjXhhhNhNubj)}(h **nextp**h]hnextp}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh is not NULL, it’s updated to point to the next work of the last scheduled work. This allows assign_work() to be nested inside list_for_each_entry_safe().}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjWubh)}(hReturns ``true`` if **work** was successfully assigned to **worker**. ``false`` if **work** was punted to another worker already executing it.h](hReturns }(hjXhhhNhNubj)}(h``true``h]htrue}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh if }(hjXhhhNhNubj)}(h**work**h]hwork}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh was successfully assigned to }(hjXhhhNhNubj)}(h **worker**h]hworker}(hj'YhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh. }(hjXhhhNhNubj)}(h ``false``h]hfalse}(hj9YhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh if }hjXsbj)}(h**work**h]hwork}(hjKYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh3 was punted to another worker already executing it.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjWubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jkick_pool_pick (C function)c.kick_pool_pickhNtauh1jhjhhhNhNubj)}(hhh](j)}(hJbool kick_pool_pick (struct worker_pool *pool, struct task_struct **wakep)h]j)}(hIbool kick_pool_pick(struct worker_pool *pool, struct task_struct **wakep)h](j)}(hj*h]hbool}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjYhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjYhhhjYhMubj)}(hkick_pool_pickh]j)}(hkick_pool_pickh]hkick_pool_pick}(hjYhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjYubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjYhhhjYhMubj|)}(h6(struct worker_pool *pool, struct task_struct **wakep)h](j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h h]h }(hjYhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjYubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjYhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjYmodnameN classnameNj7j:)}j=]j@)}j3jYsbc.kick_pool_pickasbuh1hhjYubj)}(h h]h }(hjYhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjYubjU)}(hjuh]h*}(hj ZhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjYubj)}(hpoolh]hpool}(hjZhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjYubj)}(hstruct task_struct **wakeph](j)}(hjh]hstruct}(hj2ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.Zubj)}(h h]h }(hj?ZhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj.Zubh)}(hhh]j)}(h task_structh]h task_struct}(hjPZhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMZubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjRZmodnameN classnameNj7j:)}j=]jYc.kick_pool_pickasbuh1hhj.Zubj)}(h h]h }(hjnZhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj.ZubjU)}(hjuh]h*}(hj|ZhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj.ZubjU)}(hjuh]h*}(hjZhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj.Zubj)}(hwakeph]hwakep}(hjZhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj.Zubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjYubeh}(h]h ]h"]h$]h&]jjuh1j{hjYhhhjYhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj|YhhhjYhMubah}(h]jwYah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjYhMhjyYhhubjC)}(hhh]h)}(h3select an idle worker to kick, deferring the wakeuph]h3select an idle worker to kick, deferring the wakeup}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZhhubah}(h]h ]h"]h$]h&]uh1jBhjyYhhhjYhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejZjfjZjgjhjiuh1jhhhjhNhNubjk)}(hX)**Parameters** ``struct worker_pool *pool`` pool to kick ``struct task_struct **wakep`` out-param, set to the task to wake after pool->lock is dropped **Description** Like kick_pool() but, for a regular (non-BH) pool, returns the picked worker's task via **wakep** instead of waking it, so the caller can issue the wakeup after dropping pool->lock (the wakeup takes rq->lock). Worker selection, wake_cpu setup and the BH kick still happen under the lock. Returns whether a worker was selected or kicked. Must be called with **pool->lock** held.h](h)}(h**Parameters**h]j)}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZubjg)}(hhh](jl)}(h*``struct worker_pool *pool`` pool to kick h](jr)}(h``struct worker_pool *pool``h]j)}(hj[h]hstruct worker_pool *pool}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZubj)}(hhh]h)}(h pool to kickh]h pool to kick}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]uh1jkhj[hMhjZubjl)}(h^``struct task_struct **wakep`` out-param, set to the task to wake after pool->lock is dropped h](jr)}(h``struct task_struct **wakep``h]j)}(hj:[h]hstruct task_struct **wakep}(hj<[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8[ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj4[ubj)}(hhh]h)}(h>out-param, set to the task to wake after pool->lock is droppedh]h>out-param, set to the task to wake after pool->lock is dropped}(hjS[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO[hMhjP[ubah}(h]h ]h"]h$]h&]uh1jhj4[ubeh}(h]h ]h"]h$]h&]uh1jkhjO[hMhjZubeh}(h]h ]h"]h$]h&]uh1jfhjZubh)}(h**Description**h]j)}(hju[h]h Description}(hjw[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs[ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZubh)}(hXPLike kick_pool() but, for a regular (non-BH) pool, returns the picked worker's task via **wakep** instead of waking it, so the caller can issue the wakeup after dropping pool->lock (the wakeup takes rq->lock). Worker selection, wake_cpu setup and the BH kick still happen under the lock. Returns whether a worker was selected or kicked.h](hZLike kick_pool() but, for a regular (non-BH) pool, returns the picked worker’s task via }(hj[hhhNhNubj)}(h **wakep**h]hwakep}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh instead of waking it, so the caller can issue the wakeup after dropping pool->lock (the wakeup takes rq->lock). Worker selection, wake_cpu setup and the BH kick still happen under the lock. Returns whether a worker was selected or kicked.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZubh)}(h(Must be called with **pool->lock** held.h](hMust be called with }(hj[hhhNhNubj)}(h**pool->lock**h]h pool->lock}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh held.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jkick_pool (C function) c.kick_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h)bool kick_pool (struct worker_pool *pool)h]j)}(h(bool kick_pool(struct worker_pool *pool)h](j)}(hj*h]hbool}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM4ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj[hhhj[hM4ubj)}(h kick_poolh]j)}(h kick_poolh]h kick_pool}(hj \hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj \ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj[hhhj[hM4ubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hj)\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%\ubj)}(h h]h }(hj6\hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj%\ubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjG\hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjD\ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjI\modnameN classnameNj7j:)}j=]j@)}j3j\sb c.kick_poolasbuh1hhj%\ubj)}(h h]h }(hjg\hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj%\ubjU)}(hjuh]h*}(hju\hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj%\ubj)}(hpoolh]hpool}(hj\hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj%\ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj!\ubah}(h]h ]h"]h$]h&]jjuh1j{hj[hhhj[hM4ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj[hhhj[hM4ubah}(h]j[ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj[hM4hj[hhubjC)}(hhh]h)}(h#wake up an idle worker if necessaryh]h#wake up an idle worker if necessary}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM4hj\hhubah}(h]h ]h"]h$]h&]uh1jBhj[hhhj[hM4ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej\jfj\jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker_pool *pool`` pool to kick **Description** **pool** may have pending work items. Wake up worker if necessary. Returns whether a worker was woken up.h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM8hj\ubjg)}(hhh]jl)}(h*``struct worker_pool *pool`` pool to kick h](jr)}(h``struct worker_pool *pool``h]j)}(hj\h]hstruct worker_pool *pool}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5hj\ubj)}(hhh]h)}(h pool to kickh]h pool to kick}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hM5hj]ubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jkhj]hM5hj\ubah}(h]h ]h"]h$]h&]uh1jfhj\ubh)}(h**Description**h]j)}(hj(]h]h Description}(hj*]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&]ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM7hj\ubh)}(hi**pool** may have pending work items. Wake up worker if necessary. Returns whether a worker was woken up.h](j)}(h**pool**h]hpool}(hjB]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>]ubha may have pending work items. Wake up worker if necessary. Returns whether a worker was woken up.}(hj>]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM6hj\ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwq_worker_running (C function)c.wq_worker_runninghNtauh1jhjhhhNhNubj)}(hhh](j)}(h1void wq_worker_running (struct task_struct *task)h]j)}(h0void wq_worker_running(struct task_struct *task)h](j)}(hvoidh]hvoid}(hj{]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjw]hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj]hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjw]hhhj]hMubj)}(hwq_worker_runningh]j)}(hwq_worker_runningh]hwq_worker_running}(hj]hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjw]hhhj]hMubj|)}(h(struct task_struct *task)h]j)}(hstruct task_struct *taskh](j)}(hjh]hstruct}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(h h]h }(hj]hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]ubh)}(hhh]j)}(h task_structh]h task_struct}(hj]hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj]modnameN classnameNj7j:)}j=]j@)}j3j]sbc.wq_worker_runningasbuh1hhj]ubj)}(h h]h }(hj]hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]ubjU)}(hjuh]h*}(hj^hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj]ubj)}(htaskh]htask}(hj^hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj]ubah}(h]h ]h"]h$]h&]jjuh1j{hjw]hhhj]hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjs]hhhj]hMubah}(h]jn]ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj]hMhjp]hhubjC)}(hhh]h)}(ha worker is running againh]ha worker is running again}(hj;^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj8^hhubah}(h]h ]h"]h$]h&]uh1jBhjp]hhhj]hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejS^jfjS^jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct task_struct *task`` task waking up **Description** This function is called when a worker returns from schedule()h](h)}(h**Parameters**h]j)}(hj]^h]h Parameters}(hj_^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[^ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW^ubjg)}(hhh]jl)}(h,``struct task_struct *task`` task waking up h](jr)}(h``struct task_struct *task``h]j)}(hj|^h]hstruct task_struct *task}(hj~^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz^ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjv^ubj)}(hhh]h)}(htask waking uph]htask waking up}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hMhj^ubah}(h]h ]h"]h$]h&]uh1jhjv^ubeh}(h]h ]h"]h$]h&]uh1jkhj^hMhjs^ubah}(h]h ]h"]h$]h&]uh1jfhjW^ubh)}(h**Description**h]j)}(hj^h]h Description}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW^ubh)}(h=This function is called when a worker returns from schedule()h]h=This function is called when a worker returns from schedule()}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwq_worker_sleeping (C function)c.wq_worker_sleepinghNtauh1jhjhhhNhNubj)}(hhh](j)}(h2void wq_worker_sleeping (struct task_struct *task)h]j)}(h1void wq_worker_sleeping(struct task_struct *task)h](j)}(hvoidh]hvoid}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj _hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj^hhhj _hMubj)}(hwq_worker_sleepingh]j)}(hwq_worker_sleepingh]hwq_worker_sleeping}(hj_hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj_ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj^hhhj _hMubj|)}(h(struct task_struct *task)h]j)}(hstruct task_struct *taskh](j)}(hjh]hstruct}(hj9_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5_ubj)}(h h]h }(hjF_hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5_ubh)}(hhh]j)}(h task_structh]h task_struct}(hjW_hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjT_ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjY_modnameN classnameNj7j:)}j=]j@)}j3j_sbc.wq_worker_sleepingasbuh1hhj5_ubj)}(h h]h }(hjw_hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5_ubjU)}(hjuh]h*}(hj_hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj5_ubj)}(htaskh]htask}(hj_hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5_ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj1_ubah}(h]h ]h"]h$]h&]jjuh1j{hj^hhhj _hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj^hhhj _hMubah}(h]j^ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj _hMhj^hhubjC)}(hhh]h)}(ha worker is going to sleeph]ha worker is going to sleep}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_hhubah}(h]h ]h"]h$]h&]uh1jBhj^hhhj _hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej_jfj_jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct task_struct *task`` task going to sleep **Description** This function is called from schedule() when a busy worker is going to sleep.h](h)}(h**Parameters**h]j)}(hj_h]h Parameters}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_ubjg)}(hhh]jl)}(h1``struct task_struct *task`` task going to sleep h](jr)}(h``struct task_struct *task``h]j)}(hj_h]hstruct task_struct *task}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_ubj)}(hhh]h)}(htask going to sleeph]htask going to sleep}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhj`ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jkhj`hMhj_ubah}(h]h ]h"]h$]h&]uh1jfhj_ubh)}(h**Description**h]j)}(hj8`h]h Description}(hj:`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6`ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_ubh)}(hMThis function is called from schedule() when a busy worker is going to sleep.h]hMThis function is called from schedule() when a busy worker is going to sleep.}(hjN`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwq_worker_tick (C function)c.wq_worker_tickhNtauh1jhjhhhNhNubj)}(hhh](j)}(h.void wq_worker_tick (struct task_struct *task)h]j)}(h-void wq_worker_tick(struct task_struct *task)h](j)}(hvoidh]hvoid}(hj}`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjy`hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj`hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjy`hhhj`hMubj)}(hwq_worker_tickh]j)}(hwq_worker_tickh]hwq_worker_tick}(hj`hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj`ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjy`hhhj`hMubj|)}(h(struct task_struct *task)h]j)}(hstruct task_struct *taskh](j)}(hjh]hstruct}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj`ubh)}(hhh]j)}(h task_structh]h task_struct}(hj`hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj`modnameN classnameNj7j:)}j=]j@)}j3j`sbc.wq_worker_tickasbuh1hhj`ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj`ubjU)}(hjuh]h*}(hjahhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj`ubj)}(htaskh]htask}(hjahhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj`ubah}(h]h ]h"]h$]h&]jjuh1j{hjy`hhhj`hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hju`hhhj`hMubah}(h]jp`ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj`hMhjr`hhubjC)}(hhh]h)}(h4a scheduler tick occurred while a kworker is runningh]h4a scheduler tick occurred while a kworker is running}(hj=ahhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj:ahhubah}(h]h ]h"]h$]h&]uh1jBhjr`hhhj`hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejUajfjUajgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct task_struct *task`` task currently running **Description** Called from sched_tick(). We're in the IRQ context and the current worker's fields which follow the 'K' locking rule can be accessed safely.h](h)}(h**Parameters**h]j)}(hj_ah]h Parameters}(hjaahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]aubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjYaubjg)}(hhh]jl)}(h4``struct task_struct *task`` task currently running h](jr)}(h``struct task_struct *task``h]j)}(hj~ah]hstruct task_struct *task}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|aubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjxaubj)}(hhh]h)}(htask currently runningh]htask currently running}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhjahMhjaubah}(h]h ]h"]h$]h&]uh1jhjxaubeh}(h]h ]h"]h$]h&]uh1jkhjahMhjuaubah}(h]h ]h"]h$]h&]uh1jfhjYaubh)}(h**Description**h]j)}(hjah]h Description}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjYaubh)}(hCalled from sched_tick(). We're in the IRQ context and the current worker's fields which follow the 'K' locking rule can be accessed safely.h]hCalled from sched_tick(). We’re in the IRQ context and the current worker’s fields which follow the ‘K’ locking rule can be accessed safely.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjYaubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j wq_worker_last_func (C function)c.wq_worker_last_funchNtauh1jhjhhhNhNubj)}(hhh](j)}(h:work_func_t wq_worker_last_func (struct task_struct *task)h]j)}(h9work_func_t wq_worker_last_func(struct task_struct *task)h](h)}(hhh]j)}(h work_func_th]h work_func_t}(hjbhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjbmodnameN classnameNj7j:)}j=]j@)}j3wq_worker_last_funcsbc.wq_worker_last_funcasbuh1hhjahhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*ubj)}(h h]h }(hj#bhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjahhhj"bhM*ubj)}(hwq_worker_last_funch]j)}(hjbh]hwq_worker_last_func}(hj5bhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj1bubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjahhhj"bhM*ubj|)}(h(struct task_struct *task)h]j)}(hstruct task_struct *taskh](j)}(hjh]hstruct}(hjPbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLbubj)}(h h]h }(hj]bhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjLbubh)}(hhh]j)}(h task_structh]h task_struct}(hjnbhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjkbubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjpbmodnameN classnameNj7j:)}j=]jbc.wq_worker_last_funcasbuh1hhjLbubj)}(h h]h }(hjbhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjLbubjU)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjLbubj)}(htaskh]htask}(hjbhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjLbubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjHbubah}(h]h ]h"]h$]h&]jjuh1j{hjahhhj"bhM*ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjahhhj"bhM*ubah}(h]jaah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj"bhM*hjahhubjC)}(hhh]h)}(h$retrieve worker's last work functionh]h&retrieve worker’s last work function}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*hjbhhubah}(h]h ]h"]h$]h&]uh1jBhjahhhj"bhM*ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejbjfjbjgjhjiuh1jhhhjhNhNubjk)}(hXx**Parameters** ``struct task_struct *task`` Task to retrieve last work function of. **Description** Determine the last function a worker executed. This is called from the scheduler to get a worker's last known identity. This function is called during schedule() when a kworker is going to sleep. It's used by psi to identify aggregation workers during dequeuing, to allow periodic aggregation to shut-off when that worker is the last task in the system or cgroup to go to sleep. As this function doesn't involve any workqueue-related locking, it only returns stable values when called from inside the scheduler's queuing and dequeuing paths, when **task**, which must be a kworker, is guaranteed to not be processing any works. **Context** raw_spin_lock_irq(rq->lock) **Return** The last work function ``current`` executed as a worker, NULL if it hasn't executed any work yet.h](h)}(h**Parameters**h]j)}(hjbh]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM.hjbubjg)}(hhh]jl)}(hE``struct task_struct *task`` Task to retrieve last work function of. h](jr)}(h``struct task_struct *task``h]j)}(hjch]hstruct task_struct *task}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM+hj cubj)}(hhh]h)}(h'Task to retrieve last work function of.h]h'Task to retrieve last work function of.}(hj+chhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'chM+hj(cubah}(h]h ]h"]h$]h&]uh1jhj cubeh}(h]h ]h"]h$]h&]uh1jkhj'chM+hj cubah}(h]h ]h"]h$]h&]uh1jfhjbubh)}(h**Description**h]j)}(hjMch]h Description}(hjOchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKcubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM-hjbubh)}(hwDetermine the last function a worker executed. This is called from the scheduler to get a worker's last known identity.h]hyDetermine the last function a worker executed. This is called from the scheduler to get a worker’s last known identity.}(hjcchhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM,hjbubh)}(hXThis function is called during schedule() when a kworker is going to sleep. It's used by psi to identify aggregation workers during dequeuing, to allow periodic aggregation to shut-off when that worker is the last task in the system or cgroup to go to sleep.h]hXThis function is called during schedule() when a kworker is going to sleep. It’s used by psi to identify aggregation workers during dequeuing, to allow periodic aggregation to shut-off when that worker is the last task in the system or cgroup to go to sleep.}(hjrchhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM0hjbubh)}(hAs this function doesn't involve any workqueue-related locking, it only returns stable values when called from inside the scheduler's queuing and dequeuing paths, when **task**, which must be a kworker, is guaranteed to not be processing any works.h](hAs this function doesn’t involve any workqueue-related locking, it only returns stable values when called from inside the scheduler’s queuing and dequeuing paths, when }(hjchhhNhNubj)}(h**task**h]htask}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubhH, which must be a kworker, is guaranteed to not be processing any works.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5hjbubh)}(h **Context**h]j)}(hjch]hContext}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM:hjbubh)}(hraw_spin_lock_irq(rq->lock)h]hraw_spin_lock_irq(rq->lock)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM0hjbubh)}(h **Return**h]j)}(hjch]hReturn}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM2hjbubh)}(haThe last work function ``current`` executed as a worker, NULL if it hasn't executed any work yet.h](hThe last work function }(hjchhhNhNubj)}(h ``current``h]hcurrent}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubhA executed as a worker, NULL if it hasn’t executed any work yet.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=hjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwq_node_nr_active (C function)c.wq_node_nr_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(hTstruct wq_node_nr_active * wq_node_nr_active (struct workqueue_struct *wq, int node)h]j)}(hRstruct wq_node_nr_active *wq_node_nr_active(struct workqueue_struct *wq, int node)h](j)}(hjh]hstruct}(hj"dhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMOubj)}(h h]h }(hj0dhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjdhhhj/dhMOubh)}(hhh]j)}(hwq_node_nr_activeh]hwq_node_nr_active}(hjAdhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj>dubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjCdmodnameN classnameNj7j:)}j=]j@)}j3wq_node_nr_activesbc.wq_node_nr_activeasbuh1hhjdhhhj/dhMOubj)}(h h]h }(hjbdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjdhhhj/dhMOubjU)}(hjuh]h*}(hjpdhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjdhhhj/dhMOubj)}(hwq_node_nr_activeh]j)}(hj_dh]hwq_node_nr_active}(hjdhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj}dubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjdhhhj/dhMOubj|)}(h'(struct workqueue_struct *wq, int node)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjdubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjdhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjdmodnameN classnameNj7j:)}j=]j]dc.wq_node_nr_activeasbuh1hhjdubj)}(h h]h }(hjdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjdubjU)}(hjuh]h*}(hjdhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjdubj)}(hwqh]hwq}(hjdhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjdubj)}(hint nodeh](j)}(hinth]hint}(hj ehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjehhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubj)}(hnodeh]hnode}(hj(ehhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjdubeh}(h]h ]h"]h$]h&]jjuh1j{hjdhhhj/dhMOubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjdhhhj/dhMOubah}(h]jdah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj/dhMOhjdhhubjC)}(hhh]h)}(h"Determine wq_node_nr_active to useh]h"Determine wq_node_nr_active to use}(hjRehhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMOhjOehhubah}(h]h ]h"]h$]h&]uh1jBhjdhhhj/dhMOubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjejfjjejgjhjiuh1jhhhjhNhNubjk)}(hXG**Parameters** ``struct workqueue_struct *wq`` workqueue of interest ``int node`` NUMA node, can be ``NUMA_NO_NODE`` **Description** Determine wq_node_nr_active to use for **wq** on **node**. **wq** must be unbound. - node_nr_active[nr_node_ids] if **node** is ``NUMA_NO_NODE``. - Otherwise, node_nr_active[**node**].h](h)}(h**Parameters**h]j)}(hjteh]h Parameters}(hjvehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjreubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMShjneubjg)}(hhh](jl)}(h6``struct workqueue_struct *wq`` workqueue of interest h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjeh]hstruct workqueue_struct *wq}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMPhjeubj)}(hhh]h)}(hworkqueue of interesth]hworkqueue of interest}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMPhjeubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jkhjehMPhjeubjl)}(h0``int node`` NUMA node, can be ``NUMA_NO_NODE`` h](jr)}(h ``int node``h]j)}(hjeh]hint node}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQhjeubj)}(hhh]h)}(h"NUMA node, can be ``NUMA_NO_NODE``h](hNUMA node, can be }(hjehhhNhNubj)}(h``NUMA_NO_NODE``h]h NUMA_NO_NODE}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1hhjehMQhjeubah}(h]h ]h"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]uh1jkhjehMQhjeubeh}(h]h ]h"]h$]h&]uh1jfhjneubh)}(h**Description**h]j)}(hjfh]h Description}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMShjneubh)}(hRDetermine wq_node_nr_active to use for **wq** on **node**. **wq** must be unbound.h](h'Determine wq_node_nr_active to use for }(hj+fhhhNhNubj)}(h**wq**h]hwq}(hj3fhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+fubh on }(hj+fhhhNhNubj)}(h**node**h]hnode}(hjEfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+fubh. }(hj+fhhhNhNubj)}(h**wq**h]hwq}(hjWfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+fubh must be unbound.}(hj+fhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMRhjneubj )}(hhh](j%)}(h=node_nr_active[nr_node_ids] if **node** is ``NUMA_NO_NODE``. h]h)}(hghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:gubj)}(h h]h }(hjKghhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj:gubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj\ghhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjYgubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj^gmodnameN classnameNj7j:)}j=]j@)}j3j$gsbc.wq_update_node_max_activeasbuh1hhj:gubj)}(h h]h }(hj|ghhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj:gubjU)}(hjuh]h*}(hjghhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj:gubj)}(hwqh]hwq}(hjghhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj:gubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj6gubj)}(h int off_cpuh](j)}(hinth]hint}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(h h]h }(hjghhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjgubj)}(hoff_cpuh]hoff_cpu}(hjghhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj6gubeh}(h]h ]h"]h$]h&]jjuh1j{hjfhhhjghMfubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjfhhhjghMfubah}(h]jfah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjghMfhjfhhubjC)}(hhh]h)}(h"Update per-node max_actives to useh]h"Update per-node max_actives to use}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMfhjghhubah}(h]h ]h"]h$]h&]uh1jBhjfhhhjghMfubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejhjfjhjgjhjiuh1jhhhjhNhNubjk)}(hX{**Parameters** ``struct workqueue_struct *wq`` workqueue to update ``int off_cpu`` CPU that's going down, -1 if a CPU is not going down **Description** Update **wq->node_nr_active**[]->max. **wq** must be unbound. max_active is distributed among nodes according to the proportions of numbers of online cpus. The result is always between **wq->min_active** and max_active.h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhjhubjg)}(hhh](jl)}(h4``struct workqueue_struct *wq`` workqueue to update h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj7hh]hstruct workqueue_struct *wq}(hj9hhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5hubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMghj1hubj)}(hhh]h)}(hworkqueue to updateh]hworkqueue to update}(hjPhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhMghjMhubah}(h]h ]h"]h$]h&]uh1jhj1hubeh}(h]h ]h"]h$]h&]uh1jkhjLhhMghj.hubjl)}(hE``int off_cpu`` CPU that's going down, -1 if a CPU is not going down h](jr)}(h``int off_cpu``h]j)}(hjphh]h int off_cpu}(hjrhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnhubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhhjjhubj)}(hhh]h)}(h4CPU that's going down, -1 if a CPU is not going downh]h6CPU that’s going down, -1 if a CPU is not going down}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMhhjhubah}(h]h ]h"]h$]h&]uh1jhjjhubeh}(h]h ]h"]h$]h&]uh1jkhjhhMhhj.hubeh}(h]h ]h"]h$]h&]uh1jfhjhubh)}(h**Description**h]j)}(hjhh]h Description}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhjhubh)}(hUpdate **wq->node_nr_active**[]->max. **wq** must be unbound. max_active is distributed among nodes according to the proportions of numbers of online cpus. The result is always between **wq->min_active** and max_active.h](hUpdate }(hjhhhhNhNubj)}(h%**wq->node_nr_active**[]->max. **wq**h]h!wq->node_nr_active**[]->max. **wq}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubh must be unbound. max_active is distributed among nodes according to the proportions of numbers of online cpus. The result is always between }(hjhhhhNhNubj)}(h**wq->min_active**h]hwq->min_active}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubh and max_active.}(hjhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihjhubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jget_pwq (C function) c.get_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(h)void get_pwq (struct pool_workqueue *pwq)h]j)}(h(void get_pwq(struct pool_workqueue *pwq)h](j)}(hvoidh]hvoid}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjihhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj#ihhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjihhhj"ihMubj)}(hget_pwqh]j)}(hget_pwqh]hget_pwq}(hj5ihhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj1iubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjihhhj"ihMubj|)}(h(struct pool_workqueue *pwq)h]j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hjQihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMiubj)}(h h]h }(hj^ihhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMiubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjoihhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjliubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjqimodnameN classnameNj7j:)}j=]j@)}j3j7isb c.get_pwqasbuh1hhjMiubj)}(h h]h }(hjihhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMiubjU)}(hjuh]h*}(hjihhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjMiubj)}(hpwqh]hpwq}(hjihhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMiubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjIiubah}(h]h ]h"]h$]h&]jjuh1j{hjihhhj"ihMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj ihhhj"ihMubah}(h]jiah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj"ihMhj ihhubjC)}(hhh]h)}(h6get an extra reference on the specified pool_workqueueh]h6get an extra reference on the specified pool_workqueue}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjihhubah}(h]h ]h"]h$]h&]uh1jBhj ihhhj"ihMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejijfjijgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue to get **Description** Obtain an extra reference on **pwq**. The caller should guarantee that **pwq** has positive refcnt and be holding the matching pool->lock.h](h)}(h**Parameters**h]j)}(hjih]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjiubjg)}(hhh]jl)}(h5``struct pool_workqueue *pwq`` pool_workqueue to get h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjjh]hstruct pool_workqueue *pwq}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjjubj)}(hhh]h)}(hpool_workqueue to geth]hpool_workqueue to get}(hj.jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*jhMhj+jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jkhj*jhMhj jubah}(h]h ]h"]h$]h&]uh1jfhjiubh)}(h**Description**h]j)}(hjPjh]h Description}(hjRjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjiubh)}(hObtain an extra reference on **pwq**. The caller should guarantee that **pwq** has positive refcnt and be holding the matching pool->lock.h](hObtain an extra reference on }(hjfjhhhNhNubj)}(h**pwq**h]hpwq}(hjnjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfjubh$. The caller should guarantee that }(hjfjhhhNhNubj)}(h**pwq**h]hpwq}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfjubh< has positive refcnt and be holding the matching pool->lock.}(hjfjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jput_pwq (C function) c.put_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(h)void put_pwq (struct pool_workqueue *pwq)h]j)}(h(void put_pwq(struct pool_workqueue *pwq)h](j)}(hvoidh]hvoid}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjjhhhjjhMubj)}(hput_pwqh]j)}(hput_pwqh]hput_pwq}(hjjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjjhhhjjhMubj|)}(h(struct pool_workqueue *pwq)h]j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubj)}(h h]h }(hjkhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjjubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjkhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjkmodnameN classnameNj7j:)}j=]j@)}j3jjsb c.put_pwqasbuh1hhjjubj)}(h h]h }(hj4khhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjjubjU)}(hjuh]h*}(hjBkhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjjubj)}(hpwqh]hpwq}(hjOkhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjjubah}(h]h ]h"]h$]h&]jjuh1j{hjjhhhjjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjjhhhjjhMubah}(h]jjah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjjhMhjjhhubjC)}(hhh]h)}(hput a pool_workqueue referenceh]hput a pool_workqueue reference}(hjykhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjvkhhubah}(h]h ]h"]h$]h&]uh1jBhjjhhhjjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejkjfjkjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue to put **Description** Drop a reference of **pwq**. If its refcnt reaches zero, schedule its destruction. The caller should be holding the matching pool->lock.h](h)}(h**Parameters**h]j)}(hjkh]h Parameters}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjkubjg)}(hhh]jl)}(h5``struct pool_workqueue *pwq`` pool_workqueue to put h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjkh]hstruct pool_workqueue *pwq}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjkubj)}(hhh]h)}(hpool_workqueue to puth]hpool_workqueue to put}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjkhMhjkubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jkhjkhMhjkubah}(h]h ]h"]h$]h&]uh1jfhjkubh)}(h**Description**h]j)}(hjkh]h Description}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjkubh)}(hDrop a reference of **pwq**. If its refcnt reaches zero, schedule its destruction. The caller should be holding the matching pool->lock.h](hDrop a reference of }(hj lhhhNhNubj)}(h**pwq**h]hpwq}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj lubho. If its refcnt reaches zero, schedule its destruction. The caller should be holding the matching pool->lock.}(hj lhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjkubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jput_pwq_unlocked (C function)c.put_pwq_unlockedhNtauh1jhjhhhNhNubj)}(hhh](j)}(h2void put_pwq_unlocked (struct pool_workqueue *pwq)h]j)}(h1void put_pwq_unlocked(struct pool_workqueue *pwq)h](j)}(hvoidh]hvoid}(hjLlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHlhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj[lhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHlhhhjZlhMubj)}(hput_pwq_unlockedh]j)}(hput_pwq_unlockedh]hput_pwq_unlocked}(hjmlhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjilubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjHlhhhjZlhMubj|)}(h(struct pool_workqueue *pwq)h]j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjlubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjlhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjlmodnameN classnameNj7j:)}j=]j@)}j3jolsbc.put_pwq_unlockedasbuh1hhjlubj)}(h h]h }(hjlhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjlubjU)}(hjuh]h*}(hjlhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjlubj)}(hpwqh]hpwq}(hjlhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjlubah}(h]h ]h"]h$]h&]jjuh1j{hjHlhhhjZlhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjDlhhhjZlhMubah}(h]j?lah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjZlhMhjAlhhubjC)}(hhh]h)}(h+put_pwq() with surrounding pool lock/unlockh]h+put_pwq() with surrounding pool lock/unlock}(hj mhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj mhhubah}(h]h ]h"]h$]h&]uh1jBhjAlhhhjZlhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej$mjfj$mjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue to put (can be ``NULL``) **Description** put_pwq() with locking. This function also allows ``NULL`` **pwq**.h](h)}(h**Parameters**h]j)}(hj.mh]h Parameters}(hj0mhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,mubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj(mubjg)}(hhh]jl)}(hG``struct pool_workqueue *pwq`` pool_workqueue to put (can be ``NULL``) h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjMmh]hstruct pool_workqueue *pwq}(hjOmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKmubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjGmubj)}(hhh]h)}(h'pool_workqueue to put (can be ``NULL``)h](hpool_workqueue to put (can be }(hjfmhhhNhNubj)}(h``NULL``h]hNULL}(hjnmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfmubh)}(hjfmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjbmhMhjcmubah}(h]h ]h"]h$]h&]uh1jhjGmubeh}(h]h ]h"]h$]h&]uh1jkhjbmhMhjDmubah}(h]h ]h"]h$]h&]uh1jfhj(mubh)}(h**Description**h]j)}(hjmh]h Description}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj(mubh)}(hDput_pwq() with locking. This function also allows ``NULL`` **pwq**.h](h3put_pwq() with locking. This function also allows }(hjmhhhNhNubj)}(h``NULL``h]hNULL}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubh }(hjmhhhNhNubj)}(h**pwq**h]hpwq}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubh.}(hjmhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj(mubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!pwq_tryinc_nr_active (C function)c.pwq_tryinc_nr_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(hAbool pwq_tryinc_nr_active (struct pool_workqueue *pwq, bool fill)h]j)}(h@bool pwq_tryinc_nr_active(struct pool_workqueue *pwq, bool fill)h](j)}(hj*h]hbool}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjnhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjmhhhjnhMubj)}(hpwq_tryinc_nr_activeh]j)}(hpwq_tryinc_nr_activeh]hpwq_tryinc_nr_active}(hj#nhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjnubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjmhhhjnhMubj|)}(h'(struct pool_workqueue *pwq, bool fill)h](j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hj?nhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;nubj)}(h h]h }(hjLnhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;nubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hj]nhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjZnubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj_nmodnameN classnameNj7j:)}j=]j@)}j3j%nsbc.pwq_tryinc_nr_activeasbuh1hhj;nubj)}(h h]h }(hj}nhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;nubjU)}(hjuh]h*}(hjnhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj;nubj)}(hpwqh]hpwq}(hjnhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj;nubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj7nubj)}(h bool fillh](j)}(hj*h]hbool}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjnhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjnubj)}(hfillh]hfill}(hjnhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj7nubeh}(h]h ]h"]h$]h&]jjuh1j{hjmhhhjnhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjmhhhjnhMubah}(h]jmah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjnhMhjmhhubjC)}(hhh]h)}(h$Try to increment nr_active for a pwqh]h$Try to increment nr_active for a pwq}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjnhhubah}(h]h ]h"]h$]h&]uh1jBhjmhhhjnhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejojfjojgjhjiuh1jhhhjhNhNubjk)}(hX-**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue of interest ``bool fill`` max_active may have increased, try to increase concurrency level **Description** Try to increment nr_active for **pwq**. Returns ``true`` if an nr_active count is successfully obtained. ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjoubjg)}(hhh](jl)}(h:``struct pool_workqueue *pwq`` pool_workqueue of interest h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hj7oh]hstruct pool_workqueue *pwq}(hj9ohhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5oubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj1oubj)}(hhh]h)}(hpool_workqueue of interesth]hpool_workqueue of interest}(hjPohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLohMhjMoubah}(h]h ]h"]h$]h&]uh1jhj1oubeh}(h]h ]h"]h$]h&]uh1jkhjLohMhj.oubjl)}(hO``bool fill`` max_active may have increased, try to increase concurrency level h](jr)}(h ``bool fill``h]j)}(hjpoh]h bool fill}(hjrohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnoubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjjoubj)}(hhh]h)}(h@max_active may have increased, try to increase concurrency levelh]h@max_active may have increased, try to increase concurrency level}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohMhjoubah}(h]h ]h"]h$]h&]uh1jhjjoubeh}(h]h ]h"]h$]h&]uh1jkhjohMhj.oubeh}(h]h ]h"]h$]h&]uh1jfhjoubh)}(h**Description**h]j)}(hjoh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjoubh)}(h}Try to increment nr_active for **pwq**. Returns ``true`` if an nr_active count is successfully obtained. ``false`` otherwise.h](hTry to increment nr_active for }(hjohhhNhNubj)}(h**pwq**h]hpwq}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh . Returns }(hjohhhNhNubj)}(h``true``h]htrue}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh1 if an nr_active count is successfully obtained. }(hjohhhNhNubj)}(h ``false``h]hfalse}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubh otherwise.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjoubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(pwq_activate_first_inactive (C function)c.pwq_activate_first_inactivehNtauh1jhjhhhNhNubj)}(hhh](j)}(hHbool pwq_activate_first_inactive (struct pool_workqueue *pwq, bool fill)h]j)}(hGbool pwq_activate_first_inactive(struct pool_workqueue *pwq, bool fill)h](j)}(hj*h]hbool}(hj&phhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"phhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=ubj)}(h h]h }(hj4phhhNhNubah}(h]h ]j ah"]h$R]h&]uh1jhj"phhhj3phM=ubj)}(hpwq_activate_first_inactiveh]j)}(hpwq_activate_first_inactiveh]hpwq_activate_first_inactive}(hjFphhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjBpubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj"phhhj3phM=ubj|)}(h'(struct pool_workqueue *pwq, bool fill)h](j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hjbphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^pubj)}(h h]h }(hjophhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj^pubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjphhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj}pubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjpmodnameN classnameNj7j:)}j=]j@)}j3jHpsbc.pwq_activate_first_inactiveasbuh1hhj^pubj)}(h h]h }(hjphhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj^pubjU)}(hjuh]h*}(hjphhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj^pubj)}(hpwqh]hpwq}(hjphhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj^pubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjZpubj)}(h bool fillh](j)}(hj*h]hbool}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubj)}(h h]h }(hjphhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjpubj)}(hfillh]hfill}(hjphhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjZpubeh}(h]h ]h"]h$]h&]jjuh1j{hj"phhhj3phM=ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjphhhj3phM=ubah}(h]jpah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj3phM=hjphhubjC)}(hhh]h)}(h.Activate the first inactive work item on a pwqh]h.Activate the first inactive work item on a pwq}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=hjqhhubah}(h]h ]h"]h$]h&]uh1jBhjphhhj3phM=ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej1qjfj1qjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue of interest ``bool fill`` max_active may have increased, try to increase concurrency level **Description** Activate the first inactive work item of **pwq** if available and allowed by max_active limit. Returns ``true`` if an inactive work item has been activated. ``false`` if no inactive work item is found or max_active limit is reached.h](h)}(h**Parameters**h]j)}(hj;qh]h Parameters}(hj=qhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9qubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhj5qubjg)}(hhh](jl)}(h:``struct pool_workqueue *pwq`` pool_workqueue of interest h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjZqh]hstruct pool_workqueue *pwq}(hj\qhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXqubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM>hjTqubj)}(hhh]h)}(hpool_workqueue of interesth]hpool_workqueue of interest}(hjsqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjoqhM>hjpqubah}(h]h ]h"]h$]h&]uh1jhjTqubeh}(h]h ]h"]h$]h&]uh1jkhjoqhM>hjQqubjl)}(hO``bool fill`` max_active may have increased, try to increase concurrency level h](jr)}(h ``bool fill``h]j)}(hjqh]h bool fill}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM?hjqubj)}(hhh]h)}(h@max_active may have increased, try to increase concurrency levelh]h@max_active may have increased, try to increase concurrency level}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhM?hjqubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jkhjqhM?hjQqubeh}(h]h ]h"]h$]h&]uh1jfhj5qubh)}(h**Description**h]j)}(hjqh]h Description}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhj5qubh)}(h^Activate the first inactive work item of **pwq** if available and allowed by max_active limit.h](h)Activate the first inactive work item of }(hjqhhhNhNubj)}(h**pwq**h]hpwq}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubh. if available and allowed by max_active limit.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM@hj5qubh)}(hReturns ``true`` if an inactive work item has been activated. ``false`` if no inactive work item is found or max_active limit is reached.h](hReturns }(hjrhhhNhNubj)}(h``true``h]htrue}(hj rhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubh. if an inactive work item has been activated. }(hjrhhhNhNubj)}(h ``false``h]hfalse}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubhB if no inactive work item is found or max_active limit is reached.}(hjrhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMChj5qubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](junplug_oldest_pwq (C function)c.unplug_oldest_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void unplug_oldest_pwq (struct workqueue_struct *wq)h]j)}(h3void unplug_oldest_pwq(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hjXrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTrhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMVubj)}(h h]h }(hjgrhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjTrhhhjfrhMVubj)}(hunplug_oldest_pwqh]j)}(hunplug_oldest_pwqh]hunplug_oldest_pwq}(hjyrhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjurubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjTrhhhjfrhMVubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubj)}(h h]h }(hjrhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjrubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjrhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjrmodnameN classnameNj7j:)}j=]j@)}j3j{rsbc.unplug_oldest_pwqasbuh1hhjrubj)}(h h]h }(hjrhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjrubjU)}(hjuh]h*}(hjrhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjrubj)}(hwqh]hwq}(hjrhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjrubah}(h]h ]h"]h$]h&]jjuh1j{hjTrhhhjfrhMVubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjPrhhhjfrhMVubah}(h]jKrah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjfrhMVhjMrhhubjC)}(hhh]h)}(h unplug the oldest pool_workqueueh]h unplug the oldest pool_workqueue}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMVhjshhubah}(h]h ]h"]h$]h&]uh1jBhjMrhhhjfrhMVubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej0sjfj0sjgjhjiuh1jhhhjhNhNubjk)}(hX!**Parameters** ``struct workqueue_struct *wq`` workqueue_struct where its oldest pwq is to be unplugged **Description** This function should only be called for ordered workqueues where only the oldest pwq is unplugged, the others are plugged to suspend execution to ensure proper work item ordering:: dfl_pwq --------------+ [P] - plugged | v pwqs -> A -> B [P] -> C [P] (newest) | | | 1 3 5 | | | 2 4 6 When the oldest pwq is drained and removed, this function should be called to unplug the next oldest one to start its work item execution. Note that pwq's are linked into wq->pwqs with the oldest first, so the first one in the list is the oldest.h](h)}(h**Parameters**h]j)}(hj:sh]h Parameters}(hj A -> B [P] -> C [P] (newest) | | | 1 3 5 | | | 2 4 6h]hdfl_pwq --------------+ [P] - plugged | v pwqs -> A -> B [P] -> C [P] (newest) | | | 1 3 5 | | | 2 4 6}hjssbah}(h]h ]h"]h$]h&]jjuh1jhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM\hj4subh)}(hWhen the oldest pwq is drained and removed, this function should be called to unplug the next oldest one to start its work item execution. Note that pwq's are linked into wq->pwqs with the oldest first, so the first one in the list is the oldest.h]hWhen the oldest pwq is drained and removed, this function should be called to unplug the next oldest one to start its work item execution. Note that pwq’s are linked into wq->pwqs with the oldest first, so the first one in the list is the oldest.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMehj4subeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&node_activate_pending_pwq (C function)c.node_activate_pending_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(h_void node_activate_pending_pwq (struct wq_node_nr_active *nna, struct worker_pool *caller_pool)h]j)}(h^void node_activate_pending_pwq(struct wq_node_nr_active *nna, struct worker_pool *caller_pool)h](j)}(hvoidh]hvoid}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjshhhjthMubj)}(hnode_activate_pending_pwqh]j)}(hnode_activate_pending_pwqh]hnode_activate_pending_pwq}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjtubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjshhhjthMubj|)}(h@(struct wq_node_nr_active *nna, struct worker_pool *caller_pool)h](j)}(hstruct wq_node_nr_active *nnah](j)}(hjh]hstruct}(hj4thhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0tubj)}(h h]h }(hjAthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0tubh)}(hhh]j)}(hwq_node_nr_activeh]hwq_node_nr_active}(hjRthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOtubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjTtmodnameN classnameNj7j:)}j=]j@)}j3jtsbc.node_activate_pending_pwqasbuh1hhj0tubj)}(h h]h }(hjrthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0tubjU)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj0tubj)}(hnnah]hnna}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj0tubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj,tubj)}(hstruct worker_pool *caller_poolh](j)}(hjh]hstruct}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubj)}(h h]h }(hjthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjtubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjtmodnameN classnameNj7j:)}j=]jntc.node_activate_pending_pwqasbuh1hhjtubj)}(h h]h }(hjthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjtubjU)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjtubj)}(h caller_poolh]h caller_pool}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj,tubeh}(h]h ]h"]h$]h&]jjuh1j{hjshhhjthMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjshhhjthMubah}(h]jsah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjthMhjshhubjC)}(hhh]h)}(h-Activate a pending pwq on a wq_node_nr_activeh]h-Activate a pending pwq on a wq_node_nr_active}(hj'uhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj$uhhubah}(h]h ]h"]h$]h&]uh1jBhjshhhjthMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej?ujfj?ujgjhjiuh1jhhhjhNhNubjk)}(hXT**Parameters** ``struct wq_node_nr_active *nna`` wq_node_nr_active to activate a pending pwq for ``struct worker_pool *caller_pool`` worker_pool the caller is locking **Description** Activate a pwq in **nna->pending_pwqs**. Called with **caller_pool** locked. **caller_pool** may be unlocked and relocked to lock other worker_pools.h](h)}(h**Parameters**h]j)}(hjIuh]h Parameters}(hjKuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGuubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCuubjg)}(hhh](jl)}(hR``struct wq_node_nr_active *nna`` wq_node_nr_active to activate a pending pwq for h](jr)}(h!``struct wq_node_nr_active *nna``h]j)}(hjhuh]hstruct wq_node_nr_active *nna}(hjjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfuubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjbuubj)}(hhh]h)}(h/wq_node_nr_active to activate a pending pwq forh]h/wq_node_nr_active to activate a pending pwq for}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}uhMhj~uubah}(h]h ]h"]h$]h&]uh1jhjbuubeh}(h]h ]h"]h$]h&]uh1jkhj}uhMhj_uubjl)}(hF``struct worker_pool *caller_pool`` worker_pool the caller is locking h](jr)}(h#``struct worker_pool *caller_pool``h]j)}(hjuh]hstruct worker_pool *caller_pool}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjuubj)}(hhh]h)}(h!worker_pool the caller is lockingh]h!worker_pool the caller is locking}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMhjuubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jkhjuhMhj_uubeh}(h]h ]h"]h$]h&]uh1jfhjCuubh)}(h**Description**h]j)}(hjuh]h Description}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCuubh)}(hActivate a pwq in **nna->pending_pwqs**. Called with **caller_pool** locked. **caller_pool** may be unlocked and relocked to lock other worker_pools.h](hActivate a pwq in }(hjuhhhNhNubj)}(h**nna->pending_pwqs**h]hnna->pending_pwqs}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubh. Called with }(hjuhhhNhNubj)}(h**caller_pool**h]h caller_pool}(hj vhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubh locked. }(hjuhhhNhNubj)}(h**caller_pool**h]h caller_pool}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubh9 may be unlocked and relocked to lock other worker_pools.}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCuubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpwq_dec_nr_active (C function)c.pwq_dec_nr_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(h3void pwq_dec_nr_active (struct pool_workqueue *pwq)h]j)}(h2void pwq_dec_nr_active(struct pool_workqueue *pwq)h](j)}(hvoidh]hvoid}(hjWvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSvhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjfvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjSvhhhjevhMubj)}(hpwq_dec_nr_activeh]j)}(hpwq_dec_nr_activeh]hpwq_dec_nr_active}(hjxvhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjtvubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjSvhhhjevhMubj|)}(h(struct pool_workqueue *pwq)h]j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjvubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjvhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjvmodnameN classnameNj7j:)}j=]j@)}j3jzvsbc.pwq_dec_nr_activeasbuh1hhjvubj)}(h h]h }(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjvubjU)}(hjuh]h*}(hjvhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjvubj)}(hpwqh]hpwq}(hjvhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjvubah}(h]h ]h"]h$]h&]jjuh1j{hjSvhhhjevhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjOvhhhjevhMubah}(h]jJvah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjevhMhjLvhhubjC)}(hhh]h)}(hRetire an active counth]hRetire an active count}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjwhhubah}(h]h ]h"]h$]h&]uh1jBhjLvhhhjevhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej/wjfj/wjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct pool_workqueue *pwq`` pool_workqueue of interest **Description** Decrement **pwq**'s nr_active and try to activate the first inactive work item. For unbound workqueues, this function may temporarily drop **pwq->pool->lock**.h](h)}(h**Parameters**h]j)}(hj9wh]h Parameters}(hj;whhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7wubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj3wubjg)}(hhh]jl)}(h:``struct pool_workqueue *pwq`` pool_workqueue of interest h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjXwh]hstruct pool_workqueue *pwq}(hjZwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVwubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjRwubj)}(hhh]h)}(hpool_workqueue of interesth]hpool_workqueue of interest}(hjqwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmwhMhjnwubah}(h]h ]h"]h$]h&]uh1jhjRwubeh}(h]h ]h"]h$]h&]uh1jkhjmwhMhjOwubah}(h]h ]h"]h$]h&]uh1jfhj3wubh)}(h**Description**h]j)}(hjwh]h Description}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj3wubh)}(hDecrement **pwq**'s nr_active and try to activate the first inactive work item. For unbound workqueues, this function may temporarily drop **pwq->pool->lock**.h](h Decrement }(hjwhhhNhNubj)}(h**pwq**h]hpwq}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh|’s nr_active and try to activate the first inactive work item. For unbound workqueues, this function may temporarily drop }(hjwhhhNhNubj)}(h**pwq->pool->lock**h]hpwq->pool->lock}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj3wubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!pwq_dec_nr_in_flight (C function)c.pwq_dec_nr_in_flighthNtauh1jhjhhhNhNubj)}(hhh](j)}(hOvoid pwq_dec_nr_in_flight (struct pool_workqueue *pwq, unsigned long work_data)h]j)}(hNvoid pwq_dec_nr_in_flight(struct pool_workqueue *pwq, unsigned long work_data)h](j)}(hvoidh]hvoid}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj xhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjwhhhj xhMubj)}(hpwq_dec_nr_in_flighth]j)}(hpwq_dec_nr_in_flighth]hpwq_dec_nr_in_flight}(hjxhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjxubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjwhhhj xhMubj|)}(h5(struct pool_workqueue *pwq, unsigned long work_data)h](j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hj9xhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5xubj)}(h h]h }(hjFxhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5xubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hjWxhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjTxubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjYxmodnameN classnameNj7j:)}j=]j@)}j3jxsbc.pwq_dec_nr_in_flightasbuh1hhj5xubj)}(h h]h }(hjwxhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5xubjU)}(hjuh]h*}(hjxhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj5xubj)}(hpwqh]hpwq}(hjxhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5xubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj1xubj)}(hunsigned long work_datah](j)}(hunsignedh]hunsigned}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjxubj)}(hlongh]hlong}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubj)}(h h]h }(hjxhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjxubj)}(h work_datah]h work_data}(hjxhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj1xubeh}(h]h ]h"]h$]h&]jjuh1j{hjwhhhj xhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjwhhhj xhMubah}(h]jwah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj xhMhjwhhubjC)}(hhh]h)}(hdecrement pwq's nr_in_flighth]hdecrement pwq’s nr_in_flight}(hj yhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj yhhubah}(h]h ]h"]h$]h&]uh1jBhjwhhhj xhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej%yjfj%yjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct pool_workqueue *pwq`` pwq of interest ``unsigned long work_data`` work_data of work which left the queue **Description** A work either has completed or is removed from pending queue, decrement nr_in_flight of its pwq and handle workqueue flushing. **NOTE** For unbound workqueues, this function may temporarily drop **pwq->pool->lock** and thus should be called after all other state updates for the in-flight work item is complete. **Context** raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hj/yh]h Parameters}(hj1yhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-yubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubjg)}(hhh](jl)}(h/``struct pool_workqueue *pwq`` pwq of interest h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjNyh]hstruct pool_workqueue *pwq}(hjPyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLyubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHyubj)}(hhh]h)}(hpwq of interesth]hpwq of interest}(hjgyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjcyhMhjdyubah}(h]h ]h"]h$]h&]uh1jhjHyubeh}(h]h ]h"]h$]h&]uh1jkhjcyhMhjEyubjl)}(hC``unsigned long work_data`` work_data of work which left the queue h](jr)}(h``unsigned long work_data``h]j)}(hjyh]hunsigned long work_data}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjyubj)}(hhh]h)}(h&work_data of work which left the queueh]h&work_data of work which left the queue}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhMhjyubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jkhjyhMhjEyubeh}(h]h ]h"]h$]h&]uh1jfhj)yubh)}(h**Description**h]j)}(hjyh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubh)}(h~A work either has completed or is removed from pending queue, decrement nr_in_flight of its pwq and handle workqueue flushing.h]h~A work either has completed or is removed from pending queue, decrement nr_in_flight of its pwq and handle workqueue flushing.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubh)}(h**NOTE**h]j)}(hjyh]hNOTE}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubh)}(hFor unbound workqueues, this function may temporarily drop **pwq->pool->lock** and thus should be called after all other state updates for the in-flight work item is complete.h](h;For unbound workqueues, this function may temporarily drop }(hjyhhhNhNubj)}(h**pwq->pool->lock**h]hpwq->pool->lock}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubha and thus should be called after all other state updates for the in-flight work item is complete.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubh)}(h **Context**h]j)}(hj"zh]hContext}(hj$zhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj zubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hj8zhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj)yubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j try_to_grab_pending (C function)c.try_to_grab_pendinghNtauh1jhjhhhNhNubj)}(hhh](j)}(hXint try_to_grab_pending (struct work_struct *work, u32 cflags, unsigned long *irq_flags)h]j)}(hWint try_to_grab_pending(struct work_struct *work, u32 cflags, unsigned long *irq_flags)h](j)}(hinth]hint}(hjgzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjczhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=ubj)}(h h]h }(hjvzhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjczhhhjuzhM=ubj)}(htry_to_grab_pendingh]j)}(htry_to_grab_pendingh]htry_to_grab_pending}(hjzhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjzubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjczhhhjuzhM=ubj|)}(h@(struct work_struct *work, u32 cflags, unsigned long *irq_flags)h](j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubj)}(h h]h }(hjzhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjzubh)}(hhh]j)}(h work_structh]h work_struct}(hjzhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjzmodnameN classnameNj7j:)}j=]j@)}j3jzsbc.try_to_grab_pendingasbuh1hhjzubj)}(h h]h }(hjzhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjzubjU)}(hjuh]h*}(hjzhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjzubj)}(hworkh]hwork}(hjzhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjzubj)}(h u32 cflagsh](h)}(hhh]j)}(hu32h]hu32}(hj{hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj{modnameN classnameNj7j:)}j=]jzc.try_to_grab_pendingasbuh1hhj{ubj)}(h h]h }(hj7{hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj{ubj)}(hcflagsh]hcflags}(hjE{hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjzubj)}(hunsigned long *irq_flagsh](j)}(hunsignedh]hunsigned}(hj^{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ{ubj)}(h h]h }(hjl{hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjZ{ubj)}(hlongh]hlong}(hjz{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZ{ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjZ{ubjU)}(hjuh]h*}(hj{hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjZ{ubj)}(h irq_flagsh]h irq_flags}(hj{hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjZ{ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjzubeh}(h]h ]h"]h$]h&]jjuh1j{hjczhhhjuzhM=ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj_zhhhjuzhM=ubah}(h]jZzah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjuzhM=hj\zhhubjC)}(hhh]h)}(h-steal work item from worklist and disable irqh]h-steal work item from worklist and disable irq}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=hj{hhubah}(h]h ]h"]h$]h&]uh1jBhj\zhhhjuzhM=ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej{jfj{jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` work item to steal ``u32 cflags`` ``WORK_CANCEL_`` flags ``unsigned long *irq_flags`` place to store irq state **Description** Try to grab PENDING bit of **work**. This function can handle **work** in any stable state - idle, on timer or on worklist. ======== ================================================================ 1 if **work** was pending and we successfully stole PENDING 0 if **work** was idle and we claimed PENDING -EAGAIN if PENDING couldn't be grabbed at the moment, safe to busy-retry ======== ================================================================ **Note** On >= 0 return, the caller owns **work**'s PENDING bit. To avoid getting interrupted while holding PENDING and **work** off queue, irq must be disabled on entry. This, combined with delayed_work->timer being irqsafe, ensures that we return -EAGAIN for finite short period of time. On successful return, >= 0, irq is disabled and the caller is responsible for releasing it using local_irq_restore(***irq_flags**). This function is safe to call from any context including IRQ handler.h](h)}(h**Parameters**h]j)}(hj{h]h Parameters}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhj{ubjg)}(hhh](jl)}(h0``struct work_struct *work`` work item to steal h](jr)}(h``struct work_struct *work``h]j)}(hj|h]hstruct work_struct *work}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj |ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM>hj|ubj)}(hhh]h)}(hwork item to stealh]hwork item to steal}(hj'|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#|hM>hj$|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jkhj#|hM>hj|ubjl)}(h&``u32 cflags`` ``WORK_CANCEL_`` flags h](jr)}(h``u32 cflags``h]j)}(hjG|h]h u32 cflags}(hjI|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE|ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM?hjA|ubj)}(hhh]h)}(h``WORK_CANCEL_`` flagsh](j)}(h``WORK_CANCEL_``h]h WORK_CANCEL_}(hjd|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`|ubh flags}(hj`|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj\|hM?hj]|ubah}(h]h ]h"]h$]h&]uh1jhjA|ubeh}(h]h ]h"]h$]h&]uh1jkhj\|hM?hj|ubjl)}(h6``unsigned long *irq_flags`` place to store irq state h](jr)}(h``unsigned long *irq_flags``h]j)}(hj|h]hunsigned long *irq_flags}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM@hj|ubj)}(hhh]h)}(hplace to store irq stateh]hplace to store irq state}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hM@hj|ubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jkhj|hM@hj|ubeh}(h]h ]h"]h$]h&]uh1jfhj{ubh)}(h**Description**h]j)}(hj|h]h Description}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMBhj{ubh)}(h|Try to grab PENDING bit of **work**. This function can handle **work** in any stable state - idle, on timer or on worklist.h](hTry to grab PENDING bit of }(hj|hhhNhNubj)}(h**work**h]hwork}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh. This function can handle }(hj|hhhNhNubj)}(h**work**h]hwork}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh5 in any stable state - idle, on timer or on worklist.}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMAhj{ubj)}(hXe======== ================================================================ 1 if **work** was pending and we successfully stole PENDING 0 if **work** was idle and we claimed PENDING -EAGAIN if PENDING couldn't be grabbed at the moment, safe to busy-retry ======== ================================================================ h]jm )}(hhh]jr )}(hhh](jw )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jv hj}ubjw )}(hhh]h}(h]h ]h"]h$]h&]colwidthK@uh1jv hj}ubj )}(hhh](j )}(hhh](j )}(hhh]h)}(h1h]h1}(hj9}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMFhj6}ubah}(h]h ]h"]h$]h&]uh1j hj3}ubj )}(hhh]h)}(h9if **work** was pending and we successfully stole PENDINGh](hif }(hjQ}hhhNhNubj)}(h**work**h]hwork}(hjY}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ}ubh. was pending and we successfully stole PENDING}(hjQ}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjG}hMFhjN}ubah}(h]h ]h"]h$]h&]uh1j hj3}ubeh}(h]h ]h"]h$]h&]uh1j hj0}ubj )}(hhh](j )}(hhh]h)}(h0h]h0}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMGhj}ubah}(h]h ]h"]h$]h&]uh1j hj}}ubj )}(hhh]h)}(h+if **work** was idle and we claimed PENDINGh](hif }(hj}hhhNhNubj)}(h**work**h]hwork}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubh was idle and we claimed PENDING}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj}hMGhj}ubah}(h]h ]h"]h$]h&]uh1j hj}}ubeh}(h]h ]h"]h$]h&]uh1j hj0}ubj )}(hhh](j )}(hhh]h)}(h-EAGAINh]h-EAGAIN}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMHhj}ubah}(h]h ]h"]h$]h&]uh1j hj}ubj )}(hhh]h)}(h@if PENDING couldn't be grabbed at the moment, safe to busy-retryh]hBif PENDING couldn’t be grabbed at the moment, safe to busy-retry}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hMHhj}ubah}(h]h ]h"]h$]h&]uh1j hj}ubeh}(h]h ]h"]h$]h&]uh1j hj0}ubeh}(h]h ]h"]h$]h&]uh1j hj}ubeh}(h]h ]h"]h$]h&]colsKuh1jq hj}ubah}(h]h ]h"]h$]h&]uh1jl hj}ubah}(h]h ]h"]h$]h&]uh1jhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMEhj{ubh)}(h**Note**h]j)}(hj~h]hNote}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMKhj{ubh)}(hXOn >= 0 return, the caller owns **work**'s PENDING bit. To avoid getting interrupted while holding PENDING and **work** off queue, irq must be disabled on entry. This, combined with delayed_work->timer being irqsafe, ensures that we return -EAGAIN for finite short period of time.h](h On >= 0 return, the caller owns }(hj1~hhhNhNubj)}(h**work**h]hwork}(hj9~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1~ubhJ’s PENDING bit. To avoid getting interrupted while holding PENDING and }(hj1~hhhNhNubj)}(h**work**h]hwork}(hjK~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1~ubh off queue, irq must be disabled on entry. This, combined with delayed_work->timer being irqsafe, ensures that we return -EAGAIN for finite short period of time.}(hj1~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMMhj{ubh)}(hOn successful return, >= 0, irq is disabled and the caller is responsible for releasing it using local_irq_restore(***irq_flags**).h](hsOn successful return, >= 0, irq is disabled and the caller is responsible for releasing it using local_irq_restore(}(hjd~hhhNhNubj)}(h***irq_flags**h]h *irq_flags}(hjl~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd~ubh).}(hjd~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMRhj{ubh)}(hEThis function is safe to call from any context including IRQ handler.h]hEThis function is safe to call from any context including IRQ handler.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMUhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwork_grab_pending (C function)c.work_grab_pendinghNtauh1jhjhhhNhNubj)}(hhh](j)}(hWbool work_grab_pending (struct work_struct *work, u32 cflags, unsigned long *irq_flags)h]j)}(hVbool work_grab_pending(struct work_struct *work, u32 cflags, unsigned long *irq_flags)h](j)}(hj*h]hbool}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj~hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj~hhhj~hMubj)}(hwork_grab_pendingh]j)}(hwork_grab_pendingh]hwork_grab_pending}(hj~hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj~ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj~hhhj~hMubj|)}(h@(struct work_struct *work, u32 cflags, unsigned long *irq_flags)h](j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubj)}(h h]h }(hj~hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj~ubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3j~sbc.work_grab_pendingasbuh1hhj~ubj)}(h h]h }(hj.hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj~ubjU)}(hjuh]h*}(hj<hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj~ubj)}(hworkh]hwork}(hjIhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj~ubj)}(h u32 cflagsh](h)}(hhh]j)}(hu32h]hu32}(hjehhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjgmodnameN classnameNj7j:)}j=]j*c.work_grab_pendingasbuh1hhj^ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj^ubj)}(hcflagsh]hcflags}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj~ubj)}(hunsigned long *irq_flagsh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(h irq_flagsh]h irq_flags}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj~ubeh}(h]h ]h"]h$]h&]jjuh1j{hj~hhhj~hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj~hhhj~hMubah}(h]j~ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj~hMhj~hhubjC)}(hhh]h)}(h-steal work item from worklist and disable irqh]h-steal work item from worklist and disable irq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhj~hhhj~hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej1jfj1jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` work item to steal ``u32 cflags`` ``WORK_CANCEL_`` flags ``unsigned long *irq_flags`` place to store IRQ state **Description** Grab PENDING bit of **work**. **work** can be in any stable state - idle, on timer or on worklist. Can be called from any context. IRQ is disabled on return with IRQ state stored in ***irq_flags**. The caller is responsible for re-enabling it using local_irq_restore(). Returns ``true`` if **work** was pending. ``false`` if idle.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj5ubjg)}(hhh](jl)}(h0``struct work_struct *work`` work item to steal h](jr)}(h``struct work_struct *work``h]j)}(hjZh]hstruct work_struct *work}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubj)}(hhh]h)}(hwork item to stealh]hwork item to steal}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohMhjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jkhjohMhjQubjl)}(h&``u32 cflags`` ``WORK_CANCEL_`` flags h](jr)}(h``u32 cflags``h]j)}(hjh]h u32 cflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h``WORK_CANCEL_`` flagsh](j)}(h``WORK_CANCEL_``h]h WORK_CANCEL_}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh flags}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjQubjl)}(h6``unsigned long *irq_flags`` place to store IRQ state h](jr)}(h``unsigned long *irq_flags``h]j)}(hjڀh]hunsigned long *irq_flags}(hj܀hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj؀ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjԀubj)}(hhh]h)}(hplace to store IRQ stateh]hplace to store IRQ state}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjԀubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjQubeh}(h]h ]h"]h$]h&]uh1jfhj5ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj5ubh)}(hbGrab PENDING bit of **work**. **work** can be in any stable state - idle, on timer or on worklist.h](hGrab PENDING bit of }(hj+hhhNhNubj)}(h**work**h]hwork}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh. }(hj+hhhNhNubj)}(h**work**h]hwork}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh< can be in any stable state - idle, on timer or on worklist.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj5ubh)}(hCan be called from any context. IRQ is disabled on return with IRQ state stored in ***irq_flags**. The caller is responsible for re-enabling it using local_irq_restore().h](hSCan be called from any context. IRQ is disabled on return with IRQ state stored in }(hj^hhhNhNubj)}(h***irq_flags**h]h *irq_flags}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubhI. The caller is responsible for re-enabling it using local_irq_restore().}(hj^hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj5ubh)}(hlock).h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h7``struct pool_workqueue *pwq`` pwq **work** belongs to h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjh]hstruct pool_workqueue *pwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hpwq **work** belongs toh](hpwq }(hj/hhhNhNubj)}(h**work**h]hwork}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubh belongs to}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj+hMhj,ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj+hMhj ubjl)}(h,``struct work_struct *work`` work to insert h](jr)}(h``struct work_struct *work``h]j)}(hjah]hstruct work_struct *work}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj[ubj)}(hhh]h)}(hwork to inserth]hwork to insert}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jkhjvhMhj ubjl)}(h+``struct list_head *head`` insertion point h](jr)}(h``struct list_head *head``h]j)}(hjh]hstruct list_head *head}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hinsertion pointh]hinsertion point}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhj ubjl)}(h>``unsigned int extra_flags`` extra WORK_STRUCT_* flags to set h](jr)}(h``unsigned int extra_flags``h]j)}(hjӄh]hunsigned int extra_flags}(hjՄhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjфubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj̈́ubj)}(hhh]h)}(h extra WORK_STRUCT_* flags to seth]h extra WORK_STRUCT_* flags to set}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj̈́ubeh}(h]h ]h"]h$]h&]uh1jkhjhMhj ubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hgInsert **work** which belongs to **pwq** after **head**. **extra_flags** is or'd to work_struct flags.h](hInsert }(hj$hhhNhNubj)}(h**work**h]hwork}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh which belongs to }(hj$hhhNhNubj)}(h**pwq**h]hpwq}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh after }(hj$hhhNhNubj)}(h**head**h]hhead}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh. }(hj$hhhNhNubj)}(h**extra_flags**h]h extra_flags}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh is or’d to work_struct flags.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.czhMhjubh)}(h **Context**h]j)}(hj}h]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jqueue_work_on (C function)c.queue_work_onhNtauh1jhjhhhNhNubj)}(hhh](j)}(hSbool queue_work_on (int cpu, struct workqueue_struct *wq, struct work_struct *work)h]j)}(hRbool queue_work_on(int cpu, struct workqueue_struct *wq, struct work_struct *work)h](j)}(hj*h]hbool}(hj…hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjЅhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjυhM ubj)}(h queue_work_onh]j)}(h queue_work_onh]h queue_work_on}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjޅubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjυhM ubj|)}(h@(int cpu, struct workqueue_struct *wq, struct work_struct *work)h](j)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjQhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjSmodnameN classnameNj7j:)}j=]j@)}j3jsbc.queue_work_onasbuh1hhj/ubj)}(h h]h }(hjqhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj/ubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjÆhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjņmodnameN classnameNj7j:)}j=]jmc.queue_work_onasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjυhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjυhM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjυhM hjhhubjC)}(hhh]h)}(hqueue work on specific cpuh]hqueue work on specific cpu}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj#hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjυhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej>jfj>jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` CPU number to execute work on ``struct workqueue_struct *wq`` workqueue to use ``struct work_struct *work`` work to queue **Description** We queue the work to a specific CPU, the caller must ensure it can't go away. Callers that fail to ensure that the specified CPU cannot go away will execute on a randomly chosen CPU. But note well that callers specifying a CPU that never has been online will get a splat. **Return** ``false`` if **work** was already on a queue, ``true`` otherwise.h](h)}(h**Parameters**h]j)}(hjHh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjBubjg)}(hhh](jl)}(h*``int cpu`` CPU number to execute work on h](jr)}(h ``int cpu``h]j)}(hjgh]hint cpu}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjaubj)}(hhh]h)}(hCPU number to execute work onh]hCPU number to execute work on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hM hj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jkhj|hM hj^ubjl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hj^ubjl)}(h+``struct work_struct *work`` work to queue h](jr)}(h``struct work_struct *work``h]j)}(hjهh]hstruct work_struct *work}(hjۇhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjׇubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjӇubj)}(hhh]h)}(h work to queueh]h work to queue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjӇubeh}(h]h ]h"]h$]h&]uh1jkhjhM hj^ubeh}(h]h ]h"]h$]h&]uh1jfhjBubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjBubh)}(hXWe queue the work to a specific CPU, the caller must ensure it can't go away. Callers that fail to ensure that the specified CPU cannot go away will execute on a randomly chosen CPU. But note well that callers specifying a CPU that never has been online will get a splat.h]hXWe queue the work to a specific CPU, the caller must ensure it can’t go away. Callers that fail to ensure that the specified CPU cannot go away will execute on a randomly chosen CPU. But note well that callers specifying a CPU that never has been online will get a splat.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjBubh)}(h **Return**h]j)}(hj;h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjBubh)}(hA``false`` if **work** was already on a queue, ``true`` otherwise.h](j)}(h ``false``h]hfalse}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh if }(hjQhhhNhNubj)}(h**work**h]hwork}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh was already on a queue, }(hjQhhhNhNubj)}(h``true``h]htrue}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubh otherwise.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjBubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!select_numa_node_cpu (C function)c.select_numa_node_cpuhNtauh1jhjhhhNhNubj)}(hhh](j)}(h#int select_numa_node_cpu (int node)h]j)}(h"int select_numa_node_cpu(int node)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM ubj)}(hselect_numa_node_cpuh]j)}(hselect_numa_node_cpuh]hselect_numa_node_cpu}(hjӈhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjψubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM ubj|)}(h (int node)h]j)}(hint nodeh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hnodeh]hnode}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjhhubjC)}(hhh]h)}(hSelect a CPU based on NUMA nodeh]hSelect a CPU based on NUMA node}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj2hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejMjfjMjgjhjiuh1jhhhjhNhNubjk)}(hX\**Parameters** ``int node`` NUMA node ID that we want to select a CPU from **Description** This function will attempt to find a "random" cpu available on a given node. If there are no CPUs available on the given node it will return WORK_CPU_UNBOUND indicating that we should just schedule to any available CPU if we need to schedule this work.h](h)}(h**Parameters**h]j)}(hjWh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubjg)}(hhh]jl)}(h<``int node`` NUMA node ID that we want to select a CPU from h](jr)}(h ``int node``h]j)}(hjvh]hint node}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjpubj)}(hhh]h)}(h.NUMA node ID that we want to select a CPU fromh]h.NUMA node ID that we want to select a CPU from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjmubah}(h]h ]h"]h$]h&]uh1jfhjQubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubh)}(hThis function will attempt to find a "random" cpu available on a given node. If there are no CPUs available on the given node it will return WORK_CPU_UNBOUND indicating that we should just schedule to any available CPU if we need to schedule this work.h]hXThis function will attempt to find a “random” cpu available on a given node. If there are no CPUs available on the given node it will return WORK_CPU_UNBOUND indicating that we should just schedule to any available CPU if we need to schedule this work.}(hjljhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jqueue_work_node (C function)c.queue_work_nodehNtauh1jhjhhhNhNubj)}(hhh](j)}(hVbool queue_work_node (int node, struct workqueue_struct *wq, struct work_struct *work)h]j)}(hUbool queue_work_node(int node, struct workqueue_struct *wq, struct work_struct *work)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM ubj)}(hqueue_work_nodeh]j)}(hqueue_work_nodeh]hqueue_work_node}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM ubj|)}(hA(int node, struct workqueue_struct *wq, struct work_struct *work)h](j)}(hint nodeh](j)}(hinth]hint}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj.ubj)}(hnodeh]hnode}(hjNhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj*ubj)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubj)}(h h]h }(hjthhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjcubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.queue_work_nodeasbuh1hhjcubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjcubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjcubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj*ubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjيhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjՊubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjՊubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.queue_work_nodeasbuh1hhjՊubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjՊubjU)}(hjuh]h*}(hj#hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjՊubj)}(hworkh]hwork}(hj0hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjՊubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj*ubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjhhubjC)}(hhh]h)}(h2queue work on a "random" cpu for a given NUMA nodeh]h6queue work on a “random” cpu for a given NUMA node}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjWhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejrjfjrjgjhjiuh1jhhhjhNhNubjk)}(hXH**Parameters** ``int node`` NUMA node that we are targeting the work for ``struct workqueue_struct *wq`` workqueue to use ``struct work_struct *work`` work to queue **Description** We queue the work to a "random" CPU within a given NUMA node. The basic idea here is to provide a way to somehow associate work with a given NUMA node. This function will only make a best effort attempt at getting this onto the right NUMA node. If no node is requested or the requested node is offline then we just fall back to standard queue_work behavior. Currently the "random" CPU ends up being the first available CPU in the intersection of cpu_online_mask and the cpumask of the node, unless we are running on the node. In that case we just use the current CPU. **Return** ``false`` if **work** was already on a queue, ``true`` otherwise.h](h)}(h**Parameters**h]j)}(hj|h]h Parameters}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubjg)}(hhh](jl)}(h:``int node`` NUMA node that we are targeting the work for h](jr)}(h ``int node``h]j)}(hjh]hint node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h,NUMA node that we are targeting the work forh]h,NUMA node that we are targeting the work for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjubjl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjԋh]hstruct workqueue_struct *wq}(hj֋hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjҋubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj΋ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj΋ubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjubjl)}(h+``struct work_struct *work`` work to queue h](jr)}(h``struct work_struct *work``h]j)}(hj h]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h work to queueh]h work to queue}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hM hj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj"hM hjubeh}(h]h ]h"]h$]h&]uh1jfhjvubh)}(h**Description**h]j)}(hjHh]h Description}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubh)}(hWe queue the work to a "random" CPU within a given NUMA node. The basic idea here is to provide a way to somehow associate work with a given NUMA node.h]hWe queue the work to a “random” CPU within a given NUMA node. The basic idea here is to provide a way to somehow associate work with a given NUMA node.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubh)}(hThis function will only make a best effort attempt at getting this onto the right NUMA node. If no node is requested or the requested node is offline then we just fall back to standard queue_work behavior.h]hThis function will only make a best effort attempt at getting this onto the right NUMA node. If no node is requested or the requested node is offline then we just fall back to standard queue_work behavior.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubh)}(hCurrently the "random" CPU ends up being the first available CPU in the intersection of cpu_online_mask and the cpumask of the node, unless we are running on the node. In that case we just use the current CPU.h]hCurrently the “random” CPU ends up being the first available CPU in the intersection of cpu_online_mask and the cpumask of the node, unless we are running on the node. In that case we just use the current CPU.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubh)}(hA``false`` if **work** was already on a queue, ``true`` otherwise.h](j)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was already on a queue, }(hjhhhNhNubj)}(h``true``h]htrue}(hjˌhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"queue_delayed_work_on (C function)c.queue_delayed_work_onhNtauh1jhjhhhNhNubj)}(hhh](j)}(hrbool queue_delayed_work_on (int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h]j)}(hqbool queue_delayed_work_on(int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQ ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMQ ubj)}(hqueue_delayed_work_onh]j)}(hqueue_delayed_work_onh]hqueue_delayed_work_on}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMQ ubj|)}(hW(int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hint cpuh](j)}(hinth]hint}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj<ubj)}(hcpuh]hcpu}(hj\hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj8ubj)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjqubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3j&sbc.queue_delayed_work_onasbuh1hhjqubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjqubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjqubj)}(hwqh]hwq}(hj΍hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj8ubj)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.queue_delayed_work_onasbuh1hhjubj)}(h h]h }(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj1hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hj>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj8ubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjehhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjSubj)}(hlongh]hlong}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjSubj)}(hdelayh]hdelay}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj8ubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMQ ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMQ ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMQ hjhhubjC)}(hhh]h)}(h&queue work on specific CPU after delayh]h&queue work on specific CPU after delay}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQ hjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMQ ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejюjfjюjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` CPU number to execute work on ``struct workqueue_struct *wq`` workqueue to use ``struct delayed_work *dwork`` work to queue ``unsigned long delay`` number of jiffies to wait before queueing **Description** We queue the delayed_work to a specific CPU, for non-zero delays the caller must ensure it is online and can't go away. Callers that fail to ensure this, may get **dwork->timer** queued to an offlined CPU and this will prevent queueing of **dwork->work** unless the offlined CPU becomes online again. **Return** ``false`` if **work** was already on a queue, ``true`` otherwise. If **delay** is zero and **dwork** is idle, it will be scheduled for immediate execution.h](h)}(h**Parameters**h]j)}(hjێh]h Parameters}(hjݎhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjَubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMU hjՎubjg)}(hhh](jl)}(h*``int cpu`` CPU number to execute work on h](jr)}(h ``int cpu``h]j)}(hjh]hint cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMR hjubj)}(hhh]h)}(hCPU number to execute work onh]hCPU number to execute work on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMR hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMR hjubjl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj3h]hstruct workqueue_struct *wq}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMS hj-ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMS hjIubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jkhjHhMS hjubjl)}(h-``struct delayed_work *dwork`` work to queue h](jr)}(h``struct delayed_work *dwork``h]j)}(hjlh]hstruct delayed_work *dwork}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMT hjfubj)}(hhh]h)}(h work to queueh]h work to queue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMT hjubah}(h]h ]h"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]uh1jkhjhMT hjubjl)}(hB``unsigned long delay`` number of jiffies to wait before queueing h](jr)}(h``unsigned long delay``h]j)}(hjh]hunsigned long delay}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMU hjubj)}(hhh]h)}(h)number of jiffies to wait before queueingh]h)number of jiffies to wait before queueing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMU hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMU hjubeh}(h]h ]h"]h$]h&]uh1jfhjՎubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjޏubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMW hjՎubh)}(hX,We queue the delayed_work to a specific CPU, for non-zero delays the caller must ensure it is online and can't go away. Callers that fail to ensure this, may get **dwork->timer** queued to an offlined CPU and this will prevent queueing of **dwork->work** unless the offlined CPU becomes online again.h](hWe queue the delayed_work to a specific CPU, for non-zero delays the caller must ensure it is online and can’t go away. Callers that fail to ensure this, may get }(hjhhhNhNubj)}(h**dwork->timer**h]h dwork->timer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh= queued to an offlined CPU and this will prevent queueing of }(hjhhhNhNubj)}(h**dwork->work**h]h dwork->work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. unless the offlined CPU becomes online again.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMV hjՎubh)}(h **Return**h]j)}(hj+h]hReturn}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM\ hjՎubh)}(h``false`` if **work** was already on a queue, ``true`` otherwise. If **delay** is zero and **dwork** is idle, it will be scheduled for immediate execution.h](j)}(h ``false``h]hfalse}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh if }(hjAhhhNhNubj)}(h**work**h]hwork}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh was already on a queue, }(hjAhhhNhNubj)}(h``true``h]htrue}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh otherwise. If }(hjAhhhNhNubj)}(h **delay**h]hdelay}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh is zero and }(hjAhhhNhNubj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubh7 is idle, it will be scheduled for immediate execution.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM] hjՎubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j mod_delayed_work_on (C function)c.mod_delayed_work_onhNtauh1jhjhhhNhNubj)}(hhh](j)}(hpbool mod_delayed_work_on (int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h]j)}(hobool mod_delayed_work_on(int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hj*h]hbool}(hjƐhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMw ubj)}(h h]h }(hjԐhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjӐhMw ubj)}(hmod_delayed_work_onh]j)}(hmod_delayed_work_onh]hmod_delayed_work_on}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjӐhMw ubj|)}(hW(int cpu, struct workqueue_struct *wq, struct delayed_work *dwork, unsigned long delay)h](j)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(h h]h }(hjDhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjUhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjWmodnameN classnameNj7j:)}j=]j@)}j3jsbc.mod_delayed_work_onasbuh1hhj3ubj)}(h h]h }(hjuhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj3ubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjǑhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjđubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjɑmodnameN classnameNj7j:)}j=]jqc.mod_delayed_work_onasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hunsigned long delayh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj'hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hlongh]hlong}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjChhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hdelayh]hdelay}(hjQhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjӐhMw ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjӐhMw ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjӐhMw hjhhubjC)}(hhh]h)}(h7modify delay of or queue a delayed work on specific CPUh]h7modify delay of or queue a delayed work on specific CPU}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMw hjxhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjӐhMw ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` CPU number to execute work on ``struct workqueue_struct *wq`` workqueue to use ``struct delayed_work *dwork`` work to queue ``unsigned long delay`` number of jiffies to wait before queueing **Description** If **dwork** is idle, equivalent to queue_delayed_work_on(); otherwise, modify **dwork**'s timer so that it expires after **delay**. If **delay** is zero, **work** is guaranteed to be scheduled immediately regardless of its current state. This function is safe to call from any context including IRQ handler. See try_to_grab_pending() for details. **Return** ``false`` if **dwork** was idle and queued, ``true`` if **dwork** was pending and its timer was modified.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM{ hjubjg)}(hhh](jl)}(h*``int cpu`` CPU number to execute work on h](jr)}(h ``int cpu``h]j)}(hjh]hint cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMx hjubj)}(hhh]h)}(hCPU number to execute work onh]hCPU number to execute work on}(hjՒhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjђhMx hjҒubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjђhMx hjubjl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMy hjubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMy hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj hMy hjubjl)}(h-``struct delayed_work *dwork`` work to queue h](jr)}(h``struct delayed_work *dwork``h]j)}(hj.h]hstruct delayed_work *dwork}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMz hj(ubj)}(hhh]h)}(h work to queueh]h work to queue}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChMz hjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jkhjChMz hjubjl)}(hB``unsigned long delay`` number of jiffies to wait before queueing h](jr)}(h``unsigned long delay``h]j)}(hjgh]hunsigned long delay}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM{ hjaubj)}(hhh]h)}(h)number of jiffies to wait before queueingh]h)number of jiffies to wait before queueing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hM{ hj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jkhj|hM{ hjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM} hjubh)}(hIf **dwork** is idle, equivalent to queue_delayed_work_on(); otherwise, modify **dwork**'s timer so that it expires after **delay**. If **delay** is zero, **work** is guaranteed to be scheduled immediately regardless of its current state.h](hIf }(hjhhhNhNubj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhC is idle, equivalent to queue_delayed_work_on(); otherwise, modify }(hjhhhNhNubj)}(h **dwork**h]hdwork}(hjғhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh$’s timer so that it expires after }(hjhhhNhNubj)}(h **delay**h]hdelay}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If }(hjhhhNhNubj)}(h **delay**h]hdelay}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is zero, }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhK is guaranteed to be scheduled immediately regardless of its current state.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM| hjubh)}(hlThis function is safe to call from any context including IRQ handler. See try_to_grab_pending() for details.h]hlThis function is safe to call from any context including IRQ handler. See try_to_grab_pending() for details.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h **Return**h]j)}(hj2h]hReturn}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hi``false`` if **dwork** was idle and queued, ``true`` if **dwork** was pending and its timer was modified.h](j)}(h ``false``h]hfalse}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh if }(hjHhhhNhNubj)}(h **dwork**h]hdwork}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh was idle and queued, }(hjHhhhNhNubj)}(h``true``h]htrue}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh if }hjHsbj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh( was pending and its timer was modified.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jqueue_rcu_work (C function)c.queue_rcu_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hIbool queue_rcu_work (struct workqueue_struct *wq, struct rcu_work *rwork)h]j)}(hHbool queue_rcu_work(struct workqueue_struct *wq, struct rcu_work *rwork)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjɔhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjȔhM ubj)}(hqueue_rcu_workh]j)}(hqueue_rcu_workh]hqueue_rcu_work}(hj۔hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjהubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjȔhM ubj|)}(h5(struct workqueue_struct *wq, struct rcu_work *rwork)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jݔsbc.queue_rcu_workasbuh1hhjubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjChhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjPhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct rcu_work *rworkh](j)}(hjh]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubh)}(hhh]j)}(hrcu_workh]hrcu_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j1c.queue_rcu_workasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjeubj)}(hrworkh]hrwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjȔhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjȔhM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjȔhM hjhhubjC)}(hhh]h)}(h#queue work after a RCU grace periodh]h#queue work after a RCU grace period}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjȔhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` workqueue to use ``struct rcu_work *rwork`` work to queue **Return** ``false`` if **rwork** was already pending, ``true`` otherwise. Note that a full RCU grace period is guaranteed only after a ``true`` return. While **rwork** is guaranteed to be executed after a ``false`` return, the execution may happen before a full RCU grace period has passed.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh](jl)}(h1``struct workqueue_struct *wq`` workqueue to use h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj+h]hstruct workqueue_struct *wq}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj%ubj)}(hhh]h)}(hworkqueue to useh]hworkqueue to use}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hM hjAubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jkhj@hM hj"ubjl)}(h)``struct rcu_work *rwork`` work to queue h](jr)}(h``struct rcu_work *rwork``h]j)}(hjdh]hstruct rcu_work *rwork}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj^ubj)}(hhh]h)}(h work to queueh]h work to queue}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhM hjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jkhjyhM hj"ubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hX``false`` if **rwork** was already pending, ``true`` otherwise. Note that a full RCU grace period is guaranteed only after a ``true`` return. While **rwork** is guaranteed to be executed after a ``false`` return, the execution may happen before a full RCU grace period has passed.h](j)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h **rwork**h]hrwork}(hj˖hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was already pending, }(hjhhhNhNubj)}(h``true``h]htrue}(hjݖhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhJ otherwise. Note that a full RCU grace period is guaranteed only after a }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh return. While }(hjhhhNhNubj)}(h **rwork**h]hrwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh& is guaranteed to be executed after a }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhL return, the execution may happen before a full RCU grace period has passed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"worker_attach_to_pool (C function)c.worker_attach_to_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(hLvoid worker_attach_to_pool (struct worker *worker, struct worker_pool *pool)h]j)}(hKvoid worker_attach_to_pool(struct worker *worker, struct worker_pool *pool)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHhhhjZhM ubj)}(hworker_attach_to_poolh]j)}(hworker_attach_to_poolh]hworker_attach_to_pool}(hjmhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjiubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjHhhhjZhM ubj|)}(h1(struct worker *worker, struct worker_pool *pool)h](j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3josbc.worker_attach_to_poolasbuh1hhjubj)}(h h]h }(hjǗhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj՗hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j×c.worker_attach_to_poolasbuh1hhjubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjEhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hjRhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjHhhhjZhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjDhhhjZhM ubah}(h]j?ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjZhM hjAhhubjC)}(hhh]h)}(hattach a worker to a poolh]hattach a worker to a pool}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjyhhubah}(h]h ]h"]h$]h&]uh1jBhjAhhhjZhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX(**Parameters** ``struct worker *worker`` worker to be attached ``struct worker_pool *pool`` the target pool **Description** Attach **worker** to **pool**. Once attached, the ``WORKER_UNBOUND`` flag and cpu-binding of **worker** are kept coordinated with the pool across cpu-[un]hotplugs.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh](jl)}(h0``struct worker *worker`` worker to be attached h](jr)}(h``struct worker *worker``h]j)}(hjh]hstruct worker *worker}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(hworker to be attachedh]hworker to be attached}(hj֘hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjҘhM hjӘubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjҘhM hjubjl)}(h-``struct worker_pool *pool`` the target pool h](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(hthe target poolh]hthe target pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj hM hjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj1h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hAttach **worker** to **pool**. Once attached, the ``WORKER_UNBOUND`` flag and cpu-binding of **worker** are kept coordinated with the pool across cpu-[un]hotplugs.h](hAttach }(hjGhhhNhNubj)}(h **worker**h]hworker}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh to }(hjGhhhNhNubj)}(h**pool**h]hpool}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh. Once attached, the }(hjGhhhNhNubj)}(h``WORKER_UNBOUND``h]hWORKER_UNBOUND}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh flag and cpu-binding of }(hjGhhhNhNubj)}(h **worker**h]hworker}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh< are kept coordinated with the pool across cpu-[un]hotplugs.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$worker_detach_from_pool (C function)c.worker_detach_from_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void worker_detach_from_pool (struct worker *worker)h]j)}(h3void worker_detach_from_pool(struct worker *worker)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hj͙hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhj̙hM ubj)}(hworker_detach_from_poolh]j)}(hworker_detach_from_poolh]hworker_detach_from_pool}(hjߙhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjۙubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhj̙hM ubj|)}(h(struct worker *worker)h]j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.worker_detach_from_poolasbuh1hhjubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjGhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjThhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhj̙hM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhj̙hM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj̙hM hjhhubjC)}(hhh]h)}(hdetach a worker from its poolh]hdetach a worker from its pool}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj{hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj̙hM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct worker *worker`` worker which is attached to its pool **Description** Undo the attaching which had been done in worker_attach_to_pool(). The caller worker shouldn't access to the pool after detached except it has other reference to the pool.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh]jl)}(h?``struct worker *worker`` worker which is attached to its pool h](jr)}(h``struct worker *worker``h]j)}(hjh]hstruct worker *worker}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h$worker which is attached to its poolh]h$worker which is attached to its pool}(hjؚhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjԚhM hj՚ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjԚhM hjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hUndo the attaching which had been done in worker_attach_to_pool(). The caller worker shouldn't access to the pool after detached except it has other reference to the pool.h]hUndo the attaching which had been done in worker_attach_to_pool(). The caller worker shouldn’t access to the pool after detached except it has other reference to the pool.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcreate_worker (C function)c.create_workerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h8struct worker * create_worker (struct worker_pool *pool)h]j)}(h6struct worker *create_worker(struct worker_pool *pool)h](j)}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM: ubj)}(h h]h }(hjMhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;hhhjLhM: ubh)}(hhh]j)}(hworkerh]hworker}(hj^hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj`modnameN classnameNj7j:)}j=]j@)}j3 create_workersbc.create_workerasbuh1hhj;hhhjLhM: ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;hhhjLhM: ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj;hhhjLhM: ubj)}(h create_workerh]j)}(hj|h]h create_worker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj;hhhjLhM: ubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjƛhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjכhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjԛubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjٛmodnameN classnameNj7j:)}j=]jzc.create_workerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj;hhhjLhM: ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj7hhhjLhM: ubah}(h]j2ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjLhM: hj4hhubjC)}(hhh]h)}(hcreate a new workqueue workerh]hcreate a new workqueue worker}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM: hj7hhubah}(h]h ]h"]h$]h&]uh1jBhj4hhhjLhM: ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejRjfjRjgjhjiuh1jhhhjhNhNubjk)}(hX **Parameters** ``struct worker_pool *pool`` pool the new worker will belong to **Description** Create and start a new worker which is attached to **pool**. **Context** Might sleep. Does GFP_KERNEL allocations. **Return** Pointer to the newly created worker.h](h)}(h**Parameters**h]j)}(hj\h]h Parameters}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM> hjVubjg)}(hhh]jl)}(h@``struct worker_pool *pool`` pool the new worker will belong to h](jr)}(h``struct worker_pool *pool``h]j)}(hj{h]hstruct worker_pool *pool}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM; hjuubj)}(hhh]h)}(h"pool the new worker will belong toh]h"pool the new worker will belong to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM; hjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jkhjhM; hjrubah}(h]h ]h"]h$]h&]uh1jfhjVubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM= hjVubh)}(h hjVubh)}(h*Might sleep. Does GFP_KERNEL allocations.h]h*Might sleep. Does GFP_KERNEL allocations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM? hjVubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMA hjVubh)}(h$Pointer to the newly created worker.h]h$Pointer to the newly created worker.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMB hjVubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jset_worker_dying (C function)c.set_worker_dyinghNtauh1jhjhhhNhNubj)}(hhh](j)}(hEvoid set_worker_dying (struct worker *worker, struct list_head *list)h]j)}(hDvoid set_worker_dying(struct worker *worker, struct list_head *list)h](j)}(hvoidh]hvoid}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjWhhhjihM ubj)}(hset_worker_dyingh]j)}(hset_worker_dyingh]hset_worker_dying}(hj|hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjxubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjWhhhjihM ubj|)}(h/(struct worker *worker, struct list_head *list)h](j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3j~sbc.set_worker_dyingasbuh1hhjubj)}(h h]h }(hj֝hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct list_head *listh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h list_headh]h list_head}(hj(hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj*modnameN classnameNj7j:)}j=]jҝc.set_worker_dyingasbuh1hhjubj)}(h h]h }(hjFhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjThhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hlisth]hlist}(hjahhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjWhhhjihM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjShhhjihM ubah}(h]jNah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjihM hjPhhubjC)}(hhh]h)}(hTag a worker for destructionh]hTag a worker for destruction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjPhhhjihM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX=**Parameters** ``struct worker *worker`` worker to be destroyed ``struct list_head *list`` transfer worker away from its pool->idle_list and into list **Description** Tag **worker** for destruction and adjust **pool** stats accordingly. The worker should be idle. **Context** raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh](jl)}(h1``struct worker *worker`` worker to be destroyed h](jr)}(h``struct worker *worker``h]j)}(hj̞h]hstruct worker *worker}(hjΞhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjʞubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjƞubj)}(hhh]h)}(hworker to be destroyedh]hworker to be destroyed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjƞubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjÞubjl)}(hW``struct list_head *list`` transfer worker away from its pool->idle_list and into list h](jr)}(h``struct list_head *list``h]j)}(hjh]hstruct list_head *list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h;transfer worker away from its pool->idle_list and into listh]h;transfer worker away from its pool->idle_list and into list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjÞubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj@h]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(haTag **worker** for destruction and adjust **pool** stats accordingly. The worker should be idle.h](hTag }(hjVhhhNhNubj)}(h **worker**h]hworker}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubh for destruction and adjust }(hjVhhhNhNubj)}(h**pool**h]hpool}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubh/ stats accordingly. The worker should be idle.}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j idle_worker_timeout (C function)c.idle_worker_timeouthNtauh1jhjhhhNhNubj)}(hhh](j)}(h/void idle_worker_timeout (struct timer_list *t)h]j)}(h.void idle_worker_timeout(struct timer_list *t)h](j)}(hvoidh]hvoid}(hjПhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̟hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjߟhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj̟hhhjޟhM ubj)}(hidle_worker_timeouth]j)}(hidle_worker_timeouth]hidle_worker_timeout}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj̟hhhjޟhM ubj|)}(h(struct timer_list *t)h]j)}(hstruct timer_list *th](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h timer_listh]h timer_list}(hj+hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj-modnameN classnameNj7j:)}j=]j@)}j3jsbc.idle_worker_timeoutasbuh1hhj ubj)}(h h]h }(hjKhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjU)}(hjuh]h*}(hjYhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj ubj)}(hth]ht}(hjfhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj̟hhhjޟhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjȟhhhjޟhM ubah}(h]jßah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjޟhM hjşhhubjC)}(hhh]h)}(h.check if some idle workers can now be deleted.h]h.check if some idle workers can now be deleted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjşhhhjޟhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct timer_list *t`` The pool's idle_timer that just expired **Description** The timer is armed in worker_enter_idle(). Note that it isn't disarmed in worker_leave_idle(), as a worker flicking between idle and active while its pool is at the too_many_workers() tipping point would cause too much timer housekeeping overhead. Since IDLE_WORKER_TIMEOUT is long enough, we just let it expire and re-evaluate things from there.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh]jl)}(hA``struct timer_list *t`` The pool's idle_timer that just expired h](jr)}(h``struct timer_list *t``h]j)}(hjѠh]hstruct timer_list *t}(hjӠhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjϠubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjˠubj)}(hhh]h)}(h'The pool's idle_timer that just expiredh]h)The pool’s idle_timer that just expired}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjˠubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjȠubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hXZThe timer is armed in worker_enter_idle(). Note that it isn't disarmed in worker_leave_idle(), as a worker flicking between idle and active while its pool is at the too_many_workers() tipping point would cause too much timer housekeeping overhead. Since IDLE_WORKER_TIMEOUT is long enough, we just let it expire and re-evaluate things from there.h]hX\The timer is armed in worker_enter_idle(). Note that it isn’t disarmed in worker_leave_idle(), as a worker flicking between idle and active while its pool is at the too_many_workers() tipping point would cause too much timer housekeeping overhead. Since IDLE_WORKER_TIMEOUT is long enough, we just let it expire and re-evaluate things from there.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jidle_cull_fn (C function)c.idle_cull_fnhNtauh1jhjhhhNhNubj)}(hhh](j)}(h,void idle_cull_fn (struct work_struct *work)h]j)}(h+void idle_cull_fn(struct work_struct *work)h](j)}(hvoidh]hvoid}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMhhhj_hM ubj)}(h idle_cull_fnh]j)}(h idle_cull_fnh]h idle_cull_fn}(hjrhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjnubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjMhhhj_hM ubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jtsbc.idle_cull_fnasbuh1hhjubj)}(h h]h }(hj̡hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjڡhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjMhhhj_hM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjIhhhj_hM ubah}(h]jDah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj_hM hjFhhubjC)}(hhh]h)}(h.cull workers that have been idle for too long.h]h.cull workers that have been idle for too long.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjFhhhj_hM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej)jfj)jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` the pool's work for handling these idle workers **Description** This goes through a pool's idle workers and gets rid of those that have been idle for at least IDLE_WORKER_TIMEOUT seconds. We don't want to disturb isolated CPUs because of a pcpu kworker being culled, so this also resets worker affinity. This requires a sleepable context, hence the split between timer callback and work item.h](h)}(h**Parameters**h]j)}(hj3h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj-ubjg)}(hhh]jl)}(hM``struct work_struct *work`` the pool's work for handling these idle workers h](jr)}(h``struct work_struct *work``h]j)}(hjRh]hstruct work_struct *work}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjLubj)}(hhh]h)}(h/the pool's work for handling these idle workersh]h1the pool’s work for handling these idle workers}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghM hjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jkhjghM hjIubah}(h]h ]h"]h$]h&]uh1jfhj-ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj-ubh)}(h{This goes through a pool's idle workers and gets rid of those that have been idle for at least IDLE_WORKER_TIMEOUT seconds.h]h}This goes through a pool’s idle workers and gets rid of those that have been idle for at least IDLE_WORKER_TIMEOUT seconds.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj-ubh)}(hWe don't want to disturb isolated CPUs because of a pcpu kworker being culled, so this also resets worker affinity. This requires a sleepable context, hence the split between timer callback and work item.h]hWe don’t want to disturb isolated CPUs because of a pcpu kworker being culled, so this also resets worker affinity. This requires a sleepable context, hence the split between timer callback and work item.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j maybe_create_worker (C function)c.maybe_create_workerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h3void maybe_create_worker (struct worker_pool *pool)h]j)}(h2void maybe_create_worker(struct worker_pool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݢhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjݢhhhjhMM ubj)}(hmaybe_create_workerh]j)}(hmaybe_create_workerh]hmaybe_create_worker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjݢhhhjhMM ubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hj<hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj>modnameN classnameNj7j:)}j=]j@)}j3jsbc.maybe_create_workerasbuh1hhjubj)}(h h]h }(hj\hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hjwhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjݢhhhjhMM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj٢hhhjhMM ubah}(h]jԢah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMM hj֢hhubjC)}(hhh]h)}(h create a new worker if necessaryh]h create a new worker if necessary}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMM hjhhubah}(h]h ]h"]h$]h&]uh1jBhj֢hhhjhMM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct worker_pool *pool`` pool to create a new worker for **Description** Create a new worker for **pool** if necessary. **pool** is guaranteed to have at least one idle worker on return from this function. If creating a new worker takes longer than MAYDAY_INTERVAL, mayday is sent to all rescuers with works scheduled on **pool** to resolve possible allocation deadlock. On return, need_to_create_worker() is guaranteed to be ``false`` and may_start_working() ``true``. LOCKING: raw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations. Called only from manager.h](h)}(h**Parameters**h]j)}(hjãh]h Parameters}(hjţhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQ hjubjg)}(hhh]jl)}(h=``struct worker_pool *pool`` pool to create a new worker for h](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMN hjܣubj)}(hhh]h)}(hpool to create a new worker forh]hpool to create a new worker for}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMN hjubah}(h]h ]h"]h$]h&]uh1jhjܣubeh}(h]h ]h"]h$]h&]uh1jkhjhMN hj٣ubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMP hjubh)}(hX+Create a new worker for **pool** if necessary. **pool** is guaranteed to have at least one idle worker on return from this function. If creating a new worker takes longer than MAYDAY_INTERVAL, mayday is sent to all rescuers with works scheduled on **pool** to resolve possible allocation deadlock.h](hCreate a new worker for }(hj3hhhNhNubj)}(h**pool**h]hpool}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh if necessary. }(hj3hhhNhNubj)}(h**pool**h]hpool}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh is guaranteed to have at least one idle worker on return from this function. If creating a new worker takes longer than MAYDAY_INTERVAL, mayday is sent to all rescuers with works scheduled on }(hj3hhhNhNubj)}(h**pool**h]hpool}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh) to resolve possible allocation deadlock.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMO hjubh)}(hbOn return, need_to_create_worker() is guaranteed to be ``false`` and may_start_working() ``true``.h](h7On return, need_to_create_worker() is guaranteed to be }(hjxhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubh and may_start_working() }(hjxhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubh.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMU hjubh)}(hLOCKING: raw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations. Called only from manager.h]hLOCKING: raw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations. Called only from manager.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMX hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jmanage_workers (C function)c.manage_workershNtauh1jhjhhhNhNubj)}(hhh](j)}(h+bool manage_workers (struct worker *worker)h]j)}(h*bool manage_workers(struct worker *worker)h](j)}(hj*h]hbool}(hjڤhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj֤hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj֤hhhjhM ubj)}(hmanage_workersh]j)}(hmanage_workersh]hmanage_workers}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj֤hhhjhM ubj|)}(h(struct worker *worker)h]j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj#hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hj4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj6modnameN classnameNj7j:)}j=]j@)}j3jsbc.manage_workersasbuh1hhjubj)}(h h]h }(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjbhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjohhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj֤hhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjҤhhhjhM ubah}(h]jͤah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjϤhhubjC)}(hhh]h)}(hmanage worker poolh]hmanage worker pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjϤhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX)**Parameters** ``struct worker *worker`` self **Description** Assume the manager role and manage the worker pool **worker** belongs to. At any given time, there can be only zero or one manager per pool. The exclusion is handled automatically by this function. The caller can safely start processing works on false return. On true return, it's guaranteed that need_to_create_worker() is false and may_start_working() is true. **Context** raw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations. **Return** ``false`` if the pool doesn't need management and the caller can safely start processing works, ``true`` if management function was performed and the conditions that the caller verified before calling the function may no longer be true.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh]jl)}(h``struct worker *worker`` self h](jr)}(h``struct worker *worker``h]j)}(hjڥh]hstruct worker *worker}(hjܥhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjإubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjԥubj)}(hhh]h)}(hselfh]hself}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjԥubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjѥubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hAssume the manager role and manage the worker pool **worker** belongs to. At any given time, there can be only zero or one manager per pool. The exclusion is handled automatically by this function.h](h3Assume the manager role and manage the worker pool }(hj+hhhNhNubj)}(h **worker**h]hworker}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubh belongs to. At any given time, there can be only zero or one manager per pool. The exclusion is handled automatically by this function.}(hj+hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hThe caller can safely start processing works on false return. On true return, it's guaranteed that need_to_create_worker() is false and may_start_working() is true.h]hThe caller can safely start processing works on false return. On true return, it’s guaranteed that need_to_create_worker() is false and may_start_working() is true.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h **Context**h]j)}(hj]h]hContext}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(horaw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations.h]horaw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times. Does GFP_KERNEL allocations.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h``false`` if the pool doesn't need management and the caller can safely start processing works, ``true`` if management function was performed and the conditions that the caller verified before calling the function may no longer be true.h](j)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhY if the pool doesn’t need management and the caller can safely start processing works, }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if management function was performed and the conditions that the caller verified before calling the function may no longer be true.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jprocess_one_work (C function)c.process_one_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(hGvoid process_one_work (struct worker *worker, struct work_struct *work)h]j)}(hFvoid process_one_work(struct worker *worker, struct work_struct *work)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM ubj)}(hprocess_one_workh]j)}(hprocess_one_workh]hprocess_one_work}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM ubj|)}(h1(struct worker *worker, struct work_struct *work)h](j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hworkerh]hworker}(hjDhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjFmodnameN classnameNj7j:)}j=]j@)}j3j sbc.process_one_workasbuh1hhj"ubj)}(h h]h }(hjdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj"ubjU)}(hjuh]h*}(hjrhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj"ubj)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j`c.process_one_workasbuh1hhjubj)}(h h]h }(hjԧhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM ubah}(h]jܦah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjަhhubjC)}(hhh]h)}(hprocess single workh]hprocess single work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjަhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej1jfj1jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct worker *worker`` self ``struct work_struct *work`` work to process **Description** Process **work**. This function contains all the logics necessary to process a single work including synchronization against and interaction with other workers on the same cpu, queueing and flushing. As long as context requirement is met, any worker can call this function to process a work. **Context** raw_spin_lock_irq(pool->lock) which is released and regrabbed.h](h)}(h**Parameters**h]j)}(hj;h]h Parameters}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5ubjg)}(hhh](jl)}(h``struct worker *worker`` self h](jr)}(h``struct worker *worker``h]j)}(hjZh]hstruct worker *worker}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjTubj)}(hhh]h)}(hselfh]hself}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjohM hjpubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jkhjohM hjQubjl)}(h-``struct work_struct *work`` work to process h](jr)}(h``struct work_struct *work``h]j)}(hjh]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(hwork to processh]hwork to process}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjQubeh}(h]h ]h"]h$]h&]uh1jfhj5ubh)}(h**Description**h]j)}(hjΨh]h Description}(hjШhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj̨ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5ubh)}(hX%Process **work**. This function contains all the logics necessary to process a single work including synchronization against and interaction with other workers on the same cpu, queueing and flushing. As long as context requirement is met, any worker can call this function to process a work.h](hProcess }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX. This function contains all the logics necessary to process a single work including synchronization against and interaction with other workers on the same cpu, queueing and flushing. As long as context requirement is met, any worker can call this function to process a work.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5ubh)}(h **Context**h]j)}(hjh]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5ubh)}(h>raw_spin_lock_irq(pool->lock) which is released and regrabbed.h]h>raw_spin_lock_irq(pool->lock) which is released and regrabbed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$process_scheduled_works (C function)c.process_scheduled_workshNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void process_scheduled_works (struct worker *worker)h]j)}(h3void process_scheduled_works(struct worker *worker)h](j)}(hvoidh]hvoid}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHhhhjZhM ubj)}(hprocess_scheduled_worksh]j)}(hprocess_scheduled_worksh]hprocess_scheduled_works}(hjmhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjiubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjHhhhjZhM ubj|)}(h(struct worker *worker)h]j)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3josbc.process_scheduled_worksasbuh1hhjubj)}(h h]h }(hjǩhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjթhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjHhhhjZhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjDhhhjZhM ubah}(h]j?ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjZhM hjAhhubjC)}(hhh]h)}(hprocess scheduled worksh]hprocess scheduled works}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj hhubah}(h]h ]h"]h$]h&]uh1jBhjAhhhjZhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej$jfj$jgjhjiuh1jhhhjhNhNubjk)}(hXQ**Parameters** ``struct worker *worker`` self **Description** Process all scheduled works. Please note that the scheduled list may change while processing a work, so this function repeatedly fetches a work from the top and executes it. **Context** raw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times.h](h)}(h**Parameters**h]j)}(hj.h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj(ubjg)}(hhh]jl)}(h``struct worker *worker`` self h](jr)}(h``struct worker *worker``h]j)}(hjMh]hstruct worker *worker}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjGubj)}(hhh]h)}(hselfh]hself}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhM hjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jkhjbhM hjDubah}(h]h ]h"]h$]h&]uh1jfhj(ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj(ubh)}(hProcess all scheduled works. Please note that the scheduled list may change while processing a work, so this function repeatedly fetches a work from the top and executes it.h]hProcess all scheduled works. Please note that the scheduled list may change while processing a work, so this function repeatedly fetches a work from the top and executes it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj(ubh)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj(ubh)}(hQraw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times.h]hQraw_spin_lock_irq(pool->lock) which may be released and regrabbed multiple times.}(hjŪhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jworker_thread (C function)c.worker_threadhNtauh1jhjhhhNhNubj)}(hhh](j)}(h"int worker_thread (void *__worker)h]j)}(h!int worker_thread(void *__worker)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM ubj)}(h worker_threadh]j)}(h worker_threadh]h worker_thread}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM ubj|)}(h(void *__worker)h]j)}(hvoid *__workerh](j)}(hvoidh]hvoid}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj-ubjU)}(hjuh]h*}(hjMhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj-ubj)}(h__workerh]h__worker}(hjZhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj)ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjhhubjC)}(hhh]h)}(hthe worker thread functionh]hthe worker thread function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``void *__worker`` self **Description** The worker thread function. All workers belong to a worker_pool - either a per-cpu one or dynamic unbound one. These workers process all work items regardless of their specific target workqueue. The only exception is work items which belong to workqueues with a rescuer which will be explained in rescuer_thread(). **Return** 0h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh]jl)}(h``void *__worker`` self h](jr)}(h``void *__worker``h]j)}(hjūh]hvoid *__worker}(hjǫhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjëubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(hselfh]hself}(hjޫhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjګhM hj۫ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjګhM hjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hX=The worker thread function. All workers belong to a worker_pool - either a per-cpu one or dynamic unbound one. These workers process all work items regardless of their specific target workqueue. The only exception is work items which belong to workqueues with a rescuer which will be explained in rescuer_thread().h]hX=The worker thread function. All workers belong to a worker_pool - either a per-cpu one or dynamic unbound one. These workers process all work items regardless of their specific target workqueue. The only exception is work items which belong to workqueues with a rescuer which will be explained in rescuer_thread().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h **Return**h]j)}(hj'h]hReturn}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(hj}h]h0}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jrescuer_thread (C function)c.rescuer_threadhNtauh1jhjhhhNhNubj)}(hhh](j)}(h$int rescuer_thread (void *__rescuer)h]j)}(h#int rescuer_thread(void *__rescuer)h](j)}(hinth]hint}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjghhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM4ubj)}(h h]h }(hjzhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjghhhjyhM4ubj)}(hrescuer_threadh]j)}(hrescuer_threadh]hrescuer_thread}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjghhhjyhM4ubj|)}(h(void *__rescuer)h]j)}(hvoid *__rescuerh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjĬhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(h __rescuerh]h __rescuer}(hjѬhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjghhhjyhM4ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjchhhjyhM4ubah}(h]j^ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjyhM4hj`hhubjC)}(hhh]h)}(hthe rescuer thread functionh]hthe rescuer thread function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM4hjhhubah}(h]h ]h"]h$]h&]uh1jBhj`hhhjyhM4ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``void *__rescuer`` self **Description** Workqueue rescuer thread function. There's one rescuer for each workqueue which has WQ_MEM_RECLAIM set. Regular work processing on a pool may block trying to create a new worker which uses GFP_KERNEL allocation which has slight chance of developing into deadlock if some works currently on the same queue need to be processed to satisfy the GFP_KERNEL allocation. This is the problem rescuer solves. When such condition is possible, the pool summons rescuers of all workqueues which have works queued on the pool and let them process those works so that forward progress can be guaranteed. This should happen rarely. **Return** 0h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM8hjubjg)}(hhh]jl)}(h``void *__rescuer`` self h](jr)}(h``void *__rescuer``h]j)}(hj<h]hvoid *__rescuer}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5hj6ubj)}(hhh]h)}(hselfh]hself}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhM5hjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jkhjQhM5hj3ubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjwh]h Description}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM7hjubh)}(hhWorkqueue rescuer thread function. There's one rescuer for each workqueue which has WQ_MEM_RECLAIM set.h]hjWorkqueue rescuer thread function. There’s one rescuer for each workqueue which has WQ_MEM_RECLAIM set.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM6hjubh)}(hX(Regular work processing on a pool may block trying to create a new worker which uses GFP_KERNEL allocation which has slight chance of developing into deadlock if some works currently on the same queue need to be processed to satisfy the GFP_KERNEL allocation. This is the problem rescuer solves.h]hX(Regular work processing on a pool may block trying to create a new worker which uses GFP_KERNEL allocation which has slight chance of developing into deadlock if some works currently on the same queue need to be processed to satisfy the GFP_KERNEL allocation. This is the problem rescuer solves.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjubh)}(hWhen such condition is possible, the pool summons rescuers of all workqueues which have works queued on the pool and let them process those works so that forward progress can be guaranteed.h]hWhen such condition is possible, the pool summons rescuers of all workqueues which have works queued on the pool and let them process those works so that forward progress can be guaranteed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM?hjubh)}(hThis should happen rarely.h]hThis should happen rarely.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMChjubh)}(h **Return**h]j)}(hj˭h]hReturn}(hjͭhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjɭubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMEhjubh)}(hj}h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMFhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#check_flush_dependency (C function)c.check_flush_dependencyhNtauh1jhjhhhNhNubj)}(hhh](j)}(hsvoid check_flush_dependency (struct workqueue_struct *target_wq, struct work_struct *target_work, bool from_cancel)h]j)}(hrvoid check_flush_dependency(struct workqueue_struct *target_wq, struct work_struct *target_work, bool from_cancel)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhjhM5ubj)}(hcheck_flush_dependencyh]j)}(hcheck_flush_dependencyh]hcheck_flush_dependency}(hj0hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj,ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj hhhjhM5ubj|)}(hW(struct workqueue_struct *target_wq, struct work_struct *target_work, bool from_cancel)h](j)}(h"struct workqueue_struct *target_wqh](j)}(hjh]hstruct}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjHubj)}(h h]h }(hjYhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjlmodnameN classnameNj7j:)}j=]j@)}j3j2sbc.check_flush_dependencyasbuh1hhjHubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjHubj)}(h target_wqh]h target_wq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjDubj)}(hstruct work_struct *target_workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjˮhhh4NhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjܮhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjٮubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjޮmodnameN classnameNj7j:)}j=]jc.check_flush_dependencyasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(h target_workh]h target_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjDubj)}(hbool from_cancelh](j)}(hj*h]hbool}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj*ubj)}(h from_cancelh]h from_cancel}(hjIhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjDubeh}(h]h ]h"]h$]h&]jjuh1j{hj hhhjhM5ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM5ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM5hjhhubjC)}(hhh]h)}(h!check for flush dependency sanityh]h!check for flush dependency sanity}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM5hjphhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhM5ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *target_wq`` workqueue being flushed ``struct work_struct *target_work`` work item being flushed (NULL for workqueue flushes) ``bool from_cancel`` are we called from the work cancel path **Description** ``current`` is trying to flush the whole **target_wq** or **target_work** on it. If this is not the cancel path (which implies work being flushed is either already running, or will not be at all), check if **target_wq** doesn't have ``WQ_MEM_RECLAIM`` and verify that ``current`` is not reclaiming memory or running on a workqueue which doesn't have ``WQ_MEM_RECLAIM`` as that can break forward- progress guarantee leading to a deadlock.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjubjg)}(hhh](jl)}(h?``struct workqueue_struct *target_wq`` workqueue being flushed h](jr)}(h&``struct workqueue_struct *target_wq``h]j)}(hjh]h"struct workqueue_struct *target_wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM6hjubj)}(hhh]h)}(hworkqueue being flushedh]hworkqueue being flushed}(hjͯhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjɯhM6hjʯubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjɯhM6hjubjl)}(hY``struct work_struct *target_work`` work item being flushed (NULL for workqueue flushes) h](jr)}(h#``struct work_struct *target_work``h]j)}(hjh]hstruct work_struct *target_work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM7hjubj)}(hhh]h)}(h4work item being flushed (NULL for workqueue flushes)h]h4work item being flushed (NULL for workqueue flushes)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM7hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM7hjubjl)}(h=``bool from_cancel`` are we called from the work cancel path h](jr)}(h``bool from_cancel``h]j)}(hj&h]hbool from_cancel}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM8hj ubj)}(hhh]h)}(h'are we called from the work cancel pathh]h'are we called from the work cancel path}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM8hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhj;hM8hjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjah]h Description}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM:hjubh)}(hX``current`` is trying to flush the whole **target_wq** or **target_work** on it. If this is not the cancel path (which implies work being flushed is either already running, or will not be at all), check if **target_wq** doesn't have ``WQ_MEM_RECLAIM`` and verify that ``current`` is not reclaiming memory or running on a workqueue which doesn't have ``WQ_MEM_RECLAIM`` as that can break forward- progress guarantee leading to a deadlock.h](j)}(h ``current``h]hcurrent}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh is trying to flush the whole }(hjwhhhNhNubj)}(h **target_wq**h]h target_wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh or }(hjwhhhNhNubj)}(h**target_work**h]h target_work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh on it. If this is not the cancel path (which implies work being flushed is either already running, or will not be at all), check if }(hjwhhhNhNubj)}(h **target_wq**h]h target_wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh doesn’t have }(hjwhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjðhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubh and verify that }(hjwhhhNhNubj)}(h ``current``h]hcurrent}(hjհhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubhI is not reclaiming memory or running on a workqueue which doesn’t have }(hjwhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubhE as that can break forward- progress guarantee leading to a deadlock.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jinsert_wq_barrier (C function)c.insert_wq_barrierhNtauh1jhjhhhNhNubj)}(hhh](j)}(hvoid insert_wq_barrier (struct pool_workqueue *pwq, struct wq_barrier *barr, struct work_struct *target, struct worker *worker)h]j)}(h~void insert_wq_barrier(struct pool_workqueue *pwq, struct wq_barrier *barr, struct work_struct *target, struct worker *worker)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMeubj)}(h h]h }(hj/hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhj.hMeubj)}(hinsert_wq_barrierh]j)}(hinsert_wq_barrierh]hinsert_wq_barrier}(hjAhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj=ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhj.hMeubj|)}(hh(struct pool_workqueue *pwq, struct wq_barrier *barr, struct work_struct *target, struct worker *worker)h](j)}(hstruct pool_workqueue *pwqh](j)}(hjh]hstruct}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubj)}(h h]h }(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjYubh)}(hhh]j)}(hpool_workqueueh]hpool_workqueue}(hj{hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj}modnameN classnameNj7j:)}j=]j@)}j3jCsbc.insert_wq_barrierasbuh1hhjYubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjYubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjYubj)}(hpwqh]hpwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjUubj)}(hstruct wq_barrier *barrh](j)}(hjh]hstruct}(hjϱhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj˱ubj)}(h h]h }(hjܱhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj˱ubh)}(hhh]j)}(h wq_barrierh]h wq_barrier}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.insert_wq_barrierasbuh1hhj˱ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj˱ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj˱ubj)}(hbarrh]hbarr}(hj&hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj˱ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjUubj)}(hstruct work_struct *targeth](j)}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(h work_structh]h work_struct}(hj]hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj_modnameN classnameNj7j:)}j=]jc.insert_wq_barrierasbuh1hhj;ubj)}(h h]h }(hj{hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj;ubj)}(htargeth]htarget}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjUubj)}(hstruct worker *workerh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkerh]hworker}(hjͲhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjʲubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjϲmodnameN classnameNj7j:)}j=]jc.insert_wq_barrierasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkerh]hworker}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjUubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhj.hMeubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhj.hMeubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj.hMehjhhubjC)}(hhh]h)}(hinsert a barrier workh]hinsert a barrier work}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMehj-hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj.hMeubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejHjfjHjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct pool_workqueue *pwq`` pwq to insert barrier into ``struct wq_barrier *barr`` wq_barrier to insert ``struct work_struct *target`` target work to attach **barr** to ``struct worker *worker`` worker currently executing **target**, NULL if **target** is not executing **Description** **barr** is linked to **target** such that **barr** is completed only after **target** finishes execution. Please note that the ordering guarantee is observed only with respect to **target** and on the local cpu. Currently, a queued barrier can't be canceled. This is because try_to_grab_pending() can't determine whether the work to be grabbed is at the head of the queue and thus can't clear LINKED flag of the previous work while there must be a valid next work after a work with LINKED flag set. Note that when **worker** is non-NULL, **target** may be modified underneath us, so we can't reliably determine pwq from **target**. **Context** raw_spin_lock_irq(pool->lock).h](h)}(h**Parameters**h]j)}(hjRh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihjLubjg)}(hhh](jl)}(h:``struct pool_workqueue *pwq`` pwq to insert barrier into h](jr)}(h``struct pool_workqueue *pwq``h]j)}(hjqh]hstruct pool_workqueue *pwq}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMfhjkubj)}(hhh]h)}(hpwq to insert barrier intoh]hpwq to insert barrier into}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jkhjhMfhjhubjl)}(h1``struct wq_barrier *barr`` wq_barrier to insert h](jr)}(h``struct wq_barrier *barr``h]j)}(hjh]hstruct wq_barrier *barr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMghjubj)}(hhh]h)}(hwq_barrier to inserth]hwq_barrier to insert}(hjóhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMghjhubjl)}(hA``struct work_struct *target`` target work to attach **barr** to h](jr)}(h``struct work_struct *target``h]j)}(hjh]hstruct work_struct *target}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhhjݳubj)}(hhh]h)}(h!target work to attach **barr** toh](htarget work to attach }(hjhhhNhNubj)}(h**barr**h]hbarr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjݳubeh}(h]h ]h"]h$]h&]uh1jkhjhMhhjhubjl)}(he``struct worker *worker`` worker currently executing **target**, NULL if **target** is not executing h](jr)}(h``struct worker *worker``h]j)}(hj.h]hstruct worker *worker}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihj(ubj)}(hhh]h)}(hJworker currently executing **target**, NULL if **target** is not executingh](hworker currently executing }(hjGhhhNhNubj)}(h **target**h]htarget}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh , NULL if }(hjGhhhNhNubj)}(h **target**h]htarget}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh is not executing}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjChMihjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jkhjChMihjhubeh}(h]h ]h"]h$]h&]uh1jfhjLubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMkhjLubh)}(h**barr** is linked to **target** such that **barr** is completed only after **target** finishes execution. Please note that the ordering guarantee is observed only with respect to **target** and on the local cpu.h](j)}(h**barr**h]hbarr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is linked to }(hjhhhNhNubj)}(h **target**h]htarget}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh such that }(hjhhhNhNubj)}(h**barr**h]hbarr}(hj˴hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is completed only after }(hjhhhNhNubj)}(h **target**h]htarget}(hjݴhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh_ finishes execution. Please note that the ordering guarantee is observed only with respect to }(hjhhhNhNubj)}(h **target**h]htarget}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and on the local cpu.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhjLubh)}(hXCurrently, a queued barrier can't be canceled. This is because try_to_grab_pending() can't determine whether the work to be grabbed is at the head of the queue and thus can't clear LINKED flag of the previous work while there must be a valid next work after a work with LINKED flag set.h]hX%Currently, a queued barrier can’t be canceled. This is because try_to_grab_pending() can’t determine whether the work to be grabbed is at the head of the queue and thus can’t clear LINKED flag of the previous work while there must be a valid next work after a work with LINKED flag set.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMohjLubh)}(hNote that when **worker** is non-NULL, **target** may be modified underneath us, so we can't reliably determine pwq from **target**.h](hNote that when }(hjhhhNhNubj)}(h **worker**h]hworker}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is non-NULL, }(hjhhhNhNubj)}(h **target**h]htarget}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhJ may be modified underneath us, so we can’t reliably determine pwq from }(hjhhhNhNubj)}(h **target**h]htarget}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMuhjLubh)}(h **Context**h]j)}(hj^h]hContext}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMxhjLubh)}(hraw_spin_lock_irq(pool->lock).h]hraw_spin_lock_irq(pool->lock).}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMyhjLubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&flush_workqueue_prep_pwqs (C function)c.flush_workqueue_prep_pwqshNtauh1jhjhhhNhNubj)}(hhh](j)}(h]bool flush_workqueue_prep_pwqs (struct workqueue_struct *wq, int flush_color, int work_color)h]j)}(h\bool flush_workqueue_prep_pwqs(struct workqueue_struct *wq, int flush_color, int work_color)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hflush_workqueue_prep_pwqsh]j)}(hflush_workqueue_prep_pwqsh]hflush_workqueue_prep_pwqs}(hjõhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h>(struct workqueue_struct *wq, int flush_color, int work_color)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjߵhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj۵ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj۵ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jŵsbc.flush_workqueue_prep_pwqsasbuh1hhj۵ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj۵ubjU)}(hjuh]h*}(hj+hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj۵ubj)}(hwqh]hwq}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj۵ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj׵ubj)}(hint flush_colorh](j)}(hinth]hint}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(h h]h }(hj_hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjMubj)}(h flush_colorh]h flush_color}(hjmhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj׵ubj)}(hint work_colorh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(h work_colorh]h work_color}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj׵ubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h#prepare pwqs for workqueue flushingh]h#prepare pwqs for workqueue flushing}(hj̶hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjɶhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hXa**Parameters** ``struct workqueue_struct *wq`` workqueue being flushed ``int flush_color`` new flush color, < 0 for no-op ``int work_color`` new work color, < 0 for no-op **Description** Prepare pwqs for workqueue flushing. If **flush_color** is non-negative, flush_color on all pwqs should be -1. If no pwq has in-flight commands at the specified color, all pwq->flush_color's stay at -1 and ``false`` is returned. If any pwq has in flight commands, its pwq->flush_color is set to **flush_color**, **wq->nr_pwqs_to_flush** is updated accordingly, pwq wakeup logic is armed and ``true`` is returned. The caller should have initialized **wq->first_flusher** prior to calling this function with non-negative **flush_color**. If **flush_color** is negative, no flush color update is done and ``false`` is returned. If **work_color** is non-negative, all pwqs should have the same work_color which is previous to **work_color** and all will be advanced to **work_color**. **Context** mutex_lock(wq->mutex). **Return** ``true`` if **flush_color** >= 0 and there's something to flush. ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h8``struct workqueue_struct *wq`` workqueue being flushed h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj h]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hworkqueue being flushedh]hworkqueue being flushed}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMhj#ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj"hMhjubjl)}(h3``int flush_color`` new flush color, < 0 for no-op h](jr)}(h``int flush_color``h]j)}(hjFh]hint flush_color}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj@ubj)}(hhh]h)}(hnew flush color, < 0 for no-oph]hnew flush color, < 0 for no-op}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj\ubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]uh1jkhj[hMhjubjl)}(h1``int work_color`` new work color, < 0 for no-op h](jr)}(h``int work_color``h]j)}(hjh]hint work_color}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjyubj)}(hhh]h)}(hnew work color, < 0 for no-oph]hnew work color, < 0 for no-op}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h$Prepare pwqs for workqueue flushing.h]h$Prepare pwqs for workqueue flushing.}(hjзhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXyIf **flush_color** is non-negative, flush_color on all pwqs should be -1. If no pwq has in-flight commands at the specified color, all pwq->flush_color's stay at -1 and ``false`` is returned. If any pwq has in flight commands, its pwq->flush_color is set to **flush_color**, **wq->nr_pwqs_to_flush** is updated accordingly, pwq wakeup logic is armed and ``true`` is returned.h](hIf }(hj߷hhhNhNubj)}(h**flush_color**h]h flush_color}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj߷ubh is non-negative, flush_color on all pwqs should be -1. If no pwq has in-flight commands at the specified color, all pwq->flush_color’s stay at -1 and }(hj߷hhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj߷ubhQ is returned. If any pwq has in flight commands, its pwq->flush_color is set to }(hj߷hhhNhNubj)}(h**flush_color**h]h flush_color}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj߷ubh, }(hj߷hhhNhNubj)}(h**wq->nr_pwqs_to_flush**h]hwq->nr_pwqs_to_flush}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj߷ubh7 is updated accordingly, pwq wakeup logic is armed and }(hj߷hhhNhNubj)}(h``true``h]htrue}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj߷ubh is returned.}(hj߷hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hThe caller should have initialized **wq->first_flusher** prior to calling this function with non-negative **flush_color**. If **flush_color** is negative, no flush color update is done and ``false`` is returned.h](h#The caller should have initialized }(hjHhhhNhNubj)}(h**wq->first_flusher**h]hwq->first_flusher}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh2 prior to calling this function with non-negative }(hjHhhhNhNubj)}(h**flush_color**h]h flush_color}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh. If }(hjHhhhNhNubj)}(h**flush_color**h]h flush_color}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh0 is negative, no flush color update is done and }(hjHhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubh is returned.}(hjHhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hIf **work_color** is non-negative, all pwqs should have the same work_color which is previous to **work_color** and all will be advanced to **work_color**.h](hIf }(hjhhhNhNubj)}(h**work_color**h]h work_color}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhP is non-negative, all pwqs should have the same work_color which is previous to }(hjhhhNhNubj)}(h**work_color**h]h work_color}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and all will be advanced to }(hjhhhNhNubj)}(h**work_color**h]h work_color}(hj˸hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hmutex_lock(wq->mutex).h]hmutex_lock(wq->mutex).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hj h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hV``true`` if **flush_color** >= 0 and there's something to flush. ``false`` otherwise.h](j)}(h``true``h]htrue}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubh if }(hj#hhhNhNubj)}(h**flush_color**h]h flush_color}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubh) >= 0 and there’s something to flush. }(hj#hhhNhNubj)}(h ``false``h]hfalse}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubh otherwise.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j__flush_workqueue (C function)c.__flush_workqueuehNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void __flush_workqueue (struct workqueue_struct *wq)h]j)}(h3void __flush_workqueue(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM'ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM'ubj)}(h__flush_workqueueh]j)}(h__flush_workqueueh]h__flush_workqueue}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM'ubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjιhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj߹hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjܹubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.__flush_workqueueasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM'ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj|hhhjhM'ubah}(h]jwah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM'hjyhhubjC)}(hhh]h)}(h5ensure that any scheduled work has run to completion.h]h5ensure that any scheduled work has run to completion.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM'hjAhhubah}(h]h ]h"]h$]h&]uh1jBhjyhhhjhM'ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej\jfj\jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct workqueue_struct *wq`` workqueue to flush **Description** This function sleeps until all work items which were queued on entry have finished execution, but it is not livelocked by new incoming ones.h](h)}(h**Parameters**h]j)}(hjfh]h Parameters}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM+hj`ubjg)}(hhh]jl)}(h3``struct workqueue_struct *wq`` workqueue to flush h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM(hjubj)}(hhh]h)}(hworkqueue to flushh]hworkqueue to flush}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM(hj|ubah}(h]h ]h"]h$]h&]uh1jfhj`ubh)}(h**Description**h]j)}(hjh]h Description}(hjºhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*hj`ubh)}(hThis function sleeps until all work items which were queued on entry have finished execution, but it is not livelocked by new incoming ones.h]hThis function sleeps until all work items which were queued on entry have finished execution, but it is not livelocked by new incoming ones.}(hjֺhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM)hj`ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdrain_workqueue (C function)c.drain_workqueuehNtauh1jhjhhhNhNubj)}(hhh](j)}(h2void drain_workqueue (struct workqueue_struct *wq)h]j)}(h1void drain_workqueue(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hdrain_workqueueh]j)}(hdrain_workqueueh]hdrain_workqueue}(hj&hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj"ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>ubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj>ubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj`hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjbmodnameN classnameNj7j:)}j=]j@)}j3j(sbc.drain_workqueueasbuh1hhj>ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj>ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj>ubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj:ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(hdrain a workqueueh]hdrain a workqueue}(hjŻhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj»hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejݻjfjݻjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` workqueue to drain **Description** Wait until the workqueue becomes empty. While draining is in progress, only chain queueing is allowed. IOW, only currently pending or running work items on **wq** can queue further work items on it. **wq** is flushed repeatedly until it becomes empty. The number of flushing is determined by the depth of chaining and should be relatively short. Whine if it takes too long.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h3``struct workqueue_struct *wq`` workqueue to drain h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hworkqueue to drainh]hworkqueue to drain}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjAh]h Description}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXzWait until the workqueue becomes empty. While draining is in progress, only chain queueing is allowed. IOW, only currently pending or running work items on **wq** can queue further work items on it. **wq** is flushed repeatedly until it becomes empty. The number of flushing is determined by the depth of chaining and should be relatively short. Whine if it takes too long.h](hWait until the workqueue becomes empty. While draining is in progress, only chain queueing is allowed. IOW, only currently pending or running work items on }(hjWhhhNhNubj)}(h**wq**h]hwq}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh& can queue further work items on it. }(hjWhhhNhNubj)}(h**wq**h]hwq}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjWubh is flushed repeatedly until it becomes empty. The number of flushing is determined by the depth of chaining and should be relatively short. Whine if it takes too long.}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jflush_work (C function) c.flush_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h*bool flush_work (struct work_struct *work)h]j)}(h)bool flush_work(struct work_struct *work)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMhubj)}(h flush_workh]j)}(h flush_workh]h flush_work}(hjʼhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjƼubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMhubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3j̼sb c.flush_workasbuh1hhjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj2hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj޼ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMhubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMhubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhhjhhubjC)}(hhh]h)}(h>wait for a work to finish executing the last queueing instanceh]h>wait for a work to finish executing the last queueing instance}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhhjfhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMhubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hXL**Parameters** ``struct work_struct *work`` the work to flush **Description** Wait until **work** has finished execution. **work** is guaranteed to be idle on return if it hasn't been requeued since flush started. **Return** ``true`` if flush_work() waited for the work to finish execution, ``false`` if it was already idle.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMlhjubjg)}(hhh]jl)}(h/``struct work_struct *work`` the work to flush h](jr)}(h``struct work_struct *work``h]j)}(hjh]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihjubj)}(hhh]h)}(hthe work to flushh]hthe work to flush}(hjýhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMihjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMkhjubh)}(hWait until **work** has finished execution. **work** is guaranteed to be idle on return if it hasn't been requeued since flush started.h](h Wait until }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh has finished execution. }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhU is guaranteed to be idle on return if it hasn’t been requeued since flush started.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhjubh)}(h **Return**h]j)}(hj0h]hReturn}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMmhjubh)}(hc``true`` if flush_work() waited for the work to finish execution, ``false`` if it was already idle.h](j)}(h``true``h]htrue}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh: if flush_work() waited for the work to finish execution, }(hjFhhhNhNubj)}(h ``false``h]hfalse}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubh if it was already idle.}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMnhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jflush_delayed_work (C function)c.flush_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h4bool flush_delayed_work (struct delayed_work *dwork)h]j)}(h3bool flush_delayed_work(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMzubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMzubj)}(hflush_delayed_workh]j)}(hflush_delayed_workh]hflush_delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMzubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjѾhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj޾hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.flush_delayed_workasbuh1hhj;ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj;ubj)}(hdworkh]hdwork}(hj*hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjɾubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMzubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMzubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMzhjhhubjC)}(hhh]h)}(h6wait for a dwork to finish executing the last queueingh]h6wait for a dwork to finish executing the last queueing}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMzhjQhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMzubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejljfjljgjhjiuh1jhhhjhNhNubjk)}(hXz**Parameters** ``struct delayed_work *dwork`` the delayed work to flush **Description** Delayed timer is cancelled and the pending work is queued for immediate execution. Like flush_work(), this function only considers the last queueing instance of **dwork**. **Return** ``true`` if flush_work() waited for the work to finish execution, ``false`` if it was already idle.h](h)}(h**Parameters**h]j)}(hjvh]h Parameters}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM~hjpubjg)}(hhh]jl)}(h9``struct delayed_work *dwork`` the delayed work to flush h](jr)}(h``struct delayed_work *dwork``h]j)}(hjh]hstruct delayed_work *dwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM{hjubj)}(hhh]h)}(hthe delayed work to flushh]hthe delayed work to flush}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM{hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM{hjubah}(h]h ]h"]h$]h&]uh1jfhjpubh)}(h**Description**h]j)}(hjпh]h Description}(hjҿhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjοubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM}hjpubh)}(hDelayed timer is cancelled and the pending work is queued for immediate execution. Like flush_work(), this function only considers the last queueing instance of **dwork**.h](hDelayed timer is cancelled and the pending work is queued for immediate execution. Like flush_work(), this function only considers the last queueing instance of }(hjhhhNhNubj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM|hjpubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjpubh)}(hc``true`` if flush_work() waited for the work to finish execution, ``false`` if it was already idle.h](j)}(h``true``h]htrue}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh: if flush_work() waited for the work to finish execution, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if it was already idle.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjpubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jflush_rcu_work (C function)c.flush_rcu_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h,bool flush_rcu_work (struct rcu_work *rwork)h]j)}(h+bool flush_rcu_work(struct rcu_work *rwork)h](j)}(hj*h]hbool}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj|hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjjhhhj{hMubj)}(hflush_rcu_workh]j)}(hflush_rcu_workh]hflush_rcu_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjjhhhj{hMubj|)}(h(struct rcu_work *rwork)h]j)}(hstruct rcu_work *rworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hrcu_workh]hrcu_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.flush_rcu_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hrworkh]hrwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjjhhhj{hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjfhhhj{hMubah}(h]jaah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj{hMhjchhubjC)}(hhh]h)}(h6wait for a rwork to finish executing the last queueingh]h6wait for a rwork to finish executing the last queueing}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj*hhubah}(h]h ]h"]h$]h&]uh1jBhjchhhj{hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejEjfjEjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct rcu_work *rwork`` the rcu work to flush **Return** ``true`` if flush_rcu_work() waited for the work to finish execution, ``false`` if it was already idle.h](h)}(h**Parameters**h]j)}(hjOh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjIubjg)}(hhh]jl)}(h1``struct rcu_work *rwork`` the rcu work to flush h](jr)}(h``struct rcu_work *rwork``h]j)}(hjnh]hstruct rcu_work *rwork}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhubj)}(hhh]h)}(hthe rcu work to flushh]hthe rcu work to flush}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjeubah}(h]h ]h"]h$]h&]uh1jfhjIubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjIubh)}(hg``true`` if flush_rcu_work() waited for the work to finish execution, ``false`` if it was already idle.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh> if flush_rcu_work() waited for the work to finish execution, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if it was already idle.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcancel_work_sync (C function)c.cancel_work_synchNtauh1jhjhhhNhNubj)}(hhh](j)}(h0bool cancel_work_sync (struct work_struct *work)h]j)}(h/bool cancel_work_sync(struct work_struct *work)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhjhMubj)}(hcancel_work_synch]j)}(hcancel_work_synch]hcancel_work_sync}(hj.hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj*ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj hhhjhMubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubj)}(h h]h }(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjjmodnameN classnameNj7j:)}j=]j@)}j3j0sbc.cancel_work_syncasbuh1hhjFubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjFubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjBubah}(h]h ]h"]h$]h&]jjuh1j{hj hhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h'cancel a work and wait for it to finishh]h'cancel a work and wait for it to finish}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` the work to cancel **Description** Cancel **work** and wait for its execution to finish. This function can be used even if the work re-queues itself or migrates to another workqueue. On return from this function, **work** is guaranteed to be not pending or executing on any CPU as long as there aren't racing enqueues. cancel_work_sync(:c:type:`delayed_work->work `) must not be used for delayed_work's. Use cancel_delayed_work_sync() instead. Must be called from a sleepable context if **work** was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if **work** was last queued on a BH workqueue. Returns ``true`` if **work** was pending, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h0``struct work_struct *work`` the work to cancel h](jr)}(h``struct work_struct *work``h]j)}(hjh]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe work to cancelh]hthe work to cancel}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMhj$ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj#hMhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjIh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXCancel **work** and wait for its execution to finish. This function can be used even if the work re-queues itself or migrates to another workqueue. On return from this function, **work** is guaranteed to be not pending or executing on any CPU as long as there aren't racing enqueues.h](hCancel }(hj_hhhNhNubj)}(h**work**h]hwork}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubh and wait for its execution to finish. This function can be used even if the work re-queues itself or migrates to another workqueue. On return from this function, }(hj_hhhNhNubj)}(h**work**h]hwork}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubhc is guaranteed to be not pending or executing on any CPU as long as there aren’t racing enqueues.}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hcancel_work_sync(:c:type:`delayed_work->work `) must not be used for delayed_work's. Use cancel_delayed_work_sync() instead.h](hcancel_work_sync(}(hjhhhNhNubh)}(h+:c:type:`delayed_work->work `h]j)}(hjh]hdelayed_work->work}(hjhhhNhNubah}(h]h ](xrefj_c-typeeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdoccore-api/workqueue refdomainj_reftypetype refexplicitrefwarnj7j:)}j=]sb reftarget delayed_workuh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubhP) must not be used for delayed_work’s. Use cancel_delayed_work_sync() instead.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubh)}(hMust be called from a sleepable context if **work** was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if **work** was last queued on a BH workqueue.h](h+Must be called from a sleepable context if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhl was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# was last queued on a BH workqueue.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h>Returns ``true`` if **work** was pending, ``false`` otherwise.h](hReturns }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was pending, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j cancel_delayed_work (C function)c.cancel_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h5bool cancel_delayed_work (struct delayed_work *dwork)h]j)}(h4bool cancel_delayed_work(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjphhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj^hhhjohMubj)}(hcancel_delayed_workh]j)}(hcancel_delayed_workh]hcancel_delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj~ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj^hhhjohMubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.cancel_delayed_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj^hhhjohMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjZhhhjohMubah}(h]jUah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjohMhjWhhubjC)}(hhh]h)}(hcancel a delayed workh]hcancel a delayed work}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjWhhhjohMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej9jfj9jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct delayed_work *dwork`` delayed_work to cancel **Description** Kill off a pending delayed_work. **Return** ``true`` if **dwork** was pending and canceled; ``false`` if it wasn't pending. **Note** The work callback function may still be running on return, unless it returns ``true`` and the work doesn't re-arm itself. Explicitly flush or use cancel_delayed_work_sync() to wait on it. This function is safe to call from any context including IRQ handler.h](h)}(h**Parameters**h]j)}(hjCh]h Parameters}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubjg)}(hhh]jl)}(h6``struct delayed_work *dwork`` delayed_work to cancel h](jr)}(h``struct delayed_work *dwork``h]j)}(hjbh]hstruct delayed_work *dwork}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj\ubj)}(hhh]h)}(hdelayed_work to cancelh]hdelayed_work to cancel}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jkhjwhMhjYubah}(h]h ]h"]h$]h&]uh1jfhj=ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubh)}(h Kill off a pending delayed_work.h]h Kill off a pending delayed_work.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubh)}(hO``true`` if **dwork** was pending and canceled; ``false`` if it wasn't pending.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was pending and canceled; }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if it wasn’t pending.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubh)}(h**Note**h]j)}(hjh]hNote}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj=ubh)}(hThe work callback function may still be running on return, unless it returns ``true`` and the work doesn't re-arm itself. Explicitly flush or use cancel_delayed_work_sync() to wait on it.h](hMThe work callback function may still be running on return, unless it returns }(hj3hhhNhNubj)}(h``true``h]htrue}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubhi and the work doesn’t re-arm itself. Explicitly flush or use cancel_delayed_work_sync() to wait on it.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj=ubh)}(hEThis function is safe to call from any context including IRQ handler.h]hEThis function is safe to call from any context including IRQ handler.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%cancel_delayed_work_sync (C function)c.cancel_delayed_work_synchNtauh1jhjhhhNhNubj)}(hhh](j)}(h:bool cancel_delayed_work_sync (struct delayed_work *dwork)h]j)}(h9bool cancel_delayed_work_sync(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hcancel_delayed_work_synch]j)}(hcancel_delayed_work_synch]hcancel_delayed_work_sync}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.cancel_delayed_work_syncasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj{hhhjhMubah}(h]jvah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjxhhubjC)}(hhh]h)}(h/cancel a delayed work and wait for it to finishh]h/cancel a delayed work and wait for it to finish}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj?hhubah}(h]h ]h"]h$]h&]uh1jBhjxhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejZjfjZjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct delayed_work *dwork`` the delayed work cancel **Description** This is cancel_work_sync() for delayed works. **Return** ``true`` if **dwork** was pending, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjdh]h Parameters}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj^ubjg)}(hhh]jl)}(h7``struct delayed_work *dwork`` the delayed work cancel h](jr)}(h``struct delayed_work *dwork``h]j)}(hjh]hstruct delayed_work *dwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj}ubj)}(hhh]h)}(hthe delayed work cancelh]hthe delayed work cancel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjzubah}(h]h ]h"]h$]h&]uh1jfhj^ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj^ubh)}(h-This is cancel_work_sync() for delayed works.h]h-This is cancel_work_sync() for delayed works.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj^ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj^ubh)}(h7``true`` if **dwork** was pending, ``false`` otherwise.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h **dwork**h]hdwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was pending, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj^ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdisable_work (C function)c.disable_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h,bool disable_work (struct work_struct *work)h]j)}(h+bool disable_work(struct work_struct *work)h](j)}(hj*h]hbool}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM'ubj)}(h h]h }(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjXhhhjihM'ubj)}(h disable_workh]j)}(h disable_workh]h disable_work}(hj|hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjxubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjXhhhjihM'ubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3j~sbc.disable_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjXhhhjihM'ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjThhhjihM'ubah}(h]jOah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjihM'hjQhhubjC)}(hhh]h)}(hDisable and cancel a work itemh]hDisable and cancel a work item}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM'hjhhubah}(h]h ]h"]h$]h&]uh1jBhjQhhhjihM'ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej3jfj3jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` work item to disable **Description** Disable **work** by incrementing its disable count and cancel it if currently pending. As long as the disable count is non-zero, any attempt to queue **work** will fail and return ``false``. The maximum supported disable depth is 2 to the power of ``WORK_OFFQ_DISABLE_BITS``, currently 65536. Can be called from any context. Returns ``true`` if **work** was pending, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hj=h]h Parameters}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM+hj7ubjg)}(hhh]jl)}(h2``struct work_struct *work`` work item to disable h](jr)}(h``struct work_struct *work``h]j)}(hj\h]hstruct work_struct *work}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM(hjVubj)}(hhh]h)}(hwork item to disableh]hwork item to disable}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjqhM(hjrubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jkhjqhM(hjSubah}(h]h ]h"]h$]h&]uh1jfhj7ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*hj7ubh)}(hX$Disable **work** by incrementing its disable count and cancel it if currently pending. As long as the disable count is non-zero, any attempt to queue **work** will fail and return ``false``. The maximum supported disable depth is 2 to the power of ``WORK_OFFQ_DISABLE_BITS``, currently 65536.h](hDisable }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh by incrementing its disable count and cancel it if currently pending. As long as the disable count is non-zero, any attempt to queue }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh will fail and return }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh;. The maximum supported disable depth is 2 to the power of }(hjhhhNhNubj)}(h``WORK_OFFQ_DISABLE_BITS``h]hWORK_OFFQ_DISABLE_BITS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, currently 65536.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM)hj7ubh)}(h^Can be called from any context. Returns ``true`` if **work** was pending, ``false`` otherwise.h](h(Can be called from any context. Returns }(hjhhhNhNubj)}(h``true``h]htrue}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was pending, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM.hj7ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdisable_work_sync (C function)c.disable_work_synchNtauh1jhjhhhNhNubj)}(hhh](j)}(h1bool disable_work_sync (struct work_struct *work)h]j)}(h0bool disable_work_sync(struct work_struct *work)h](j)}(hj*h]hbool}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjehhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9ubj)}(h h]h }(hjwhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjehhhjvhM9ubj)}(hdisable_work_synch]j)}(hdisable_work_synch]hdisable_work_sync}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjehhhjvhM9ubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.disable_work_syncasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjehhhjvhM9ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjahhhjvhM9ubah}(h]j\ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjvhM9hj^hhubjC)}(hhh]h)}(h%Disable, cancel and drain a work itemh]h%Disable, cancel and drain a work item}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hj%hhubah}(h]h ]h"]h$]h&]uh1jBhj^hhhjvhM9ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej@jfj@jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct work_struct *work`` work item to disable **Description** Similar to disable_work() but also wait for **work** to finish if currently executing. Must be called from a sleepable context if **work** was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if **work** was last queued on a BH workqueue. Returns ``true`` if **work** was pending, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjJh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=hjDubjg)}(hhh]jl)}(h2``struct work_struct *work`` work item to disable h](jr)}(h``struct work_struct *work``h]j)}(hjih]hstruct work_struct *work}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM:hjcubj)}(hhh]h)}(hwork item to disableh]hwork item to disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj~hM:hjubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jkhj~hM:hj`ubah}(h]h ]h"]h$]h&]uh1jfhjDubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM<hjDubh)}(hVSimilar to disable_work() but also wait for **work** to finish if currently executing.h](h,Similar to disable_work() but also wait for }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh" to finish if currently executing.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM;hjDubh)}(hMust be called from a sleepable context if **work** was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if **work** was last queued on a BH workqueue.h](h+Must be called from a sleepable context if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhl was last queued on a non-BH workqueue. Can also be called from non-hardirq atomic contexts including BH if }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh# was last queued on a BH workqueue.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM>hjDubh)}(h>Returns ``true`` if **work** was pending, ``false`` otherwise.h](hReturns }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h**work**h]hwork}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh was pending, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMBhjDubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jenable_work (C function) c.enable_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h+bool enable_work (struct work_struct *work)h]j)}(h*bool enable_work(struct work_struct *work)h](j)}(hj*h]hbool}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjohhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMLubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjohhhjhMLubj)}(h enable_workh]j)}(h enable_workh]h enable_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjohhhjhMLubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsb c.enable_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjohhhjhMLubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjkhhhjhMLubah}(h]jfah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMLhjhhhubjC)}(hhh]h)}(hEnable a work itemh]hEnable a work item}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMLhj/hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhhjhMLubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejJjfjJjgjhjiuh1jhhhjhNhNubjk)}(hX8**Parameters** ``struct work_struct *work`` work item to enable **Description** Undo disable_work[_sync]() by decrementing **work**'s disable count. **work** can only be queued if its disable count is 0. Can be called from any context. Returns ``true`` if the disable count reached 0. Otherwise, ``false``.h](h)}(h**Parameters**h]j)}(hjTh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMPhjNubjg)}(hhh]jl)}(h1``struct work_struct *work`` work item to enable h](jr)}(h``struct work_struct *work``h]j)}(hjsh]hstruct work_struct *work}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMMhjmubj)}(hhh]h)}(hwork item to enableh]hwork item to enable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMMhjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jkhjhMMhjjubah}(h]h ]h"]h$]h&]uh1jfhjNubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMOhjNubh)}(h{Undo disable_work[_sync]() by decrementing **work**'s disable count. **work** can only be queued if its disable count is 0.h](h+Undo disable_work[_sync]() by decrementing }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh’s disable count. }(hjhhhNhNubj)}(h**work**h]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. can only be queued if its disable count is 0.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMNhjNubh)}(hfCan be called from any context. Returns ``true`` if the disable count reached 0. Otherwise, ``false``.h](h(Can be called from any context. Returns }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, if the disable count reached 0. Otherwise, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!disable_delayed_work (C function)c.disable_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h6bool disable_delayed_work (struct delayed_work *dwork)h]j)}(h5bool disable_delayed_work(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMgubj)}(h h]h }(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFhhhjWhMgubj)}(hdisable_delayed_workh]j)}(hdisable_delayed_workh]hdisable_delayed_work}(hjjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjfubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjFhhhjWhMgubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jlsbc.disable_delayed_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj~ubah}(h]h ]h"]h$]h&]jjuh1j{hjFhhhjWhMgubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjBhhhjWhMgubah}(h]j=ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjWhMghj?hhubjC)}(hhh]h)}(h&Disable and cancel a delayed work itemh]h&Disable and cancel a delayed work item}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMghjhhubah}(h]h ]h"]h$]h&]uh1jBhj?hhhjWhMgubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej!jfj!jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct delayed_work *dwork`` delayed work item to disable **Description** disable_work() for delayed work items.h](h)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMkhj%ubjg)}(hhh]jl)}(h<``struct delayed_work *dwork`` delayed work item to disable h](jr)}(h``struct delayed_work *dwork``h]j)}(hjJh]hstruct delayed_work *dwork}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhhjDubj)}(hhh]h)}(hdelayed work item to disableh]hdelayed work item to disable}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jkhj_hMhhjAubah}(h]h ]h"]h$]h&]uh1jfhj%ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhj%ubh)}(h&disable_work() for delayed work items.h]h&disable_work() for delayed work items.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&disable_delayed_work_sync (C function)c.disable_delayed_work_synchNtauh1jhjhhhNhNubj)}(hhh](j)}(h;bool disable_delayed_work_sync (struct delayed_work *dwork)h]j)}(h:bool disable_delayed_work_sync(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMtubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMtubj)}(hdisable_delayed_work_synch]j)}(hdisable_delayed_work_synch]hdisable_delayed_work_sync}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMtubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj&modnameN classnameNj7j:)}j=]j@)}j3jsbc.disable_delayed_work_syncasbuh1hhjubj)}(h h]h }(hjDhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjRhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hj_hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMtubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMtubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMthjhhubjC)}(hhh]h)}(h-Disable, cancel and drain a delayed work itemh]h-Disable, cancel and drain a delayed work item}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMthjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMtubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct delayed_work *dwork`` delayed work item to disable **Description** disable_work_sync() for delayed work items.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMxhjubjg)}(hhh]jl)}(h<``struct delayed_work *dwork`` delayed work item to disable h](jr)}(h``struct delayed_work *dwork``h]j)}(hjh]hstruct delayed_work *dwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMuhjubj)}(hhh]h)}(hdelayed work item to disableh]hdelayed work item to disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMuhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMwhjubh)}(h+disable_work_sync() for delayed work items.h]h+disable_work_sync() for delayed work items.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMvhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j enable_delayed_work (C function)c.enable_delayed_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h5bool enable_delayed_work (struct delayed_work *dwork)h]j)}(h4bool enable_delayed_work(struct delayed_work *dwork)h](j)}(hj*h]hbool}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjFhhhjWhMubj)}(henable_delayed_workh]j)}(henable_delayed_workh]henable_delayed_work}(hjjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjfubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjFhhhjWhMubj|)}(h(struct delayed_work *dwork)h]j)}(hstruct delayed_work *dworkh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h delayed_workh]h delayed_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jlsbc.enable_delayed_workasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hdworkh]hdwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj~ubah}(h]h ]h"]h$]h&]jjuh1j{hjFhhhjWhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjBhhhjWhMubah}(h]j=ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjWhMhj?hhubjC)}(hhh]h)}(hEnable a delayed work itemh]hEnable a delayed work item}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhj?hhhjWhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej!jfj!jgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct delayed_work *dwork`` delayed work item to enable **Description** enable_work() for delayed work items.h](h)}(h**Parameters**h]j)}(hj+h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj%ubjg)}(hhh]jl)}(h;``struct delayed_work *dwork`` delayed work item to enable h](jr)}(h``struct delayed_work *dwork``h]j)}(hjJh]hstruct delayed_work *dwork}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjDubj)}(hhh]h)}(hdelayed work item to enableh]hdelayed work item to enable}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMhj`ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jkhj_hMhjAubah}(h]h ]h"]h$]h&]uh1jfhj%ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj%ubh)}(h%enable_work() for delayed work items.h]h%enable_work() for delayed work items.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!schedule_on_each_cpu (C function)c.schedule_on_each_cpuhNtauh1jhjhhhNhNubj)}(hhh](j)}(h+int schedule_on_each_cpu (work_func_t func)h]j)}(h*int schedule_on_each_cpu(work_func_t func)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hschedule_on_each_cpuh]j)}(hschedule_on_each_cpuh]hschedule_on_each_cpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(work_func_t func)h]j)}(hwork_func_t funch](h)}(hhh]j)}(h work_func_th]h work_func_t}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj modnameN classnameNj7j:)}j=]j@)}j3jsbc.schedule_on_each_cpuasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hfunch]hfunc}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h3execute a function synchronously on each online CPUh]h3execute a function synchronously on each online CPU}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejzjfjzjgjhjiuh1jhhhjhNhNubjk)}(hX!**Parameters** ``work_func_t func`` the function to call **Description** schedule_on_each_cpu() executes **func** on each online CPU using the system workqueue and blocks until all CPUs have completed. schedule_on_each_cpu() is very slow. **Return** 0 on success, -errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubjg)}(hhh]jl)}(h*``work_func_t func`` the function to call h](jr)}(h``work_func_t func``h]j)}(hjh]hwork_func_t func}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe function to callh]hthe function to call}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhj~ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubh)}(hschedule_on_each_cpu() executes **func** on each online CPU using the system workqueue and blocks until all CPUs have completed. schedule_on_each_cpu() is very slow.h](h schedule_on_each_cpu() executes }(hjhhhNhNubj)}(h**func**h]hfunc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh} on each online CPU using the system workqueue and blocks until all CPUs have completed. schedule_on_each_cpu() is very slow.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubh)}(h 0 on success, -errno on failure.h]h 0 on success, -errno on failure.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'execute_in_process_context (C function)c.execute_in_process_contexthNtauh1jhjhhhNhNubj)}(hhh](j)}(hHint execute_in_process_context (work_func_t fn, struct execute_work *ew)h]j)}(hGint execute_in_process_context(work_func_t fn, struct execute_work *ew)h](j)}(hinth]hint}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjkhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjXhhhjjhMubj)}(hexecute_in_process_contexth]j)}(hexecute_in_process_contexth]hexecute_in_process_context}(hj}hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjyubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjXhhhjjhMubj|)}(h)(work_func_t fn, struct execute_work *ew)h](j)}(hwork_func_t fnh](h)}(hhh]j)}(h work_func_th]h work_func_t}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.execute_in_process_contextasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hfnh]hfn}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct execute_work *ewh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h execute_workh]h execute_work}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.execute_in_process_contextasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj-hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hewh]hew}(hj:hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjXhhhjjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjThhhjjhMubah}(h]jOah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjjhMhjQhhubjC)}(hhh]h)}(h.reliably execute the routine with user contexth]h.reliably execute the routine with user context}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjahhubah}(h]h ]h"]h$]h&]uh1jBhjQhhhjjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej|jfj|jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``work_func_t fn`` the function to execute ``struct execute_work *ew`` guaranteed storage for the execute work structure (must be available when the work executes) **Description** Executes the function immediately if process context is available, otherwise schedules the function for delayed execution. **Return** 0 - function was executed 1 - function was scheduled for executionh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h+``work_func_t fn`` the function to execute h](jr)}(h``work_func_t fn``h]j)}(hjh]hwork_func_t fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe function to executeh]hthe function to execute}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubjl)}(hy``struct execute_work *ew`` guaranteed storage for the execute work structure (must be available when the work executes) h](jr)}(h``struct execute_work *ew``h]j)}(hjh]hstruct execute_work *ew}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h\guaranteed storage for the execute work structure (must be available when the work executes)h]h\guaranteed storage for the execute work structure (must be available when the work executes)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hzExecutes the function immediately if process context is available, otherwise schedules the function for delayed execution.h]hzExecutes the function immediately if process context is available, otherwise schedules the function for delayed execution.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hjAh]hReturn}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hB0 - function was executed 1 - function was scheduled for executionh]hB0 - function was executed 1 - function was scheduled for execution}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!free_workqueue_attrs (C function)c.free_workqueue_attrshNtauh1jhjhhhNhNubj)}(hhh](j)}(h9void free_workqueue_attrs (struct workqueue_attrs *attrs)h]j)}(h8void free_workqueue_attrs(struct workqueue_attrs *attrs)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hfree_workqueue_attrsh]j)}(hfree_workqueue_attrsh]hfree_workqueue_attrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct workqueue_attrs *attrs)h]j)}(hstruct workqueue_attrs *attrsh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_attrsh]hworkqueue_attrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.free_workqueue_attrsasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hattrsh]hattrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj~hhhjhMubah}(h]jyah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhj{hhubjC)}(hhh]h)}(hfree a workqueue_attrsh]hfree a workqueue_attrs}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjChhubah}(h]h ]h"]h$]h&]uh1jBhj{hhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej^jfj^jgjhjiuh1jhhhjhNhNubjk)}(h{**Parameters** ``struct workqueue_attrs *attrs`` workqueue_attrs to free **Description** Undo alloc_workqueue_attrs().h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjbubjg)}(hhh]jl)}(h:``struct workqueue_attrs *attrs`` workqueue_attrs to free h](jr)}(h!``struct workqueue_attrs *attrs``h]j)}(hjh]hstruct workqueue_attrs *attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hworkqueue_attrs to freeh]hworkqueue_attrs to free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhj~ubah}(h]h ]h"]h$]h&]uh1jfhjbubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjbubh)}(hUndo alloc_workqueue_attrs().h]hUndo alloc_workqueue_attrs().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"alloc_workqueue_attrs (C function)c.alloc_workqueue_attrshNtauh1jhjhhhNhNubj)}(hhh](j)}(h5struct workqueue_attrs * alloc_workqueue_attrs (void)h]j)}(h3struct workqueue_attrs *alloc_workqueue_attrs(void)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(hworkqueue_attrsh]hworkqueue_attrs}(hj&hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj(modnameN classnameNj7j:)}j=]j@)}j3alloc_workqueue_attrssbc.alloc_workqueue_attrsasbuh1hhjhhhjhMubj)}(h h]h }(hjGhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubjU)}(hjuh]h*}(hjUhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjhhhjhMubj)}(halloc_workqueue_attrsh]j)}(hjDh]halloc_workqueue_attrs}(hjfhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjbubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]noemphjjuh1jhjyubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(hallocate a workqueue_attrsh]hallocate a workqueue_attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Allocate a new workqueue_attrs, initialize with default settings and return it. **Return** The allocated new workqueue_attr on success. ``NULL`` on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj'h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubh)}(hOAllocate a new workqueue_attrs, initialize with default settings and return it.h]hOAllocate a new workqueue_attrs, initialize with default settings and return it.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hjNh]hReturn}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hAThe allocated new workqueue_attr on success. ``NULL`` on failure.h](h-The allocated new workqueue_attr on success. }(hjdhhhNhNubj)}(h``NULL``h]hNULL}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubh on failure.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jinit_worker_pool (C function)c.init_worker_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h/int init_worker_pool (struct worker_pool *pool)h]j)}(h.int init_worker_pool(struct worker_pool *pool)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM^ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhM^ubj)}(hinit_worker_poolh]j)}(hinit_worker_poolh]hinit_worker_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhM^ubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.init_worker_poolasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj.hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hj;hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhM^ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhM^ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM^hjhhubjC)}(hhh]h)}(h'initialize a newly zalloc'd worker_poolh]h)initialize a newly zalloc’d worker_pool}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM^hjbhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhM^ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej}jfj}jgjhjiuh1jhhhjhNhNubjk)}(hX]**Parameters** ``struct worker_pool *pool`` worker_pool to initialize **Description** Initialize a newly zalloc'd **pool**. It also allocates **pool->attrs**. **Return** 0 on success, -errno on failure. Even on failure, all fields inside **pool** proper are initialized and put_unbound_pool() can be called on **pool** safely to release it.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMbhjubjg)}(hhh]jl)}(h7``struct worker_pool *pool`` worker_pool to initialize h](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM_hjubj)}(hhh]h)}(hworker_pool to initializeh]hworker_pool to initialize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM_hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM_hjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMahjubh)}(hIInitialize a newly zalloc'd **pool**. It also allocates **pool->attrs**.h](hInitialize a newly zalloc’d }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. It also allocates }(hjhhhNhNubj)}(h**pool->attrs**h]h pool->attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM`hjubh)}(h **Return**h]j)}(hj,h]hReturn}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMbhjubh)}(h0 on success, -errno on failure. Even on failure, all fields inside **pool** proper are initialized and put_unbound_pool() can be called on **pool** safely to release it.h](hE0 on success, -errno on failure. Even on failure, all fields inside }(hjBhhhNhNubj)}(h**pool**h]hpool}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubh@ proper are initialized and put_unbound_pool() can be called on }(hjBhhhNhNubj)}(h**pool**h]hpool}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubh safely to release it.}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMchjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jput_unbound_pool (C function)c.put_unbound_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h0void put_unbound_pool (struct worker_pool *pool)h]j)}(h/void put_unbound_pool(struct worker_pool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hput_unbound_poolh]j)}(hput_unbound_poolh]hput_unbound_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.put_unbound_poolasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hj+hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(hput a worker_poolh]hput a worker_pool}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjRhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejmjfjmjgjhjiuh1jhhhjhNhNubjk)}(hXz**Parameters** ``struct worker_pool *pool`` worker_pool to put **Description** Put **pool**. If its refcnt reaches zero, it gets destroyed in RCU safe manner. get_unbound_pool() calls this function on its failure path and this function should be able to release pools which went through, successfully or not, init_worker_pool(). Should be called with wq_pool_mutex held.h](h)}(h**Parameters**h]j)}(hjwh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjqubjg)}(hhh]jl)}(h0``struct worker_pool *pool`` worker_pool to put h](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hworker_pool to puth]hworker_pool to put}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjqubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjqubh)}(hPut **pool**. If its refcnt reaches zero, it gets destroyed in RCU safe manner. get_unbound_pool() calls this function on its failure path and this function should be able to release pools which went through, successfully or not, init_worker_pool().h](hPut }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If its refcnt reaches zero, it gets destroyed in RCU safe manner. get_unbound_pool() calls this function on its failure path and this function should be able to release pools which went through, successfully or not, init_worker_pool().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjqubh)}(h)Should be called with wq_pool_mutex held.h]h)Should be called with wq_pool_mutex held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jget_unbound_pool (C function)c.get_unbound_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(hKstruct worker_pool * get_unbound_pool (const struct workqueue_attrs *attrs)h]j)}(hIstruct worker_pool *get_unbound_pool(const struct workqueue_attrs *attrs)h](j)}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMSubj)}(h h]h }(hjEhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3hhhjDhMSubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjVhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjXmodnameN classnameNj7j:)}j=]j@)}j3get_unbound_poolsbc.get_unbound_poolasbuh1hhj3hhhjDhMSubj)}(h h]h }(hjwhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj3hhhjDhMSubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj3hhhjDhMSubj)}(hget_unbound_poolh]j)}(hjth]hget_unbound_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj3hhhjDhMSubj|)}(h%(const struct workqueue_attrs *attrs)h]j)}(h#const struct workqueue_attrs *attrsh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_attrsh]hworkqueue_attrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jrc.get_unbound_poolasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hattrsh]hattrs}(hj#hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj3hhhjDhMSubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj/hhhjDhMSubah}(h]j*ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjDhMShj,hhubjC)}(hhh]h)}(h/get a worker_pool with the specified attributesh]h/get a worker_pool with the specified attributes}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMShjJhhubah}(h]h ]h"]h$]h&]uh1jBhj,hhhjDhMSubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejejfjejgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``const struct workqueue_attrs *attrs`` the attributes of the worker_pool to get **Description** Obtain a worker_pool which has the same attributes as **attrs**, bump the reference count and return it. If there already is a matching worker_pool, it will be used; otherwise, this function attempts to create a new one. Should be called with wq_pool_mutex held. **Return** On success, a worker_pool with the same attributes as **attrs**. On failure, ``NULL``.h](h)}(h**Parameters**h]j)}(hjoh]h Parameters}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMWhjiubjg)}(hhh]jl)}(hQ``const struct workqueue_attrs *attrs`` the attributes of the worker_pool to get h](jr)}(h'``const struct workqueue_attrs *attrs``h]j)}(hjh]h#const struct workqueue_attrs *attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMThjubj)}(hhh]h)}(h(the attributes of the worker_pool to geth]h(the attributes of the worker_pool to get}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMThjubah}(h]h ]h"]h$]h&]uh1jfhjiubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMVhjiubh)}(hObtain a worker_pool which has the same attributes as **attrs**, bump the reference count and return it. If there already is a matching worker_pool, it will be used; otherwise, this function attempts to create a new one.h](h6Obtain a worker_pool which has the same attributes as }(hjhhhNhNubj)}(h **attrs**h]hattrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, bump the reference count and return it. If there already is a matching worker_pool, it will be used; otherwise, this function attempts to create a new one.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMUhjiubh)}(h)Should be called with wq_pool_mutex held.h]h)Should be called with wq_pool_mutex held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMZhjiubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM\hjiubh)}(hVOn success, a worker_pool with the same attributes as **attrs**. On failure, ``NULL``.h](h6On success, a worker_pool with the same attributes as }(hj'hhhNhNubj)}(h **attrs**h]hattrs}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh. On failure, }(hj'hhhNhNubj)}(h``NULL``h]hNULL}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubh.}(hj'hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM]hjiubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j wq_calc_pod_cpumask (C function)c.wq_calc_pod_cpumaskhNtauh1jhjhhhNhNubj)}(hhh](j)}(hAvoid wq_calc_pod_cpumask (struct workqueue_attrs *attrs, int cpu)h]j)}(h@void wq_calc_pod_cpumask(struct workqueue_attrs *attrs, int cpu)h](j)}(hvoidh]hvoid}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM$ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjvhhhjhM$ubj)}(hwq_calc_pod_cpumaskh]j)}(hwq_calc_pod_cpumaskh]hwq_calc_pod_cpumask}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjvhhhjhM$ubj|)}(h((struct workqueue_attrs *attrs, int cpu)h](j)}(hstruct workqueue_attrs *attrsh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_attrsh]hworkqueue_attrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.wq_calc_pod_cpumaskasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hattrsh]hattrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint cpuh](j)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj%ubj)}(hcpuh]hcpu}(hjEhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjvhhhjhM$ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjrhhhjhM$ubah}(h]jmah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM$hjohhubjC)}(hhh]h)}(h'calculate a wq_attrs' cpumask for a podh]h)calculate a wq_attrs’ cpumask for a pod}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM$hjlhhubah}(h]h ]h"]h$]h&]uh1jBhjohhhjhM$ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hXK**Parameters** ``struct workqueue_attrs *attrs`` the wq_attrs of the default pwq of the target workqueue ``int cpu`` the target CPU **Description** Calculate the cpumask a workqueue with **attrs** should use on **pod**. The result is stored in **attrs->__pod_cpumask**. If pod affinity is not enabled, **attrs->cpumask** is always used. If enabled and **pod** has online CPUs requested by **attrs**, the returned cpumask is the intersection of the possible CPUs of **pod** and **attrs->cpumask**. The caller is responsible for ensuring that the cpumask of **pod** stays stable.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM(hjubjg)}(hhh](jl)}(hZ``struct workqueue_attrs *attrs`` the wq_attrs of the default pwq of the target workqueue h](jr)}(h!``struct workqueue_attrs *attrs``h]j)}(hjh]hstruct workqueue_attrs *attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM%hjubj)}(hhh]h)}(h7the wq_attrs of the default pwq of the target workqueueh]h7the wq_attrs of the default pwq of the target workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM%hjubjl)}(h``int cpu`` the target CPU h](jr)}(h ``int cpu``h]j)}(hjh]hint cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM&hjubj)}(hhh]h)}(hthe target CPUh]hthe target CPU}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM&hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM&hjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM(hjubh)}(hyCalculate the cpumask a workqueue with **attrs** should use on **pod**. The result is stored in **attrs->__pod_cpumask**.h](h'Calculate the cpumask a workqueue with }(hj:hhhNhNubj)}(h **attrs**h]hattrs}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh should use on }(hj:hhhNhNubj)}(h**pod**h]hpod}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh. The result is stored in }(hj:hhhNhNubj)}(h**attrs->__pod_cpumask**h]hattrs->__pod_cpumask}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM'hjubh)}(hIf pod affinity is not enabled, **attrs->cpumask** is always used. If enabled and **pod** has online CPUs requested by **attrs**, the returned cpumask is the intersection of the possible CPUs of **pod** and **attrs->cpumask**.h](h If pod affinity is not enabled, }(hjhhhNhNubj)}(h**attrs->cpumask**h]hattrs->cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is always used. If enabled and }(hjhhhNhNubj)}(h**pod**h]hpod}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh has online CPUs requested by }(hjhhhNhNubj)}(h **attrs**h]hattrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhC, the returned cpumask is the intersection of the possible CPUs of }(hjhhhNhNubj)}(h**pod**h]hpod}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h**attrs->cpumask**h]hattrs->cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*hjubh)}(hPThe caller is responsible for ensuring that the cpumask of **pod** stays stable.h](h;The caller is responsible for ensuring that the cpumask of }(hjhhhNhNubj)}(h**pod**h]hpod}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh stays stable.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM.hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"apply_workqueue_attrs (C function)c.apply_workqueue_attrshNtauh1jhjhhhNhNubj)}(hhh](j)}(h\int apply_workqueue_attrs (struct workqueue_struct *wq, const struct workqueue_attrs *attrs)h]j)}(h[int apply_workqueue_attrs(struct workqueue_struct *wq, const struct workqueue_attrs *attrs)h](j)}(hinth]hint}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj8hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj%hhhj7hMubj)}(happly_workqueue_attrsh]j)}(happly_workqueue_attrsh]happly_workqueue_attrs}(hjJhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjFubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj%hhhj7hMubj|)}(hB(struct workqueue_struct *wq, const struct workqueue_attrs *attrs)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubj)}(h h]h }(hjshhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjbubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jLsbc.apply_workqueue_attrsasbuh1hhjbubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjbubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjbubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj^ubj)}(h#const struct workqueue_attrs *attrsh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_attrsh]hworkqueue_attrs}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.apply_workqueue_attrsasbuh1hhjubj)}(h h]h }(hj/hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj=hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hattrsh]hattrs}(hjJhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj^ubeh}(h]h ]h"]h$]h&]jjuh1j{hj%hhhj7hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj!hhhj7hMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj7hMhjhhubjC)}(hhh]h)}(h1apply new workqueue_attrs to an unbound workqueueh]h1apply new workqueue_attrs to an unbound workqueue}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjqhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj7hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` the target workqueue ``const struct workqueue_attrs *attrs`` the workqueue_attrs to apply, allocated with alloc_workqueue_attrs() **Description** Apply **attrs** to an unbound workqueue **wq**. Unless disabled, this function maps a separate pwq to each CPU pod with possibles CPUs in **attrs->cpumask** so that work items are affine to the pod it was issued on. Older pwqs are released as in-flight work items finish. Note that a work item which repeatedly requeues itself back-to-back will stay on its current pwq. Performs GFP_KERNEL allocations. **Return** 0 on success and -errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h5``struct workqueue_struct *wq`` the target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe target workqueueh]hthe target workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubjl)}(hm``const struct workqueue_attrs *attrs`` the workqueue_attrs to apply, allocated with alloc_workqueue_attrs() h](jr)}(h'``const struct workqueue_attrs *attrs``h]j)}(hjh]h#const struct workqueue_attrs *attrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hDthe workqueue_attrs to apply, allocated with alloc_workqueue_attrs()h]hDthe workqueue_attrs to apply, allocated with alloc_workqueue_attrs()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj)h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXqApply **attrs** to an unbound workqueue **wq**. Unless disabled, this function maps a separate pwq to each CPU pod with possibles CPUs in **attrs->cpumask** so that work items are affine to the pod it was issued on. Older pwqs are released as in-flight work items finish. Note that a work item which repeatedly requeues itself back-to-back will stay on its current pwq.h](hApply }(hj?hhhNhNubj)}(h **attrs**h]hattrs}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubh to an unbound workqueue }(hj?hhhNhNubj)}(h**wq**h]hwq}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubh\. Unless disabled, this function maps a separate pwq to each CPU pod with possibles CPUs in }(hj?hhhNhNubj)}(h**attrs->cpumask**h]hattrs->cpumask}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubh so that work items are affine to the pod it was issued on. Older pwqs are released as in-flight work items finish. Note that a work item which repeatedly requeues itself back-to-back will stay on its current pwq.}(hj?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h Performs GFP_KERNEL allocations.h]h Performs GFP_KERNEL allocations.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h#0 on success and -errno on failure.h]h#0 on success and -errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"unbound_wq_update_pwq (C function)c.unbound_wq_update_pwqhNtauh1jhjhhhNhNubj)}(hhh](j)}(hAvoid unbound_wq_update_pwq (struct workqueue_struct *wq, int cpu)h]j)}(h@void unbound_wq_update_pwq(struct workqueue_struct *wq, int cpu)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hunbound_wq_update_pwqh]j)}(hunbound_wq_update_pwqh]hunbound_wq_update_pwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h&(struct workqueue_struct *wq, int cpu)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj7modnameN classnameNj7j:)}j=]j@)}j3jsbc.unbound_wq_update_pwqasbuh1hhjubj)}(h h]h }(hjUhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjchhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjphhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h%update a pwq slot for CPU hot[un]plugh]h%update a pwq slot for CPU hot[un]plug}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hXj**Parameters** ``struct workqueue_struct *wq`` the target workqueue ``int cpu`` the CPU to update the pwq slot for **Description** This function is to be called from ``CPU_DOWN_PREPARE``, ``CPU_ONLINE`` and ``CPU_DOWN_FAILED``. **cpu** is in the same pod of the CPU being hot[un]plugged. If pod affinity can't be adjusted due to memory allocation failure, it falls back to **wq->dfl_pwq** which may not be optimal but is always correct. Note that when the last allowed CPU of a pod goes offline for a workqueue with a cpumask spanning multiple pods, the workers which were already executing the work items for the workqueue will lose their CPU affinity and may execute on any CPU. This is similar to how per-cpu workqueues behave on CPU_DOWN. If a workqueue user wants strict affinity, it's the user's responsibility to flush the work item from CPU_DOWN_PREPARE.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h5``struct workqueue_struct *wq`` the target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubj)}(hhh]h)}(hthe target workqueueh]hthe target workqueue}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj&ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhj%hMhjubjl)}(h/``int cpu`` the CPU to update the pwq slot for h](jr)}(h ``int cpu``h]j)}(hjIh]hint cpu}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjCubj)}(hhh]h)}(h"the CPU to update the pwq slot forh]h"the CPU to update the pwq slot for}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hMhj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jkhj^hMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hThis function is to be called from ``CPU_DOWN_PREPARE``, ``CPU_ONLINE`` and ``CPU_DOWN_FAILED``. **cpu** is in the same pod of the CPU being hot[un]plugged.h](h#This function is to be called from }(hjhhhNhNubj)}(h``CPU_DOWN_PREPARE``h]hCPU_DOWN_PREPARE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h``CPU_ONLINE``h]h CPU_ONLINE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh and }(hjhhhNhNubj)}(h``CPU_DOWN_FAILED``h]hCPU_DOWN_FAILED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. }(hjhhhNhNubj)}(h**cpu**h]hcpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh4 is in the same pod of the CPU being hot[un]plugged.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hIf pod affinity can't be adjusted due to memory allocation failure, it falls back to **wq->dfl_pwq** which may not be optimal but is always correct.h](hWIf pod affinity can’t be adjusted due to memory allocation failure, it falls back to }(hjhhhNhNubj)}(h**wq->dfl_pwq**h]h wq->dfl_pwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0 which may not be optimal but is always correct.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXNote that when the last allowed CPU of a pod goes offline for a workqueue with a cpumask spanning multiple pods, the workers which were already executing the work items for the workqueue will lose their CPU affinity and may execute on any CPU. This is similar to how per-cpu workqueues behave on CPU_DOWN. If a workqueue user wants strict affinity, it's the user's responsibility to flush the work item from CPU_DOWN_PREPARE.h]hXNote that when the last allowed CPU of a pod goes offline for a workqueue with a cpumask spanning multiple pods, the workers which were already executing the work items for the workqueue will lose their CPU affinity and may execute on any CPU. This is similar to how per-cpu workqueues behave on CPU_DOWN. If a workqueue user wants strict affinity, it’s the user’s responsibility to flush the work item from CPU_DOWN_PREPARE.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!wq_adjust_max_active (C function)c.wq_adjust_max_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(h7void wq_adjust_max_active (struct workqueue_struct *wq)h]j)}(h6void wq_adjust_max_active(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjPhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=hhhjOhMubj)}(hwq_adjust_max_activeh]j)}(hwq_adjust_max_activeh]hwq_adjust_max_active}(hjbhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj^ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj=hhhjOhMubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjzubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jdsbc.wq_adjust_max_activeasbuh1hhjzubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjzubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjzubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjvubah}(h]h ]h"]h$]h&]jjuh1j{hj=hhhjOhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj9hhhjOhMubah}(h]j4ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjOhMhj6hhubjC)}(hhh]h)}(h/update a wq's max_active to the current settingh]h1update a wq’s max_active to the current setting}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhj6hhhjOhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` target workqueue **Description** If **wq** isn't freezing, set **wq->max_active** to the saved_max_active and activate inactive work items accordingly. If **wq** is freezing, clear **wq->max_active** to zero.h](h)}(h**Parameters**h]j)}(hj#h]h Parameters}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h1``struct workqueue_struct *wq`` target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjBh]hstruct workqueue_struct *wq}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj<ubj)}(hhh]h)}(htarget workqueueh]htarget workqueue}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjXubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jkhjWhMhj9ubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj}h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hIf **wq** isn't freezing, set **wq->max_active** to the saved_max_active and activate inactive work items accordingly. If **wq** is freezing, clear **wq->max_active** to zero.h](hIf }(hjhhhNhNubj)}(h**wq**h]hwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh isn’t freezing, set }(hjhhhNhNubj)}(h**wq->max_active**h]hwq->max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhJ to the saved_max_active and activate inactive work items accordingly. If }(hjhhhNhNubj)}(h**wq**h]hwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is freezing, clear }(hjhhhNhNubj)}(h**wq->max_active**h]hwq->max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to zero.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdestroy_workqueue (C function)c.destroy_workqueuehNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void destroy_workqueue (struct workqueue_struct *wq)h]j)}(h3void destroy_workqueue(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hdestroy_workqueueh]j)}(hdestroy_workqueueh]hdestroy_workqueue}(hj+hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj'ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(h h]h }(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjCubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjehhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjgmodnameN classnameNj7j:)}j=]j@)}j3j-sbc.destroy_workqueueasbuh1hhjCubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjCubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjCubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj?ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(hsafely terminate a workqueueh]hsafely terminate a workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` target workqueue **Description** Safely destroy a workqueue. All work currently pending will be done first. This function does NOT guarantee that non-pending work that has been submitted with queue_delayed_work() and similar functions will be done before destroying the workqueue. The fundamental problem is that, currently, the workqueue has no way of accessing non-pending delayed_work. delayed_work is only linked on the timer-side. All delayed_work must, therefore, be canceled before calling this function. TODO: It would be better if the problem described above wouldn't exist and destroy_workqueue() would cleanly cancel all pending and non-pending delayed_work.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h1``struct workqueue_struct *wq`` target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hj h]hstruct workqueue_struct *wq}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(htarget workqueueh]htarget workqueue}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj hMhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjFh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hJSafely destroy a workqueue. All work currently pending will be done first.h]hJSafely destroy a workqueue. All work currently pending will be done first.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXThis function does NOT guarantee that non-pending work that has been submitted with queue_delayed_work() and similar functions will be done before destroying the workqueue. The fundamental problem is that, currently, the workqueue has no way of accessing non-pending delayed_work. delayed_work is only linked on the timer-side. All delayed_work must, therefore, be canceled before calling this function.h]hXThis function does NOT guarantee that non-pending work that has been submitted with queue_delayed_work() and similar functions will be done before destroying the workqueue. The fundamental problem is that, currently, the workqueue has no way of accessing non-pending delayed_work. delayed_work is only linked on the timer-side. All delayed_work must, therefore, be canceled before calling this function.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hTODO: It would be better if the problem described above wouldn't exist and destroy_workqueue() would cleanly cancel all pending and non-pending delayed_work.h]hTODO: It would be better if the problem described above wouldn’t exist and destroy_workqueue() would cleanly cancel all pending and non-pending delayed_work.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%workqueue_set_max_active (C function)c.workqueue_set_max_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(hKvoid workqueue_set_max_active (struct workqueue_struct *wq, int max_active)h]j)}(hJvoid workqueue_set_max_active(struct workqueue_struct *wq, int max_active)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMFubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMFubj)}(hworkqueue_set_max_activeh]j)}(hworkqueue_set_max_activeh]hworkqueue_set_max_active}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMFubj|)}(h-(struct workqueue_struct *wq, int max_active)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.workqueue_set_max_activeasbuh1hhjubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj2hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint max_activeh](j)}(hinth]hint}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjfhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjTubj)}(h max_activeh]h max_active}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMFubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMFubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMFhjhhubjC)}(hhh]h)}(h adjust max_active of a workqueueh]h adjust max_active of a workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMFhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMFubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` target workqueue ``int max_active`` new max_active value. **Description** Set max_active of **wq** to **max_active**. See the alloc_workqueue() function comment. **Context** Don't call from IRQ context.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMJhjubjg)}(hhh](jl)}(h1``struct workqueue_struct *wq`` target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMGhjubj)}(hhh]h)}(htarget workqueueh]htarget workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMGhjubjl)}(h)``int max_active`` new max_active value. h](jr)}(h``int max_active``h]j)}(hjh]hint max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMHhjubj)}(hhh]h)}(hnew max_active value.h]hnew max_active value.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMHhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj-hMHhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjSh]h Description}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMJhjubh)}(hWSet max_active of **wq** to **max_active**. See the alloc_workqueue() function comment.h](hSet max_active of }(hjihhhNhNubj)}(h**wq**h]hwq}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubh to }(hjihhhNhNubj)}(h**max_active**h]h max_active}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubh-. See the alloc_workqueue() function comment.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMIhjubh)}(h **Context**h]j)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMLhjubh)}(hDon't call from IRQ context.h]hDon’t call from IRQ context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%workqueue_set_min_active (C function)c.workqueue_set_min_activehNtauh1jhjhhhNhNubj)}(hhh](j)}(hKvoid workqueue_set_min_active (struct workqueue_struct *wq, int min_active)h]j)}(hJvoid workqueue_set_min_active(struct workqueue_struct *wq, int min_active)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMhubj)}(hworkqueue_set_min_activeh]j)}(hworkqueue_set_min_activeh]hworkqueue_set_min_active}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMhubj|)}(h-(struct workqueue_struct *wq, int min_active)h](j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj-hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hj>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj@modnameN classnameNj7j:)}j=]j@)}j3jsbc.workqueue_set_min_activeasbuh1hhjubj)}(h h]h }(hj^hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjlhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjyhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint min_activeh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(h min_activeh]h min_active}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMhubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMhubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhhjhhubjC)}(hhh]h)}(h)adjust min_active of an unbound workqueueh]h)adjust min_active of an unbound workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMhubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX(**Parameters** ``struct workqueue_struct *wq`` target unbound workqueue ``int min_active`` new min_active value **Description** Set min_active of an unbound workqueue. Unlike other types of workqueues, an unbound workqueue is not guaranteed to be able to process max_active interdependent work items. Instead, an unbound workqueue is guaranteed to be able to process min_active number of interdependent work items which is ``WQ_DFL_MIN_ACTIVE`` by default. Use this function to adjust the min_active value between 0 and the current max_active.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMlhjubjg)}(hhh](jl)}(h9``struct workqueue_struct *wq`` target unbound workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMihjubj)}(hhh]h)}(htarget unbound workqueueh]htarget unbound workqueue}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMihj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj.hMihjubjl)}(h(``int min_active`` new min_active value h](jr)}(h``int min_active``h]j)}(hjRh]hint min_active}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMjhjLubj)}(hhh]h)}(hnew min_active valueh]hnew min_active value}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghMjhjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jkhjghMjhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMlhjubh)}(hXHSet min_active of an unbound workqueue. Unlike other types of workqueues, an unbound workqueue is not guaranteed to be able to process max_active interdependent work items. Instead, an unbound workqueue is guaranteed to be able to process min_active number of interdependent work items which is ``WQ_DFL_MIN_ACTIVE`` by default.h](hX'Set min_active of an unbound workqueue. Unlike other types of workqueues, an unbound workqueue is not guaranteed to be able to process max_active interdependent work items. Instead, an unbound workqueue is guaranteed to be able to process min_active number of interdependent work items which is }(hjhhhNhNubj)}(h``WQ_DFL_MIN_ACTIVE``h]hWQ_DFL_MIN_ACTIVE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh by default.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMkhjubh)}(hVUse this function to adjust the min_active value between 0 and the current max_active.h]hVUse this function to adjust the min_active value between 0 and the current max_active.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMqhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcurrent_work (C function)c.current_workhNtauh1jhjhhhNhNubj)}(hhh](j)}(h(struct work_struct * current_work (void)h]j)}(h&struct work_struct *current_work(void)h](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubh)}(hhh]j)}(h work_structh]h work_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3 current_worksbc.current_workasbuh1hhjhhhjhMubj)}(h h]h }(hj3hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubjU)}(hjuh]h*}(hjAhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjhhhjhMubj)}(h current_workh]j)}(hj0h]h current_work}(hjRhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjNubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]noemphjjuh1jhjeubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h'retrieve ``current`` task's work structh](h retrieve }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh task’s work struct}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX'**Parameters** ``void`` no arguments **Description** Determine if ``current`` task is a workqueue worker and what it's working on. Useful to find out the context that the ``current`` task is running in. **Return** work struct if ``current`` task is a workqueue worker, ``NULL`` otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj%h]h Description}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubh)}(hDetermine if ``current`` task is a workqueue worker and what it's working on. Useful to find out the context that the ``current`` task is running in.h](h Determine if }(hj;hhhNhNubj)}(h ``current``h]hcurrent}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh` task is a workqueue worker and what it’s working on. Useful to find out the context that the }(hj;hhhNhNubj)}(h ``current``h]hcurrent}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubh task is running in.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hjph]hReturn}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hJwork struct if ``current`` task is a workqueue worker, ``NULL`` otherwise.h](hwork struct if }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh task is a workqueue worker, }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j)current_is_workqueue_rescuer (C function)c.current_is_workqueue_rescuerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h(bool current_is_workqueue_rescuer (void)h]j)}(h'bool current_is_workqueue_rescuer(void)h](j)}(hj*h]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hcurrent_is_workqueue_rescuerh]j)}(hcurrent_is_workqueue_rescuerh]hcurrent_is_workqueue_rescuer}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhj ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h!is ``current`` workqueue rescuer?h](his }(hj?hhhNhNubj)}(h ``current``h]hcurrent}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubh workqueue rescuer?}(hj?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj<hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejijfjijgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``void`` no arguments **Description** Determine whether ``current`` is a workqueue rescuer. Can be used from work functions to determine whether it's being run off the rescuer task. **Return** ``true`` if ``current`` is a workqueue rescuer. ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjsh]h Parameters}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjmubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubah}(h]h ]h"]h$]h&]uh1jfhjmubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjmubh)}(hDetermine whether ``current`` is a workqueue rescuer. Can be used from work functions to determine whether it's being run off the rescuer task.h](hDetermine whether }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhu is a workqueue rescuer. Can be used from work functions to determine whether it’s being run off the rescuer task.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjmubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjmubh)}(hD``true`` if ``current`` is a workqueue rescuer. ``false`` otherwise.h](j)}(h``true``h]htrue}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is a workqueue rescuer. }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjmubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-current_is_workqueue_mem_reclaim (C function)"c.current_is_workqueue_mem_reclaimhNtauh1jhjhhhNhNubj)}(hhh](j)}(h,bool current_is_workqueue_mem_reclaim (void)h]j)}(h+bool current_is_workqueue_mem_reclaim(void)h](j)}(hj*h]hbool}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjyhhhjhMubj)}(h current_is_workqueue_mem_reclaimh]j)}(h current_is_workqueue_mem_reclaimh]h current_is_workqueue_mem_reclaim}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjyhhhjhMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjyhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjuhhhjhMubah}(h]jpah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjrhhubjC)}(hhh]h)}(h+is ``current`` a ``WQ_MEM_RECLAIM`` worker?h](his }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh a }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh worker?}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjrhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``void`` no arguments **Description** Determine whether ``current`` is a workqueue worker executing on a workqueue created with ``WQ_MEM_RECLAIM``. This mirrors the condition that check_flush_dependency() warns on: flushing (or otherwise waiting on) a !WQ_MEM_RECLAIM workqueue from such a context breaks the forward-progress guarantee and can deadlock. Callers that may recurse into such a flush -- e.g. NFS LOCALIO submitting into a stacked filesystem that flushes its own !WQ_MEM_RECLAIM workqueue -- can use this to decide whether they must defer the work to a !WQ_MEM_RECLAIM workqueue rather than run it inline. **Return** ``true`` if ``current`` is a ``WQ_MEM_RECLAIM`` worker. ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hj)h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj#ubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hjHh]hvoid}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjBubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hKhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jkhj]hKhj?ubah}(h]h ]h"]h$]h&]uh1jfhj#ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj#ubh)}(hXEDetermine whether ``current`` is a workqueue worker executing on a workqueue created with ``WQ_MEM_RECLAIM``. This mirrors the condition that check_flush_dependency() warns on: flushing (or otherwise waiting on) a !WQ_MEM_RECLAIM workqueue from such a context breaks the forward-progress guarantee and can deadlock. Callers that may recurse into such a flush -- e.g. NFS LOCALIO submitting into a stacked filesystem that flushes its own !WQ_MEM_RECLAIM workqueue -- can use this to decide whether they must defer the work to a !WQ_MEM_RECLAIM workqueue rather than run it inline.h](hDetermine whether }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh= is a workqueue worker executing on a workqueue created with }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX. This mirrors the condition that check_flush_dependency() warns on: flushing (or otherwise waiting on) a !WQ_MEM_RECLAIM workqueue from such a context breaks the forward-progress guarantee and can deadlock. Callers that may recurse into such a flush -- e.g. NFS LOCALIO submitting into a stacked filesystem that flushes its own !WQ_MEM_RECLAIM workqueue -- can use this to decide whether they must defer the work to a !WQ_MEM_RECLAIM workqueue rather than run it inline.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj#ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj#ubh)}(hM``true`` if ``current`` is a ``WQ_MEM_RECLAIM`` worker. ``false`` otherwise.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if }(hjhhhNhNubj)}(h ``current``h]hcurrent}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is a }(hjhhhNhNubj)}(h``WQ_MEM_RECLAIM``h]hWQ_MEM_RECLAIM}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh worker. }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j workqueue_congested (C function)c.workqueue_congestedhNtauh1jhjhhhNhNubj)}(hhh](j)}(h?bool workqueue_congested (int cpu, struct workqueue_struct *wq)h]j)}(h>bool workqueue_congested(int cpu, struct workqueue_struct *wq)h](j)}(hj*h]hbool}(hjWhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjehhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjShhhjdhMubj)}(hworkqueue_congestedh]j)}(hworkqueue_congestedh]hworkqueue_congested}(hjwhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjsubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjShhhjdhMubj|)}(h&(int cpu, struct workqueue_struct *wq)h](j)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jysbc.workqueue_congestedasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hj!hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjShhhjdhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjOhhhjdhMubah}(h]jJah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjdhMhjLhhubjC)}(hhh]h)}(h%test whether a workqueue is congestedh]h%test whether a workqueue is congested}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjHhhubah}(h]h ]h"]h$]h&]uh1jBhjLhhhjdhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejcjfjcjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` CPU in question ``struct workqueue_struct *wq`` target workqueue **Description** Test whether **wq**'s cpu workqueue for **cpu** is congested. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging. If **cpu** is WORK_CPU_UNBOUND, the test is performed on the local CPU. With the exception of ordered workqueues, all workqueues have per-cpu pool_workqueues, each with its own congested state. A workqueue being congested on one CPU doesn't mean that the workqueue is contested on any other CPUs. **Return** ``true`` if congested, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjmh]h Parameters}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubjg)}(hhh](jl)}(h``int cpu`` CPU in question h](jr)}(h ``int cpu``h]j)}(hjh]hint cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hCPU in questionh]hCPU in question}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubjl)}(h1``struct workqueue_struct *wq`` target workqueue h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(htarget workqueueh]htarget workqueue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjgubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubh)}(hTest whether **wq**'s cpu workqueue for **cpu** is congested. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging.h](h Test whether }(hjhhhNhNubj)}(h**wq**h]hwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh’s cpu workqueue for }(hjhhhNhNubj)}(h**cpu**h]hcpu}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is congested. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubh)}(hGIf **cpu** is WORK_CPU_UNBOUND, the test is performed on the local CPU.h](hIf }(hjIhhhNhNubj)}(h**cpu**h]hcpu}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubh= is WORK_CPU_UNBOUND, the test is performed on the local CPU.}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubh)}(hWith the exception of ordered workqueues, all workqueues have per-cpu pool_workqueues, each with its own congested state. A workqueue being congested on one CPU doesn't mean that the workqueue is contested on any other CPUs.h]hWith the exception of ordered workqueues, all workqueues have per-cpu pool_workqueues, each with its own congested state. A workqueue being congested on one CPU doesn’t mean that the workqueue is contested on any other CPUs.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubh)}(h **Return**h]j)}(hj{h]hReturn}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubh)}(h+``true`` if congested, ``false`` otherwise.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if congested, }(hjhhhNhNubj)}(h ``false``h]hfalse}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh otherwise.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjgubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwork_busy (C function) c.work_busyhNtauh1jhjhhhNhNubj)}(hhh](j)}(h1unsigned int work_busy (struct work_struct *work)h]j)}(h0unsigned int work_busy(struct work_struct *work)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(h work_busyh]j)}(h work_busyh]h work_busy}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct work_struct *work)h]j)}(hstruct work_struct *workh](j)}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(h h]h }(hjFhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5ubh)}(hhh]j)}(h work_structh]h work_struct}(hjWhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjYmodnameN classnameNj7j:)}j=]j@)}j3jsb c.work_busyasbuh1hhj5ubj)}(h h]h }(hjwhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj5ubj)}(hworkh]hwork}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj1ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h3test whether a work is currently pending or runningh]h3test whether a work is currently pending or running}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hXD**Parameters** ``struct work_struct *work`` the work to be tested **Description** Test whether **work** is currently pending or running. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging. **Return** OR'd bitmask of WORK_BUSY_* bits.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h3``struct work_struct *work`` the work to be tested h](jr)}(h``struct work_struct *work``h]j)}(hjh]hstruct work_struct *work}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe work to be testedh]hthe work to be tested}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj8h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hTest whether **work** is currently pending or running. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging.h](h Test whether }(hjNhhhNhNubj)}(h**work**h]hwork}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubh is currently pending or running. There is no synchronization around this function and the test result is unreliable and only useful as advisory hints or for debugging.}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h **Return**h]j)}(hjqh]hReturn}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h!OR'd bitmask of WORK_BUSY_* bits.h]h#OR’d bitmask of WORK_BUSY_* bits.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jset_worker_desc (C function)c.set_worker_deschNtauh1jhjhhhNhNubj)}(hhh](j)}(h+void set_worker_desc (const char *fmt, ...)h]j)}(h*void set_worker_desc(const char *fmt, ...)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hset_worker_desch]j)}(hset_worker_desch]hset_worker_desc}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(const char *fmt, ...)h](j)}(hconst char *fmth](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj*hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hfmth]hfmt}(hj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h...h]jU)}(hjph]h...}(hjPhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjLubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h)set description for the current work itemh]h)set description for the current work item}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjvhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``const char *fmt`` printf-style format string ``...`` arguments for the format string **Description** This function can be called by a running work function to describe what the work item is about. If the worker task gets dumped, this information will be printed out together to help debugging. The description can be at most WORKER_DESC_LEN including the trailing '\0'.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h/``const char *fmt`` printf-style format string h](jr)}(h``const char *fmt``h]j)}(hjh]hconst char *fmt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hprintf-style format stringh]hprintf-style format string}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubjl)}(h(``...`` arguments for the format string h](jr)}(h``...``h]j)}(hjh]h...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(harguments for the format stringh]harguments for the format string}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj.h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hXThis function can be called by a running work function to describe what the work item is about. If the worker task gets dumped, this information will be printed out together to help debugging. The description can be at most WORKER_DESC_LEN including the trailing '\0'.h]hXThis function can be called by a running work function to describe what the work item is about. If the worker task gets dumped, this information will be printed out together to help debugging. The description can be at most WORKER_DESC_LEN including the trailing ‘0’.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jprint_worker_info (C function)c.print_worker_infohNtauh1jhjhhhNhNubj)}(hhh](j)}(hFvoid print_worker_info (const char *log_lvl, struct task_struct *task)h]j)}(hEvoid print_worker_info(const char *log_lvl, struct task_struct *task)h](j)}(hvoidh]hvoid}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjohhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjohhhjhMubj)}(hprint_worker_infoh]j)}(hprint_worker_infoh]hprint_worker_info}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjohhhjhMubj|)}(h/(const char *log_lvl, struct task_struct *task)h](j)}(hconst char *log_lvlh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hlog_lvlh]hlog_lvl}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct task_struct *taskh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubh)}(hhh]j)}(h task_structh]h task_struct}(hj+hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj-modnameN classnameNj7j:)}j=]j@)}j3jsbc.print_worker_infoasbuh1hhj ubj)}(h h]h }(hjKhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjU)}(hjuh]h*}(hjYhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj ubj)}(htaskh]htask}(hjfhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjohhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjkhhhjhMubah}(h]jfah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhhubjC)}(hhh]h)}(h,print out worker information and descriptionh]h,print out worker information and description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``const char *log_lvl`` the log level to use when printing ``struct task_struct *task`` target task **Description** If **task** is a worker and currently executing a work item, print out the name of the workqueue being serviced and worker description set with set_worker_desc() by the currently executing work item. This function can be safely called on any task as long as the task_struct itself is accessible. While safe, this function isn't synchronized and may print out mixups or garbages of limited length.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh](jl)}(h;``const char *log_lvl`` the log level to use when printing h](jr)}(h``const char *log_lvl``h]j)}(hjh]hconst char *log_lvl}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h"the log level to use when printingh]h"the log level to use when printing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubjl)}(h)``struct task_struct *task`` target task h](jr)}(h``struct task_struct *task``h]j)}(hj h]hstruct task_struct *task}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h target taskh]h target task}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjEh]h Description}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hIf **task** is a worker and currently executing a work item, print out the name of the workqueue being serviced and worker description set with set_worker_desc() by the currently executing work item.h](hIf }(hj[hhhNhNubj)}(h**task**h]htask}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubh is a worker and currently executing a work item, print out the name of the workqueue being serviced and worker description set with set_worker_desc() by the currently executing work item.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(hThis function can be safely called on any task as long as the task_struct itself is accessible. While safe, this function isn't synchronized and may print out mixups or garbages of limited length.h]hThis function can be safely called on any task as long as the task_struct itself is accessible. While safe, this function isn’t synchronized and may print out mixups or garbages of limited length.}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jshow_one_workqueue (C function)c.show_one_workqueuehNtauh1jhjhhhNhNubj)}(hhh](j)}(h5void show_one_workqueue (struct workqueue_struct *wq)h]j)}(h4void show_one_workqueue(struct workqueue_struct *wq)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hshow_one_workqueueh]j)}(hshow_one_workqueueh]hshow_one_workqueue}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.show_one_workqueueasbuh1hhjubj)}(h h]h }(hj&hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj4hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjAhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h!dump state of specified workqueueh]h!dump state of specified workqueue}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hW**Parameters** ``struct workqueue_struct *wq`` workqueue whose state will be printedh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(hE``struct workqueue_struct *wq`` workqueue whose state will be printedh](jr)}(h``struct workqueue_struct *wq``h]j)}(hjh]hstruct workqueue_struct *wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h%workqueue whose state will be printedh]h%workqueue whose state will be printed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!show_one_worker_pool (C function)c.show_one_worker_poolhNtauh1jhjhhhNhNubj)}(hhh](j)}(h4void show_one_worker_pool (struct worker_pool *pool)h]j)}(h3void show_one_worker_pool(struct worker_pool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hshow_one_worker_poolh]j)}(hshow_one_worker_poolh]hshow_one_worker_pool}(hj'hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj#ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(h h]h }(hjPhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?ubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjahhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjcmodnameN classnameNj7j:)}j=]j@)}j3j)sbc.show_one_worker_poolasbuh1hhj?ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj?ubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj;ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h#dump state of specified worker poolh]h#dump state of specified worker pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hV**Parameters** ``struct worker_pool *pool`` worker pool whose state will be printedh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh]jl)}(hD``struct worker_pool *pool`` worker pool whose state will be printedh](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h'worker pool whose state will be printedh]h'worker pool whose state will be printed}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j show_all_workqueues (C function)c.show_all_workqueueshNtauh1jhjhhhNhNubj)}(hhh](j)}(hvoid show_all_workqueues (void)h]j)}(hvoid show_all_workqueues(void)h](j)}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9ubj)}(h h]h }(hjphhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]hhhjohM9ubj)}(hshow_all_workqueuesh]j)}(hshow_all_workqueuesh]hshow_all_workqueues}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj~ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj]hhhjohM9ubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hj]hhhjohM9ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjYhhhjohM9ubah}(h]jTah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjohM9hjVhhubjC)}(hhh]h)}(hdump workqueue stateh]hdump workqueue state}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM9hjhhubah}(h]h ]h"]h$]h&]uh1jBhjVhhhjohM9ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Called from a sysrq handler and prints out all busy workqueues and pools.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM=hjubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj h]hvoid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjDh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubh)}(hICalled from a sysrq handler and prints out all busy workqueues and pools.h]hICalled from a sysrq handler and prints out all busy workqueues and pools.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM:hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&show_freezable_workqueues (C function)c.show_freezable_workqueueshNtauh1jhjhhhNhNubj)}(hhh](j)}(h%void show_freezable_workqueues (void)h]j)}(h$void show_freezable_workqueues(void)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMQubj)}(hshow_freezable_workqueuesh]j)}(hshow_freezable_workqueuesh]hshow_freezable_workqueues}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMQubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMQubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMQubah}(h]j|ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMQhj~hhubjC)}(hhh]h)}(hdump freezable workqueue stateh]hdump freezable workqueue state}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMQhjhhubah}(h]h ]h"]h$]h&]uh1jBhj~hhhjhMQubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Called from try_to_freeze_tasks() and prints out all freezable workqueues still busy.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMUhj ubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj1h]hvoid}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj+ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhKhjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jkhjFhKhj(ubah}(h]h ]h"]h$]h&]uh1jfhj ubh)}(h**Description**h]j)}(hjlh]h Description}(hjnhhhNhNubah}(h]h ]h"]h$]h&]u;h1jhjjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj ubh)}(hUCalled from try_to_freeze_tasks() and prints out all freezable workqueues still busy.h]hUCalled from try_to_freeze_tasks() and prints out all freezable workqueues still busy.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMRhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jrebind_workers (C function)c.rebind_workershNtauh1jhjhhhNhNubj)}(hhh](j)}(h.void rebind_workers (struct worker_pool *pool)h]j)}(h-void rebind_workers(struct worker_pool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hrebind_workersh]j)}(hrebind_workersh]hrebind_workers}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(struct worker_pool *pool)h]j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.rebind_workersasbuh1hhjubj)}(h h]h }(hj,hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj:hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpoolh]hpool}(hjGhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h2rebind all workers of a pool to the associated CPUh]h2rebind all workers of a pool to the associated CPU}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjnhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``struct worker_pool *pool`` pool of interest **Description** **pool->cpu** is coming online. Rebind all workers to the CPU.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubjg)}(hhh]jl)}(h.``struct worker_pool *pool`` pool of interest h](jr)}(h``struct worker_pool *pool``h]j)}(hjh]hstruct worker_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hpool of interesth]hpool of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubh)}(h?**pool->cpu** is coming online. Rebind all workers to the CPU.h](j)}(h **pool->cpu**h]h pool->cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh2 is coming online. Rebind all workers to the CPU.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j,restore_unbound_workers_cpumask (C function)!c.restore_unbound_workers_cpumaskhNtauh1jhjhhhNhNubj)}(hhh](j)}(hHvoid restore_unbound_workers_cpumask (struct worker_pool *pool, int cpu)h]j)}(hGvoid restore_unbound_workers_cpumask(struct worker_pool *pool, int cpu)h](j)}(hvoidh]hvoid}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj<hhhjNhMubj)}(hrestore_unbound_workers_cpumaskh]j)}(hrestore_unbound_workers_cpumaskh]hrestore_unbound_workers_cpumask}(hjahhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj<hhhjNhMubj|)}(h#(struct worker_pool *pool, int cpu)h](j)}(hstruct worker_pool *poolh](j)}(hjh]hstruct}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjyubh)}(hhh]j)}(h worker_poolh]h worker_pool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jcsb!c.restore_unbound_workers_cpumaskasbuh1hhjyubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjyubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjyubj)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjuubj)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjuubeh}(h]h ]h"]h$]h&]jjuh1j{hj<hhhjNhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj8hhhjNhMubah}(h]j3ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjNhMhj5hhubjC)}(hhh]h)}(h"restore cpumask of unbound workersh]h"restore cpumask of unbound workers}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj2hhubah}(h]h ]h"]h$]h&]uh1jBhj5hhhjNhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejMjfjMjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct worker_pool *pool`` unbound pool of interest ``int cpu`` the CPU which is coming up **Description** An unbound pool may end up with a cpumask which doesn't have any online CPUs. When a worker of such pool get scheduled, the scheduler resets its cpus_allowed. If **cpu** is in **pool**'s cpumask which didn't have any online CPU before, cpus_allowed of all its workers should be restored.h](h)}(h**Parameters**h]j)}(hjWh]h Parameters}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubjg)}(hhh](jl)}(h6``struct worker_pool *pool`` unbound pool of interest h](jr)}(h``struct worker_pool *pool``h]j)}(hjvh]hstruct worker_pool *pool}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjpubj)}(hhh]h)}(hunbound pool of interesth]hunbound pool of interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjmubjl)}(h'``int cpu`` the CPU which is coming up h](jr)}(h ``int cpu``h]j)}(hjh]hint cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe CPU which is coming uph]hthe CPU which is coming up}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjmubeh}(h]h ]h"]h$]h&]uh1jfhjQubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubh)}(hX!An unbound pool may end up with a cpumask which doesn't have any online CPUs. When a worker of such pool get scheduled, the scheduler resets its cpus_allowed. If **cpu** is in **pool**'s cpumask which didn't have any online CPU before, cpus_allowed of all its workers should be restored.h](hAn unbound pool may end up with a cpumask which doesn’t have any online CPUs. When a worker of such pool get scheduled, the scheduler resets its cpus_allowed. If }(hjhhhNhNubj)}(h**cpu**h]hcpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh is in }(hjhhhNhNubj)}(h**pool**h]hpool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhk’s cpumask which didn’t have any online CPU before, cpus_allowed of all its workers should be restored.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jwork_on_cpu_key (C function)c.work_on_cpu_keyhNtauh1jhjhhhNhNubj)}(hhh](j)}(hYlong work_on_cpu_key (int cpu, long (*fn)(void *), void *arg, struct lock_class_key *key)h]j)}(hWlong work_on_cpu_key(int cpu, long (*fn)(void*), void *arg, struct lock_class_key *key)h](j)}(hlongh]hlong}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjbhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOhhhjahMubj)}(hwork_on_cpu_keyh]j)}(hwork_on_cpu_keyh]hwork_on_cpu_key}(hjthhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjpubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjOhhhjahMubj|)}(hC(int cpu, long (*fn)(void*), void *arg, struct lock_class_key *key)h](j)}(hint cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpuh]hcpu}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hlong (*fn)(void*)h](j)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(h(h]h(}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hfnh]hfn}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubjU)}(h)h]h)}(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubjU)}(hjh]h(}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hvoidh]hvoid}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj3hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubjU)}(hj h]h)}(hj@hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h void *argh](j)}(hvoidh]hvoid}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hjfhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjTubjU)}(hjuh]h*}(hjthhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjTubj)}(hargh]harg}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct lock_class_key *keyh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hlock_class_keyh]hlock_class_key}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jvsbc.work_on_cpu_keyasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hkeyh]hkey}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjOhhhjahMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjKhhhjahMubah}(h]jFah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjahMhjHhhubjC)}(hhh]h)}(h4run a function in thread context on a particular cpuh]h4run a function in thread context on a particular cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjhhubah}(h]h ]h"]h$]h&]uh1jBhjHhhhjahMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej5jfj5jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``int cpu`` the cpu to run on ``long (*fn)(void *)`` the function to run ``void *arg`` the function arg ``struct lock_class_key *key`` The lock class key for lock debugging purposes **Description** It is up to the caller to ensure that the cpu doesn't go offline. The caller must not hold any locks which would prevent **fn** from completing. **Return** The value **fn** returns.h](h)}(h**Parameters**h]j)}(hj?h]h Parameters}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj9ubjg)}(hhh](jl)}(h``int cpu`` the cpu to run on h](jr)}(h ``int cpu``h]j)}(hj^h]hint cpu}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjXubj)}(hhh]h)}(hthe cpu to run onh]hthe cpu to run on}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshMhjtubah}(h]h ]h"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]uh1jkhjshMhjUubjl)}(h+``long (*fn)(void *)`` the function to run h](jr)}(h``long (*fn)(void *)``h]j)}(hjh]hlong (*fn)(void *)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe function to runh]hthe function to run}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjUubjl)}(h``void *arg`` the function arg h](jr)}(h ``void *arg``h]j)}(hjh]h void *arg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe function argh]hthe function arg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjUubjl)}(hN``struct lock_class_key *key`` The lock class key for lock debugging purposes h](jr)}(h``struct lock_class_key *key``h]j)}(hj h]hstruct lock_class_key *key}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(h.The lock class key for lock debugging purposesh]h.The lock class key for lock debugging purposes}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjUubeh}(h]h ]h"]h$]h&]uh1jfhj9ubh)}(h**Description**h]j)}(hjDh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj9ubh)}(hIt is up to the caller to ensure that the cpu doesn't go offline. The caller must not hold any locks which would prevent **fn** from completing.h](h{It is up to the caller to ensure that the cpu doesn’t go offline. The caller must not hold any locks which would prevent }(hjZhhhNhNubj)}(h**fn**h]hfn}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubh from completing.}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj9ubh)}(h **Return**h]j)}(hj}h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj9ubh)}(hThe value **fn** returns.h](h The value }(hjhhhNhNubj)}(h**fn**h]hfn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh returns.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$freeze_workqueues_begin (C function)c.freeze_workqueues_beginhNtauh1jhjhhhNhNubj)}(hhh](j)}(h#void freeze_workqueues_begin (void)h]j)}(h"void freeze_workqueues_begin(void)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hfreeze_workqueues_beginh]j)}(hfreeze_workqueues_beginh]hfreeze_workqueues_begin}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]noemphjjuh1jhj ubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(hbegin freezing workqueuesh]hbegin freezing workqueues}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj8 hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejS jfjS jgjhjiuh1jhhhjhNhNubjk)}(hX$**Parameters** ``void`` no arguments **Description** Start freezing workqueues. After this function returns, all freezable workqueues will queue new works to their inactive_works list instead of pool->worklist. **Context** Grabs and releases wq_pool_mutex, wq->mutex and pool->lock's.h](h)}(h**Parameters**h]j)}(hj] h]h Parameters}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW ubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj| h]hvoid}(hj~ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjz ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjv ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjv ubeh}(h]h ]h"]h$]h&]uh1jkhj hKhjs ubah}(h]h ]h"]h$]h&]uh1jfhjW ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjW ubh)}(hStart freezing workqueues. After this function returns, all freezable workqueues will queue new works to their inactive_works list instead of pool->worklist.h]hStart freezing workqueues. After this function returns, all freezable workqueues will queue new works to their inactive_works list instead of pool->worklist.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW ubh)}(h **Context**h]j)}(hj h]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW ubh)}(h=Grabs and releases wq_pool_mutex, wq->mutex and pool->lock's.h]h?Grabs and releases wq_pool_mutex, wq->mutex and pool->lock’s.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjW ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#freeze_workqueues_busy (C function)c.freeze_workqueues_busyhNtauh1jhjhhhNhNubj)}(hhh](j)}(h"bool freeze_workqueues_busy (void)h]j)}(h!bool freeze_workqueues_busy(void)h](j)}(hj*h]hbool}(hj# hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj1 hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj0 hMubj)}(hfreeze_workqueues_busyh]j)}(hfreeze_workqueues_busyh]hfreeze_workqueues_busy}(hjC hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj? ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj hhhj0 hMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hj_ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ ubah}(h]h ]h"]h$]h&]noemphjjuh1jhjW ubah}(h]h ]h"]h$]h&]jjuh1j{hj hhhj0 hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj hhhj0 hMubah}(h]j ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj0 hMhj hhubjC)}(hhh]h)}(h$are freezable workqueues still busy?h]h$are freezable workqueues still busy?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj hhubah}(h]h ]h"]h$]h&]uh1jBhj hhhj0 hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej jfj jgjhjiuh1jhhhjhNhNubjk)}(hXK**Parameters** ``void`` no arguments **Description** Check whether freezing is complete. This function must be called between freeze_workqueues_begin() and thaw_workqueues(). **Context** Grabs and releases wq_pool_mutex. **Return** ``true`` if some freezable workqueues are still busy. ``false`` if freezing is complete.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj h]hvoid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jkhj hKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj ubh)}(hzCheck whether freezing is complete. This function must be called between freeze_workqueues_begin() and thaw_workqueues().h]hzCheck whether freezing is complete. This function must be called between freeze_workqueues_begin() and thaw_workqueues().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubh)}(h **Context**h]j)}(hj, h]hContext}(hj. hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj* ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubh)}(h!Grabs and releases wq_pool_mutex.h]h!Grabs and releases wq_pool_mutex.}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubh)}(h **Return**h]j)}(hjS h]hReturn}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubh)}(hY``true`` if some freezable workqueues are still busy. ``false`` if freezing is complete.h](j)}(h``true``h]htrue}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji ubh/ if some freezable workqueues are still busy. }(hji hhhNhNubj)}(h ``false``h]hfalse}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji ubh if freezing is complete.}(hji hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jthaw_workqueues (C function)c.thaw_workqueueshNtauh1jhjhhhNhNubj)}(hhh](j)}(hvoid thaw_workqueues (void)h]j)}(hvoid thaw_workqueues(void)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj hMubj)}(hthaw_workqueuesh]j)}(hthaw_workqueuesh]hthaw_workqueues}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj hhhj hMubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]noemphjjuh1jhj ubah}(h]h ]h"]h$]h&]jjuh1j{hj hhhj hMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj hhhj hMubah}(h]j ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj hMhj hhubjC)}(hhh]h)}(hthaw workqueuesh]hthaw workqueues}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj hhubah}(h]h ]h"]h$]h&]uh1jBhj hhhj hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej7 jfj7 jgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``void`` no arguments **Description** Thaw workqueues. Normal queueing is restored and all collected frozen works are transferred to their respective pool worklists. **Context** Grabs and releases wq_pool_mutex, wq->mutex and pool->lock's.h](h)}(h**Parameters**h]j)}(hjA h]h Parameters}(hjC hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj? ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj; ubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj` h]hvoid}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjZ ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju hKhjv ubah}(h]h ]h"]h$]h&]uh1jhjZ ubeh}(h]h ]h"]h$]h&]uh1jkhju hKhjW ubah}(h]h ]h"]h$]h&]uh1jfhj; ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhj; ubh)}(hThaw workqueues. Normal queueing is restored and all collected frozen works are transferred to their respective pool worklists.h]hThaw workqueues. Normal queueing is restored and all collected frozen works are transferred to their respective pool worklists.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj; ubh)}(h **Context**h]j)}(hj h]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj; ubh)}(h=Grabs and releases wq_pool_mutex, wq->mutex and pool->lock's.h]h?Grabs and releases wq_pool_mutex, wq->mutex and pool->lock’s.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj; ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j2workqueue_unbound_housekeeping_update (C function)'c.workqueue_unbound_housekeeping_updatehNtauh1jhjhhhNhNubj)}(hhh](j)}(hDint workqueue_unbound_housekeeping_update (const struct cpumask *hk)h]j)}(hCint workqueue_unbound_housekeeping_update(const struct cpumask *hk)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMHubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj hMHubj)}(h%workqueue_unbound_housekeeping_updateh]j)}(h%workqueue_unbound_housekeeping_updateh]h%workqueue_unbound_housekeeping_update}(hj( hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ ubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhj hhhj hMHubj|)}(h(const struct cpumask *hk)h]j)}(hconst struct cpumask *hkh](j)}(hjh]hconst}(hjD hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ ubj)}(h h]h }(hjQ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj@ ubj)}(hjh]hstruct}(hj_ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ ubj)}(h h]h }(hjl hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj@ ubh)}(hhh]j)}(hcpumaskh]hcpumask}(hj} hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjz ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj modnameN classnameNj7j:)}j=]j@)}j3j* sb'c.workqueue_unbound_housekeeping_updateasbuh1hhj@ ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj@ ubjU)}(hjuh]h*}(hj hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj@ ubj)}(hhkh]hhk}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj@ ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj< ubah}(h]h ]h"]h$]h&]jjuh1j{hj hhhj hMHubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hj hhhj hMHubah}(h]j ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj hMHhj hhubjC)}(hhh]h)}(h%Propagate housekeeping cpumask updateh]h%Propagate housekeeping cpumask update}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMHhj hhubah}(h]h ]h"]h$]h&]uh1jBhj hhhj hMHubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej jfj jgjhjiuh1jhhhjhNhNubjk)}(hXr**Parameters** ``const struct cpumask *hk`` the new housekeeping cpumask **Description** Update the unbound workqueue cpumask on top of the new housekeeping cpumask such that the effective unbound affinity is the intersection of the new housekeeping with the requested affinity set via nohz_full=/isolcpus= or sysfs. **Return** 0 on success and -errno on failure.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMLhj ubjg)}(hhh]jl)}(h:``const struct cpumask *hk`` the new housekeeping cpumask h](jr)}(h``const struct cpumask *hk``h]j)}(hj#h]hconst struct cpumask *hk}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMIhjubj)}(hhh]h)}(hthe new housekeeping cpumaskh]hthe new housekeeping cpumask}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMIhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj8hMIhjubah}(h]h ]h"]h$]h&]uh1jfhj ubh)}(h**Description**h]j)}(hj^h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMKhj ubh)}(hUpdate the unbound workqueue cpumask on top of the new housekeeping cpumask such that the effective unbound affinity is the intersection of the new housekeeping with the requested affinity set via nohz_full=/isolcpus= or sysfs.h]hUpdate the unbound workqueue cpumask on top of the new housekeeping cpumask such that the effective unbound affinity is the intersection of the new housekeeping with the requested affinity set via nohz_full=/isolcpus= or sysfs.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMJhj ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMNhj ubh)}(h#0 on success and -errno on failure.h]h#0 on success and -errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMOhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j*workqueue_set_unbound_cpumask (C function)c.workqueue_set_unbound_cpumaskhNtauh1jhjhhhNhNubj)}(hhh](j)}(h9int workqueue_set_unbound_cpumask (cpumask_var_t cpumask)h]j)}(h8int workqueue_set_unbound_cpumask(cpumask_var_t cpumask)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hworkqueue_set_unbound_cpumaskh]j)}(hworkqueue_set_unbound_cpumaskh]hworkqueue_set_unbound_cpumask}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjhhhjhMubj|)}(h(cpumask_var_t cpumask)h]j)}(hcpumask_var_t cpumaskh](h)}(hhh]j)}(h cpumask_var_th]h cpumask_var_t}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetj modnameN classnameNj7j:)}j=]j@)}j3jsbc.workqueue_set_unbound_cpumaskasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hcpumaskh]hcpumask}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjhhhjhMubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhjhMubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjhhubjC)}(hhh]h)}(h!Set the low-level unbound cpumaskh]h!Set the low-level unbound cpumask}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj_hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejzjfjzjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``cpumask_var_t cpumask`` the cpumask to set **Description** The low-level workqueues cpumask is a global cpumask that limits the affinity of all unbound workqueues. This function check the **cpumask** and apply it to all unbound workqueues and updates all pwqs of them. **Return** 0 - Success -EINVAL - Invalid **cpumask** -ENOMEM - Failed to allocate memory for attrs or pwqs.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubjg)}(hhh]jl)}(h-``cpumask_var_t cpumask`` the cpumask to set h](jr)}(h``cpumask_var_t cpumask``h]j)}(hjh]hcpumask_var_t cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubj)}(hhh]h)}(hthe cpumask to seth]hthe cpumask to set}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhMhjubah}(h]h ]h"]h$]h&]uh1jfhj~ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubj)}(hThe low-level workqueues cpumask is a global cpumask that limits the affinity of all unbound workqueues. This function check the **cpumask** and apply it to all unbound workqueues and updates all pwqs of them. h]h)}(hThe low-level workqueues cpumask is a global cpumask that limits the affinity of all unbound workqueues. This function check the **cpumask** and apply it to all unbound workqueues and updates all pwqs of them.h](hThe low-level workqueues cpumask is a global cpumask that limits the affinity of all unbound workqueues. This function check the }(hjhhhNhNubj)}(h **cpumask**h]hcpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhE and apply it to all unbound workqueues and updates all pwqs of them.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjubah}(h]h ]h"]h$]h&]uh1jhjhMhj~ubh)}(h **Return**h]j)}(hj!h]hReturn}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubh)}(hf0 - Success -EINVAL - Invalid **cpumask** -ENOMEM - Failed to allocate memory for attrs or pwqs.h](h$0 - Success -EINVAL - Invalid }(hj7hhhNhNubj)}(h **cpumask**h]hcpumask}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubh7 -ENOMEM - Failed to allocate memory for attrs or pwqs.}(hj7hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhj~ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%workqueue_sysfs_register (C function)c.workqueue_sysfs_registerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h:int workqueue_sysfs_register (struct workqueue_struct *wq)h]j)}(h9int workqueue_sysfs_register(struct workqueue_struct *wq)h](j)}(hinth]hint}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjthhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjthhhjhM ubj)}(hworkqueue_sysfs_registerh]j)}(hworkqueue_sysfs_registerh]hworkqueue_sysfs_register}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjthhhjhM ubj|)}(h(struct workqueue_struct *wq)h]j)}(hstruct workqueue_struct *wqh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hworkqueue_structh]hworkqueue_struct}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.workqueue_sysfs_registerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hwqh]hwq}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjthhhjhM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjphhhjhM ubah}(h]jkah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM hjmhhubjC)}(hhh]h)}(h!make a workqueue visible in sysfsh]h!make a workqueue visible in sysfs}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hj5hhubah}(h]h ]h"]h$]h&]uh1jBhjmhhhjhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejPjfjPjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``struct workqueue_struct *wq`` the workqueue to register **Description** Expose **wq** in sysfs under /sys/bus/workqueue/devices. alloc_workqueue*() automatically calls this function if WQ_SYSFS is set which is the preferred method. Workqueue user should use this function directly iff it wants to apply workqueue_attrs before making the workqueue visible in sysfs; otherwise, apply_workqueue_attrs() may race against userland updating the attributes. **Return** 0 on success, -errno on failure.h](h)}(h**Parameters**h]j)}(hjZh]h Parameters}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubjg)}(hhh]jl)}(h:``struct workqueue_struct *wq`` the workqueue to register h](jr)}(h``struct workqueue_struct *wq``h]j)}(hjyh]hstruct workqueue_struct *wq}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjwubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjsubj)}(hhh]h)}(hthe workqueue to registerh]hthe workqueue to register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjpubah}(h]h ]h"]h$]h&]uh1jfhjTubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubh)}(hExpose **wq** in sysfs under /sys/bus/workqueue/devices. alloc_workqueue*() automatically calls this function if WQ_SYSFS is set which is the preferred method.h](hExpose }(hjhhhNhNubj)}(h**wq**h]hwq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in sysfs under /sys/bus/workqueue/devices. alloc_workqueue*() automatically calls this function if WQ_SYSFS is set which is the preferred method.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjTubh)}(hWorkqueue user should use this function directly iff it wants to apply workqueue_attrs before making the workqueue visible in sysfs; otherwise, apply_workqueue_attrs() may race against userland updating the attributes.h]hWorkqueue user should use this function directly iff it wants to apply workqueue_attrs before making the workqueue visible in sysfs; otherwise, apply_workqueue_attrs() may race against userland updating the attributes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubh)}(h 0 on success, -errno on failure.h]h 0 on success, -errno on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMhjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'workqueue_sysfs_unregister (C function)c.workqueue_sysfs_unregisterhNtauh1jhjhhhNhNubj)}(hhh](j)}(h=void workqueue_sysfs_unregister (struct workqueue_struct *wq)h]j)}(h(const struct cpumask *pod_cpus, struct wq_pod_type *smt_pods)h](j)}(hconst struct cpumask *pod_cpush](j)}(hjh]hconst}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(h h]h }(hjnhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]ubj)}(hjh]hstruct}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]ubh)}(hhh]j)}(hcpumaskh]hcpumask}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jGsbc.llc_count_coresasbuh1hhj]ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj]ubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThj]ubj)}(hpod_cpush]hpod_cpus}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjYubj)}(hstruct wq_pod_type *smt_podsh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(h wq_pod_typeh]h wq_pod_type}(hj hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]jc.llc_count_coresasbuh1hhjubj)}(h h]h }(hj*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hj8hhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hsmt_podsh]hsmt_pods}(hjEhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjYubeh}(h]h ]h"]h$]h&]jjuh1j{hj hhhj2hM ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjhhhj2hM ubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj2hM hjhhubjC)}(hhh]h)}(h3count distinct cores (SMT groups) within an LLC podh]h3count distinct cores (SMT groups) within an LLC pod}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjlhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj2hM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX>**Parameters** ``const struct cpumask *pod_cpus`` the cpumask of CPUs in the LLC pod ``struct wq_pod_type *smt_pods`` the SMT pod type, used to identify sibling groups **Description** A core is represented by the lowest-numbered CPU in its SMT group. Returns the number of distinct cores found in **pod_cpus**.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubjg)}(hhh](jl)}(hF``const struct cpumask *pod_cpus`` the cpumask of CPUs in the LLC pod h](jr)}(h"``const struct cpumask *pod_cpus``h]j)}(hjh]hconst struct cpumask *pod_cpus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h"the cpumask of CPUs in the LLC podh]h"the cpumask of CPUs in the LLC pod}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjubjl)}(hS``struct wq_pod_type *smt_pods`` the SMT pod type, used to identify sibling groups h](jr)}(h ``struct wq_pod_type *smt_pods``h]j)}(hjh]hstruct wq_pod_type *smt_pods}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubj)}(hhh]h)}(h1the SMT pod type, used to identify sibling groupsh]h1the SMT pod type, used to identify sibling groups}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM hjubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj$h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubh)}(h~A core is represented by the lowest-numbered CPU in its SMT group. Returns the number of distinct cores found in **pod_cpus**.h](hqA core is represented by the lowest-numbered CPU in its SMT group. Returns the number of distinct cores found in }(hj:hhhNhNubj)}(h **pod_cpus**h]hpod_cpus}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubh.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&llc_populate_cpu_shard_id (C function)c.llc_populate_cpu_shard_idhNtauh1jhjhhhNhNubj)}(hhh](j)}(hkvoid llc_populate_cpu_shard_id (const struct cpumask *pod_cpus, struct wq_pod_type *smt_pods, int nr_cores)h]j)}(hjvoid llc_populate_cpu_shard_id(const struct cpumask *pod_cpus, struct wq_pod_type *smt_pods, int nr_cores)h](j)}(hvoidh]hvoid}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*!ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjwhhhjhM*!ubj)}(hllc_populate_cpu_shard_idh]j)}(hllc_populate_cpu_shard_idh]hllc_populate_cpu_shard_id}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjwhhhjhM*!ubj|)}(hL(const struct cpumask *pod_cpus, struct wq_pod_type *smt_pods, int nr_cores)h](j)}(hconst struct cpumask *pod_cpush](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hcpumaskh]hcpumask}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjmodnameN classnameNj7j:)}j=]j@)}j3jsbc.llc_populate_cpu_shard_idasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjubj)}(hpod_cpush]hpod_cpus}(hj,hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct wq_pod_type *smt_podsh](j)}(hjh]hstruct}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(h h]h }(hjRhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjAubh)}(hhh]j)}(h wq_pod_typeh]h wq_pod_type}(hjchhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainj_reftypej3 reftargetjemodnameN classnameNj7j:)}j=]j c.llc_populate_cpu_shard_idasbuh1hhjAubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjAubjU)}(hjuh]h*}(hjhhhNhNubah}(h]h ]j`ah"]h$]h&]uh1jThjAubj)}(hsmt_podsh]hsmt_pods}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h int nr_coresh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hnr_coresh]hnr_cores}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j{hjwhhhjhM*!ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjshhhjhM*!ubah}(h]jnah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM*!hjphhubjC)}(hhh]h)}(h2populate cpu_shard_id[] for each CPU in an LLC podh]h2populate cpu_shard_id[] for each CPU in an LLC pod}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM*!hjhhubah}(h]h ]h"]h$]h&]uh1jBhjphhhjhM*!ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(hX**Parameters** ``const struct cpumask *pod_cpus`` the cpumask of CPUs in the LLC pod ``struct wq_pod_type *smt_pods`` the SMT pod type, used to identify sibling groups ``int nr_cores`` number of distinct cores in **pod_cpus** (from llc_count_cores()) **Description** Walks **pod_cpus** in order. At each SMT group leader, advances to the next shard once the current shard is full. Results are written to cpu_shard_id[].h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM.!hjubjg)}(hhh](jl)}(hF``const struct cpumask *pod_cpus`` the cpumask of CPUs in the LLC pod h](jr)}(h"``const struct cpumask *pod_cpus``h]j)}(hj<h]hconst struct cpumask *pod_cpus}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM+!hj6ubj)}(hhh]h)}(h"the cpumask of CPUs in the LLC podh]h"the cpumask of CPUs in the LLC pod}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQhM+!hjRubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jkhjQhM+!hj3ubjl)}(hS``struct wq_pod_type *smt_pods`` the SMT pod type, used to identify sibling groups h](jr)}(h ``struct wq_pod_type *smt_pods``h]j)}(hjuh]hstruct wq_pod_type *smt_pods}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM,!hjoubj)}(hhh]h)}(h1the SMT pod type, used to identify sibling groupsh]h1the SMT pod type, used to identify sibling groups}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM,!hjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jkhjhM,!hj3ubjl)}(hS``int nr_cores`` number of distinct cores in **pod_cpus** (from llc_count_cores()) h](jr)}(h``int nr_cores``h]j)}(hjh]h int nr_cores}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM-!hjubj)}(hhh]h)}(hAnumber of distinct cores in **pod_cpus** (from llc_count_cores())h](hnumber of distinct cores in }(hjhhhNhNubj)}(h **pod_cpus**h]hpod_cpus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh (from llc_count_cores())}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM-!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhM-!hj3ubeh}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM/!hjubh)}(hWalks **pod_cpus** in order. At each SMT group leader, advances to the next shard once the current shard is full. Results are written to cpu_shard_id[].h](hWalks }(hjhhhNhNubj)}(h **pod_cpus**h]hpod_cpus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh in order. At each SMT group leader, advances to the next shard once the current shard is full. Results are written to cpu_shard_id[].}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM.!hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'precompute_cache_shard_ids (C function)c.precompute_cache_shard_idshNtauh1jhjhhhNhNubj)}(hhh](j)}(h&void precompute_cache_shard_ids (void)h]j)}(h%void precompute_cache_shard_ids(void)h](j)}(hvoidh]hvoid}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMa!ubj)}(h h]h }(hjahhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjNhhhj`hMa!ubj)}(hprecompute_cache_shard_idsh]j)}(hprecompute_cache_shard_idsh]hprecompute_cache_shard_ids}(hjshhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjoubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjNhhhj`hMa!ubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjNhhhj`hMa!ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjJhhhj`hMa!ubah}(h]jEah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj`hMa!hjGhhubjC)}(hhh]h)}(h.assign each CPU its shard index within its LLCh]h.assign each CPU its shard index within its LLC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMa!hjhhubah}(h]h ]h"]h$]h&]uh1jBhjGhhhj`hMa!ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Iterates over all LLC pods. For each pod, counts distinct cores then assigns shard indices to all CPUs in the pod. Must be called after WQ_AFFN_CACHE and WQ_AFFN_SMT have been initialized.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMe!hjubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhjhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj5h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubh)}(hIterates over all LLC pods. For each pod, counts distinct cores then assigns shard indices to all CPUs in the pod. Must be called after WQ_AFFN_CACHE and WQ_AFFN_SMT have been initialized.h]hIterates over all LLC pods. For each pod, counts distinct cores then assigns shard indices to all CPUs in the pod. Must be called after WQ_AFFN_CACHE and WQ_AFFN_SMT have been initialized.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chMb!hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$workqueue_init_topology (C function)c.workqueue_init_topologyhNtauh1jhjhhhNhNubj)}(hhh](j)}(h#void workqueue_init_topology (void)h]j)}(h"void workqueue_init_topology(void)h](j)}(hvoidh]hvoid}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvhhhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM!ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjvhhhjhM!ubj)}(hworkqueue_init_topologyh]j)}(hworkqueue_init_topologyh]hworkqueue_init_topology}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]jjuh1jhjvhhhjhM!ubj|)}(h(void)h]j)}(hvoidh]j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1j{hjvhhhjhM!ubeh}(h]h ]h"]h$]h&]jjj4uh1jj5j6hjrhhhjhM!ubah}(h]jmah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhM!hjohhubjC)}(hhh]h)}(h*initialize CPU pods for unbound workqueuesh]h*initialize CPU pods for unbound workqueues}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM!hjhhubah}(h]h ]h"]h$]h&]uh1jBhjohhhjhM!ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhjhNhNubjk)}(h**Parameters** ``void`` no arguments **Description** This is the third step of three-staged workqueue subsystem initialization and invoked after SMP and topology information are fully initialized. It initializes the unbound CPU pods accordingly.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM!hjubjg)}(hhh]jl)}(h``void`` no arguments h](jr)}(h``void``h]j)}(hj"h]hvoid}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jqhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hKhj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jkhj7hKhjubah}(h]h ]h"]h$]h&]uh1jfhjubh)}(h**Description**h]j)}(hj]h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chKhjubh)}(hThis is the third step of three-staged workqueue subsystem initialization and invoked after SMP and topology information are fully initialized. It initializes the unbound CPU pods accordingly.h]hThis is the third step of three-staged workqueue subsystem initialization and invoked after SMP and topology information are fully initialized. It initializes the unbound CPU pods accordingly.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhV/var/lib/git/docbuild/linux/Documentation/core-api/workqueue:795: ./kernel/workqueue.chM!hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubeh}(h]&kernel-inline-documentations-referenceah ]h"]&kernel inline documentations referenceah$]h&]uh1hhhhhhhhMubeh}(h] workqueueah ]h"] workqueueah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjjjj{jxj~j{jjjjjjj~j{jn jk j j jjjjjjjjjjjjj-j*jjjjjju nametypes}(jjj{j~jjjj~jn j jjjjjjj-jjjuh}(jhjjjxjj{j~jjjjLjjj{jjk jj jq jj jj jj jjjjjjj*jjj0jjjjjjj)j.j jjjj=jBj.#j3#j'j'j )j)j*j*j-j-j0j0jA3jF3j/5j45j7j7j9j9j<j$<j)>j.>j{?j?j@j@jBj$BjCjCjxEj}EjGjGjIjIjKjKjMjMj(Oj-OjwRj|RjUjUjwYj|Yj[j[jn]js]j^j^jp`ju`jajajdjdjfjfjij ijjjjj?ljDljmjmjpjpjKrjPrjsjsjJvjOvjwjwjZzj_zj~j~jׁj܁jjjjjjjjjjjjj?jDjjj2j7jNjSjßjȟjDjIjԢj٢jͤjҤjܦjj?jDjjj^jcjjjjjjjwj|jjjjjjjajfjjjUjZjvj{jOjTj\jajfjkj=jBjjj=jBjjjOjTjyj~jjjjjjj*j/jmjrjj!jjj4j9jjjjjjjjjjjpjujJjOjjjjjfjkjjjjjTjYj|jjjj3j8jFjKjjj j j j j j jjjkjpj4j9jjjjjjjnjsjEjJjmjru footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.