workqueue_internal.h 2.4 KB

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