[linux.git] / kernel / workqueue_internal.h

/*
 * kernel/workqueue_internal.h
 *
 * Workqueue internal header file.  Only to be included by workqueue and
 * core kernel subsystems.
 */
#ifndef _KERNEL_WORKQUEUE_INTERNAL_H
#define _KERNEL_WORKQUEUE_INTERNAL_H

#include <linux/workqueue.h>
#include <linux/kthread.h>

struct worker_pool;

/*
 * The poor guys doing the actual heavy lifting.  All on-duty workers are
 * either serving the manager role, on idle list or on busy hash.  For
 * details on the locking annotation (L, I, X...), refer to workqueue.c.
 *
 * Only to be used in workqueue and async.
 */
struct worker {
	/* on idle list while idle, on busy hash table while busy */
	union {
		struct list_head	entry;	/* L: while idle */
		struct hlist_node	hentry;	/* L: while busy */
	};

	struct work_struct	*current_work;	/* L: work being processed */
	work_func_t		current_func;	/* L: current_work's fn */
	struct pool_workqueue	*current_pwq; /* L: current_work's pwq */
	bool			desc_valid;	/* ->desc is valid */
	struct list_head	scheduled;	/* L: scheduled works */

	/* 64 bytes boundary on 64bit, 32 on 32bit */

	struct task_struct	*task;		/* I: worker task */
	struct worker_pool	*pool;		/* I: the associated pool */
						/* L: for rescuers */
	struct list_head	node;		/* A: anchored at pool->workers */
						/* A: runs through worker->node */

	unsigned long		last_active;	/* L: last active timestamp */
	unsigned int		flags;		/* X: flags */
	int			id;		/* I: worker id */

	/*
	 * Opaque string set with work_set_desc().  Printed out with task
	 * dump for debugging - WARN, BUG, panic or sysrq.
	 */
	char			desc[WORKER_DESC_LEN];

	/* used only by rescuers to point to the target workqueue */
	struct workqueue_struct	*rescue_wq;	/* I: the workqueue to rescue */
};

/**
 * current_wq_worker - return struct worker if %current is a workqueue worker
 */
static inline struct worker *current_wq_worker(void)
{
	if (current->flags & PF_WQ_WORKER)
		return kthread_data(current);
	return NULL;
}

/*
 * Scheduler hooks for concurrency managed workqueue.  Only to be used from
 * sched/core.c and workqueue.c.
 */
void wq_worker_waking_up(struct task_struct *task, int cpu);
struct task_struct *wq_worker_sleeping(struct task_struct *task);

#endif /* _KERNEL_WORKQUEUE_INTERNAL_H */
Commit	Line	Data
ea138446 TH	1	/*
	2	* kernel/workqueue_internal.h
	3	*
	4	* Workqueue internal header file. Only to be included by workqueue and
	5	* core kernel subsystems.
	6	*/
	7	#ifndef _KERNEL_WORKQUEUE_INTERNAL_H
	8	#define _KERNEL_WORKQUEUE_INTERNAL_H
	9
2eaebdb3	10	#include <linux/workqueue.h>
84b233ad	11	#include <linux/kthread.h>
2eaebdb3	12
2eaebdb3 TH	13	struct worker_pool;
	14
	15	/*
	16	* The poor guys doing the actual heavy lifting. All on-duty workers are
	17	* either serving the manager role, on idle list or on busy hash. For
	18	* details on the locking annotation (L, I, X...), refer to workqueue.c.
	19	*
	20	* Only to be used in workqueue and async.
	21	*/
	22	struct worker {
	23	/* on idle list while idle, on busy hash table while busy */
	24	union {
	25	struct list_head entry; /* L: while idle */
	26	struct hlist_node hentry; /* L: while busy */
	27	};
	28
	29	struct work_struct current_work; / L: work being processed */
	30	work_func_t current_func; /* L: current_work's fn */
112202d9	31	struct pool_workqueue current_pwq; / L: current_work's pwq */
3d1cb205	32	bool desc_valid; /* ->desc is valid */
2eaebdb3	33	struct list_head scheduled; /* L: scheduled works */
3d1cb205 TH	34
	35	/* 64 bytes boundary on 64bit, 32 on 32bit */
	36
2eaebdb3 TH	37	struct task_struct task; / I: worker task */
2eaebdb3 TH	38	struct worker_pool pool; / I: the associated pool */
b3104104	39	/* L: for rescuers */
92f9c5c4 LJ	40	struct list_head node; /* A: anchored at pool->workers */
92f9c5c4 LJ	41	/* A: runs through worker->node */
3d1cb205	42
2eaebdb3 TH	43	unsigned long last_active; /* L: last active timestamp */
	44	unsigned int flags; /* X: flags */
	45	int id; /* I: worker id */
	46
3d1cb205 TH	47	/*
	48	* Opaque string set with work_set_desc(). Printed out with task
	49	* dump for debugging - WARN, BUG, panic or sysrq.
	50	*/
	51	char desc[WORKER_DESC_LEN];
	52
2eaebdb3 TH	53	/* used only by rescuers to point to the target workqueue */
	54	struct workqueue_struct rescue_wq; / I: the workqueue to rescue */
	55	};
	56
84b233ad TH	57	/**
	58	* current_wq_worker - return struct worker if %current is a workqueue worker
	59	*/
	60	static inline struct worker *current_wq_worker(void)
	61	{
	62	if (current->flags & PF_WQ_WORKER)
	63	return kthread_data(current);
	64	return NULL;
	65	}
	66
ea138446 TH	67	/*
ea138446 TH	68	* Scheduler hooks for concurrency managed workqueue. Only to be used from
0a0fca9d	69	* sched/core.c and workqueue.c.
ea138446	70	*/
d84ff051	71	void wq_worker_waking_up(struct task_struct *task, int cpu);
9b7f6597	72	struct task_struct wq_worker_sleeping(struct task_struct task);
ea138446 TH	73
ea138446 TH	74	#endif /* _KERNEL_WORKQUEUE_INTERNAL_H */