,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/padatamodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/core-api/padatamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/core-api/padatamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/core-api/padatamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/core-api/padatamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/core-api/padatamodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/core-api/padata.rsthKubhsection)}(hhh](htitle)}(h'The padata parallel execution mechanismh]h'The padata parallel execution mechanism}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hDateh]hDate}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h May 2020 h]h paragraph)}(hMay 2020h]hMay 2020}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hPadata is a mechanism by which the kernel can farm jobs out to be done in parallel on multiple CPUs while optionally retaining their ordering.h]hPadata is a mechanism by which the kernel can farm jobs out to be done in parallel on multiple CPUs while optionally retaining their ordering.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hIt was originally developed for IPsec, which needs to perform encryption and decryption on large numbers of packets without reordering those packets. This is currently the sole consumer of padata's serialized job support.h]hIt was originally developed for IPsec, which needs to perform encryption and decryption on large numbers of packets without reordering those packets. This is currently the sole consumer of padata’s serialized job support.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(h{Padata also supports multithreaded jobs, splitting up the job evenly while load balancing and coordinating between threads.h]h{Padata also supports multithreaded jobs, splitting up the job evenly while load balancing and coordinating between threads.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hRunning Serialized Jobsh]hRunning Serialized Jobs}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hhhhhKubh)}(hhh](h)}(h Initializingh]h Initializing}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhhhhhKubh)}(hThe first step in using padata to run serialized jobs is to set up a padata_instance structure for overall control of how jobs are to be run::h]hThe first step in using padata to run serialized jobs is to set up a padata_instance structure for overall control of how jobs are to be run:}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjFhhubh literal_block)}(hR#include struct padata_instance *padata_alloc(const char *name);h]hR#include struct padata_instance *padata_alloc(const char *name);}hjgsbah}(h]h ]h"]h$]h&]hhuh1jehhhKhjFhhubh)}(h&'name' simply identifies the instance.h]h*‘name’ simply identifies the instance.}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjFhhubh)}(hCThen, complete padata initialization by allocating a padata_shell::h]hBThen, complete padata initialization by allocating a padata_shell:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hjFhhubjf)}(hGstruct padata_shell *padata_alloc_shell(struct padata_instance *pinst);h]hGstruct padata_shell *padata_alloc_shell(struct padata_instance *pinst);}hjsbah}(h]h ]h"]h$]h&]hhuh1jehhhK$hjFhhubh)}(hA padata_shell is used to submit a job to padata and allows a series of such jobs to be serialized independently. A padata_instance may have one or more padata_shells associated with it, each allowing a separate series of jobs.h]hA padata_shell is used to submit a job to padata and allows a series of such jobs to be serialized independently. A padata_instance may have one or more padata_shells associated with it, each allowing a separate series of jobs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjFhhubeh}(h] initializingah ]h"] initializingah$]h&]uh1hhj5hhhhhKubh)}(hhh](h)}(hModifying cpumasksh]hModifying cpumasks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK+ubh)}(hThe CPUs used to run jobs can be changed in two ways, programmatically with padata_set_cpumask() or via sysfs. The former is defined::h]hThe CPUs used to run jobs can be changed in two ways, programmatically with padata_set_cpumask() or via sysfs. The former is defined:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubjf)}(hvint padata_set_cpumask(struct padata_instance *pinst, int cpumask_type, cpumask_var_t cpumask);h]hvint padata_set_cpumask(struct padata_instance *pinst, int cpumask_type, cpumask_var_t cpumask);}hjsbah}(h]h ]h"]h$]h&]hhuh1jehhhK0hjhhubh)}(hXUHere cpumask_type is one of PADATA_CPU_PARALLEL or PADATA_CPU_SERIAL, where a parallel cpumask describes which processors will be used to execute jobs submitted to this instance in parallel and a serial cpumask defines which processors are allowed to be used as the serialization callback processor. cpumask specifies the new cpumask to use.h]hXUHere cpumask_type is one of PADATA_CPU_PARALLEL or PADATA_CPU_SERIAL, where a parallel cpumask describes which processors will be used to execute jobs submitted to this instance in parallel and a serial cpumask defines which processors are allowed to be used as the serialization callback processor. cpumask specifies the new cpumask to use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjhhubh)}(hX%There may be sysfs files for an instance's cpumasks. For example, pcrypt's live in /sys/kernel/pcrypt/. Within an instance's directory there are two files, parallel_cpumask and serial_cpumask, and either cpumask may be changed by echoing a bitmask into the file, for example::h]hX*There may be sysfs files for an instance’s cpumasks. For example, pcrypt’s live in /sys/kernel/pcrypt/. Within an instance’s directory there are two files, parallel_cpumask and serial_cpumask, and either cpumask may be changed by echoing a bitmask into the file, for example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjhhubjf)}(h5echo f > /sys/kernel/pcrypt/pencrypt/parallel_cpumaskh]h5echo f > /sys/kernel/pcrypt/pencrypt/parallel_cpumask}hjsbah}(h]h ]h"]h$]h&]hhuh1jehhhK>hjhhubh)}(hmReading one of these files shows the user-supplied cpumask, which may be different from the 'usable' cpumask.h]hqReading one of these files shows the user-supplied cpumask, which may be different from the ‘usable’ cpumask.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjhhubh)}(hXePadata maintains two pairs of cpumasks internally, the user-supplied cpumasks and the 'usable' cpumasks. (Each pair consists of a parallel and a serial cpumask.) The user-supplied cpumasks default to all possible CPUs on instance allocation and may be changed as above. The usable cpumasks are always a subset of the user-supplied cpumasks and contain only the online CPUs in the user-supplied masks; these are the cpumasks padata actually uses. So it is legal to supply a cpumask to padata that contains offline CPUs. Once an offline CPU in the user-supplied cpumask comes online, padata is going to use it.h]hXiPadata maintains two pairs of cpumasks internally, the user-supplied cpumasks and the ‘usable’ cpumasks. (Each pair consists of a parallel and a serial cpumask.) The user-supplied cpumasks default to all possible CPUs on instance allocation and may be changed as above. The usable cpumasks are always a subset of the user-supplied cpumasks and contain only the online CPUs in the user-supplied masks; these are the cpumasks padata actually uses. So it is legal to supply a cpumask to padata that contains offline CPUs. Once an offline CPU in the user-supplied cpumask comes online, padata is going to use it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjhhubh)}(h_Changing the CPU masks are expensive operations, so it should not be done with great frequency.h]h_Changing the CPU masks are expensive operations, so it should not be done with great frequency.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjhhubeh}(h]modifying-cpumasksah ]h"]modifying cpumasksah$]h&]uh1hhj5hhhhhK+ubh)}(hhh](h)}(h Running A Jobh]h Running A Job}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hhhhhKQubh)}(h|Actually submitting work to the padata instance requires the creation of a padata_priv structure, which represents one job::h]h{Actually submitting work to the padata instance requires the creation of a padata_priv structure, which represents one job:}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShj>hhubjf)}(hstruct padata_priv { /* Other stuff here... */ void (*parallel)(struct padata_priv *padata); void (*serial)(struct padata_priv *padata); };h]hstruct padata_priv { /* Other stuff here... */ void (*parallel)(struct padata_priv *padata); void (*serial)(struct padata_priv *padata); };}hj]sbah}(h]h ]h"]h$]h&]hhuh1jehhhKVhj>hhubh)}(hXvThis structure will almost certainly be embedded within some larger structure specific to the work to be done. Most of its fields are private to padata, but the structure should be zeroed at initialisation time, and the parallel() and serial() functions should be provided. Those functions will be called in the process of getting the work done as we will see momentarily.h]hXvThis structure will almost certainly be embedded within some larger structure specific to the work to be done. Most of its fields are private to padata, but the structure should be zeroed at initialisation time, and the parallel() and serial() functions should be provided. Those functions will be called in the process of getting the work done as we will see momentarily.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hj>hhubh)}(h(The submission of the job is done with::h]h'The submission of the job is done with:}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj>hhubjf)}(hpint padata_do_parallel(struct padata_shell *ps, struct padata_priv *padata, int *cb_cpu);h]hpint padata_do_parallel(struct padata_shell *ps, struct padata_priv *padata, int *cb_cpu);}hjsbah}(h]h ]h"]h$]h&]hhuh1jehhhKehj>hhubh)}(hXeThe ps and padata structures must be set up as described above; cb_cpu points to the preferred CPU to be used for the final callback when the job is done; it must be in the current instance's CPU mask (if not the cb_cpu pointer is updated to point to the CPU actually chosen). The return value from padata_do_parallel() is zero on success, indicating that the job is in progress. -EBUSY means that somebody, somewhere else is messing with the instance's CPU mask, while -EINVAL is a complaint about cb_cpu not being in the serial cpumask, no online CPUs in the parallel or serial cpumasks, or a stopped instance.h]hXiThe ps and padata structures must be set up as described above; cb_cpu points to the preferred CPU to be used for the final callback when the job is done; it must be in the current instance’s CPU mask (if not the cb_cpu pointer is updated to point to the CPU actually chosen). The return value from padata_do_parallel() is zero on success, indicating that the job is in progress. -EBUSY means that somebody, somewhere else is messing with the instance’s CPU mask, while -EINVAL is a complaint about cb_cpu not being in the serial cpumask, no online CPUs in the parallel or serial cpumasks, or a stopped instance.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhj>hhubh)}(hXEach job submitted to padata_do_parallel() will, in turn, be passed to exactly one call to the above-mentioned parallel() function, on one CPU, so true parallelism is achieved by submitting multiple jobs. parallel() runs with software interrupts disabled and thus cannot sleep. The parallel() function gets the padata_priv structure pointer as its lone parameter; information about the actual work to be done is probably obtained by using container_of() to find the enclosing structure.h]hXEach job submitted to padata_do_parallel() will, in turn, be passed to exactly one call to the above-mentioned parallel() function, on one CPU, so true parallelism is achieved by submitting multiple jobs. parallel() runs with software interrupts disabled and thus cannot sleep. The parallel() function gets the padata_priv structure pointer as its lone parameter; information about the actual work to be done is probably obtained by using container_of() to find the enclosing structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhj>hhubh)}(hXDNote that parallel() has no return value; the padata subsystem assumes that parallel() will take responsibility for the job from this point. The job need not be completed during this call, but, if parallel() leaves work outstanding, it should be prepared to be called again with a new job before the previous one completes.h]hXDNote that parallel() has no return value; the padata subsystem assumes that parallel() will take responsibility for the job from this point. The job need not be completed during this call, but, if parallel() leaves work outstanding, it should be prepared to be called again with a new job before the previous one completes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhj>hhubeh}(h] running-a-jobah ]h"] running a jobah$]h&]uh1hhj5hhhhhKQubh)}(hhh](h)}(hSerializing Jobsh]hSerializing Jobs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hWhen a job does complete, parallel() (or whatever function actually finishes the work) should inform padata of the fact with a call to::h]hWhen a job does complete, parallel() (or whatever function actually finishes the work) should inform padata of the fact with a call to:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubjf)}(h2void padata_do_serial(struct padata_priv *padata);h]h2void padata_do_serial(struct padata_priv *padata);}hjsbah}(h]h ]h"]h$]h&]hhuh1jehhhKhjhhubh)}(hXAt some point in the future, padata_do_serial() will trigger a call to the serial() function in the padata_priv structure. That call will happen on the CPU requested in the initial call to padata_do_parallel(); it, too, is run with local software interrupts disabled. Note that this call may be deferred for a while since the padata code takes pains to ensure that jobs are completed in the order in which they were submitted.h]hXAt some point in the future, padata_do_serial() will trigger a call to the serial() function in the padata_priv structure. That call will happen on the CPU requested in the initial call to padata_do_parallel(); it, too, is run with local software interrupts disabled. Note that this call may be deferred for a while since the padata code takes pains to ensure that jobs are completed in the order in which they were submitted.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]serializing-jobsah ]h"]serializing jobsah$]h&]uh1hhj5hhhhhKubh)}(hhh](h)}(h Destroyingh]h Destroying}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hCleaning up a padata instance predictably involves calling the two free functions that correspond to the allocation in reverse::h]hCleaning up a padata instance predictably involves calling the two free functions that correspond to the allocation in reverse:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubjf)}(havoid padata_free_shell(struct padata_shell *ps); void padata_free(struct padata_instance *pinst);h]havoid padata_free_shell(struct padata_shell *ps); void padata_free(struct padata_instance *pinst);}hj)sbah}(h]h ]h"]h$]h&]hhuh1jehhhKhj hhubh)}(hoIt is the user's responsibility to ensure all outstanding jobs are complete before any of the above are called.h]hqIt is the user’s responsibility to ensure all outstanding jobs are complete before any of the above are called.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h] destroyingah ]h"] destroyingah$]h&]uh1hhj5hhhhhKubeh}(h]running-serialized-jobsah ]h"]running serialized jobsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hRunning Multithreaded Jobsh]hRunning Multithreaded Jobs}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhhhhhKubh)}(hX9A multithreaded job has a main thread and zero or more helper threads, with the main thread participating in the job and then waiting until all helpers have finished. padata splits the job into units called chunks, where a chunk is a piece of the job that one thread completes in one call to the thread function.h]hX9A multithreaded job has a main thread and zero or more helper threads, with the main thread participating in the job and then waiting until all helpers have finished. padata splits the job into units called chunks, where a chunk is a piece of the job that one thread completes in one call to the thread function.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjUhhubh)}(hXA user has to do three things to run a multithreaded job. First, describe the job by defining a padata_mt_job structure, which is explained in the Interface section. This includes a pointer to the thread function, which padata will call each time it assigns a job chunk to a thread. Then, define the thread function, which accepts three arguments, ``start``, ``end``, and ``arg``, where the first two delimit the range that the thread operates on and the last is a pointer to the job's shared state, if any. Prepare the shared state, which is typically allocated on the main thread's stack. Last, call padata_do_multithreaded(), which will return once the job is finished.h](hX_A user has to do three things to run a multithreaded job. First, describe the job by defining a padata_mt_job structure, which is explained in the Interface section. This includes a pointer to the thread function, which padata will call each time it assigns a job chunk to a thread. Then, define the thread function, which accepts three arguments, }(hjthhhNhNubhliteral)}(h ``start``h]hstart}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtubh, }(hjthhhNhNubj})}(h``end``h]hend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtubh, and }(hjthhhNhNubj})}(h``arg``h]harg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjtubhX+, where the first two delimit the range that the thread operates on and the last is a pointer to the job’s shared state, if any. Prepare the shared state, which is typically allocated on the main thread’s stack. Last, call padata_do_multithreaded(), which will return once the job is finished.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjUhhubeh}(h]running-multithreaded-jobsah ]h"]running multithreaded jobsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Interfaceh]h Interface}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlepadata_priv (C struct) c.padata_privhNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h padata_privh]hdesc_signature_line)}(hstruct padata_privh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKubhdesc_sig_space)}(h h]h }(hj hhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(h padata_privh]h desc_sig_name)}(hjh]h padata_priv}(hj hhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(hRepresents one jobh]hRepresents one job}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjLhhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhKubeh}(h]h ](cstructeh"]h$]h&]domainjgobjtypejhdesctypejhnoindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(hX**Definition**:: struct padata_priv { struct list_head list; struct parallel_data *pd; int cb_cpu; unsigned int seq_nr; int info; void (*parallel)(struct padata_priv *padata); void (*serial)(struct padata_priv *padata); }; **Members** ``list`` List entry, to attach to the padata lists. ``pd`` Pointer to the internal control structure. ``cb_cpu`` Callback cpu for serializatioon. ``seq_nr`` Sequence number of the parallelized data object. ``info`` Used to pass information from the parallel to the serial function. ``parallel`` Parallel execution function. ``serial`` Serial complete function.h](h)}(h**Definition**::h](hstrong)}(h**Definition**h]h Definition}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjxubh:}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjtubjf)}(hstruct padata_priv { struct list_head list; struct parallel_data *pd; int cb_cpu; unsigned int seq_nr; int info; void (*parallel)(struct padata_priv *padata); void (*serial)(struct padata_priv *padata); };h]hstruct padata_priv { struct list_head list; struct parallel_data *pd; int cb_cpu; unsigned int seq_nr; int info; void (*parallel)(struct padata_priv *padata); void (*serial)(struct padata_priv *padata); };}hjsbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK hjtubh)}(h **Members**h]j})}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK*hjtubhdefinition_list)}(hhh](hdefinition_list_item)}(h4``list`` List entry, to attach to the padata lists. h](hterm)}(h``list``h]j})}(hjh]hlist}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubh definition)}(hhh]h)}(h*List entry, to attach to the padata lists.h]h*List entry, to attach to the padata lists.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h2``pd`` Pointer to the internal control structure. h](j)}(h``pd``h]j})}(hjh]hpd}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h*Pointer to the internal control structure.h]h*Pointer to the internal control structure.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h,``cb_cpu`` Callback cpu for serializatioon. h](j)}(h ``cb_cpu``h]j})}(hjAh]hcb_cpu}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj?ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj;ubj)}(hhh]h)}(h Callback cpu for serializatioon.h]h Callback cpu for serializatioon.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhKhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhKhjubj)}(h<``seq_nr`` Sequence number of the parallelized data object. h](j)}(h ``seq_nr``h]j})}(hjzh]hseq_nr}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjxubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK hjtubj)}(hhh]h)}(h0Sequence number of the parallelized data object.h]h0Sequence number of the parallelized data object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK hjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhK hjubj)}(hL``info`` Used to pass information from the parallel to the serial function. h](j)}(h``info``h]j})}(hjh]hinfo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK!hjubj)}(hhh]h)}(hBUsed to pass information from the parallel to the serial function.h]hBUsed to pass information from the parallel to the serial function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK!hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK!hjubj)}(h*``parallel`` Parallel execution function. h](j)}(h ``parallel``h]j})}(hjh]hparallel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK"hjubj)}(hhh]h)}(hParallel execution function.h]hParallel execution function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK"hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK"hjubj)}(h$``serial`` Serial complete function.h](j)}(h ``serial``h]j})}(hj%h]hserial}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK"hjubj)}(hhh]h)}(hSerial complete function.h]hSerial complete function.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK#hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hK"hjubeh}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_list (C struct) c.padata_listhNtauh1jhjhhhNhNubj)}(hhh](j)}(h padata_listh]j)}(hstruct padata_listh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK)ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{hhhjhK)ubj)}(h padata_listh]j)}(hjyh]h padata_list}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhj{hhhjhK)ubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjwhhhjhK)ubah}(h]jrah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhK)hjthhubjK)}(hhh]h)}(hone per work type per CPUh]hone per work type per CPU}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK/hjhhubah}(h]h ]h"]h$]h&]uh1jJhjthhhjhK)ubeh}(h]h ](jgstructeh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(h**Definition**:: struct padata_list { struct list_head list; spinlock_t lock; }; **Members** ``list`` List head. ``lock`` List lock.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK3hjubjf)}(hNstruct padata_list { struct list_head list; spinlock_t lock; };h]hNstruct padata_list { struct list_head list; spinlock_t lock; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK5hjubh)}(h **Members**h]j})}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK:hjubj)}(hhh](j)}(h``list`` List head. h](j)}(h``list``h]j})}(hj.h]hlist}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj,ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK2hj(ubj)}(hhh]h)}(h List head.h]h List head.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChK2hjDubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhjChK2hj%ubj)}(h``lock`` List lock.h](j)}(h``lock``h]j})}(hjgh]hlock}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjeubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK2hjaubj)}(hhh]h)}(h List lock.h]h List lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK3hj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hK2hj%ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_serial_queue (C struct)c.padata_serial_queuehNtauh1jhjhhhNhNubj)}(hhh](j)}(hpadata_serial_queueh]j)}(hstruct padata_serial_queueh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK9ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhK9ubj)}(hpadata_serial_queueh]j)}(hjh]hpadata_serial_queue}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjhhhjhK9ubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjhhhjhK9ubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhK9hjhhubjK)}(hhh]h)}(hThe percpu padata serial queueh]hThe percpu padata serial queue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK:hjhhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhK9ubeh}(h]h ](jgstructeh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(hXK**Definition**:: struct padata_serial_queue { struct padata_list serial; struct work_struct work; struct parallel_data *pd; }; **Members** ``serial`` List to wait for serialization after reordering. ``work`` work struct for serialization. ``pd`` Backpointer to the internal control structure.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj#ubh:}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK>hjubjf)}(hstruct padata_serial_queue { struct padata_list serial; struct work_struct work; struct parallel_data *pd; };h]hstruct padata_serial_queue { struct padata_list serial; struct work_struct work; struct parallel_data *pd; };}hj@sbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK@hjubh)}(h **Members**h]j})}(hjQh]hMembers}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjOubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKFhjubj)}(hhh](j)}(h<``serial`` List to wait for serialization after reordering. h](j)}(h ``serial``h]j})}(hjph]hserial}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK=hjjubj)}(hhh]h)}(h0List to wait for serialization after reordering.h]h0List to wait for serialization after reordering.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK=hjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhK=hjgubj)}(h(``work`` work struct for serialization. h](j)}(h``work``h]j})}(hjh]hwork}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK>hjubj)}(hhh]h)}(hwork struct for serialization.h]hwork struct for serialization.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK>hjgubj)}(h5``pd`` Backpointer to the internal control structure.h](j)}(h``pd``h]j})}(hjh]hpd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK>hjubj)}(hhh]h)}(h.Backpointer to the internal control structure.h]h.Backpointer to the internal control structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK>hjgubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_cpumask (C struct)c.padata_cpumaskhNtauh1jhjhhhNhNubj)}(hhh](j)}(hpadata_cpumaskh]j)}(hstruct padata_cpumaskh](j)}(hjh]hstruct}(hj< hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8 hhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKEubj)}(h h]h }(hjJ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8 hhhjI hKEubj)}(hpadata_cpumaskh]j)}(hj6 h]hpadata_cpumask}(hj\ hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjX ubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhj8 hhhjI hKEubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hj4 hhhjI hKEubah}(h]j/ ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjI hKEhj1 hhubjK)}(hhh]h)}(h,The cpumasks for the parallel/serial workersh]h,The cpumasks for the parallel/serial workers}(hj~ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKGhj{ hhubah}(h]h ]h"]h$]h&]uh1jJhj1 hhhjI hKEubeh}(h]h ](jgstructeh"]h$]h&]jljgjmj jnj jojpjquh1jhhhjhNhNubjs)}(h**Definition**:: struct padata_cpumask { cpumask_var_t pcpu; cpumask_var_t cbcpu; }; **Members** ``pcpu`` cpumask for the parallel workers. ``cbcpu`` cpumask for the serial (callback) workers.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKKhj ubjf)}(hKstruct padata_cpumask { cpumask_var_t pcpu; cpumask_var_t cbcpu; };h]hKstruct padata_cpumask { cpumask_var_t pcpu; cpumask_var_t cbcpu; };}hj sbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKMhj ubh)}(h **Members**h]j})}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKRhj ubj)}(hhh](j)}(h+``pcpu`` cpumask for the parallel workers. h](j)}(h``pcpu``h]j})}(hj h]hpcpu}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKJhj ubj)}(hhh]h)}(h!cpumask for the parallel workers.h]h!cpumask for the parallel workers.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKJhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKJhj ubj)}(h4``cbcpu`` cpumask for the serial (callback) workers.h](j)}(h ``cbcpu``h]j})}(hj$ h]hcbcpu}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj" ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKJhj ubj)}(hhh]h)}(h*cpumask for the serial (callback) workers.h]h*cpumask for the serial (callback) workers.}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKKhj: ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj9 hKJhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jparallel_data (C struct)c.parallel_datahNtauh1jhjhhhNhNubj)}(hhh](j)}(h parallel_datah]j)}(hstruct parallel_datah](j)}(hjh]hstruct}(hj~ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz hhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKQubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz hhhj hKQubj)}(h parallel_datah]j)}(hjx h]h parallel_data}(hj hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj ubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjz hhhj hKQubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjv hhhj hKQubah}(h]jq ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhj hKQhjs hhubjK)}(hhh]h)}(hQInternal control structure, covers everything that depends on the cpumask in use.h]hQInternal control structure, covers everything that depends on the cpumask in use.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKRhj hhubah}(h]h ]h"]h$]h&]uh1jJhjs hhhj hKQubeh}(h]h ](jgstructeh"]h$]h&]jljgjmj jnj jojpjquh1jhhhjhNhNubjs)}(hX**Definition**:: struct parallel_data { struct padata_shell *ps; struct padata_list __percpu *reorder_list; struct padata_serial_queue __percpu *squeue; refcount_t refcnt; unsigned int seq_nr; unsigned int processed; int cpu; struct padata_cpumask cpumask; struct work_struct reorder_work; spinlock_t lock; }; **Members** ``ps`` padata_shell object. ``reorder_list`` percpu reorder lists ``squeue`` percpu padata queues used for serialuzation. ``refcnt`` Number of objects holding a reference on this parallel_data. ``seq_nr`` Sequence number of the parallelized data object. ``processed`` Number of already processed objects. ``cpu`` Next CPU to be processed. ``cpumask`` The cpumasks in use for parallel and serial workers. ``reorder_work`` work struct for reordering. ``lock`` Reorder lock.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKVhj ubjf)}(hXstruct parallel_data { struct padata_shell *ps; struct padata_list __percpu *reorder_list; struct padata_serial_queue __percpu *squeue; refcount_t refcnt; unsigned int seq_nr; unsigned int processed; int cpu; struct padata_cpumask cpumask; struct work_struct reorder_work; spinlock_t lock; };h]hXstruct parallel_data { struct padata_shell *ps; struct padata_list __percpu *reorder_list; struct padata_serial_queue __percpu *squeue; refcount_t refcnt; unsigned int seq_nr; unsigned int processed; int cpu; struct padata_cpumask cpumask; struct work_struct reorder_work; spinlock_t lock; };}hj sbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKXhj ubh)}(h **Members**h]j})}(hj h]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKehj ubj)}(hhh](j)}(h``ps`` padata_shell object. h](j)}(h``ps``h]j})}(hj- h]hps}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj+ ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKVhj' ubj)}(hhh]h)}(hpadata_shell object.h]hpadata_shell object.}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjB hKVhjC ubah}(h]h ]h"]h$]h&]uh1jhj' ubeh}(h]h ]h"]h$]h&]uh1jhjB hKVhj$ ubj)}(h&``reorder_list`` percpu reorder lists h](j)}(h``reorder_list``h]j})}(hjf h]h reorder_list}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjd ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKWhj` ubj)}(hhh]h)}(hpercpu reorder listsh]hpercpu reorder lists}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{ hKWhj| ubah}(h]h ]h"]h$]h&]uh1jhj` ubeh}(h]h ]h"]h$]h&]uh1jhj{ hKWhj$ ubj)}(h8``squeue`` percpu padata queues used for serialuzation. h](j)}(h ``squeue``h]j})}(hj h]hsqueue}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKXhj ubj)}(hhh]h)}(h,percpu padata queues used for serialuzation.h]h,percpu padata queues used for serialuzation.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKXhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKXhj$ ubj)}(hH``refcnt`` Number of objects holding a reference on this parallel_data. h](j)}(h ``refcnt``h]j})}(hj h]hrefcnt}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKYhj ubj)}(hhh]h)}(hhj hhhj hKeubah}(h]j{ ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhj hKehj} hhubjK)}(hhh]h)}(hWrapper around struct parallel_data, its purpose is to allow the underlying control structure to be replaced on the fly using RCU.h]hWrapper around struct parallel_data, its purpose is to allow the underlying control structure to be replaced on the fly using RCU.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKnhj hhubah}(h]h ]h"]h$]h&]uh1jJhj} hhhj hKeubeh}(h]h ](jgstructeh"]h$]h&]jljgjmj jnj jojpjquh1jhhhjhNhNubjs)}(hX**Definition**:: struct padata_shell { struct padata_instance *pinst; struct parallel_data __rcu *pd; struct parallel_data *opd; struct list_head list; }; **Members** ``pinst`` padat instance. ``pd`` Actual parallel_data structure which may be substituted on the fly. ``opd`` Pointer to old pd to be freed by padata_replace. ``list`` List entry in padata_instance list.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubh:}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKrhj ubjf)}(hstruct padata_shell { struct padata_instance *pinst; struct parallel_data __rcu *pd; struct parallel_data *opd; struct list_head list; };h]hstruct padata_shell { struct padata_instance *pinst; struct parallel_data __rcu *pd; struct parallel_data *opd; struct list_head list; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKthj ubh)}(h **Members**h]j})}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK{hj ubj)}(hhh](j)}(h``pinst`` padat instance. h](j)}(h ``pinst``h]j})}(hj7h]hpinst}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKshj1ubj)}(hhh]h)}(hpadat instance.h]hpadat instance.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhKshjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhKshj.ubj)}(hK``pd`` Actual parallel_data structure which may be substituted on the fly. h](j)}(h``pd``h]j})}(hjph]hpd}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKthjjubj)}(hhh]h)}(hCActual parallel_data structure which may be substituted on the fly.h]hCActual parallel_data structure which may be substituted on the fly.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKthjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhKthj.ubj)}(h9``opd`` Pointer to old pd to be freed by padata_replace. h](j)}(h``opd``h]j})}(hjh]hopd}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKuhjubj)}(hhh]h)}(h0Pointer to old pd to be freed by padata_replace.h]h0Pointer to old pd to be freed by padata_replace.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKuhj.ubj)}(h,``list`` List entry in padata_instance list.h](j)}(h``list``h]j})}(hjh]hlist}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKuhjubj)}(hhh]h)}(h#List entry in padata_instance list.h]h#List entry in padata_instance list.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKuhj.ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_mt_job (C struct)c.padata_mt_jobhNtauh1jhjhhhNhNubj)}(hhh](j)}(h padata_mt_jobh]j)}(hstruct padata_mt_jobh](j)}(hjh]hstruct}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhK|ubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhjIhK|ubj)}(h padata_mt_jobh]j)}(hj6h]h padata_mt_job}(hj\hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjXubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhj8hhhjIhK|ubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hj4hhhjIhK|ubah}(h]j/ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjIhK|hj1hhubjK)}(hhh]h)}(h represents one multithreaded jobh]h represents one multithreaded job}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj{hhubah}(h]h ]h"]h$]h&]uh1jJhj1hhhjIhK|ubeh}(h]h ](jgstructeh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(hXr**Definition**:: struct padata_mt_job { void (*thread_fn)(unsigned long start, unsigned long end, void *arg); void *fn_arg; unsigned long start; unsigned long size; unsigned long align; unsigned long min_chunk; int max_threads; bool numa_aware; }; **Members** ``thread_fn`` Called for each chunk of work that a padata thread does. ``fn_arg`` The thread function argument. ``start`` The start of the job (units are job-specific). ``size`` size of this node's work (units are job-specific). ``align`` Ranges passed to the thread function fall on this boundary, with the possible exceptions of the beginning and end of the job. ``min_chunk`` The minimum chunk size in job-specific units. This allows the client to communicate the minimum amount of work that's appropriate for one worker thread to do at once. ``max_threads`` Max threads to use for the job, actual number may be less depending on task size and minimum chunk size. ``numa_aware`` Distribute jobs to different nodes with CPU in a round robin fashion.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubjf)}(hX.struct padata_mt_job { void (*thread_fn)(unsigned long start, unsigned long end, void *arg); void *fn_arg; unsigned long start; unsigned long size; unsigned long align; unsigned long min_chunk; int max_threads; bool numa_aware; };h]hX.struct padata_mt_job { void (*thread_fn)(unsigned long start, unsigned long end, void *arg); void *fn_arg; unsigned long start; unsigned long size; unsigned long align; unsigned long min_chunk; int max_threads; bool numa_aware; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubh)}(h **Members**h]j})}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh](j)}(hG``thread_fn`` Called for each chunk of work that a padata thread does. h](j)}(h ``thread_fn``h]j})}(hjh]h thread_fn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h8Called for each chunk of work that a padata thread does.h]h8Called for each chunk of work that a padata thread does.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h)``fn_arg`` The thread function argument. h](j)}(h ``fn_arg``h]j})}(hj$h]hfn_arg}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj"ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(hThe thread function argument.h]hThe thread function argument.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hKhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hKhjubj)}(h9``start`` The start of the job (units are job-specific). h](j)}(h ``start``h]j})}(hj]h]hstart}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjWubj)}(hhh]h)}(h.The start of the job (units are job-specific).h]h.The start of the job (units are job-specific).}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhKhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhKhjubj)}(h<``size`` size of this node's work (units are job-specific). h](j)}(h``size``h]j})}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h2size of this node's work (units are job-specific).h]h4size of this node’s work (units are job-specific).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``align`` Ranges passed to the thread function fall on this boundary, with the possible exceptions of the beginning and end of the job. h](j)}(h ``align``h]j})}(hjh]halign}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h}Ranges passed to the thread function fall on this boundary, with the possible exceptions of the beginning and end of the job.h]h}Ranges passed to the thread function fall on this boundary, with the possible exceptions of the beginning and end of the job.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``min_chunk`` The minimum chunk size in job-specific units. This allows the client to communicate the minimum amount of work that's appropriate for one worker thread to do at once. h](j)}(h ``min_chunk``h]j})}(hj h]h min_chunk}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(hThe minimum chunk size in job-specific units. This allows the client to communicate the minimum amount of work that's appropriate for one worker thread to do at once.h]hThe minimum chunk size in job-specific units. This allows the client to communicate the minimum amount of work that’s appropriate for one worker thread to do at once.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hy``max_threads`` Max threads to use for the job, actual number may be less depending on task size and minimum chunk size. h](j)}(h``max_threads``h]j})}(hjCh]h max_threads}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjAubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj=ubj)}(hhh]h)}(hhMax threads to use for the job, actual number may be less depending on task size and minimum chunk size.h]hhMax threads to use for the job, actual number may be less depending on task size and minimum chunk size.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhKhjubj)}(hT``numa_aware`` Distribute jobs to different nodes with CPU in a round robin fashion.h](j)}(h``numa_aware``h]j})}(hj}h]h numa_aware}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj{ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjwubj)}(hhh]h)}(hEDistribute jobs to different nodes with CPU in a round robin fashion.h]hEDistribute jobs to different nodes with CPU in a round robin fashion.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_instance (C struct)c.padata_instancehNtauh1jhjhhhNhNubj)}(hhh](j)}(hpadata_instanceh]j)}(hstruct padata_instanceh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hpadata_instanceh]j)}(hjh]hpadata_instance}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjhhhjhKubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhKhjhhubjK)}(hhh]h)}(hThe overall control structure.h]hThe overall control structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhKubeh}(h]h ](jgstructeh"]h$]h&]jljgjmj1jnj1jojpjquh1jhhhjhNhNubjs)}(hX**Definition**:: struct padata_instance { struct hlist_node cpu_online_node; struct hlist_node cpu_dead_node; struct workqueue_struct *parallel_wq; struct workqueue_struct *serial_wq; struct list_head pslist; struct padata_cpumask cpumask; struct kobject kobj; struct mutex lock; u8 flags; #define PADATA_INIT 1; #define PADATA_RESET 2; #define PADATA_INVALID 4; }; **Members** ``cpu_online_node`` Linkage for CPU online callback. ``cpu_dead_node`` Linkage for CPU offline callback. ``parallel_wq`` The workqueue used for parallel work. ``serial_wq`` The workqueue used for serial work. ``pslist`` List of padata_shell objects attached to this instance. ``cpumask`` User supplied cpumasks for parallel and serial works. ``kobj`` padata instance kernel object. ``lock`` padata instance lock. ``flags`` padata flags.h](h)}(h**Definition**::h](j})}(h**Definition**h]h Definition}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj9ubh:}(hj9hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj5ubjf)}(hXstruct padata_instance { struct hlist_node cpu_online_node; struct hlist_node cpu_dead_node; struct workqueue_struct *parallel_wq; struct workqueue_struct *serial_wq; struct list_head pslist; struct padata_cpumask cpumask; struct kobject kobj; struct mutex lock; u8 flags; #define PADATA_INIT 1; #define PADATA_RESET 2; #define PADATA_INVALID 4; };h]hXstruct padata_instance { struct hlist_node cpu_online_node; struct hlist_node cpu_dead_node; struct workqueue_struct *parallel_wq; struct workqueue_struct *serial_wq; struct list_head pslist; struct padata_cpumask cpumask; struct kobject kobj; struct mutex lock; u8 flags; #define PADATA_INIT 1; #define PADATA_RESET 2; #define PADATA_INVALID 4; };}hjVsbah}(h]h ]h"]h$]h&]hhuh1jehW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj5ubh)}(h **Members**h]j})}(hjgh]hMembers}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjeubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj5ubj)}(hhh](j)}(h5``cpu_online_node`` Linkage for CPU online callback. h](j)}(h``cpu_online_node``h]j})}(hjh]hcpu_online_node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h Linkage for CPU online callback.h]h Linkage for CPU online callback.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubj)}(h4``cpu_dead_node`` Linkage for CPU offline callback. h](j)}(h``cpu_dead_node``h]j})}(hjh]h cpu_dead_node}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h!Linkage for CPU offline callback.h]h!Linkage for CPU offline callback.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubj)}(h6``parallel_wq`` The workqueue used for parallel work. h](j)}(h``parallel_wq``h]j})}(hjh]h parallel_wq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h%The workqueue used for parallel work.h]h%The workqueue used for parallel work.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhj}ubj)}(h2``serial_wq`` The workqueue used for serial work. h](j)}(h ``serial_wq``h]j})}(hj1h]h serial_wq}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj/ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhj+ubj)}(hhh]h)}(h#The workqueue used for serial work.h]h#The workqueue used for serial work.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhKhjGubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhKhj}ubj)}(hC``pslist`` List of padata_shell objects attached to this instance. h](j)}(h ``pslist``h]j})}(hjjh]hpslist}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjhubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjdubj)}(hhh]h)}(h7List of padata_shell objects attached to this instance.h]h7List of padata_shell objects attached to this instance.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubj)}(hB``cpumask`` User supplied cpumasks for parallel and serial works. h](j)}(h ``cpumask``h]j})}(hjh]hcpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(h5User supplied cpumasks for parallel and serial works.h]h5User supplied cpumasks for parallel and serial works.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubj)}(h(``kobj`` padata instance kernel object. h](j)}(h``kobj``h]j})}(hjh]hkobj}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(hpadata instance kernel object.h]hpadata instance kernel object.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubj)}(h``lock`` padata instance lock. h](j)}(h``lock``h]j})}(hjh]hlock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjubj)}(hhh]h)}(hpadata instance lock.h]hpadata instance lock.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hKhj+ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj*hKhj}ubj)}(h``flags`` padata flags.h](j)}(h ``flags``h]j})}(hjNh]hflags}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjLubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjHubj)}(hhh]h)}(h padata flags.h]h padata flags.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/padata:177: ./include/linux/padata.hhKhjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchKhj}ubeh}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_do_parallel (C function)c.padata_do_parallelhNtauh1jhjhhhNhNubj)}(hhh](j)}(hYint padata_do_parallel (struct padata_shell *ps, struct padata_priv *padata, int *cb_cpu)h]j)}(hXint padata_do_parallel(struct padata_shell *ps, struct padata_priv *padata, int *cb_cpu)h](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubj)}(hpadata_do_parallelh]j)}(hpadata_do_parallelh]hpadata_do_parallel}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjhhhjhKubhdesc_parameterlist)}(hB(struct padata_shell *ps, struct padata_priv *padata, int *cb_cpu)h](hdesc_parameter)}(hstruct padata_shell *psh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h padata_shellh]h padata_shell}(hj hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjgreftype identifier reftargetj modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j% ASTIdentifier)}j jsbc.padata_do_parallelasbuh1hhjubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubhdesc_sig_punctuation)}(h*h]h*}(hjBhhhNhNubah}(h]h ]pah"]h$]h&]uh1j@hjubj)}(hpsh]hps}(hjQhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hstruct padata_priv *padatah](j)}(hjh]hstruct}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubj)}(h h]h }(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubh)}(hhh]j)}(h padata_privh]h padata_priv}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetjmodnameN classnameNj$j')}j*]j.c.padata_do_parallelasbuh1hhjfubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubjA)}(hjDh]h*}(hjhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjfubj)}(hpadatah]hpadata}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h int *cb_cpuh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjA)}(hjDh]h*}(hjhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjubj)}(hcb_cpuh]hcb_cpu}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjhhhjhKubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhKhjhhubjK)}(hhh]h)}(hpadata parallelization functionh]hpadata parallelization function}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhj*hhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhKubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjEjnjEjojpjquh1jhhhjhNhNubjs)}(hXT**Parameters** ``struct padata_shell *ps`` padatashell ``struct padata_priv *padata`` object to be parallelized ``int *cb_cpu`` pointer to the CPU that the serialization callback function should run on. If it's not in the serial cpumask of **pinst** (i.e. cpumask.cbcpu), this function selects a fallback CPU and if none found, returns -EINVAL. **Description** The parallelization callback function will run with BHs off. **Note** Every object which is parallelized by padata_do_parallel must be seen by padata_do_serial. **Return** 0 on success or else negative error code.h](h)}(h**Parameters**h]j})}(hjOh]h Parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjMubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjIubj)}(hhh](j)}(h(``struct padata_shell *ps`` padatashell h](j)}(h``struct padata_shell *ps``h]j})}(hjnh]hstruct padata_shell *ps}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjlubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjhubj)}(hhh]h)}(h padatashellh]h padatashell}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjhKhjeubj)}(h9``struct padata_priv *padata`` object to be parallelized h](j)}(h``struct padata_priv *padata``h]j})}(hjh]hstruct padata_priv *padata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjubj)}(hhh]h)}(hobject to be parallelizedh]hobject to be parallelized}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjeubj)}(h``int *cb_cpu`` pointer to the CPU that the serialization callback function should run on. If it's not in the serial cpumask of **pinst** (i.e. cpumask.cbcpu), this function selects a fallback CPU and if none found, returns -EINVAL. h](j)}(h``int *cb_cpu``h]j})}(hjh]h int *cb_cpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjubj)}(hhh]h)}(hpointer to the CPU that the serialization callback function should run on. If it's not in the serial cpumask of **pinst** (i.e. cpumask.cbcpu), this function selects a fallback CPU and if none found, returns -EINVAL.h](hspointer to the CPU that the serialization callback function should run on. If it’s not in the serial cpumask of }(hjhhhNhNubj})}(h **pinst**h]hpinst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh_ (i.e. cpumask.cbcpu), this function selects a fallback CPU and if none found, returns -EINVAL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjeubeh}(h]h ]h"]h$]h&]uh1jhjIubh)}(h**Description**h]j})}(hj.h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj,ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chKhjIubh)}(hhjhhhjhMubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhMhjhhubjK)}(hhh]h)}(hpadata serialization functionh]hpadata serialization function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj~hhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhMubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(h**Parameters** ``struct padata_priv *padata`` object to be serialized. **Description** padata_do_serial must be called for every parallelized object. The serialization callback function will run with BHs off.h](h)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubj)}(hhh]j)}(h8``struct padata_priv *padata`` object to be serialized. h](j)}(h``struct padata_priv *padata``h]j})}(hjh]hstruct padata_priv *padata}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubj)}(hhh]h)}(hobject to be serialized.h]hobject to be serialized.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j})}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubh)}(hypadata_do_serial must be called for every parallelized object. The serialization callback function will run with BHs off.h]hypadata_do_serial must be called for every parallelized object. The serialization callback function will run with BHs off.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$padata_do_multithreaded (C function)c.padata_do_multithreadedhNtauh1jhjhhhNhNubj)}(hhh](j)}(h8void padata_do_multithreaded (struct padata_mt_job *job)h]j)}(h7void padata_do_multithreaded(struct padata_mt_job *job)h](j)}(hvoidh]hvoid}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhjPhMubj)}(hpadata_do_multithreadedh]j)}(hpadata_do_multithreadedh]hpadata_do_multithreaded}(hjchhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj_ubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhj>hhhjPhMubj)}(h(struct padata_mt_job *job)h]j)}(hstruct padata_mt_job *jobh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubh)}(hhh]j)}(h padata_mt_jobh]h padata_mt_job}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetjmodnameN classnameNj$j')}j*]j-)}j jesbc.padata_do_multithreadedasbuh1hhj{ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubjA)}(hjDh]h*}(hjhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hj{ubj)}(hjobh]hjob}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjwubah}(h]h ]h"]h$]h&]hhuh1jhj>hhhjPhMubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hj:hhhjPhMubah}(h]j5ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjPhMhj7hhubjK)}(hhh]h)}(hrun a multithreaded jobh]hrun a multithreaded job}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjhhubah}(h]h ]h"]h$]h&]uh1jJhj7hhhjPhMubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(h**Parameters** ``struct padata_mt_job *job`` Description of the job. **Description** See the definition of struct padata_mt_job for more details.h](h)}(h**Parameters**h]j})}(hj$h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj"ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubj)}(hhh]j)}(h6``struct padata_mt_job *job`` Description of the job. h](j)}(h``struct padata_mt_job *job``h]j})}(hjCh]hstruct padata_mt_job *job}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjAubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj=ubj)}(hhh]h)}(hDescription of the job.h]hDescription of the job.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhMhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j})}(hj~h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj|ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubh)}(hhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjA)}(hjDh]h*}(hjLhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjubj)}(hpinsth]hpinst}(hjYhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hint cpumask_typeh](j)}(hinth]hint}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubj)}(h cpumask_typeh]h cpumask_type}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hcpumask_var_t cpumaskh](h)}(hhh]j)}(h cpumask_var_th]h cpumask_var_t}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetjmodnameN classnameNj$j')}j*]j:c.padata_set_cpumaskasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcpumaskh]hcpumask}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjhhhjhMubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhMhjhhubjK)}(hhh]h)}(hRSets specified by **cpumask_type** cpumask to the value equivalent to **cpumask**.h](hSets specified by }(hjhhhNhNubj})}(h**cpumask_type**h]h cpumask_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh$ cpumask to the value equivalent to }(hjhhhNhNubj})}(h **cpumask**h]hcpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjhhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhMubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmj<jnj<jojpjquh1jhhhjhNhNubjs)}(hX#**Parameters** ``struct padata_instance *pinst`` padata instance ``int cpumask_type`` PADATA_CPU_SERIAL or PADATA_CPU_PARALLEL corresponding to parallel and serial cpumasks respectively. ``cpumask_var_t cpumask`` the cpumask to use **Return** 0 on success or negative error codeh](h)}(h**Parameters**h]j})}(hjFh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjDubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj@ubj)}(hhh](j)}(h2``struct padata_instance *pinst`` padata instance h](j)}(h!``struct padata_instance *pinst``h]j})}(hjeh]hstruct padata_instance *pinst}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjcubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj_ubj)}(hhh]h)}(hpadata instanceh]hpadata instance}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhMhj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhMhj\ubj)}(hz``int cpumask_type`` PADATA_CPU_SERIAL or PADATA_CPU_PARALLEL corresponding to parallel and serial cpumasks respectively. h](j)}(h``int cpumask_type``h]j})}(hjh]hint cpumask_type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubj)}(hhh]h)}(hdPADATA_CPU_SERIAL or PADATA_CPU_PARALLEL corresponding to parallel and serial cpumasks respectively.h]hdPADATA_CPU_SERIAL or PADATA_CPU_PARALLEL corresponding to parallel and serial cpumasks respectively.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj\ubj)}(h-``cpumask_var_t cpumask`` the cpumask to use h](j)}(h``cpumask_var_t cpumask``h]j})}(hjh]hcpumask_var_t cpumask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhjubj)}(hhh]h)}(hthe cpumask to useh]hthe cpumask to use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj\ubeh}(h]h ]h"]h$]h&]uh1jhj@ubh)}(h **Return**h]j})}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj@ubh)}(h#0 on success or negative error codeh]h#0 on success or negative error code}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_alloc (C function)c.padata_allochNtauh1jhjhhhNhNubj)}(hhh](j)}(h8struct padata_instance * padata_alloc (const char *name)h]j)}(h6struct padata_instance *padata_alloc(const char *name)h](j)}(hjh]hstruct}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMubj)}(h h]h }(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhjehMubh)}(hhh]j)}(hpadata_instanceh]hpadata_instance}(hjwhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetjymodnameN classnameNj$j')}j*]j-)}j  padata_allocsbc.padata_allocasbuh1hhjThhhjehMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjThhhjehMubjA)}(hjDh]h*}(hjhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjThhhjehMubj)}(h padata_alloch]j)}(hjh]h padata_alloc}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjThhhjehMubj)}(h(const char *name)h]j)}(hconst char *nameh](j)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjA)}(hjDh]h*}(hj hhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjubj)}(hnameh]hname}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjThhhjehMubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjPhhhjehMubah}(h]jKah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjehMhjMhhubjK)}(hhh]h)}(h)allocate and initialize a padata instanceh]h)allocate and initialize a padata instance}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj>hhubah}(h]h ]h"]h$]h&]uh1jJhjMhhhjehMubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjYjnjYjojpjquh1jhhhjhNhNubjs)}(hx**Parameters** ``const char *name`` used to identify the instance **Return** new instance on success, NULL on errorh](h)}(h**Parameters**h]j})}(hjch]h Parameters}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjaubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj]ubj)}(hhh]j)}(h3``const char *name`` used to identify the instance h](j)}(h``const char *name``h]j})}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj|ubj)}(hhh]h)}(hused to identify the instanceh]hused to identify the instance}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubh)}(h **Return**h]j})}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj]ubh)}(h&new instance on success, NULL on errorh]h&new instance on success, NULL on error}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMhj]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_free (C function) c.padata_freehNtauh1jhjhhhNhNubj)}(hhh](j)}(h0void padata_free (struct padata_instance *pinst)h]j)}(h/void padata_free(struct padata_instance *pinst)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMAubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMAubj)}(h padata_freeh]j)}(h padata_freeh]h padata_free}(hj#hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjhhhjhMAubj)}(h(struct padata_instance *pinst)h]j)}(hstruct padata_instance *pinsth](j)}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(hpadata_instanceh]hpadata_instance}(hj]hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetj_modnameN classnameNj$j')}j*]j-)}j j%sb c.padata_freeasbuh1hhj;ubj)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubjA)}(hjDh]h*}(hjhhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hj;ubj)}(hpinsth]hpinst}(hjhhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj7ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMAubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjhhhjhMAubah}(h]jah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjhMAhjhhubjK)}(hhh]h)}(hfree a padata instanceh]hfree a padata instance}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chM=hjhhubah}(h]h ]h"]h$]h&]uh1jJhjhhhjhMAubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjjnjjojpjquh1jhhhjhNhNubjs)}(hK**Parameters** ``struct padata_instance *pinst`` padata instance to freeh](h)}(h**Parameters**h]j})}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMAhjubj)}(hhh]j)}(h9``struct padata_instance *pinst`` padata instance to freeh](j)}(h!``struct padata_instance *pinst``h]j})}(hj h]hstruct padata_instance *pinst}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMChjubj)}(hhh]h)}(hpadata instance to freeh]hpadata instance to free}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chM?hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_alloc_shell (C function)c.padata_alloc_shellhNtauh1jhjhhhNhNubj)}(hhh](j)}(hHstruct padata_shell * padata_alloc_shell (struct padata_instance *pinst)h]j)}(hFstruct padata_shell *padata_alloc_shell(struct padata_instance *pinst)h](j)}(hjh]hstruct}(hj] hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY hhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMNubj)}(h h]h }(hjk hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY hhhjj hMNubh)}(hhh]j)}(h padata_shellh]h padata_shell}(hj| hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjy ubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetj~ modnameN classnameNj$j')}j*]j-)}j padata_alloc_shellsbc.padata_alloc_shellasbuh1hhjY hhhjj hMNubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjY hhhjj hMNubjA)}(hjDh]h*}(hj hhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjY hhhjj hMNubj)}(hpadata_alloc_shellh]j)}(hj h]hpadata_alloc_shell}(hj hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj ubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhjY hhhjj hMNubj)}(h(struct padata_instance *pinst)h]j)}(hstruct padata_instance *pinsth](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpadata_instanceh]hpadata_instance}(hj hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetj modnameN classnameNj$j')}j*]j c.padata_alloc_shellasbuh1hhj ubj)}(h h]h }(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjA)}(hjDh]h*}(hj!!hhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hj ubj)}(hpinsth]hpinst}(hj.!hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubah}(h]h ]h"]h$]h&]hhuh1jhjY hhhjj hMNubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hjU hhhjj hMNubah}(h]jP ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhjj hMNhjR hhubjK)}(hhh]h)}(h%Allocate and initialize padata shell.h]h%Allocate and initialize padata shell.}(hjX!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMHhjU!hhubah}(h]h ]h"]h$]h&]uh1jJhjR hhhjj hMNubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmjp!jnjp!jojpjquh1jhhhjhNhNubjs)}(h**Parameters** ``struct padata_instance *pinst`` Parent padata_instance object. **Return** new shell on success, NULL on errorh](h)}(h**Parameters**h]j})}(hjz!h]h Parameters}(hj|!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hjx!ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMLhjt!ubj)}(hhh]j)}(hA``struct padata_instance *pinst`` Parent padata_instance object. h](j)}(h!``struct padata_instance *pinst``h]j})}(hj!h]hstruct padata_instance *pinst}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj!ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMJhj!ubj)}(hhh]h)}(hParent padata_instance object.h]hParent padata_instance object.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMJhj!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hMJhj!ubah}(h]h ]h"]h$]h&]uh1jhjt!ubh)}(h **Return**h]j})}(hj!h]hReturn}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj!ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMLhjt!ubh)}(h#new shell on success, NULL on errorh]h#new shell on success, NULL on error}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMLhjt!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jpadata_free_shell (C function)c.padata_free_shellhNtauh1jhjhhhNhNubj)}(hhh](j)}(h0void padata_free_shell (struct padata_shell *ps)h]j)}(h/void padata_free_shell(struct padata_shell *ps)h](j)}(hvoidh]hvoid}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMsubj)}(h h]h }(hj("hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj'"hMsubj)}(hpadata_free_shellh]j)}(hpadata_free_shellh]hpadata_free_shell}(hj:"hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhj6"ubah}(h]h ](j1j2eh"]h$]h&]hhuh1jhj"hhhj'"hMsubj)}(h(struct padata_shell *ps)h]j)}(hstruct padata_shell *psh](j)}(hjh]hstruct}(hjV"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR"ubj)}(h h]h }(hjc"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR"ubh)}(hhh]j)}(h padata_shellh]h padata_shell}(hjt"hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjq"ubah}(h]h ]h"]h$]h&] refdomainjgreftypej  reftargetjv"modnameN classnameNj$j')}j*]j-)}j j<"sbc.padata_free_shellasbuh1hhjR"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR"ubjA)}(hjDh]h*}(hj"hhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjR"ubj)}(hpsh]hps}(hj"hhhNhNubah}(h]h ]j*ah"]h$]h&]uh1jhjR"ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjN"ubah}(h]h ]h"]h$]h&]hhuh1jhj"hhhj'"hMsubeh}(h]h ]h"]h$]h&]hhj<uh1jj=j>hj"hhhj'"hMsubah}(h]j "ah ](jBjCeh"]h$]h&]jGjH)jIhuh1jhj'"hMshj"hhubjK)}(hhh]h)}(hfree a padata shellh]hfree a padata shell}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMohj"hhubah}(h]h ]h"]h$]h&]uh1jJhj"hhhj'"hMsubeh}(h]h ](jgfunctioneh"]h$]h&]jljgjmj"jnj"jojpjquh1jhhhjhNhNubjs)}(hB**Parameters** ``struct padata_shell *ps`` padata shell to freeh](h)}(h**Parameters**h]j})}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj"ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMshj"ubj)}(hhh]j)}(h0``struct padata_shell *ps`` padata shell to freeh](j)}(h``struct padata_shell *ps``h]j})}(hj#h]hstruct padata_shell *ps}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1j|hj#ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMuhj#ubj)}(hhh]h)}(hpadata shell to freeh]hpadata shell to free}(hj3#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/padata:178: ./kernel/padata.chMqhj0#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj/#hMuhj#ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jrhjhhhNhNubeh}(h] interfaceah ]h"] interfaceah$]h&]uh1hhhhhhhhKubeh}(h]'the-padata-parallel-execution-mechanismah ]h"]'the padata parallel execution mechanismah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_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_handlerj#error_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}(jh#je#jRjOjjj;j8jjjjjJjGjjj`#j]#u nametypes}(jh#jRjj;jjjJjj`#uh}(je#hjOj5jjFj8jjj>jjjGj jjUj]#jjjjrjwjjj/ j4 jq jv j{ j j/j4jjjjjjj5j:jjjKjPjjjP jU j "j"u 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.