History

workqueue: implement several utility APIs

Implement the following utility APIs. workqueue_set_max_active() : adjust max_active of a wq workqueue_congested() : test whether a wq is contested work_cpu() : determine the last / current cpu of a work work_busy() : query whether a work is busy * Anton Blanchard fixed missing ret initialization in work_busy().

Tejun Heo committed 16 years ago

Commit dcd989c1 parent d320c032 files · +117 −2Browse files

Unified · Split

2 files
  1. include/linux/workqueue.h +10 −1
  2. kernel/workqueue.c +107 −1
include/linux/workqueue.h+10−1
@@ -61,6 +61,10 @@ enum { · 60 unmodified lines
6161 WORK_STRUCT_FLAG_MASK = (1UL << WORK_STRUCT_FLAG_BITS) - 1,
6262 WORK_STRUCT_WQ_DATA_MASK = ~WORK_STRUCT_FLAG_MASK,
6363 WORK_STRUCT_NO_CPU = NR_CPUS << WORK_STRUCT_FLAG_BITS,
64+
65+ /* bit mask for work_busy() return values */
66+ WORK_BUSY_PENDING = 1 << 0,
67+ WORK_BUSY_RUNNING = 1 << 1,
6468 };
6569
6670 struct work_struct {
@@ -307,9 +311,14 @@ extern void init_workqueues(void); · 240 unmodified lines
307311 int execute_in_process_context(work_func_t fn, struct execute_work *);
308312
309313 extern int flush_work(struct work_struct *work);
310−
311314 extern int cancel_work_sync(struct work_struct *work);
312315
316+extern void workqueue_set_max_active(struct workqueue_struct *wq,
317+ int max_active);
318+extern bool workqueue_congested(unsigned int cpu, struct workqueue_struct *wq);
319+extern unsigned int work_cpu(struct work_struct *work);
320+extern unsigned int work_busy(struct work_struct *work);
321+
313322 /*
314323 * Kill off a pending schedule_delayed_work(). Note that the work callback
315324 * function may still be running on return from cancel_delayed_work(), unless
kernel/workqueue.c+107−1
@@ -203,7 +203,7 @@ struct workqueue_struct { · 202 unmodified lines
203203 cpumask_var_t mayday_mask; /* cpus requesting rescue */
204204 struct worker *rescuer; /* I: rescue worker */
205205
206− int saved_max_active; /* I: saved cwq max_active */
206+ int saved_max_active; /* W: saved cwq max_active */
207207 const char *name; /* I: workqueue name */
208208 #ifdef CONFIG_LOCKDEP
209209 struct lockdep_map lockdep_map;
@@ -2675,6 +2675,112 @@ void destroy_workqueue(struct workqueue_struct *wq) · 2465 unmodified lines
26752675 }
26762676 EXPORT_SYMBOL_GPL(destroy_workqueue);
26772677
2678+/**
2679+ * workqueue_set_max_active - adjust max_active of a workqueue
2680+ * @wq: target workqueue
2681+ * @max_active: new max_active value.
2682+ *
2683+ * Set max_active of @wq to @max_active.
2684+ *
2685+ * CONTEXT:
2686+ * Don't call from IRQ context.
2687+ */
2688+void workqueue_set_max_active(struct workqueue_struct *wq, int max_active)
2689+{
2690+ unsigned int cpu;
2691+
2692+ max_active = wq_clamp_max_active(max_active, wq->name);
2693+
2694+ spin_lock(&workqueue_lock);
2695+
2696+ wq->saved_max_active = max_active;
2697+
2698+ for_each_possible_cpu(cpu) {
2699+ struct global_cwq *gcwq = get_gcwq(cpu);
2700+
2701+ spin_lock_irq(&gcwq->lock);
2702+
2703+ if (!(wq->flags & WQ_FREEZEABLE) ||
2704+ !(gcwq->flags & GCWQ_FREEZING))
2705+ get_cwq(gcwq->cpu, wq)->max_active = max_active;
2706+
2707+ spin_unlock_irq(&gcwq->lock);
2708+ }
2709+
2710+ spin_unlock(&workqueue_lock);
2711+}
2712+EXPORT_SYMBOL_GPL(workqueue_set_max_active);
2713+
2714+/**
2715+ * workqueue_congested - test whether a workqueue is congested
2716+ * @cpu: CPU in question
2717+ * @wq: target workqueue
2718+ *
2719+ * Test whether @wq's cpu workqueue for @cpu is congested. There is
2720+ * no synchronization around this function and the test result is
2721+ * unreliable and only useful as advisory hints or for debugging.
2722+ *
2723+ * RETURNS:
2724+ * %true if congested, %false otherwise.
2725+ */
2726+bool workqueue_congested(unsigned int cpu, struct workqueue_struct *wq)
2727+{
2728+ struct cpu_workqueue_struct *cwq = get_cwq(cpu, wq);
2729+
2730+ return !list_empty(&cwq->delayed_works);
2731+}
2732+EXPORT_SYMBOL_GPL(workqueue_congested);
2733+
2734+/**
2735+ * work_cpu - return the last known associated cpu for @work
2736+ * @work: the work of interest
2737+ *
2738+ * RETURNS:
2739+ * CPU number if @work was ever queued. NR_CPUS otherwise.
2740+ */
2741+unsigned int work_cpu(struct work_struct *work)
2742+{
2743+ struct global_cwq *gcwq = get_work_gcwq(work);
2744+
2745+ return gcwq ? gcwq->cpu : NR_CPUS;
2746+}
2747+EXPORT_SYMBOL_GPL(work_cpu);
2748+
2749+/**
2750+ * work_busy - test whether a work is currently pending or running
2751+ * @work: the work to be tested
2752+ *
2753+ * Test whether @work is currently pending or running. There is no
2754+ * synchronization around this function and the test result is
2755+ * unreliable and only useful as advisory hints or for debugging.
2756+ * Especially for reentrant wqs, the pending state might hide the
2757+ * running state.
2758+ *
2759+ * RETURNS:
2760+ * OR'd bitmask of WORK_BUSY_* bits.
2761+ */
2762+unsigned int work_busy(struct work_struct *work)
2763+{
2764+ struct global_cwq *gcwq = get_work_gcwq(work);
2765+ unsigned long flags;
2766+ unsigned int ret = 0;
2767+
2768+ if (!gcwq)
2769+ return false;
2770+
2771+ spin_lock_irqsave(&gcwq->lock, flags);
2772+
2773+ if (work_pending(work))
2774+ ret |= WORK_BUSY_PENDING;
2775+ if (find_worker_executing_work(gcwq, work))
2776+ ret |= WORK_BUSY_RUNNING;
2777+
2778+ spin_unlock_irqrestore(&gcwq->lock, flags);
2779+
2780+ return ret;
2781+}
2782+EXPORT_SYMBOL_GPL(work_busy);
2783+
26782784 /*
26792785 * CPU hotplug.
26802786 *

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t