xref: /linux-6.15/kernel/workqueue.c (revision 8bb78442)
11da177e4SLinus Torvalds /*
21da177e4SLinus Torvalds  * linux/kernel/workqueue.c
31da177e4SLinus Torvalds  *
41da177e4SLinus Torvalds  * Generic mechanism for defining kernel helper threads for running
51da177e4SLinus Torvalds  * arbitrary tasks in process context.
61da177e4SLinus Torvalds  *
71da177e4SLinus Torvalds  * Started by Ingo Molnar, Copyright (C) 2002
81da177e4SLinus Torvalds  *
91da177e4SLinus Torvalds  * Derived from the taskqueue/keventd code by:
101da177e4SLinus Torvalds  *
111da177e4SLinus Torvalds  *   David Woodhouse <[email protected]>
121da177e4SLinus Torvalds  *   Andrew Morton <[email protected]>
131da177e4SLinus Torvalds  *   Kai Petzke <[email protected]>
141da177e4SLinus Torvalds  *   Theodore Ts'o <[email protected]>
1589ada679SChristoph Lameter  *
1689ada679SChristoph Lameter  * Made to use alloc_percpu by Christoph Lameter <[email protected]>.
171da177e4SLinus Torvalds  */
181da177e4SLinus Torvalds 
191da177e4SLinus Torvalds #include <linux/module.h>
201da177e4SLinus Torvalds #include <linux/kernel.h>
211da177e4SLinus Torvalds #include <linux/sched.h>
221da177e4SLinus Torvalds #include <linux/init.h>
231da177e4SLinus Torvalds #include <linux/signal.h>
241da177e4SLinus Torvalds #include <linux/completion.h>
251da177e4SLinus Torvalds #include <linux/workqueue.h>
261da177e4SLinus Torvalds #include <linux/slab.h>
271da177e4SLinus Torvalds #include <linux/cpu.h>
281da177e4SLinus Torvalds #include <linux/notifier.h>
291da177e4SLinus Torvalds #include <linux/kthread.h>
301fa44ecaSJames Bottomley #include <linux/hardirq.h>
3146934023SChristoph Lameter #include <linux/mempolicy.h>
32341a5958SRafael J. Wysocki #include <linux/freezer.h>
33d5abe669SPeter Zijlstra #include <linux/kallsyms.h>
34d5abe669SPeter Zijlstra #include <linux/debug_locks.h>
351da177e4SLinus Torvalds 
361da177e4SLinus Torvalds /*
37f756d5e2SNathan Lynch  * The per-CPU workqueue (if single thread, we always use the first
38f756d5e2SNathan Lynch  * possible cpu).
391da177e4SLinus Torvalds  */
401da177e4SLinus Torvalds struct cpu_workqueue_struct {
411da177e4SLinus Torvalds 
421da177e4SLinus Torvalds 	spinlock_t lock;
431da177e4SLinus Torvalds 
441da177e4SLinus Torvalds 	struct list_head worklist;
451da177e4SLinus Torvalds 	wait_queue_head_t more_work;
463af24433SOleg Nesterov 	struct work_struct *current_work;
471da177e4SLinus Torvalds 
481da177e4SLinus Torvalds 	struct workqueue_struct *wq;
4936c8b586SIngo Molnar 	struct task_struct *thread;
503af24433SOleg Nesterov 	int should_stop;
511da177e4SLinus Torvalds 
521da177e4SLinus Torvalds 	int run_depth;		/* Detect run_workqueue() recursion depth */
531da177e4SLinus Torvalds } ____cacheline_aligned;
541da177e4SLinus Torvalds 
551da177e4SLinus Torvalds /*
561da177e4SLinus Torvalds  * The externally visible workqueue abstraction is an array of
571da177e4SLinus Torvalds  * per-CPU workqueues:
581da177e4SLinus Torvalds  */
591da177e4SLinus Torvalds struct workqueue_struct {
6089ada679SChristoph Lameter 	struct cpu_workqueue_struct *cpu_wq;
61cce1a165SOleg Nesterov 	struct list_head list;
621da177e4SLinus Torvalds 	const char *name;
63cce1a165SOleg Nesterov 	int singlethread;
64319c2a98SOleg Nesterov 	int freezeable;		/* Freeze threads during suspend */
651da177e4SLinus Torvalds };
661da177e4SLinus Torvalds 
671da177e4SLinus Torvalds /* All the per-cpu workqueues on the system, for hotplug cpu to add/remove
681da177e4SLinus Torvalds    threads to each one as cpus come/go. */
699b41ea72SAndrew Morton static DEFINE_MUTEX(workqueue_mutex);
701da177e4SLinus Torvalds static LIST_HEAD(workqueues);
711da177e4SLinus Torvalds 
723af24433SOleg Nesterov static int singlethread_cpu __read_mostly;
73b1f4ec17SOleg Nesterov static cpumask_t cpu_singlethread_map __read_mostly;
743af24433SOleg Nesterov /* optimization, we could use cpu_possible_map */
753af24433SOleg Nesterov static cpumask_t cpu_populated_map __read_mostly;
76f756d5e2SNathan Lynch 
771da177e4SLinus Torvalds /* If it's single threaded, it isn't in the list of workqueues. */
781da177e4SLinus Torvalds static inline int is_single_threaded(struct workqueue_struct *wq)
791da177e4SLinus Torvalds {
80cce1a165SOleg Nesterov 	return wq->singlethread;
811da177e4SLinus Torvalds }
821da177e4SLinus Torvalds 
83b1f4ec17SOleg Nesterov static const cpumask_t *wq_cpu_map(struct workqueue_struct *wq)
84b1f4ec17SOleg Nesterov {
85b1f4ec17SOleg Nesterov 	return is_single_threaded(wq)
86b1f4ec17SOleg Nesterov 		? &cpu_singlethread_map : &cpu_populated_map;
87b1f4ec17SOleg Nesterov }
88b1f4ec17SOleg Nesterov 
89a848e3b6SOleg Nesterov static
90a848e3b6SOleg Nesterov struct cpu_workqueue_struct *wq_per_cpu(struct workqueue_struct *wq, int cpu)
91a848e3b6SOleg Nesterov {
92a848e3b6SOleg Nesterov 	if (unlikely(is_single_threaded(wq)))
93a848e3b6SOleg Nesterov 		cpu = singlethread_cpu;
94a848e3b6SOleg Nesterov 	return per_cpu_ptr(wq->cpu_wq, cpu);
95a848e3b6SOleg Nesterov }
96a848e3b6SOleg Nesterov 
974594bf15SDavid Howells /*
984594bf15SDavid Howells  * Set the workqueue on which a work item is to be run
994594bf15SDavid Howells  * - Must *only* be called if the pending flag is set
1004594bf15SDavid Howells  */
101ed7c0feeSOleg Nesterov static inline void set_wq_data(struct work_struct *work,
102ed7c0feeSOleg Nesterov 				struct cpu_workqueue_struct *cwq)
103365970a1SDavid Howells {
1044594bf15SDavid Howells 	unsigned long new;
105365970a1SDavid Howells 
1064594bf15SDavid Howells 	BUG_ON(!work_pending(work));
1074594bf15SDavid Howells 
108ed7c0feeSOleg Nesterov 	new = (unsigned long) cwq | (1UL << WORK_STRUCT_PENDING);
109a08727baSLinus Torvalds 	new |= WORK_STRUCT_FLAG_MASK & *work_data_bits(work);
110a08727baSLinus Torvalds 	atomic_long_set(&work->data, new);
111365970a1SDavid Howells }
112365970a1SDavid Howells 
113ed7c0feeSOleg Nesterov static inline
114ed7c0feeSOleg Nesterov struct cpu_workqueue_struct *get_wq_data(struct work_struct *work)
115365970a1SDavid Howells {
116a08727baSLinus Torvalds 	return (void *) (atomic_long_read(&work->data) & WORK_STRUCT_WQ_DATA_MASK);
117365970a1SDavid Howells }
118365970a1SDavid Howells 
119b89deed3SOleg Nesterov static void insert_work(struct cpu_workqueue_struct *cwq,
120b89deed3SOleg Nesterov 				struct work_struct *work, int tail)
121b89deed3SOleg Nesterov {
122b89deed3SOleg Nesterov 	set_wq_data(work, cwq);
1236e84d644SOleg Nesterov 	/*
1246e84d644SOleg Nesterov 	 * Ensure that we get the right work->data if we see the
1256e84d644SOleg Nesterov 	 * result of list_add() below, see try_to_grab_pending().
1266e84d644SOleg Nesterov 	 */
1276e84d644SOleg Nesterov 	smp_wmb();
128b89deed3SOleg Nesterov 	if (tail)
129b89deed3SOleg Nesterov 		list_add_tail(&work->entry, &cwq->worklist);
130b89deed3SOleg Nesterov 	else
131b89deed3SOleg Nesterov 		list_add(&work->entry, &cwq->worklist);
132b89deed3SOleg Nesterov 	wake_up(&cwq->more_work);
133b89deed3SOleg Nesterov }
134b89deed3SOleg Nesterov 
1351da177e4SLinus Torvalds /* Preempt must be disabled. */
1361da177e4SLinus Torvalds static void __queue_work(struct cpu_workqueue_struct *cwq,
1371da177e4SLinus Torvalds 			 struct work_struct *work)
1381da177e4SLinus Torvalds {
1391da177e4SLinus Torvalds 	unsigned long flags;
1401da177e4SLinus Torvalds 
1411da177e4SLinus Torvalds 	spin_lock_irqsave(&cwq->lock, flags);
142b89deed3SOleg Nesterov 	insert_work(cwq, work, 1);
1431da177e4SLinus Torvalds 	spin_unlock_irqrestore(&cwq->lock, flags);
1441da177e4SLinus Torvalds }
1451da177e4SLinus Torvalds 
1460fcb78c2SRolf Eike Beer /**
1470fcb78c2SRolf Eike Beer  * queue_work - queue work on a workqueue
1480fcb78c2SRolf Eike Beer  * @wq: workqueue to use
1490fcb78c2SRolf Eike Beer  * @work: work to queue
1500fcb78c2SRolf Eike Beer  *
151057647fcSAlan Stern  * Returns 0 if @work was already on a queue, non-zero otherwise.
1521da177e4SLinus Torvalds  *
1531da177e4SLinus Torvalds  * We queue the work to the CPU it was submitted, but there is no
1541da177e4SLinus Torvalds  * guarantee that it will be processed by that CPU.
1551da177e4SLinus Torvalds  */
1561da177e4SLinus Torvalds int fastcall queue_work(struct workqueue_struct *wq, struct work_struct *work)
1571da177e4SLinus Torvalds {
158a848e3b6SOleg Nesterov 	int ret = 0;
1591da177e4SLinus Torvalds 
160a08727baSLinus Torvalds 	if (!test_and_set_bit(WORK_STRUCT_PENDING, work_data_bits(work))) {
1611da177e4SLinus Torvalds 		BUG_ON(!list_empty(&work->entry));
162a848e3b6SOleg Nesterov 		__queue_work(wq_per_cpu(wq, get_cpu()), work);
163a848e3b6SOleg Nesterov 		put_cpu();
1641da177e4SLinus Torvalds 		ret = 1;
1651da177e4SLinus Torvalds 	}
1661da177e4SLinus Torvalds 	return ret;
1671da177e4SLinus Torvalds }
168ae90dd5dSDave Jones EXPORT_SYMBOL_GPL(queue_work);
1691da177e4SLinus Torvalds 
17082f67cd9SIngo Molnar void delayed_work_timer_fn(unsigned long __data)
1711da177e4SLinus Torvalds {
17252bad64dSDavid Howells 	struct delayed_work *dwork = (struct delayed_work *)__data;
173ed7c0feeSOleg Nesterov 	struct cpu_workqueue_struct *cwq = get_wq_data(&dwork->work);
174ed7c0feeSOleg Nesterov 	struct workqueue_struct *wq = cwq->wq;
1751da177e4SLinus Torvalds 
176a848e3b6SOleg Nesterov 	__queue_work(wq_per_cpu(wq, smp_processor_id()), &dwork->work);
1771da177e4SLinus Torvalds }
1781da177e4SLinus Torvalds 
1790fcb78c2SRolf Eike Beer /**
1800fcb78c2SRolf Eike Beer  * queue_delayed_work - queue work on a workqueue after delay
1810fcb78c2SRolf Eike Beer  * @wq: workqueue to use
182af9997e4SRandy Dunlap  * @dwork: delayable work to queue
1830fcb78c2SRolf Eike Beer  * @delay: number of jiffies to wait before queueing
1840fcb78c2SRolf Eike Beer  *
185057647fcSAlan Stern  * Returns 0 if @work was already on a queue, non-zero otherwise.
1860fcb78c2SRolf Eike Beer  */
1871da177e4SLinus Torvalds int fastcall queue_delayed_work(struct workqueue_struct *wq,
18852bad64dSDavid Howells 			struct delayed_work *dwork, unsigned long delay)
1891da177e4SLinus Torvalds {
19063bc0362SOleg Nesterov 	timer_stats_timer_set_start_info(&dwork->timer);
19152bad64dSDavid Howells 	if (delay == 0)
19263bc0362SOleg Nesterov 		return queue_work(wq, &dwork->work);
1931da177e4SLinus Torvalds 
19463bc0362SOleg Nesterov 	return queue_delayed_work_on(-1, wq, dwork, delay);
1951da177e4SLinus Torvalds }
196ae90dd5dSDave Jones EXPORT_SYMBOL_GPL(queue_delayed_work);
1971da177e4SLinus Torvalds 
1980fcb78c2SRolf Eike Beer /**
1990fcb78c2SRolf Eike Beer  * queue_delayed_work_on - queue work on specific CPU after delay
2000fcb78c2SRolf Eike Beer  * @cpu: CPU number to execute work on
2010fcb78c2SRolf Eike Beer  * @wq: workqueue to use
202af9997e4SRandy Dunlap  * @dwork: work to queue
2030fcb78c2SRolf Eike Beer  * @delay: number of jiffies to wait before queueing
2040fcb78c2SRolf Eike Beer  *
205057647fcSAlan Stern  * Returns 0 if @work was already on a queue, non-zero otherwise.
2060fcb78c2SRolf Eike Beer  */
2077a6bc1cdSVenkatesh Pallipadi int queue_delayed_work_on(int cpu, struct workqueue_struct *wq,
20852bad64dSDavid Howells 			struct delayed_work *dwork, unsigned long delay)
2097a6bc1cdSVenkatesh Pallipadi {
2107a6bc1cdSVenkatesh Pallipadi 	int ret = 0;
21152bad64dSDavid Howells 	struct timer_list *timer = &dwork->timer;
21252bad64dSDavid Howells 	struct work_struct *work = &dwork->work;
2137a6bc1cdSVenkatesh Pallipadi 
214a08727baSLinus Torvalds 	if (!test_and_set_bit(WORK_STRUCT_PENDING, work_data_bits(work))) {
2157a6bc1cdSVenkatesh Pallipadi 		BUG_ON(timer_pending(timer));
2167a6bc1cdSVenkatesh Pallipadi 		BUG_ON(!list_empty(&work->entry));
2177a6bc1cdSVenkatesh Pallipadi 
218ed7c0feeSOleg Nesterov 		/* This stores cwq for the moment, for the timer_fn */
219a848e3b6SOleg Nesterov 		set_wq_data(work, wq_per_cpu(wq, raw_smp_processor_id()));
2207a6bc1cdSVenkatesh Pallipadi 		timer->expires = jiffies + delay;
22152bad64dSDavid Howells 		timer->data = (unsigned long)dwork;
2227a6bc1cdSVenkatesh Pallipadi 		timer->function = delayed_work_timer_fn;
22363bc0362SOleg Nesterov 
22463bc0362SOleg Nesterov 		if (unlikely(cpu >= 0))
2257a6bc1cdSVenkatesh Pallipadi 			add_timer_on(timer, cpu);
22663bc0362SOleg Nesterov 		else
22763bc0362SOleg Nesterov 			add_timer(timer);
2287a6bc1cdSVenkatesh Pallipadi 		ret = 1;
2297a6bc1cdSVenkatesh Pallipadi 	}
2307a6bc1cdSVenkatesh Pallipadi 	return ret;
2317a6bc1cdSVenkatesh Pallipadi }
232ae90dd5dSDave Jones EXPORT_SYMBOL_GPL(queue_delayed_work_on);
2331da177e4SLinus Torvalds 
234858119e1SArjan van de Ven static void run_workqueue(struct cpu_workqueue_struct *cwq)
2351da177e4SLinus Torvalds {
236f293ea92SOleg Nesterov 	spin_lock_irq(&cwq->lock);
2371da177e4SLinus Torvalds 	cwq->run_depth++;
2381da177e4SLinus Torvalds 	if (cwq->run_depth > 3) {
2391da177e4SLinus Torvalds 		/* morton gets to eat his hat */
2401da177e4SLinus Torvalds 		printk("%s: recursion depth exceeded: %d\n",
2411da177e4SLinus Torvalds 			__FUNCTION__, cwq->run_depth);
2421da177e4SLinus Torvalds 		dump_stack();
2431da177e4SLinus Torvalds 	}
2441da177e4SLinus Torvalds 	while (!list_empty(&cwq->worklist)) {
2451da177e4SLinus Torvalds 		struct work_struct *work = list_entry(cwq->worklist.next,
2461da177e4SLinus Torvalds 						struct work_struct, entry);
2476bb49e59SDavid Howells 		work_func_t f = work->func;
2481da177e4SLinus Torvalds 
249b89deed3SOleg Nesterov 		cwq->current_work = work;
2501da177e4SLinus Torvalds 		list_del_init(cwq->worklist.next);
251f293ea92SOleg Nesterov 		spin_unlock_irq(&cwq->lock);
2521da177e4SLinus Torvalds 
253365970a1SDavid Howells 		BUG_ON(get_wq_data(work) != cwq);
25423b2e599SOleg Nesterov 		work_clear_pending(work);
25565f27f38SDavid Howells 		f(work);
2561da177e4SLinus Torvalds 
257d5abe669SPeter Zijlstra 		if (unlikely(in_atomic() || lockdep_depth(current) > 0)) {
258d5abe669SPeter Zijlstra 			printk(KERN_ERR "BUG: workqueue leaked lock or atomic: "
259d5abe669SPeter Zijlstra 					"%s/0x%08x/%d\n",
260d5abe669SPeter Zijlstra 					current->comm, preempt_count(),
261d5abe669SPeter Zijlstra 				       	current->pid);
262d5abe669SPeter Zijlstra 			printk(KERN_ERR "    last function: ");
263d5abe669SPeter Zijlstra 			print_symbol("%s\n", (unsigned long)f);
264d5abe669SPeter Zijlstra 			debug_show_held_locks(current);
265d5abe669SPeter Zijlstra 			dump_stack();
266d5abe669SPeter Zijlstra 		}
267d5abe669SPeter Zijlstra 
268f293ea92SOleg Nesterov 		spin_lock_irq(&cwq->lock);
269b89deed3SOleg Nesterov 		cwq->current_work = NULL;
2701da177e4SLinus Torvalds 	}
2711da177e4SLinus Torvalds 	cwq->run_depth--;
272f293ea92SOleg Nesterov 	spin_unlock_irq(&cwq->lock);
2731da177e4SLinus Torvalds }
2741da177e4SLinus Torvalds 
2753af24433SOleg Nesterov /*
2763af24433SOleg Nesterov  * NOTE: the caller must not touch *cwq if this func returns true
2773af24433SOleg Nesterov  */
2783af24433SOleg Nesterov static int cwq_should_stop(struct cpu_workqueue_struct *cwq)
2793af24433SOleg Nesterov {
2803af24433SOleg Nesterov 	int should_stop = cwq->should_stop;
2813af24433SOleg Nesterov 
2823af24433SOleg Nesterov 	if (unlikely(should_stop)) {
2833af24433SOleg Nesterov 		spin_lock_irq(&cwq->lock);
2843af24433SOleg Nesterov 		should_stop = cwq->should_stop && list_empty(&cwq->worklist);
2853af24433SOleg Nesterov 		if (should_stop)
2863af24433SOleg Nesterov 			cwq->thread = NULL;
2873af24433SOleg Nesterov 		spin_unlock_irq(&cwq->lock);
2883af24433SOleg Nesterov 	}
2893af24433SOleg Nesterov 
2903af24433SOleg Nesterov 	return should_stop;
2913af24433SOleg Nesterov }
2923af24433SOleg Nesterov 
2931da177e4SLinus Torvalds static int worker_thread(void *__cwq)
2941da177e4SLinus Torvalds {
2951da177e4SLinus Torvalds 	struct cpu_workqueue_struct *cwq = __cwq;
2963af24433SOleg Nesterov 	DEFINE_WAIT(wait);
2971da177e4SLinus Torvalds 
298319c2a98SOleg Nesterov 	if (!cwq->wq->freezeable)
2991da177e4SLinus Torvalds 		current->flags |= PF_NOFREEZE;
3001da177e4SLinus Torvalds 
3011da177e4SLinus Torvalds 	set_user_nice(current, -5);
3021da177e4SLinus Torvalds 
3033af24433SOleg Nesterov 	for (;;) {
3043af24433SOleg Nesterov 		prepare_to_wait(&cwq->more_work, &wait, TASK_INTERRUPTIBLE);
30585f4186aSOleg Nesterov 		if (!freezing(current) && !cwq->should_stop
30685f4186aSOleg Nesterov 		    && list_empty(&cwq->worklist))
3071da177e4SLinus Torvalds 			schedule();
3083af24433SOleg Nesterov 		finish_wait(&cwq->more_work, &wait);
3091da177e4SLinus Torvalds 
31085f4186aSOleg Nesterov 		try_to_freeze();
31185f4186aSOleg Nesterov 
3123af24433SOleg Nesterov 		if (cwq_should_stop(cwq))
3133af24433SOleg Nesterov 			break;
3143af24433SOleg Nesterov 
3151da177e4SLinus Torvalds 		run_workqueue(cwq);
3161da177e4SLinus Torvalds 	}
3173af24433SOleg Nesterov 
3181da177e4SLinus Torvalds 	return 0;
3191da177e4SLinus Torvalds }
3201da177e4SLinus Torvalds 
321fc2e4d70SOleg Nesterov struct wq_barrier {
322fc2e4d70SOleg Nesterov 	struct work_struct	work;
323fc2e4d70SOleg Nesterov 	struct completion	done;
324fc2e4d70SOleg Nesterov };
325fc2e4d70SOleg Nesterov 
326fc2e4d70SOleg Nesterov static void wq_barrier_func(struct work_struct *work)
327fc2e4d70SOleg Nesterov {
328fc2e4d70SOleg Nesterov 	struct wq_barrier *barr = container_of(work, struct wq_barrier, work);
329fc2e4d70SOleg Nesterov 	complete(&barr->done);
330fc2e4d70SOleg Nesterov }
331fc2e4d70SOleg Nesterov 
33283c22520SOleg Nesterov static void insert_wq_barrier(struct cpu_workqueue_struct *cwq,
33383c22520SOleg Nesterov 					struct wq_barrier *barr, int tail)
334fc2e4d70SOleg Nesterov {
335fc2e4d70SOleg Nesterov 	INIT_WORK(&barr->work, wq_barrier_func);
336fc2e4d70SOleg Nesterov 	__set_bit(WORK_STRUCT_PENDING, work_data_bits(&barr->work));
337fc2e4d70SOleg Nesterov 
338fc2e4d70SOleg Nesterov 	init_completion(&barr->done);
33983c22520SOleg Nesterov 
34083c22520SOleg Nesterov 	insert_work(cwq, &barr->work, tail);
341fc2e4d70SOleg Nesterov }
342fc2e4d70SOleg Nesterov 
3431da177e4SLinus Torvalds static void flush_cpu_workqueue(struct cpu_workqueue_struct *cwq)
3441da177e4SLinus Torvalds {
3451da177e4SLinus Torvalds 	if (cwq->thread == current) {
3461da177e4SLinus Torvalds 		/*
3471da177e4SLinus Torvalds 		 * Probably keventd trying to flush its own queue. So simply run
3481da177e4SLinus Torvalds 		 * it by hand rather than deadlocking.
3491da177e4SLinus Torvalds 		 */
3501da177e4SLinus Torvalds 		run_workqueue(cwq);
3511da177e4SLinus Torvalds 	} else {
352fc2e4d70SOleg Nesterov 		struct wq_barrier barr;
35383c22520SOleg Nesterov 		int active = 0;
3541da177e4SLinus Torvalds 
35583c22520SOleg Nesterov 		spin_lock_irq(&cwq->lock);
35683c22520SOleg Nesterov 		if (!list_empty(&cwq->worklist) || cwq->current_work != NULL) {
35783c22520SOleg Nesterov 			insert_wq_barrier(cwq, &barr, 1);
35883c22520SOleg Nesterov 			active = 1;
35983c22520SOleg Nesterov 		}
36083c22520SOleg Nesterov 		spin_unlock_irq(&cwq->lock);
3611da177e4SLinus Torvalds 
362d721304dSOleg Nesterov 		if (active)
363fc2e4d70SOleg Nesterov 			wait_for_completion(&barr.done);
3641da177e4SLinus Torvalds 	}
36583c22520SOleg Nesterov }
3661da177e4SLinus Torvalds 
3670fcb78c2SRolf Eike Beer /**
3681da177e4SLinus Torvalds  * flush_workqueue - ensure that any scheduled work has run to completion.
3690fcb78c2SRolf Eike Beer  * @wq: workqueue to flush
3701da177e4SLinus Torvalds  *
3711da177e4SLinus Torvalds  * Forces execution of the workqueue and blocks until its completion.
3721da177e4SLinus Torvalds  * This is typically used in driver shutdown handlers.
3731da177e4SLinus Torvalds  *
374fc2e4d70SOleg Nesterov  * We sleep until all works which were queued on entry have been handled,
375fc2e4d70SOleg Nesterov  * but we are not livelocked by new incoming ones.
3761da177e4SLinus Torvalds  *
3771da177e4SLinus Torvalds  * This function used to run the workqueues itself.  Now we just wait for the
3781da177e4SLinus Torvalds  * helper threads to do it.
3791da177e4SLinus Torvalds  */
3801da177e4SLinus Torvalds void fastcall flush_workqueue(struct workqueue_struct *wq)
3811da177e4SLinus Torvalds {
382b1f4ec17SOleg Nesterov 	const cpumask_t *cpu_map = wq_cpu_map(wq);
383cce1a165SOleg Nesterov 	int cpu;
384b1f4ec17SOleg Nesterov 
385f293ea92SOleg Nesterov 	might_sleep();
386b1f4ec17SOleg Nesterov 	for_each_cpu_mask(cpu, *cpu_map)
38789ada679SChristoph Lameter 		flush_cpu_workqueue(per_cpu_ptr(wq->cpu_wq, cpu));
3881da177e4SLinus Torvalds }
389ae90dd5dSDave Jones EXPORT_SYMBOL_GPL(flush_workqueue);
3901da177e4SLinus Torvalds 
3916e84d644SOleg Nesterov /*
3926e84d644SOleg Nesterov  * Upon a successful return, the caller "owns" WORK_STRUCT_PENDING bit,
3936e84d644SOleg Nesterov  * so this work can't be re-armed in any way.
3946e84d644SOleg Nesterov  */
3956e84d644SOleg Nesterov static int try_to_grab_pending(struct work_struct *work)
3966e84d644SOleg Nesterov {
3976e84d644SOleg Nesterov 	struct cpu_workqueue_struct *cwq;
3986e84d644SOleg Nesterov 	int ret = 0;
3996e84d644SOleg Nesterov 
4006e84d644SOleg Nesterov 	if (!test_and_set_bit(WORK_STRUCT_PENDING, work_data_bits(work)))
4016e84d644SOleg Nesterov 		return 1;
4026e84d644SOleg Nesterov 
4036e84d644SOleg Nesterov 	/*
4046e84d644SOleg Nesterov 	 * The queueing is in progress, or it is already queued. Try to
4056e84d644SOleg Nesterov 	 * steal it from ->worklist without clearing WORK_STRUCT_PENDING.
4066e84d644SOleg Nesterov 	 */
4076e84d644SOleg Nesterov 
4086e84d644SOleg Nesterov 	cwq = get_wq_data(work);
4096e84d644SOleg Nesterov 	if (!cwq)
4106e84d644SOleg Nesterov 		return ret;
4116e84d644SOleg Nesterov 
4126e84d644SOleg Nesterov 	spin_lock_irq(&cwq->lock);
4136e84d644SOleg Nesterov 	if (!list_empty(&work->entry)) {
4146e84d644SOleg Nesterov 		/*
4156e84d644SOleg Nesterov 		 * This work is queued, but perhaps we locked the wrong cwq.
4166e84d644SOleg Nesterov 		 * In that case we must see the new value after rmb(), see
4176e84d644SOleg Nesterov 		 * insert_work()->wmb().
4186e84d644SOleg Nesterov 		 */
4196e84d644SOleg Nesterov 		smp_rmb();
4206e84d644SOleg Nesterov 		if (cwq == get_wq_data(work)) {
4216e84d644SOleg Nesterov 			list_del_init(&work->entry);
4226e84d644SOleg Nesterov 			ret = 1;
4236e84d644SOleg Nesterov 		}
4246e84d644SOleg Nesterov 	}
4256e84d644SOleg Nesterov 	spin_unlock_irq(&cwq->lock);
4266e84d644SOleg Nesterov 
4276e84d644SOleg Nesterov 	return ret;
4286e84d644SOleg Nesterov }
4296e84d644SOleg Nesterov 
4306e84d644SOleg Nesterov static void wait_on_cpu_work(struct cpu_workqueue_struct *cwq,
431b89deed3SOleg Nesterov 				struct work_struct *work)
432b89deed3SOleg Nesterov {
433b89deed3SOleg Nesterov 	struct wq_barrier barr;
434b89deed3SOleg Nesterov 	int running = 0;
435b89deed3SOleg Nesterov 
436b89deed3SOleg Nesterov 	spin_lock_irq(&cwq->lock);
437b89deed3SOleg Nesterov 	if (unlikely(cwq->current_work == work)) {
43883c22520SOleg Nesterov 		insert_wq_barrier(cwq, &barr, 0);
439b89deed3SOleg Nesterov 		running = 1;
440b89deed3SOleg Nesterov 	}
441b89deed3SOleg Nesterov 	spin_unlock_irq(&cwq->lock);
442b89deed3SOleg Nesterov 
4433af24433SOleg Nesterov 	if (unlikely(running))
444b89deed3SOleg Nesterov 		wait_for_completion(&barr.done);
445b89deed3SOleg Nesterov }
446b89deed3SOleg Nesterov 
4476e84d644SOleg Nesterov static void wait_on_work(struct work_struct *work)
448b89deed3SOleg Nesterov {
449b89deed3SOleg Nesterov 	struct cpu_workqueue_struct *cwq;
45028e53bddSOleg Nesterov 	struct workqueue_struct *wq;
45128e53bddSOleg Nesterov 	const cpumask_t *cpu_map;
452b1f4ec17SOleg Nesterov 	int cpu;
453b89deed3SOleg Nesterov 
454f293ea92SOleg Nesterov 	might_sleep();
455f293ea92SOleg Nesterov 
456b89deed3SOleg Nesterov 	cwq = get_wq_data(work);
457b89deed3SOleg Nesterov 	if (!cwq)
4583af24433SOleg Nesterov 		return;
459b89deed3SOleg Nesterov 
46028e53bddSOleg Nesterov 	wq = cwq->wq;
46128e53bddSOleg Nesterov 	cpu_map = wq_cpu_map(wq);
46228e53bddSOleg Nesterov 
463b1f4ec17SOleg Nesterov 	for_each_cpu_mask(cpu, *cpu_map)
4646e84d644SOleg Nesterov 		wait_on_cpu_work(per_cpu_ptr(wq->cpu_wq, cpu), work);
4656e84d644SOleg Nesterov }
4666e84d644SOleg Nesterov 
4676e84d644SOleg Nesterov /**
4686e84d644SOleg Nesterov  * cancel_work_sync - block until a work_struct's callback has terminated
4696e84d644SOleg Nesterov  * @work: the work which is to be flushed
4706e84d644SOleg Nesterov  *
4716e84d644SOleg Nesterov  * cancel_work_sync() will cancel the work if it is queued. If the work's
4726e84d644SOleg Nesterov  * callback appears to be running, cancel_work_sync() will block until it
4736e84d644SOleg Nesterov  * has completed.
4746e84d644SOleg Nesterov  *
4756e84d644SOleg Nesterov  * It is possible to use this function if the work re-queues itself. It can
4766e84d644SOleg Nesterov  * cancel the work even if it migrates to another workqueue, however in that
4776e84d644SOleg Nesterov  * case it only guarantees that work->func() has completed on the last queued
4786e84d644SOleg Nesterov  * workqueue.
4796e84d644SOleg Nesterov  *
4806e84d644SOleg Nesterov  * cancel_work_sync(&delayed_work->work) should be used only if ->timer is not
4816e84d644SOleg Nesterov  * pending, otherwise it goes into a busy-wait loop until the timer expires.
4826e84d644SOleg Nesterov  *
4836e84d644SOleg Nesterov  * The caller must ensure that workqueue_struct on which this work was last
4846e84d644SOleg Nesterov  * queued can't be destroyed before this function returns.
4856e84d644SOleg Nesterov  */
4866e84d644SOleg Nesterov void cancel_work_sync(struct work_struct *work)
4876e84d644SOleg Nesterov {
4886e84d644SOleg Nesterov 	while (!try_to_grab_pending(work))
4896e84d644SOleg Nesterov 		cpu_relax();
4906e84d644SOleg Nesterov 	wait_on_work(work);
4916e84d644SOleg Nesterov 	work_clear_pending(work);
492b89deed3SOleg Nesterov }
49328e53bddSOleg Nesterov EXPORT_SYMBOL_GPL(cancel_work_sync);
494b89deed3SOleg Nesterov 
4956e84d644SOleg Nesterov /**
4966e84d644SOleg Nesterov  * cancel_rearming_delayed_work - reliably kill off a delayed work.
4976e84d644SOleg Nesterov  * @dwork: the delayed work struct
4986e84d644SOleg Nesterov  *
4996e84d644SOleg Nesterov  * It is possible to use this function if @dwork rearms itself via queue_work()
5006e84d644SOleg Nesterov  * or queue_delayed_work(). See also the comment for cancel_work_sync().
5016e84d644SOleg Nesterov  */
5026e84d644SOleg Nesterov void cancel_rearming_delayed_work(struct delayed_work *dwork)
5036e84d644SOleg Nesterov {
5046e84d644SOleg Nesterov 	while (!del_timer(&dwork->timer) &&
5056e84d644SOleg Nesterov 	       !try_to_grab_pending(&dwork->work))
5066e84d644SOleg Nesterov 		cpu_relax();
5076e84d644SOleg Nesterov 	wait_on_work(&dwork->work);
5086e84d644SOleg Nesterov 	work_clear_pending(&dwork->work);
5096e84d644SOleg Nesterov }
5106e84d644SOleg Nesterov EXPORT_SYMBOL(cancel_rearming_delayed_work);
5111da177e4SLinus Torvalds 
5126e84d644SOleg Nesterov static struct workqueue_struct *keventd_wq __read_mostly;
5131da177e4SLinus Torvalds 
5140fcb78c2SRolf Eike Beer /**
5150fcb78c2SRolf Eike Beer  * schedule_work - put work task in global workqueue
5160fcb78c2SRolf Eike Beer  * @work: job to be done
5170fcb78c2SRolf Eike Beer  *
5180fcb78c2SRolf Eike Beer  * This puts a job in the kernel-global workqueue.
5190fcb78c2SRolf Eike Beer  */
5201da177e4SLinus Torvalds int fastcall schedule_work(struct work_struct *work)
5211da177e4SLinus Torvalds {
5221da177e4SLinus Torvalds 	return queue_work(keventd_wq, work);
5231da177e4SLinus Torvalds }
524ae90dd5dSDave Jones EXPORT_SYMBOL(schedule_work);
5251da177e4SLinus Torvalds 
5260fcb78c2SRolf Eike Beer /**
5270fcb78c2SRolf Eike Beer  * schedule_delayed_work - put work task in global workqueue after delay
52852bad64dSDavid Howells  * @dwork: job to be done
52952bad64dSDavid Howells  * @delay: number of jiffies to wait or 0 for immediate execution
5300fcb78c2SRolf Eike Beer  *
5310fcb78c2SRolf Eike Beer  * After waiting for a given time this puts a job in the kernel-global
5320fcb78c2SRolf Eike Beer  * workqueue.
5330fcb78c2SRolf Eike Beer  */
53482f67cd9SIngo Molnar int fastcall schedule_delayed_work(struct delayed_work *dwork,
53582f67cd9SIngo Molnar 					unsigned long delay)
5361da177e4SLinus Torvalds {
53782f67cd9SIngo Molnar 	timer_stats_timer_set_start_info(&dwork->timer);
53852bad64dSDavid Howells 	return queue_delayed_work(keventd_wq, dwork, delay);
5391da177e4SLinus Torvalds }
540ae90dd5dSDave Jones EXPORT_SYMBOL(schedule_delayed_work);
5411da177e4SLinus Torvalds 
5420fcb78c2SRolf Eike Beer /**
5430fcb78c2SRolf Eike Beer  * schedule_delayed_work_on - queue work in global workqueue on CPU after delay
5440fcb78c2SRolf Eike Beer  * @cpu: cpu to use
54552bad64dSDavid Howells  * @dwork: job to be done
5460fcb78c2SRolf Eike Beer  * @delay: number of jiffies to wait
5470fcb78c2SRolf Eike Beer  *
5480fcb78c2SRolf Eike Beer  * After waiting for a given time this puts a job in the kernel-global
5490fcb78c2SRolf Eike Beer  * workqueue on the specified CPU.
5500fcb78c2SRolf Eike Beer  */
5511da177e4SLinus Torvalds int schedule_delayed_work_on(int cpu,
55252bad64dSDavid Howells 			struct delayed_work *dwork, unsigned long delay)
5531da177e4SLinus Torvalds {
55452bad64dSDavid Howells 	return queue_delayed_work_on(cpu, keventd_wq, dwork, delay);
5551da177e4SLinus Torvalds }
556ae90dd5dSDave Jones EXPORT_SYMBOL(schedule_delayed_work_on);
5571da177e4SLinus Torvalds 
558b6136773SAndrew Morton /**
559b6136773SAndrew Morton  * schedule_on_each_cpu - call a function on each online CPU from keventd
560b6136773SAndrew Morton  * @func: the function to call
561b6136773SAndrew Morton  *
562b6136773SAndrew Morton  * Returns zero on success.
563b6136773SAndrew Morton  * Returns -ve errno on failure.
564b6136773SAndrew Morton  *
565b6136773SAndrew Morton  * Appears to be racy against CPU hotplug.
566b6136773SAndrew Morton  *
567b6136773SAndrew Morton  * schedule_on_each_cpu() is very slow.
568b6136773SAndrew Morton  */
56965f27f38SDavid Howells int schedule_on_each_cpu(work_func_t func)
57015316ba8SChristoph Lameter {
57115316ba8SChristoph Lameter 	int cpu;
572b6136773SAndrew Morton 	struct work_struct *works;
57315316ba8SChristoph Lameter 
574b6136773SAndrew Morton 	works = alloc_percpu(struct work_struct);
575b6136773SAndrew Morton 	if (!works)
57615316ba8SChristoph Lameter 		return -ENOMEM;
577b6136773SAndrew Morton 
578e18f3ffbSAndrew Morton 	preempt_disable();		/* CPU hotplug */
57915316ba8SChristoph Lameter 	for_each_online_cpu(cpu) {
5809bfb1839SIngo Molnar 		struct work_struct *work = per_cpu_ptr(works, cpu);
5819bfb1839SIngo Molnar 
5829bfb1839SIngo Molnar 		INIT_WORK(work, func);
5839bfb1839SIngo Molnar 		set_bit(WORK_STRUCT_PENDING, work_data_bits(work));
5849bfb1839SIngo Molnar 		__queue_work(per_cpu_ptr(keventd_wq->cpu_wq, cpu), work);
58515316ba8SChristoph Lameter 	}
586e18f3ffbSAndrew Morton 	preempt_enable();
58715316ba8SChristoph Lameter 	flush_workqueue(keventd_wq);
588b6136773SAndrew Morton 	free_percpu(works);
58915316ba8SChristoph Lameter 	return 0;
59015316ba8SChristoph Lameter }
59115316ba8SChristoph Lameter 
5921da177e4SLinus Torvalds void flush_scheduled_work(void)
5931da177e4SLinus Torvalds {
5941da177e4SLinus Torvalds 	flush_workqueue(keventd_wq);
5951da177e4SLinus Torvalds }
596ae90dd5dSDave Jones EXPORT_SYMBOL(flush_scheduled_work);
5971da177e4SLinus Torvalds 
5981da177e4SLinus Torvalds /**
5991fa44ecaSJames Bottomley  * execute_in_process_context - reliably execute the routine with user context
6001fa44ecaSJames Bottomley  * @fn:		the function to execute
6011fa44ecaSJames Bottomley  * @ew:		guaranteed storage for the execute work structure (must
6021fa44ecaSJames Bottomley  *		be available when the work executes)
6031fa44ecaSJames Bottomley  *
6041fa44ecaSJames Bottomley  * Executes the function immediately if process context is available,
6051fa44ecaSJames Bottomley  * otherwise schedules the function for delayed execution.
6061fa44ecaSJames Bottomley  *
6071fa44ecaSJames Bottomley  * Returns:	0 - function was executed
6081fa44ecaSJames Bottomley  *		1 - function was scheduled for execution
6091fa44ecaSJames Bottomley  */
61065f27f38SDavid Howells int execute_in_process_context(work_func_t fn, struct execute_work *ew)
6111fa44ecaSJames Bottomley {
6121fa44ecaSJames Bottomley 	if (!in_interrupt()) {
61365f27f38SDavid Howells 		fn(&ew->work);
6141fa44ecaSJames Bottomley 		return 0;
6151fa44ecaSJames Bottomley 	}
6161fa44ecaSJames Bottomley 
61765f27f38SDavid Howells 	INIT_WORK(&ew->work, fn);
6181fa44ecaSJames Bottomley 	schedule_work(&ew->work);
6191fa44ecaSJames Bottomley 
6201fa44ecaSJames Bottomley 	return 1;
6211fa44ecaSJames Bottomley }
6221fa44ecaSJames Bottomley EXPORT_SYMBOL_GPL(execute_in_process_context);
6231fa44ecaSJames Bottomley 
6241da177e4SLinus Torvalds int keventd_up(void)
6251da177e4SLinus Torvalds {
6261da177e4SLinus Torvalds 	return keventd_wq != NULL;
6271da177e4SLinus Torvalds }
6281da177e4SLinus Torvalds 
6291da177e4SLinus Torvalds int current_is_keventd(void)
6301da177e4SLinus Torvalds {
6311da177e4SLinus Torvalds 	struct cpu_workqueue_struct *cwq;
6321da177e4SLinus Torvalds 	int cpu = smp_processor_id();	/* preempt-safe: keventd is per-cpu */
6331da177e4SLinus Torvalds 	int ret = 0;
6341da177e4SLinus Torvalds 
6351da177e4SLinus Torvalds 	BUG_ON(!keventd_wq);
6361da177e4SLinus Torvalds 
63789ada679SChristoph Lameter 	cwq = per_cpu_ptr(keventd_wq->cpu_wq, cpu);
6381da177e4SLinus Torvalds 	if (current == cwq->thread)
6391da177e4SLinus Torvalds 		ret = 1;
6401da177e4SLinus Torvalds 
6411da177e4SLinus Torvalds 	return ret;
6421da177e4SLinus Torvalds 
6431da177e4SLinus Torvalds }
6441da177e4SLinus Torvalds 
6453af24433SOleg Nesterov static struct cpu_workqueue_struct *
6463af24433SOleg Nesterov init_cpu_workqueue(struct workqueue_struct *wq, int cpu)
6471da177e4SLinus Torvalds {
64889ada679SChristoph Lameter 	struct cpu_workqueue_struct *cwq = per_cpu_ptr(wq->cpu_wq, cpu);
6493af24433SOleg Nesterov 
6503af24433SOleg Nesterov 	cwq->wq = wq;
6513af24433SOleg Nesterov 	spin_lock_init(&cwq->lock);
6523af24433SOleg Nesterov 	INIT_LIST_HEAD(&cwq->worklist);
6533af24433SOleg Nesterov 	init_waitqueue_head(&cwq->more_work);
6543af24433SOleg Nesterov 
6553af24433SOleg Nesterov 	return cwq;
6563af24433SOleg Nesterov }
6573af24433SOleg Nesterov 
6583af24433SOleg Nesterov static int create_workqueue_thread(struct cpu_workqueue_struct *cwq, int cpu)
6593af24433SOleg Nesterov {
6603af24433SOleg Nesterov 	struct workqueue_struct *wq = cwq->wq;
6613af24433SOleg Nesterov 	const char *fmt = is_single_threaded(wq) ? "%s" : "%s/%d";
6623af24433SOleg Nesterov 	struct task_struct *p;
6633af24433SOleg Nesterov 
6643af24433SOleg Nesterov 	p = kthread_create(worker_thread, cwq, fmt, wq->name, cpu);
6653af24433SOleg Nesterov 	/*
6663af24433SOleg Nesterov 	 * Nobody can add the work_struct to this cwq,
6673af24433SOleg Nesterov 	 *	if (caller is __create_workqueue)
6683af24433SOleg Nesterov 	 *		nobody should see this wq
6693af24433SOleg Nesterov 	 *	else // caller is CPU_UP_PREPARE
6703af24433SOleg Nesterov 	 *		cpu is not on cpu_online_map
6713af24433SOleg Nesterov 	 * so we can abort safely.
6723af24433SOleg Nesterov 	 */
6733af24433SOleg Nesterov 	if (IS_ERR(p))
6743af24433SOleg Nesterov 		return PTR_ERR(p);
6753af24433SOleg Nesterov 
6763af24433SOleg Nesterov 	cwq->thread = p;
6773af24433SOleg Nesterov 	cwq->should_stop = 0;
6783af24433SOleg Nesterov 
6793af24433SOleg Nesterov 	return 0;
6803af24433SOleg Nesterov }
6813af24433SOleg Nesterov 
68206ba38a9SOleg Nesterov static void start_workqueue_thread(struct cpu_workqueue_struct *cwq, int cpu)
68306ba38a9SOleg Nesterov {
68406ba38a9SOleg Nesterov 	struct task_struct *p = cwq->thread;
68506ba38a9SOleg Nesterov 
68606ba38a9SOleg Nesterov 	if (p != NULL) {
68706ba38a9SOleg Nesterov 		if (cpu >= 0)
68806ba38a9SOleg Nesterov 			kthread_bind(p, cpu);
68906ba38a9SOleg Nesterov 		wake_up_process(p);
69006ba38a9SOleg Nesterov 	}
69106ba38a9SOleg Nesterov }
69206ba38a9SOleg Nesterov 
6933af24433SOleg Nesterov struct workqueue_struct *__create_workqueue(const char *name,
6943af24433SOleg Nesterov 					    int singlethread, int freezeable)
6953af24433SOleg Nesterov {
6963af24433SOleg Nesterov 	struct workqueue_struct *wq;
6973af24433SOleg Nesterov 	struct cpu_workqueue_struct *cwq;
6983af24433SOleg Nesterov 	int err = 0, cpu;
6993af24433SOleg Nesterov 
7003af24433SOleg Nesterov 	wq = kzalloc(sizeof(*wq), GFP_KERNEL);
7013af24433SOleg Nesterov 	if (!wq)
7023af24433SOleg Nesterov 		return NULL;
7033af24433SOleg Nesterov 
7043af24433SOleg Nesterov 	wq->cpu_wq = alloc_percpu(struct cpu_workqueue_struct);
7053af24433SOleg Nesterov 	if (!wq->cpu_wq) {
7063af24433SOleg Nesterov 		kfree(wq);
7073af24433SOleg Nesterov 		return NULL;
7083af24433SOleg Nesterov 	}
7093af24433SOleg Nesterov 
7103af24433SOleg Nesterov 	wq->name = name;
711cce1a165SOleg Nesterov 	wq->singlethread = singlethread;
7123af24433SOleg Nesterov 	wq->freezeable = freezeable;
713cce1a165SOleg Nesterov 	INIT_LIST_HEAD(&wq->list);
7143af24433SOleg Nesterov 
7153af24433SOleg Nesterov 	if (singlethread) {
7163af24433SOleg Nesterov 		cwq = init_cpu_workqueue(wq, singlethread_cpu);
7173af24433SOleg Nesterov 		err = create_workqueue_thread(cwq, singlethread_cpu);
71806ba38a9SOleg Nesterov 		start_workqueue_thread(cwq, -1);
7193af24433SOleg Nesterov 	} else {
7203af24433SOleg Nesterov 		mutex_lock(&workqueue_mutex);
7213af24433SOleg Nesterov 		list_add(&wq->list, &workqueues);
7223af24433SOleg Nesterov 
7233af24433SOleg Nesterov 		for_each_possible_cpu(cpu) {
7243af24433SOleg Nesterov 			cwq = init_cpu_workqueue(wq, cpu);
7253af24433SOleg Nesterov 			if (err || !cpu_online(cpu))
7263af24433SOleg Nesterov 				continue;
7273af24433SOleg Nesterov 			err = create_workqueue_thread(cwq, cpu);
72806ba38a9SOleg Nesterov 			start_workqueue_thread(cwq, cpu);
7293af24433SOleg Nesterov 		}
7303af24433SOleg Nesterov 		mutex_unlock(&workqueue_mutex);
7313af24433SOleg Nesterov 	}
7323af24433SOleg Nesterov 
7333af24433SOleg Nesterov 	if (err) {
7343af24433SOleg Nesterov 		destroy_workqueue(wq);
7353af24433SOleg Nesterov 		wq = NULL;
7363af24433SOleg Nesterov 	}
7373af24433SOleg Nesterov 	return wq;
7383af24433SOleg Nesterov }
7393af24433SOleg Nesterov EXPORT_SYMBOL_GPL(__create_workqueue);
7403af24433SOleg Nesterov 
7413af24433SOleg Nesterov static void cleanup_workqueue_thread(struct cpu_workqueue_struct *cwq, int cpu)
7423af24433SOleg Nesterov {
7433af24433SOleg Nesterov 	struct wq_barrier barr;
7443af24433SOleg Nesterov 	int alive = 0;
7451da177e4SLinus Torvalds 
7461da177e4SLinus Torvalds 	spin_lock_irq(&cwq->lock);
7473af24433SOleg Nesterov 	if (cwq->thread != NULL) {
7483af24433SOleg Nesterov 		insert_wq_barrier(cwq, &barr, 1);
7493af24433SOleg Nesterov 		cwq->should_stop = 1;
7503af24433SOleg Nesterov 		alive = 1;
7511da177e4SLinus Torvalds 	}
7521da177e4SLinus Torvalds 	spin_unlock_irq(&cwq->lock);
7533af24433SOleg Nesterov 
7543af24433SOleg Nesterov 	if (alive) {
7553af24433SOleg Nesterov 		wait_for_completion(&barr.done);
7563af24433SOleg Nesterov 
7573af24433SOleg Nesterov 		while (unlikely(cwq->thread != NULL))
7583af24433SOleg Nesterov 			cpu_relax();
7593af24433SOleg Nesterov 		/*
7603af24433SOleg Nesterov 		 * Wait until cwq->thread unlocks cwq->lock,
7613af24433SOleg Nesterov 		 * it won't touch *cwq after that.
7623af24433SOleg Nesterov 		 */
7633af24433SOleg Nesterov 		smp_rmb();
7643af24433SOleg Nesterov 		spin_unlock_wait(&cwq->lock);
7653af24433SOleg Nesterov 	}
7661da177e4SLinus Torvalds }
7671da177e4SLinus Torvalds 
7683af24433SOleg Nesterov /**
7693af24433SOleg Nesterov  * destroy_workqueue - safely terminate a workqueue
7703af24433SOleg Nesterov  * @wq: target workqueue
7713af24433SOleg Nesterov  *
7723af24433SOleg Nesterov  * Safely destroy a workqueue. All work currently pending will be done first.
7733af24433SOleg Nesterov  */
7743af24433SOleg Nesterov void destroy_workqueue(struct workqueue_struct *wq)
7753af24433SOleg Nesterov {
776b1f4ec17SOleg Nesterov 	const cpumask_t *cpu_map = wq_cpu_map(wq);
7773af24433SOleg Nesterov 	struct cpu_workqueue_struct *cwq;
7783af24433SOleg Nesterov 	int cpu;
7793af24433SOleg Nesterov 
7803af24433SOleg Nesterov 	mutex_lock(&workqueue_mutex);
7813af24433SOleg Nesterov 	list_del(&wq->list);
7823af24433SOleg Nesterov 	mutex_unlock(&workqueue_mutex);
7833af24433SOleg Nesterov 
784b1f4ec17SOleg Nesterov 	for_each_cpu_mask(cpu, *cpu_map) {
7853af24433SOleg Nesterov 		cwq = per_cpu_ptr(wq->cpu_wq, cpu);
7863af24433SOleg Nesterov 		cleanup_workqueue_thread(cwq, cpu);
7873af24433SOleg Nesterov 	}
7883af24433SOleg Nesterov 
7893af24433SOleg Nesterov 	free_percpu(wq->cpu_wq);
7903af24433SOleg Nesterov 	kfree(wq);
7913af24433SOleg Nesterov }
7923af24433SOleg Nesterov EXPORT_SYMBOL_GPL(destroy_workqueue);
7933af24433SOleg Nesterov 
7949c7b216dSChandra Seetharaman static int __devinit workqueue_cpu_callback(struct notifier_block *nfb,
7951da177e4SLinus Torvalds 						unsigned long action,
7961da177e4SLinus Torvalds 						void *hcpu)
7971da177e4SLinus Torvalds {
7983af24433SOleg Nesterov 	unsigned int cpu = (unsigned long)hcpu;
7993af24433SOleg Nesterov 	struct cpu_workqueue_struct *cwq;
8001da177e4SLinus Torvalds 	struct workqueue_struct *wq;
8011da177e4SLinus Torvalds 
802*8bb78442SRafael J. Wysocki 	action &= ~CPU_TASKS_FROZEN;
803*8bb78442SRafael J. Wysocki 
8041da177e4SLinus Torvalds 	switch (action) {
8053af24433SOleg Nesterov 	case CPU_LOCK_ACQUIRE:
8069b41ea72SAndrew Morton 		mutex_lock(&workqueue_mutex);
8073af24433SOleg Nesterov 		return NOTIFY_OK;
8083af24433SOleg Nesterov 
8093af24433SOleg Nesterov 	case CPU_LOCK_RELEASE:
8103af24433SOleg Nesterov 		mutex_unlock(&workqueue_mutex);
8113af24433SOleg Nesterov 		return NOTIFY_OK;
8123af24433SOleg Nesterov 
8133af24433SOleg Nesterov 	case CPU_UP_PREPARE:
8143af24433SOleg Nesterov 		cpu_set(cpu, cpu_populated_map);
8153af24433SOleg Nesterov 	}
8163af24433SOleg Nesterov 
8171da177e4SLinus Torvalds 	list_for_each_entry(wq, &workqueues, list) {
8183af24433SOleg Nesterov 		cwq = per_cpu_ptr(wq->cpu_wq, cpu);
8193af24433SOleg Nesterov 
8203af24433SOleg Nesterov 		switch (action) {
8213af24433SOleg Nesterov 		case CPU_UP_PREPARE:
8223af24433SOleg Nesterov 			if (!create_workqueue_thread(cwq, cpu))
8231da177e4SLinus Torvalds 				break;
8243af24433SOleg Nesterov 			printk(KERN_ERR "workqueue for %i failed\n", cpu);
8253af24433SOleg Nesterov 			return NOTIFY_BAD;
8261da177e4SLinus Torvalds 
8271da177e4SLinus Torvalds 		case CPU_ONLINE:
82806ba38a9SOleg Nesterov 			start_workqueue_thread(cwq, cpu);
8291da177e4SLinus Torvalds 			break;
8301da177e4SLinus Torvalds 
8311da177e4SLinus Torvalds 		case CPU_UP_CANCELED:
83206ba38a9SOleg Nesterov 			start_workqueue_thread(cwq, -1);
8331da177e4SLinus Torvalds 		case CPU_DEAD:
8343af24433SOleg Nesterov 			cleanup_workqueue_thread(cwq, cpu);
8351da177e4SLinus Torvalds 			break;
8361da177e4SLinus Torvalds 		}
8373af24433SOleg Nesterov 	}
8381da177e4SLinus Torvalds 
8391da177e4SLinus Torvalds 	return NOTIFY_OK;
8401da177e4SLinus Torvalds }
8411da177e4SLinus Torvalds 
842c12920d1SOleg Nesterov void __init init_workqueues(void)
8431da177e4SLinus Torvalds {
8443af24433SOleg Nesterov 	cpu_populated_map = cpu_online_map;
845f756d5e2SNathan Lynch 	singlethread_cpu = first_cpu(cpu_possible_map);
846b1f4ec17SOleg Nesterov 	cpu_singlethread_map = cpumask_of_cpu(singlethread_cpu);
8471da177e4SLinus Torvalds 	hotcpu_notifier(workqueue_cpu_callback, 0);
8481da177e4SLinus Torvalds 	keventd_wq = create_workqueue("events");
8491da177e4SLinus Torvalds 	BUG_ON(!keventd_wq);
8501da177e4SLinus Torvalds }
851