kernel/workqueue_internal.h

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