1 // SPDX-License-Identifier: GPL-2.0
3 * padata.c - generic interface to process data streams in parallel
5 * See Documentation/padata.txt for an api documentation.
7 * Copyright (C) 2008, 2009 secunet Security Networks AG
8 * Copyright (C) 2008, 2009 Steffen Klassert <steffen.klassert@secunet.com>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms and conditions of the GNU General Public License,
12 * version 2, as published by the Free Software Foundation.
14 * This program is distributed in the hope it will be useful, but WITHOUT
15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
16 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
19 * You should have received a copy of the GNU General Public License along with
20 * this program; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
24 #include <linux/export.h>
25 #include <linux/cpumask.h>
26 #include <linux/err.h>
27 #include <linux/cpu.h>
28 #include <linux/padata.h>
29 #include <linux/mutex.h>
30 #include <linux/sched.h>
31 #include <linux/slab.h>
32 #include <linux/sysfs.h>
33 #include <linux/rcupdate.h>
34 #include <linux/module.h>
36 #define MAX_OBJ_NUM 1000
38 static int padata_index_to_cpu(struct parallel_data
*pd
, int cpu_index
)
42 target_cpu
= cpumask_first(pd
->cpumask
.pcpu
);
43 for (cpu
= 0; cpu
< cpu_index
; cpu
++)
44 target_cpu
= cpumask_next(target_cpu
, pd
->cpumask
.pcpu
);
49 static int padata_cpu_hash(struct parallel_data
*pd
)
55 * Hash the sequence numbers to the cpus by taking
56 * seq_nr mod. number of cpus in use.
59 seq_nr
= atomic_inc_return(&pd
->seq_nr
);
60 cpu_index
= seq_nr
% cpumask_weight(pd
->cpumask
.pcpu
);
62 return padata_index_to_cpu(pd
, cpu_index
);
65 static void padata_parallel_worker(struct work_struct
*parallel_work
)
67 struct padata_parallel_queue
*pqueue
;
68 LIST_HEAD(local_list
);
71 pqueue
= container_of(parallel_work
,
72 struct padata_parallel_queue
, work
);
74 spin_lock(&pqueue
->parallel
.lock
);
75 list_replace_init(&pqueue
->parallel
.list
, &local_list
);
76 spin_unlock(&pqueue
->parallel
.lock
);
78 while (!list_empty(&local_list
)) {
79 struct padata_priv
*padata
;
81 padata
= list_entry(local_list
.next
,
82 struct padata_priv
, list
);
84 list_del_init(&padata
->list
);
86 padata
->parallel(padata
);
93 * padata_do_parallel - padata parallelization function
95 * @pinst: padata instance
96 * @padata: object to be parallelized
97 * @cb_cpu: cpu the serialization callback function will run on,
98 * must be in the serial cpumask of padata(i.e. cpumask.cbcpu).
100 * The parallelization callback function will run with BHs off.
101 * Note: Every object which is parallelized by padata_do_parallel
102 * must be seen by padata_do_serial.
104 int padata_do_parallel(struct padata_instance
*pinst
,
105 struct padata_priv
*padata
, int cb_cpu
)
108 struct padata_parallel_queue
*queue
;
109 struct parallel_data
*pd
;
113 pd
= rcu_dereference_bh(pinst
->pd
);
116 if (!(pinst
->flags
& PADATA_INIT
) || pinst
->flags
& PADATA_INVALID
)
119 if (!cpumask_test_cpu(cb_cpu
, pd
->cpumask
.cbcpu
))
123 if ((pinst
->flags
& PADATA_RESET
))
126 if (atomic_read(&pd
->refcnt
) >= MAX_OBJ_NUM
)
130 atomic_inc(&pd
->refcnt
);
132 padata
->cb_cpu
= cb_cpu
;
134 target_cpu
= padata_cpu_hash(pd
);
135 padata
->cpu
= target_cpu
;
136 queue
= per_cpu_ptr(pd
->pqueue
, target_cpu
);
138 spin_lock(&queue
->parallel
.lock
);
139 list_add_tail(&padata
->list
, &queue
->parallel
.list
);
140 spin_unlock(&queue
->parallel
.lock
);
142 queue_work_on(target_cpu
, pinst
->wq
, &queue
->work
);
145 rcu_read_unlock_bh();
149 EXPORT_SYMBOL(padata_do_parallel
);
152 * padata_get_next - Get the next object that needs serialization.
156 * A pointer to the control struct of the next object that needs
157 * serialization, if present in one of the percpu reorder queues.
159 * -EINPROGRESS, if the next object that needs serialization will
160 * be parallel processed by another cpu and is not yet present in
161 * the cpu's reorder queue.
163 * -ENODATA, if this cpu has to do the parallel processing for
166 static struct padata_priv
*padata_get_next(struct parallel_data
*pd
)
169 unsigned int next_nr
, next_index
;
170 struct padata_parallel_queue
*next_queue
;
171 struct padata_priv
*padata
;
172 struct padata_list
*reorder
;
174 num_cpus
= cpumask_weight(pd
->cpumask
.pcpu
);
177 * Calculate the percpu reorder queue and the sequence
178 * number of the next object.
180 next_nr
= pd
->processed
;
181 next_index
= next_nr
% num_cpus
;
182 cpu
= padata_index_to_cpu(pd
, next_index
);
183 next_queue
= per_cpu_ptr(pd
->pqueue
, cpu
);
185 reorder
= &next_queue
->reorder
;
187 spin_lock(&reorder
->lock
);
188 if (!list_empty(&reorder
->list
)) {
189 padata
= list_entry(reorder
->list
.next
,
190 struct padata_priv
, list
);
192 list_del_init(&padata
->list
);
193 atomic_dec(&pd
->reorder_objects
);
197 spin_unlock(&reorder
->lock
);
200 spin_unlock(&reorder
->lock
);
202 if (__this_cpu_read(pd
->pqueue
->cpu_index
) == next_queue
->cpu_index
) {
203 padata
= ERR_PTR(-ENODATA
);
207 padata
= ERR_PTR(-EINPROGRESS
);
212 static void padata_reorder(struct parallel_data
*pd
)
215 struct padata_priv
*padata
;
216 struct padata_serial_queue
*squeue
;
217 struct padata_instance
*pinst
= pd
->pinst
;
220 * We need to ensure that only one cpu can work on dequeueing of
221 * the reorder queue the time. Calculating in which percpu reorder
222 * queue the next object will arrive takes some time. A spinlock
223 * would be highly contended. Also it is not clear in which order
224 * the objects arrive to the reorder queues. So a cpu could wait to
225 * get the lock just to notice that there is nothing to do at the
226 * moment. Therefore we use a trylock and let the holder of the lock
227 * care for all the objects enqueued during the holdtime of the lock.
229 if (!spin_trylock_bh(&pd
->lock
))
233 padata
= padata_get_next(pd
);
236 * If the next object that needs serialization is parallel
237 * processed by another cpu and is still on it's way to the
238 * cpu's reorder queue, nothing to do for now.
240 if (PTR_ERR(padata
) == -EINPROGRESS
)
244 * This cpu has to do the parallel processing of the next
245 * object. It's waiting in the cpu's parallelization queue,
246 * so exit immediately.
248 if (PTR_ERR(padata
) == -ENODATA
) {
249 del_timer(&pd
->timer
);
250 spin_unlock_bh(&pd
->lock
);
254 cb_cpu
= padata
->cb_cpu
;
255 squeue
= per_cpu_ptr(pd
->squeue
, cb_cpu
);
257 spin_lock(&squeue
->serial
.lock
);
258 list_add_tail(&padata
->list
, &squeue
->serial
.list
);
259 spin_unlock(&squeue
->serial
.lock
);
261 queue_work_on(cb_cpu
, pinst
->wq
, &squeue
->work
);
264 spin_unlock_bh(&pd
->lock
);
267 * The next object that needs serialization might have arrived to
268 * the reorder queues in the meantime, we will be called again
269 * from the timer function if no one else cares for it.
271 if (atomic_read(&pd
->reorder_objects
)
272 && !(pinst
->flags
& PADATA_RESET
))
273 mod_timer(&pd
->timer
, jiffies
+ HZ
);
275 del_timer(&pd
->timer
);
280 static void invoke_padata_reorder(struct work_struct
*work
)
282 struct padata_parallel_queue
*pqueue
;
283 struct parallel_data
*pd
;
286 pqueue
= container_of(work
, struct padata_parallel_queue
, reorder_work
);
292 static void padata_reorder_timer(struct timer_list
*t
)
294 struct parallel_data
*pd
= from_timer(pd
, t
, timer
);
300 /* We don't lock pd here to not interfere with parallel processing
301 * padata_reorder() calls on other CPUs. We just need any CPU out of
302 * the cpumask.pcpu set. It would be nice if it's the right one but
303 * it doesn't matter if we're off to the next one by using an outdated
304 * pd->processed value.
306 weight
= cpumask_weight(pd
->cpumask
.pcpu
);
307 target_cpu
= padata_index_to_cpu(pd
, pd
->processed
% weight
);
309 /* ensure to call the reorder callback on the correct CPU */
310 if (cpu
!= target_cpu
) {
311 struct padata_parallel_queue
*pqueue
;
312 struct padata_instance
*pinst
;
314 /* The timer function is serialized wrt itself -- no locking
318 pqueue
= per_cpu_ptr(pd
->pqueue
, target_cpu
);
319 queue_work_on(target_cpu
, pinst
->wq
, &pqueue
->reorder_work
);
327 static void padata_serial_worker(struct work_struct
*serial_work
)
329 struct padata_serial_queue
*squeue
;
330 struct parallel_data
*pd
;
331 LIST_HEAD(local_list
);
334 squeue
= container_of(serial_work
, struct padata_serial_queue
, work
);
337 spin_lock(&squeue
->serial
.lock
);
338 list_replace_init(&squeue
->serial
.list
, &local_list
);
339 spin_unlock(&squeue
->serial
.lock
);
341 while (!list_empty(&local_list
)) {
342 struct padata_priv
*padata
;
344 padata
= list_entry(local_list
.next
,
345 struct padata_priv
, list
);
347 list_del_init(&padata
->list
);
349 padata
->serial(padata
);
350 atomic_dec(&pd
->refcnt
);
356 * padata_do_serial - padata serialization function
358 * @padata: object to be serialized.
360 * padata_do_serial must be called for every parallelized object.
361 * The serialization callback function will run with BHs off.
363 void padata_do_serial(struct padata_priv
*padata
)
366 struct padata_parallel_queue
*pqueue
;
367 struct parallel_data
*pd
;
368 int reorder_via_wq
= 0;
374 /* We need to run on the same CPU padata_do_parallel(.., padata, ..)
375 * was called on -- or, at least, enqueue the padata object into the
376 * correct per-cpu queue.
378 if (cpu
!= padata
->cpu
) {
383 pqueue
= per_cpu_ptr(pd
->pqueue
, cpu
);
385 spin_lock(&pqueue
->reorder
.lock
);
386 atomic_inc(&pd
->reorder_objects
);
387 list_add_tail(&padata
->list
, &pqueue
->reorder
.list
);
388 spin_unlock(&pqueue
->reorder
.lock
);
392 /* If we're running on the wrong CPU, call padata_reorder() via a
396 queue_work_on(cpu
, pd
->pinst
->wq
, &pqueue
->reorder_work
);
400 EXPORT_SYMBOL(padata_do_serial
);
402 static int padata_setup_cpumasks(struct parallel_data
*pd
,
403 const struct cpumask
*pcpumask
,
404 const struct cpumask
*cbcpumask
)
406 if (!alloc_cpumask_var(&pd
->cpumask
.pcpu
, GFP_KERNEL
))
409 cpumask_and(pd
->cpumask
.pcpu
, pcpumask
, cpu_online_mask
);
410 if (!alloc_cpumask_var(&pd
->cpumask
.cbcpu
, GFP_KERNEL
)) {
411 free_cpumask_var(pd
->cpumask
.pcpu
);
415 cpumask_and(pd
->cpumask
.cbcpu
, cbcpumask
, cpu_online_mask
);
419 static void __padata_list_init(struct padata_list
*pd_list
)
421 INIT_LIST_HEAD(&pd_list
->list
);
422 spin_lock_init(&pd_list
->lock
);
425 /* Initialize all percpu queues used by serial workers */
426 static void padata_init_squeues(struct parallel_data
*pd
)
429 struct padata_serial_queue
*squeue
;
431 for_each_cpu(cpu
, pd
->cpumask
.cbcpu
) {
432 squeue
= per_cpu_ptr(pd
->squeue
, cpu
);
434 __padata_list_init(&squeue
->serial
);
435 INIT_WORK(&squeue
->work
, padata_serial_worker
);
439 /* Initialize all percpu queues used by parallel workers */
440 static void padata_init_pqueues(struct parallel_data
*pd
)
443 struct padata_parallel_queue
*pqueue
;
446 for_each_possible_cpu(cpu
) {
447 pqueue
= per_cpu_ptr(pd
->pqueue
, cpu
);
449 if (!cpumask_test_cpu(cpu
, pd
->cpumask
.pcpu
)) {
450 pqueue
->cpu_index
= -1;
455 pqueue
->cpu_index
= cpu_index
;
458 __padata_list_init(&pqueue
->reorder
);
459 __padata_list_init(&pqueue
->parallel
);
460 INIT_WORK(&pqueue
->work
, padata_parallel_worker
);
461 INIT_WORK(&pqueue
->reorder_work
, invoke_padata_reorder
);
462 atomic_set(&pqueue
->num_obj
, 0);
466 /* Allocate and initialize the internal cpumask dependend resources. */
467 static struct parallel_data
*padata_alloc_pd(struct padata_instance
*pinst
,
468 const struct cpumask
*pcpumask
,
469 const struct cpumask
*cbcpumask
)
471 struct parallel_data
*pd
;
473 pd
= kzalloc(sizeof(struct parallel_data
), GFP_KERNEL
);
477 pd
->pqueue
= alloc_percpu(struct padata_parallel_queue
);
481 pd
->squeue
= alloc_percpu(struct padata_serial_queue
);
483 goto err_free_pqueue
;
484 if (padata_setup_cpumasks(pd
, pcpumask
, cbcpumask
) < 0)
485 goto err_free_squeue
;
487 padata_init_pqueues(pd
);
488 padata_init_squeues(pd
);
489 timer_setup(&pd
->timer
, padata_reorder_timer
, 0);
490 atomic_set(&pd
->seq_nr
, -1);
491 atomic_set(&pd
->reorder_objects
, 0);
492 atomic_set(&pd
->refcnt
, 0);
494 spin_lock_init(&pd
->lock
);
499 free_percpu(pd
->squeue
);
501 free_percpu(pd
->pqueue
);
508 static void padata_free_pd(struct parallel_data
*pd
)
510 free_cpumask_var(pd
->cpumask
.pcpu
);
511 free_cpumask_var(pd
->cpumask
.cbcpu
);
512 free_percpu(pd
->pqueue
);
513 free_percpu(pd
->squeue
);
517 /* Flush all objects out of the padata queues. */
518 static void padata_flush_queues(struct parallel_data
*pd
)
521 struct padata_parallel_queue
*pqueue
;
522 struct padata_serial_queue
*squeue
;
524 for_each_cpu(cpu
, pd
->cpumask
.pcpu
) {
525 pqueue
= per_cpu_ptr(pd
->pqueue
, cpu
);
526 flush_work(&pqueue
->work
);
529 del_timer_sync(&pd
->timer
);
531 if (atomic_read(&pd
->reorder_objects
))
534 for_each_cpu(cpu
, pd
->cpumask
.cbcpu
) {
535 squeue
= per_cpu_ptr(pd
->squeue
, cpu
);
536 flush_work(&squeue
->work
);
539 BUG_ON(atomic_read(&pd
->refcnt
) != 0);
542 static void __padata_start(struct padata_instance
*pinst
)
544 pinst
->flags
|= PADATA_INIT
;
547 static void __padata_stop(struct padata_instance
*pinst
)
549 if (!(pinst
->flags
& PADATA_INIT
))
552 pinst
->flags
&= ~PADATA_INIT
;
557 padata_flush_queues(pinst
->pd
);
561 /* Replace the internal control structure with a new one. */
562 static void padata_replace(struct padata_instance
*pinst
,
563 struct parallel_data
*pd_new
)
565 struct parallel_data
*pd_old
= pinst
->pd
;
566 int notification_mask
= 0;
568 pinst
->flags
|= PADATA_RESET
;
570 rcu_assign_pointer(pinst
->pd
, pd_new
);
574 if (!cpumask_equal(pd_old
->cpumask
.pcpu
, pd_new
->cpumask
.pcpu
))
575 notification_mask
|= PADATA_CPU_PARALLEL
;
576 if (!cpumask_equal(pd_old
->cpumask
.cbcpu
, pd_new
->cpumask
.cbcpu
))
577 notification_mask
|= PADATA_CPU_SERIAL
;
579 padata_flush_queues(pd_old
);
580 padata_free_pd(pd_old
);
582 if (notification_mask
)
583 blocking_notifier_call_chain(&pinst
->cpumask_change_notifier
,
587 pinst
->flags
&= ~PADATA_RESET
;
591 * padata_register_cpumask_notifier - Registers a notifier that will be called
592 * if either pcpu or cbcpu or both cpumasks change.
594 * @pinst: A poineter to padata instance
595 * @nblock: A pointer to notifier block.
597 int padata_register_cpumask_notifier(struct padata_instance
*pinst
,
598 struct notifier_block
*nblock
)
600 return blocking_notifier_chain_register(&pinst
->cpumask_change_notifier
,
603 EXPORT_SYMBOL(padata_register_cpumask_notifier
);
606 * padata_unregister_cpumask_notifier - Unregisters cpumask notifier
607 * registered earlier using padata_register_cpumask_notifier
609 * @pinst: A pointer to data instance.
610 * @nlock: A pointer to notifier block.
612 int padata_unregister_cpumask_notifier(struct padata_instance
*pinst
,
613 struct notifier_block
*nblock
)
615 return blocking_notifier_chain_unregister(
616 &pinst
->cpumask_change_notifier
,
619 EXPORT_SYMBOL(padata_unregister_cpumask_notifier
);
622 /* If cpumask contains no active cpu, we mark the instance as invalid. */
623 static bool padata_validate_cpumask(struct padata_instance
*pinst
,
624 const struct cpumask
*cpumask
)
626 if (!cpumask_intersects(cpumask
, cpu_online_mask
)) {
627 pinst
->flags
|= PADATA_INVALID
;
631 pinst
->flags
&= ~PADATA_INVALID
;
635 static int __padata_set_cpumasks(struct padata_instance
*pinst
,
636 cpumask_var_t pcpumask
,
637 cpumask_var_t cbcpumask
)
640 struct parallel_data
*pd
;
642 valid
= padata_validate_cpumask(pinst
, pcpumask
);
644 __padata_stop(pinst
);
648 valid
= padata_validate_cpumask(pinst
, cbcpumask
);
650 __padata_stop(pinst
);
653 pd
= padata_alloc_pd(pinst
, pcpumask
, cbcpumask
);
657 cpumask_copy(pinst
->cpumask
.pcpu
, pcpumask
);
658 cpumask_copy(pinst
->cpumask
.cbcpu
, cbcpumask
);
660 padata_replace(pinst
, pd
);
663 __padata_start(pinst
);
669 * padata_set_cpumask: Sets specified by @cpumask_type cpumask to the value
670 * equivalent to @cpumask.
672 * @pinst: padata instance
673 * @cpumask_type: PADATA_CPU_SERIAL or PADATA_CPU_PARALLEL corresponding
674 * to parallel and serial cpumasks respectively.
675 * @cpumask: the cpumask to use
677 int padata_set_cpumask(struct padata_instance
*pinst
, int cpumask_type
,
678 cpumask_var_t cpumask
)
680 struct cpumask
*serial_mask
, *parallel_mask
;
683 mutex_lock(&pinst
->lock
);
686 switch (cpumask_type
) {
687 case PADATA_CPU_PARALLEL
:
688 serial_mask
= pinst
->cpumask
.cbcpu
;
689 parallel_mask
= cpumask
;
691 case PADATA_CPU_SERIAL
:
692 parallel_mask
= pinst
->cpumask
.pcpu
;
693 serial_mask
= cpumask
;
699 err
= __padata_set_cpumasks(pinst
, parallel_mask
, serial_mask
);
703 mutex_unlock(&pinst
->lock
);
707 EXPORT_SYMBOL(padata_set_cpumask
);
710 * padata_start - start the parallel processing
712 * @pinst: padata instance to start
714 int padata_start(struct padata_instance
*pinst
)
718 mutex_lock(&pinst
->lock
);
720 if (pinst
->flags
& PADATA_INVALID
)
723 __padata_start(pinst
);
725 mutex_unlock(&pinst
->lock
);
729 EXPORT_SYMBOL(padata_start
);
732 * padata_stop - stop the parallel processing
734 * @pinst: padata instance to stop
736 void padata_stop(struct padata_instance
*pinst
)
738 mutex_lock(&pinst
->lock
);
739 __padata_stop(pinst
);
740 mutex_unlock(&pinst
->lock
);
742 EXPORT_SYMBOL(padata_stop
);
744 #ifdef CONFIG_HOTPLUG_CPU
746 static int __padata_add_cpu(struct padata_instance
*pinst
, int cpu
)
748 struct parallel_data
*pd
;
750 if (cpumask_test_cpu(cpu
, cpu_online_mask
)) {
751 pd
= padata_alloc_pd(pinst
, pinst
->cpumask
.pcpu
,
752 pinst
->cpumask
.cbcpu
);
756 padata_replace(pinst
, pd
);
758 if (padata_validate_cpumask(pinst
, pinst
->cpumask
.pcpu
) &&
759 padata_validate_cpumask(pinst
, pinst
->cpumask
.cbcpu
))
760 __padata_start(pinst
);
766 static int __padata_remove_cpu(struct padata_instance
*pinst
, int cpu
)
768 struct parallel_data
*pd
= NULL
;
770 if (cpumask_test_cpu(cpu
, cpu_online_mask
)) {
772 if (!padata_validate_cpumask(pinst
, pinst
->cpumask
.pcpu
) ||
773 !padata_validate_cpumask(pinst
, pinst
->cpumask
.cbcpu
))
774 __padata_stop(pinst
);
776 pd
= padata_alloc_pd(pinst
, pinst
->cpumask
.pcpu
,
777 pinst
->cpumask
.cbcpu
);
781 padata_replace(pinst
, pd
);
783 cpumask_clear_cpu(cpu
, pd
->cpumask
.cbcpu
);
784 cpumask_clear_cpu(cpu
, pd
->cpumask
.pcpu
);
791 * padata_remove_cpu - remove a cpu from the one or both(serial and parallel)
794 * @pinst: padata instance
795 * @cpu: cpu to remove
796 * @mask: bitmask specifying from which cpumask @cpu should be removed
797 * The @mask may be any combination of the following flags:
798 * PADATA_CPU_SERIAL - serial cpumask
799 * PADATA_CPU_PARALLEL - parallel cpumask
801 int padata_remove_cpu(struct padata_instance
*pinst
, int cpu
, int mask
)
805 if (!(mask
& (PADATA_CPU_SERIAL
| PADATA_CPU_PARALLEL
)))
808 mutex_lock(&pinst
->lock
);
811 if (mask
& PADATA_CPU_SERIAL
)
812 cpumask_clear_cpu(cpu
, pinst
->cpumask
.cbcpu
);
813 if (mask
& PADATA_CPU_PARALLEL
)
814 cpumask_clear_cpu(cpu
, pinst
->cpumask
.pcpu
);
816 err
= __padata_remove_cpu(pinst
, cpu
);
819 mutex_unlock(&pinst
->lock
);
823 EXPORT_SYMBOL(padata_remove_cpu
);
825 static inline int pinst_has_cpu(struct padata_instance
*pinst
, int cpu
)
827 return cpumask_test_cpu(cpu
, pinst
->cpumask
.pcpu
) ||
828 cpumask_test_cpu(cpu
, pinst
->cpumask
.cbcpu
);
831 static int padata_cpu_online(unsigned int cpu
, struct hlist_node
*node
)
833 struct padata_instance
*pinst
;
836 pinst
= hlist_entry_safe(node
, struct padata_instance
, node
);
837 if (!pinst_has_cpu(pinst
, cpu
))
840 mutex_lock(&pinst
->lock
);
841 ret
= __padata_add_cpu(pinst
, cpu
);
842 mutex_unlock(&pinst
->lock
);
846 static int padata_cpu_prep_down(unsigned int cpu
, struct hlist_node
*node
)
848 struct padata_instance
*pinst
;
851 pinst
= hlist_entry_safe(node
, struct padata_instance
, node
);
852 if (!pinst_has_cpu(pinst
, cpu
))
855 mutex_lock(&pinst
->lock
);
856 ret
= __padata_remove_cpu(pinst
, cpu
);
857 mutex_unlock(&pinst
->lock
);
861 static enum cpuhp_state hp_online
;
864 static void __padata_free(struct padata_instance
*pinst
)
866 #ifdef CONFIG_HOTPLUG_CPU
867 cpuhp_state_remove_instance_nocalls(hp_online
, &pinst
->node
);
871 padata_free_pd(pinst
->pd
);
872 free_cpumask_var(pinst
->cpumask
.pcpu
);
873 free_cpumask_var(pinst
->cpumask
.cbcpu
);
877 #define kobj2pinst(_kobj) \
878 container_of(_kobj, struct padata_instance, kobj)
879 #define attr2pentry(_attr) \
880 container_of(_attr, struct padata_sysfs_entry, attr)
882 static void padata_sysfs_release(struct kobject
*kobj
)
884 struct padata_instance
*pinst
= kobj2pinst(kobj
);
885 __padata_free(pinst
);
888 struct padata_sysfs_entry
{
889 struct attribute attr
;
890 ssize_t (*show
)(struct padata_instance
*, struct attribute
*, char *);
891 ssize_t (*store
)(struct padata_instance
*, struct attribute
*,
892 const char *, size_t);
895 static ssize_t
show_cpumask(struct padata_instance
*pinst
,
896 struct attribute
*attr
, char *buf
)
898 struct cpumask
*cpumask
;
901 mutex_lock(&pinst
->lock
);
902 if (!strcmp(attr
->name
, "serial_cpumask"))
903 cpumask
= pinst
->cpumask
.cbcpu
;
905 cpumask
= pinst
->cpumask
.pcpu
;
907 len
= snprintf(buf
, PAGE_SIZE
, "%*pb\n",
908 nr_cpu_ids
, cpumask_bits(cpumask
));
909 mutex_unlock(&pinst
->lock
);
910 return len
< PAGE_SIZE
? len
: -EINVAL
;
913 static ssize_t
store_cpumask(struct padata_instance
*pinst
,
914 struct attribute
*attr
,
915 const char *buf
, size_t count
)
917 cpumask_var_t new_cpumask
;
921 if (!alloc_cpumask_var(&new_cpumask
, GFP_KERNEL
))
924 ret
= bitmap_parse(buf
, count
, cpumask_bits(new_cpumask
),
929 mask_type
= !strcmp(attr
->name
, "serial_cpumask") ?
930 PADATA_CPU_SERIAL
: PADATA_CPU_PARALLEL
;
931 ret
= padata_set_cpumask(pinst
, mask_type
, new_cpumask
);
936 free_cpumask_var(new_cpumask
);
940 #define PADATA_ATTR_RW(_name, _show_name, _store_name) \
941 static struct padata_sysfs_entry _name##_attr = \
942 __ATTR(_name, 0644, _show_name, _store_name)
943 #define PADATA_ATTR_RO(_name, _show_name) \
944 static struct padata_sysfs_entry _name##_attr = \
945 __ATTR(_name, 0400, _show_name, NULL)
947 PADATA_ATTR_RW(serial_cpumask
, show_cpumask
, store_cpumask
);
948 PADATA_ATTR_RW(parallel_cpumask
, show_cpumask
, store_cpumask
);
951 * Padata sysfs provides the following objects:
952 * serial_cpumask [RW] - cpumask for serial workers
953 * parallel_cpumask [RW] - cpumask for parallel workers
955 static struct attribute
*padata_default_attrs
[] = {
956 &serial_cpumask_attr
.attr
,
957 ¶llel_cpumask_attr
.attr
,
961 static ssize_t
padata_sysfs_show(struct kobject
*kobj
,
962 struct attribute
*attr
, char *buf
)
964 struct padata_instance
*pinst
;
965 struct padata_sysfs_entry
*pentry
;
968 pinst
= kobj2pinst(kobj
);
969 pentry
= attr2pentry(attr
);
971 ret
= pentry
->show(pinst
, attr
, buf
);
976 static ssize_t
padata_sysfs_store(struct kobject
*kobj
, struct attribute
*attr
,
977 const char *buf
, size_t count
)
979 struct padata_instance
*pinst
;
980 struct padata_sysfs_entry
*pentry
;
983 pinst
= kobj2pinst(kobj
);
984 pentry
= attr2pentry(attr
);
986 ret
= pentry
->store(pinst
, attr
, buf
, count
);
991 static const struct sysfs_ops padata_sysfs_ops
= {
992 .show
= padata_sysfs_show
,
993 .store
= padata_sysfs_store
,
996 static struct kobj_type padata_attr_type
= {
997 .sysfs_ops
= &padata_sysfs_ops
,
998 .default_attrs
= padata_default_attrs
,
999 .release
= padata_sysfs_release
,
1003 * padata_alloc - allocate and initialize a padata instance and specify
1004 * cpumasks for serial and parallel workers.
1006 * @wq: workqueue to use for the allocated padata instance
1007 * @pcpumask: cpumask that will be used for padata parallelization
1008 * @cbcpumask: cpumask that will be used for padata serialization
1010 * Must be called from a cpus_read_lock() protected region
1012 static struct padata_instance
*padata_alloc(struct workqueue_struct
*wq
,
1013 const struct cpumask
*pcpumask
,
1014 const struct cpumask
*cbcpumask
)
1016 struct padata_instance
*pinst
;
1017 struct parallel_data
*pd
= NULL
;
1019 pinst
= kzalloc(sizeof(struct padata_instance
), GFP_KERNEL
);
1023 if (!alloc_cpumask_var(&pinst
->cpumask
.pcpu
, GFP_KERNEL
))
1025 if (!alloc_cpumask_var(&pinst
->cpumask
.cbcpu
, GFP_KERNEL
)) {
1026 free_cpumask_var(pinst
->cpumask
.pcpu
);
1029 if (!padata_validate_cpumask(pinst
, pcpumask
) ||
1030 !padata_validate_cpumask(pinst
, cbcpumask
))
1031 goto err_free_masks
;
1033 pd
= padata_alloc_pd(pinst
, pcpumask
, cbcpumask
);
1035 goto err_free_masks
;
1037 rcu_assign_pointer(pinst
->pd
, pd
);
1041 cpumask_copy(pinst
->cpumask
.pcpu
, pcpumask
);
1042 cpumask_copy(pinst
->cpumask
.cbcpu
, cbcpumask
);
1046 BLOCKING_INIT_NOTIFIER_HEAD(&pinst
->cpumask_change_notifier
);
1047 kobject_init(&pinst
->kobj
, &padata_attr_type
);
1048 mutex_init(&pinst
->lock
);
1050 #ifdef CONFIG_HOTPLUG_CPU
1051 cpuhp_state_add_instance_nocalls_cpuslocked(hp_online
, &pinst
->node
);
1056 free_cpumask_var(pinst
->cpumask
.pcpu
);
1057 free_cpumask_var(pinst
->cpumask
.cbcpu
);
1065 * padata_alloc_possible - Allocate and initialize padata instance.
1066 * Use the cpu_possible_mask for serial and
1069 * @wq: workqueue to use for the allocated padata instance
1071 * Must be called from a cpus_read_lock() protected region
1073 struct padata_instance
*padata_alloc_possible(struct workqueue_struct
*wq
)
1075 lockdep_assert_cpus_held();
1076 return padata_alloc(wq
, cpu_possible_mask
, cpu_possible_mask
);
1078 EXPORT_SYMBOL(padata_alloc_possible
);
1081 * padata_free - free a padata instance
1083 * @padata_inst: padata instance to free
1085 void padata_free(struct padata_instance
*pinst
)
1087 kobject_put(&pinst
->kobj
);
1089 EXPORT_SYMBOL(padata_free
);
1091 #ifdef CONFIG_HOTPLUG_CPU
1093 static __init
int padata_driver_init(void)
1097 ret
= cpuhp_setup_state_multi(CPUHP_AP_ONLINE_DYN
, "padata:online",
1099 padata_cpu_prep_down
);
1105 module_init(padata_driver_init
);
1107 static __exit
void padata_driver_exit(void)
1109 cpuhp_remove_multi_state(hp_online
);
1111 module_exit(padata_driver_exit
);