workqueue.h 4.9 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10
/*
 * workqueue.h --- work queue handling for Linux.
 */

#ifndef _LINUX_WORKQUEUE_H
#define _LINUX_WORKQUEUE_H

#include <linux/timer.h>
#include <linux/linkage.h>
#include <linux/bitops.h>
11
#include <asm/atomic.h>
L
Linus Torvalds 已提交
12 13 14

struct workqueue_struct;

15 16
struct work_struct;
typedef void (*work_func_t)(struct work_struct *work);
17

18 19 20 21 22 23
/*
 * The first word is the work queue pointer and the flags rolled into
 * one
 */
#define work_data_bits(work) ((unsigned long *)(&(work)->data))

L
Linus Torvalds 已提交
24
struct work_struct {
25
	atomic_long_t data;
26 27 28
#define WORK_STRUCT_PENDING 0		/* T if work item pending execution */
#define WORK_STRUCT_FLAG_MASK (3UL)
#define WORK_STRUCT_WQ_DATA_MASK (~WORK_STRUCT_FLAG_MASK)
L
Linus Torvalds 已提交
29
	struct list_head entry;
30
	work_func_t func;
31 32
};

O
Oleg Nesterov 已提交
33
#define WORK_DATA_INIT()	ATOMIC_LONG_INIT(0)
34

35 36
struct delayed_work {
	struct work_struct work;
L
Linus Torvalds 已提交
37 38 39
	struct timer_list timer;
};

40 41 42 43
struct execute_work {
	struct work_struct work;
};

44
#define __WORK_INITIALIZER(n, f) {				\
O
Oleg Nesterov 已提交
45 46
	.data = WORK_DATA_INIT(),				\
	.entry	= { &(n).entry, &(n).entry },			\
47 48 49 50 51 52 53 54 55 56 57 58 59 60
	.func = (f),						\
	}

#define __DELAYED_WORK_INITIALIZER(n, f) {			\
	.work = __WORK_INITIALIZER((n).work, (f)),		\
	.timer = TIMER_INITIALIZER(NULL, 0, 0),			\
	}

#define DECLARE_WORK(n, f)					\
	struct work_struct n = __WORK_INITIALIZER(n, f)

#define DECLARE_DELAYED_WORK(n, f)				\
	struct delayed_work n = __DELAYED_WORK_INITIALIZER(n, f)

L
Linus Torvalds 已提交
61
/*
62
 * initialize a work item's function pointer
L
Linus Torvalds 已提交
63
 */
64
#define PREPARE_WORK(_work, _func)				\
L
Linus Torvalds 已提交
65
	do {							\
66
		(_work)->func = (_func);			\
L
Linus Torvalds 已提交
67 68
	} while (0)

69 70
#define PREPARE_DELAYED_WORK(_work, _func)			\
	PREPARE_WORK(&(_work)->work, (_func))
71

L
Linus Torvalds 已提交
72
/*
73
 * initialize all of a work item in one go
74 75 76 77
 *
 * NOTE! No point in using "atomic_long_set()": useing a direct
 * assignment of the work data initializer allows the compiler
 * to generate better code.
L
Linus Torvalds 已提交
78
 */
O
Oleg Nesterov 已提交
79
#define INIT_WORK(_work, _func)						\
80
	do {								\
O
Oleg Nesterov 已提交
81
		(_work)->data = (atomic_long_t) WORK_DATA_INIT();	\
82 83 84 85 86 87 88 89
		INIT_LIST_HEAD(&(_work)->entry);			\
		PREPARE_WORK((_work), (_func));				\
	} while (0)

#define INIT_DELAYED_WORK(_work, _func)				\
	do {							\
		INIT_WORK(&(_work)->work, (_func));		\
		init_timer(&(_work)->timer);			\
90 91
	} while (0)

92 93 94 95 96 97
#define INIT_DELAYED_WORK_DEFERRABLE(_work, _func)			\
	do {							\
		INIT_WORK(&(_work)->work, (_func));		\
		init_timer_deferrable(&(_work)->timer);		\
	} while (0)

98 99 100 101 102
/**
 * work_pending - Find out whether a work item is currently pending
 * @work: The work item in question
 */
#define work_pending(work) \
103
	test_bit(WORK_STRUCT_PENDING, work_data_bits(work))
104 105 106 107 108 109

/**
 * delayed_work_pending - Find out whether a delayable work item is currently
 * pending
 * @work: The work item in question
 */
110 111
#define delayed_work_pending(w) \
	work_pending(&(w)->work)
112

113
/**
O
Oleg Nesterov 已提交
114 115
 * work_clear_pending - for internal use only, mark a work item as not pending
 * @work: The work item in question
116
 */
O
Oleg Nesterov 已提交
117
#define work_clear_pending(work) \
118
	clear_bit(WORK_STRUCT_PENDING, work_data_bits(work))
119

120

L
Linus Torvalds 已提交
121
extern struct workqueue_struct *__create_workqueue(const char *name,
122 123 124
						    int singlethread,
						    int freezeable);
#define create_workqueue(name) __create_workqueue((name), 0, 0)
125
#define create_freezeable_workqueue(name) __create_workqueue((name), 1, 1)
126
#define create_singlethread_workqueue(name) __create_workqueue((name), 1, 0)
L
Linus Torvalds 已提交
127 128 129 130

extern void destroy_workqueue(struct workqueue_struct *wq);

extern int FASTCALL(queue_work(struct workqueue_struct *wq, struct work_struct *work));
131 132
extern int FASTCALL(queue_delayed_work(struct workqueue_struct *wq,
			struct delayed_work *work, unsigned long delay));
133
extern int queue_delayed_work_on(int cpu, struct workqueue_struct *wq,
134 135
			struct delayed_work *work, unsigned long delay);

L
Linus Torvalds 已提交
136
extern void FASTCALL(flush_workqueue(struct workqueue_struct *wq));
137
extern void flush_scheduled_work(void);
L
Linus Torvalds 已提交
138 139

extern int FASTCALL(schedule_work(struct work_struct *work));
140 141 142 143
extern int FASTCALL(schedule_delayed_work(struct delayed_work *work,
					unsigned long delay));
extern int schedule_delayed_work_on(int cpu, struct delayed_work *work,
					unsigned long delay);
144
extern int schedule_on_each_cpu(work_func_t func);
L
Linus Torvalds 已提交
145 146 147 148
extern int current_is_keventd(void);
extern int keventd_up(void);

extern void init_workqueues(void);
149
int execute_in_process_context(work_func_t fn, struct execute_work *);
L
Linus Torvalds 已提交
150

151 152
extern void cancel_work_sync(struct work_struct *work);

L
Linus Torvalds 已提交
153 154
/*
 * Kill off a pending schedule_delayed_work().  Note that the work callback
155 156
 * function may still be running on return from cancel_delayed_work(), unless
 * it returns 1 and the work doesn't re-arm itself. Run flush_workqueue() or
157
 * cancel_work_sync() to wait on it.
L
Linus Torvalds 已提交
158
 */
159
static inline int cancel_delayed_work(struct delayed_work *work)
L
Linus Torvalds 已提交
160 161 162
{
	int ret;

163
	ret = del_timer(&work->timer);
L
Linus Torvalds 已提交
164
	if (ret)
O
Oleg Nesterov 已提交
165
		work_clear_pending(&work->work);
L
Linus Torvalds 已提交
166 167 168
	return ret;
}

169 170 171 172 173 174 175 176 177 178
extern void cancel_rearming_delayed_work(struct delayed_work *work);

/* Obsolete. use cancel_rearming_delayed_work() */
static inline
void cancel_rearming_delayed_workqueue(struct workqueue_struct *wq,
					struct delayed_work *work)
{
	cancel_rearming_delayed_work(work);
}

L
Linus Torvalds 已提交
179
#endif