Lines Matching full:work
18 * This is the generic async execution mechanism. Work items as are
21 * normal work items and the other for high priority ones) and some extra
209 PWQ_STAT_STARTED, /* work items started execution */
210 PWQ_STAT_COMPLETED, /* work items completed execution */
216 PWQ_STAT_RESCUED, /* linked work items executed by rescuer */
239 * When pwq->nr_active >= max_active, new work item is queued to
243 * All work items marked with WORK_STRUCT_INACTIVE do not participate
244 * in pwq->nr_active and all work items in pwq->inactive_works are
246 * work items are in pwq->inactive_works. Some of them are ready to
247 * run in pool->worklist or worker->scheduled. Those work itmes are
249 * not participate in pwq->nr_active. For non-barrier work item, it
282 * The externally visible workqueue. It relays the issued work items to
290 int work_color; /* WQ: current work color */
354 * Per-cpu work items which run for longer than the following threshold are
356 * management to prevent them from noticeably delaying other per-cpu work items.
381 /* PL&A: allowable cpus for unbound wqs and work items */
387 /* CPU where unbound work was last round robin scheduled from this CPU */
391 * Local execution of unbound work items is no longer guaranteed. The
392 * following always forces round-robin CPU selection on unbound work items
521 struct work_struct *work = addr; in work_is_static_object() local
523 return test_bit(WORK_STRUCT_STATIC_BIT, work_data_bits(work)); in work_is_static_object()
532 struct work_struct *work = addr; in work_fixup_init() local
536 cancel_work_sync(work); in work_fixup_init()
537 debug_object_init(work, &work_debug_descr); in work_fixup_init()
550 struct work_struct *work = addr; in work_fixup_free() local
554 cancel_work_sync(work); in work_fixup_free()
555 debug_object_free(work, &work_debug_descr); in work_fixup_free()
570 static inline void debug_work_activate(struct work_struct *work) in debug_work_activate() argument
572 debug_object_activate(work, &work_debug_descr); in debug_work_activate()
575 static inline void debug_work_deactivate(struct work_struct *work) in debug_work_deactivate() argument
577 debug_object_deactivate(work, &work_debug_descr); in debug_work_deactivate()
580 void __init_work(struct work_struct *work, int onstack) in __init_work() argument
583 debug_object_init_on_stack(work, &work_debug_descr); in __init_work()
585 debug_object_init(work, &work_debug_descr); in __init_work()
589 void destroy_work_on_stack(struct work_struct *work) in destroy_work_on_stack() argument
591 debug_object_free(work, &work_debug_descr); in destroy_work_on_stack()
595 void destroy_delayed_work_on_stack(struct delayed_work *work) in destroy_delayed_work_on_stack() argument
597 destroy_timer_on_stack(&work->timer); in destroy_delayed_work_on_stack()
598 debug_object_free(&work->work, &work_debug_descr); in destroy_delayed_work_on_stack()
603 static inline void debug_work_activate(struct work_struct *work) { } in debug_work_activate() argument
604 static inline void debug_work_deactivate(struct work_struct *work) { } in debug_work_deactivate() argument
646 * While queued, %WORK_STRUCT_PWQ is set and non flag bits of a work's data
652 * work->data. These functions should only be called while the work is
656 * corresponding to a work. Pool is available once the work has been
658 * available only while the work item is queued.
660 * %WORK_OFFQ_CANCELING is used to mark a work item which is being
661 * canceled. While being canceled, a work item may have its PENDING set
665 static inline void set_work_data(struct work_struct *work, unsigned long data, in set_work_data() argument
668 WARN_ON_ONCE(!work_pending(work)); in set_work_data()
669 atomic_long_set(&work->data, data | flags | work_static(work)); in set_work_data()
672 static void set_work_pwq(struct work_struct *work, struct pool_workqueue *pwq, in set_work_pwq() argument
675 set_work_data(work, (unsigned long)pwq, in set_work_pwq()
679 static void set_work_pool_and_keep_pending(struct work_struct *work, in set_work_pool_and_keep_pending() argument
682 set_work_data(work, (unsigned long)pool_id << WORK_OFFQ_POOL_SHIFT, in set_work_pool_and_keep_pending()
686 static void set_work_pool_and_clear_pending(struct work_struct *work, in set_work_pool_and_clear_pending() argument
691 * test_and_set_bit(PENDING) and ensures all updates to @work made in set_work_pool_and_clear_pending()
696 set_work_data(work, (unsigned long)pool_id << WORK_OFFQ_POOL_SHIFT, 0); in set_work_pool_and_clear_pending()
700 * work->current_func, which is executed afterwards. This possible in set_work_pool_and_clear_pending()
702 * the same @work. E.g. consider this case: in set_work_pool_and_clear_pending()
713 * 7 work->current_func() { in set_work_pool_and_clear_pending()
720 * a @work is not queued in a hope, that CPU#1 will eventually in set_work_pool_and_clear_pending()
721 * finish the queued @work. Meanwhile CPU#1 does not see in set_work_pool_and_clear_pending()
728 static void clear_work_data(struct work_struct *work) in clear_work_data() argument
731 set_work_data(work, WORK_STRUCT_NO_POOL, 0); in clear_work_data()
739 static struct pool_workqueue *get_work_pwq(struct work_struct *work) in get_work_pwq() argument
741 unsigned long data = atomic_long_read(&work->data); in get_work_pwq()
750 * get_work_pool - return the worker_pool a given work was associated with
751 * @work: the work item of interest
762 * Return: The worker_pool @work was last associated with. %NULL if none.
764 static struct worker_pool *get_work_pool(struct work_struct *work) in get_work_pool() argument
766 unsigned long data = atomic_long_read(&work->data); in get_work_pool()
782 * get_work_pool_id - return the worker pool ID a given work is associated with
783 * @work: the work item of interest
785 * Return: The worker_pool ID @work was last associated with.
788 static int get_work_pool_id(struct work_struct *work) in get_work_pool_id() argument
790 unsigned long data = atomic_long_read(&work->data); in get_work_pool_id()
798 static void mark_work_canceling(struct work_struct *work) in mark_work_canceling() argument
800 unsigned long pool_id = get_work_pool_id(work); in mark_work_canceling()
803 set_work_data(work, pool_id | WORK_OFFQ_CANCELING, WORK_STRUCT_PENDING); in mark_work_canceling()
806 static bool work_is_canceling(struct work_struct *work) in work_is_canceling() argument
808 unsigned long data = atomic_long_read(&work->data); in work_is_canceling()
972 * find_worker_executing_work - find worker which is executing a work
974 * @work: work to find worker for
976 * Find a worker which is executing @work on @pool by searching
977 * @pool->busy_hash which is keyed by the address of @work. For a worker
978 * to match, its current execution should match the address of @work and
979 * its work function. This is to avoid unwanted dependency between
980 * unrelated work executions through a work item being recycled while still
983 * This is a bit tricky. A work item may be freed once its execution
985 * another work item. If the same work item address ends up being reused
987 * recycled work item as currently executing and make it wait until the
990 * This function checks the work item address and work function to avoid
992 * work function which can introduce dependency onto itself through a
993 * recycled work item. Well, if somebody wants to shoot oneself in the
995 * actually occurs, it should be easy to locate the culprit work function.
1001 * Pointer to worker which is executing @work if found, %NULL
1005 struct work_struct *work) in find_worker_executing_work() argument
1010 (unsigned long)work) in find_worker_executing_work()
1011 if (worker->current_work == work && in find_worker_executing_work()
1012 worker->current_func == work->func) in find_worker_executing_work()
1020 * @work: start of series of works to be scheduled
1021 * @head: target list to append @work to
1024 * Schedule linked works starting from @work to @head. Work series to be
1025 * scheduled starts at @work and includes any consecutive work with
1032 static void move_linked_works(struct work_struct *work, struct list_head *head, in move_linked_works() argument
1041 list_for_each_entry_safe_from(work, n, NULL, entry) { in move_linked_works()
1042 list_move_tail(&work->entry, head); in move_linked_works()
1043 if (!(*work_data_bits(work) & WORK_STRUCT_LINKED)) in move_linked_works()
1057 * assign_work - assign a work item and its linked work items to a worker
1058 * @work: work to assign
1062 * Assign @work and its linked work items to @worker. If @work is already being
1065 * If @nextp is not NULL, it's updated to point to the next work of the last
1066 * scheduled work. This allows assign_work() to be nested inside
1069 * Returns %true if @work was successfully assigned to @worker. %false if @work
1072 static bool assign_work(struct work_struct *work, struct worker *worker, in assign_work() argument
1081 * A single work shouldn't be executed concurrently by multiple workers. in assign_work()
1082 * __queue_work() ensures that @work doesn't jump to a different pool in assign_work()
1084 * @work is not executed concurrently by multiple workers from the same in assign_work()
1085 * pool. Check whether anyone is already processing the work. If so, in assign_work()
1086 * defer the work to the currently executing one. in assign_work()
1088 collision = find_worker_executing_work(pool, work); in assign_work()
1090 move_linked_works(work, &collision->scheduled, nextp); in assign_work()
1094 move_linked_works(work, &worker->scheduled, nextp); in assign_work()
1102 * @pool may have pending work items. Wake up worker if necessary. Returns
1119 * Idle @worker is about to execute @work and waking up provides an in kick_pool()
1136 struct work_struct *work = list_first_entry(&pool->worklist, in kick_pool() local
1139 get_work_pwq(work)->stats[PWQ_STAT_REPATRIATED]++; in kick_pool()
1149 * Concurrency-managed per-cpu work items that hog CPU for longer than
1151 * which prevents them from stalling other concurrency-managed work items. If a
1152 * work function keeps triggering this mechanism, it's likely that the work item
1155 * wq_cpu_intensive_report() tracks work functions which trigger such conditions
1157 * workqueues as appropriate. To avoid flooding the console, each violating work
1263 * CPU intensive auto-detection cares about how long a work item hogged in wq_worker_running()
1341 * CPU_INTENSIVE to avoid stalling other concurrency-managed work items. in wq_worker_tick()
1368 * wq_worker_last_func - retrieve worker's last work function
1369 * @task: Task to retrieve last work function of.
1388 * The last work function %current executed as a worker, NULL if it
1389 * hasn't executed any work yet.
1450 static void pwq_activate_inactive_work(struct work_struct *work) in pwq_activate_inactive_work() argument
1452 struct pool_workqueue *pwq = get_work_pwq(work); in pwq_activate_inactive_work()
1454 trace_workqueue_activate_work(work); in pwq_activate_inactive_work()
1457 move_linked_works(work, &pwq->pool->worklist, NULL); in pwq_activate_inactive_work()
1458 __clear_bit(WORK_STRUCT_INACTIVE_BIT, work_data_bits(work)); in pwq_activate_inactive_work()
1464 struct work_struct *work = list_first_entry(&pwq->inactive_works, in pwq_activate_first_inactive() local
1467 pwq_activate_inactive_work(work); in pwq_activate_first_inactive()
1473 * @work_data: work_data of work which left the queue
1475 * A work either has completed or is removed from pending queue,
1518 * try_to_grab_pending - steal work item from worklist and disable irq
1519 * @work: work item to steal
1520 * @is_dwork: @work is a delayed_work
1523 * Try to grab PENDING bit of @work. This function can handle @work in any
1529 * 1 if @work was pending and we successfully stole PENDING
1530 * 0 if @work was idle and we claimed PENDING
1532 * -ENOENT if someone else is canceling @work, this state may persist
1537 * On >= 0 return, the caller owns @work's PENDING bit. To avoid getting
1538 * interrupted while holding PENDING and @work off queue, irq must be
1547 static int try_to_grab_pending(struct work_struct *work, bool is_dwork, in try_to_grab_pending() argument
1557 struct delayed_work *dwork = to_delayed_work(work); in try_to_grab_pending()
1569 if (!test_and_set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work))) in try_to_grab_pending()
1577 pool = get_work_pool(work); in try_to_grab_pending()
1583 * work->data is guaranteed to point to pwq only while the work in try_to_grab_pending()
1584 * item is queued on pwq->wq, and both updating work->data to point in try_to_grab_pending()
1586 * pwq->pool->lock. This in turn guarantees that, if work->data in try_to_grab_pending()
1587 * points to pwq which is associated with a locked pool, the work in try_to_grab_pending()
1590 pwq = get_work_pwq(work); in try_to_grab_pending()
1592 debug_work_deactivate(work); in try_to_grab_pending()
1595 * A cancelable inactive work item must be in the in try_to_grab_pending()
1599 * An inactive work item cannot be grabbed directly because in try_to_grab_pending()
1600 * it might have linked barrier work items which, if left in try_to_grab_pending()
1602 * management later on and cause stall. Make sure the work in try_to_grab_pending()
1605 if (*work_data_bits(work) & WORK_STRUCT_INACTIVE) in try_to_grab_pending()
1606 pwq_activate_inactive_work(work); in try_to_grab_pending()
1608 list_del_init(&work->entry); in try_to_grab_pending()
1609 pwq_dec_nr_in_flight(pwq, *work_data_bits(work)); in try_to_grab_pending()
1611 /* work->data points to pwq iff queued, point to pool */ in try_to_grab_pending()
1612 set_work_pool_and_keep_pending(work, pool->id); in try_to_grab_pending()
1622 if (work_is_canceling(work)) in try_to_grab_pending()
1629 * insert_work - insert a work into a pool
1630 * @pwq: pwq @work belongs to
1631 * @work: work to insert
1635 * Insert @work which belongs to @pwq after @head. @extra_flags is or'd to
1641 static void insert_work(struct pool_workqueue *pwq, struct work_struct *work, in insert_work() argument
1644 debug_work_activate(work); in insert_work()
1646 /* record the work call stack in order to print it in KASAN reports */ in insert_work()
1647 kasan_record_aux_stack_noalloc(work); in insert_work()
1649 /* we own @work, set data and link */ in insert_work()
1650 set_work_pwq(work, pwq, extra_flags); in insert_work()
1651 list_add_tail(&work->entry, head); in insert_work()
1656 * Test whether @work is being queued from another work executing on the
1665 * Return %true iff I'm a worker executing a work item on @wq. If in is_chained_work()
1672 * When queueing an unbound work item to a wq, prefer local CPU if allowed
1703 struct work_struct *work) in __queue_work() argument
1711 * While a work item is PENDING && off queue, a task trying to in __queue_work()
1722 * queues a new work item to a wq after destroy_workqueue(wq). in __queue_work()
1729 /* pwq which will be used unless @work is executing elsewhere */ in __queue_work()
1741 * If @work was previously on a different pool, it might still be in __queue_work()
1742 * running there, in which case the work needs to be queued on that in __queue_work()
1745 last_pool = get_work_pool(work); in __queue_work()
1751 worker = find_worker_executing_work(last_pool, work); in __queue_work()
1770 * another pwq replacing it in cpu_pwq or while work items are executing in __queue_work()
1785 trace_workqueue_queue_work(req_cpu, pwq, work); in __queue_work()
1787 if (WARN_ON(!list_empty(&work->entry))) in __queue_work()
1797 trace_workqueue_activate_work(work); in __queue_work()
1799 insert_work(pwq, work, &pool->worklist, work_flags); in __queue_work()
1803 insert_work(pwq, work, &pwq->inactive_works, work_flags); in __queue_work()
1812 * queue_work_on - queue work on specific cpu
1813 * @cpu: CPU number to execute work on
1815 * @work: work to queue
1817 * We queue the work to a specific CPU, the caller must ensure it
1823 * Return: %false if @work was already on a queue, %true otherwise.
1826 struct work_struct *work) in queue_work_on() argument
1833 if (!test_and_set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work))) { in queue_work_on()
1834 __queue_work(cpu, wq, work); in queue_work_on()
1850 * available CPU if we need to schedule this work.
1873 * queue_work_node - queue work on a "random" cpu for a given NUMA node
1874 * @node: NUMA node that we are targeting the work for
1876 * @work: work to queue
1878 * We queue the work to a "random" CPU within a given NUMA node. The basic
1879 * idea here is to provide a way to somehow associate work with a given
1890 * Return: %false if @work was already on a queue, %true otherwise.
1893 struct work_struct *work) in queue_work_node() argument
1911 if (!test_and_set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work))) { in queue_work_node()
1914 __queue_work(cpu, wq, work); in queue_work_node()
1928 __queue_work(dwork->cpu, dwork->wq, &dwork->work); in delayed_work_timer_fn()
1936 struct work_struct *work = &dwork->work; in __queue_delayed_work() local
1941 WARN_ON_ONCE(!list_empty(&work->entry)); in __queue_delayed_work()
1944 * If @delay is 0, queue @dwork->work immediately. This is for in __queue_delayed_work()
1950 __queue_work(cpu, wq, &dwork->work); in __queue_delayed_work()
1965 * queue_delayed_work_on - queue work on specific CPU after delay
1966 * @cpu: CPU number to execute work on
1968 * @dwork: work to queue
1971 * Return: %false if @work was already on a queue, %true otherwise. If
1978 struct work_struct *work = &dwork->work; in queue_delayed_work_on() local
1985 if (!test_and_set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work))) { in queue_delayed_work_on()
1996 * mod_delayed_work_on - modify delay of or queue a delayed work on specific CPU
1997 * @cpu: CPU number to execute work on
1999 * @dwork: work to queue
2004 * zero, @work is guaranteed to be scheduled immediately regardless of its
2020 ret = try_to_grab_pending(&dwork->work, true, &flags); in mod_delayed_work_on()
2039 __queue_work(WORK_CPU_UNBOUND, rwork->wq, &rwork->work); in rcu_work_rcufn()
2044 * queue_rcu_work - queue work after a RCU grace period
2046 * @rwork: work to queue
2055 struct work_struct *work = &rwork->work; in queue_rcu_work() local
2057 if (!test_and_set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work))) { in queue_rcu_work()
2341 * @work: the pool's work for handling these idle workers
2348 * context, hence the split between timer callback and work item.
2350 static void idle_cull_fn(struct work_struct *work) in idle_cull_fn() argument
2352 struct worker_pool *pool = container_of(work, struct worker_pool, idle_cull_work); in idle_cull_fn()
2384 static void send_mayday(struct work_struct *work) in send_mayday() argument
2386 struct pool_workqueue *pwq = get_work_pwq(work); in send_mayday()
2411 struct work_struct *work; in pool_mayday_timeout() local
2423 list_for_each_entry(work, &pool->worklist, entry) in pool_mayday_timeout()
2424 send_mayday(work); in pool_mayday_timeout()
2523 * process_one_work - process single work
2525 * @work: work to process
2527 * Process @work. This function contains all the logics necessary to
2528 * process a single work including synchronization against and
2531 * call this function to process a work.
2536 static void process_one_work(struct worker *worker, struct work_struct *work) in process_one_work() argument
2540 struct pool_workqueue *pwq = get_work_pwq(work); in process_one_work()
2549 * work->lockdep_map, make a copy and use that here. in process_one_work()
2553 lockdep_copy_map(&lockdep_map, &work->lockdep_map); in process_one_work()
2560 debug_work_deactivate(work); in process_one_work()
2561 hash_add(pool->busy_hash, &worker->hentry, (unsigned long)work); in process_one_work()
2562 worker->current_work = work; in process_one_work()
2563 worker->current_func = work->func; in process_one_work()
2566 work_data = *work_data_bits(work); in process_one_work()
2575 list_del_init(&work->entry); in process_one_work()
2581 * execution of the pending work items. in process_one_work()
2589 * chain execution of the pending work items for WORKER_NOT_RUNNING in process_one_work()
2596 * update to @work. Also, do this inside @pool->lock so that in process_one_work()
2600 set_work_pool_and_clear_pending(work, pool->id); in process_one_work()
2620 * read-recursive acquire on the work(queue) 'locks', but this will then in process_one_work()
2629 trace_workqueue_execute_start(work); in process_one_work()
2630 worker->current_func(work); in process_one_work()
2632 * While we must be careful to not use "work" after this, the trace in process_one_work()
2635 trace_workqueue_execute_end(work, worker->current_func); in process_one_work()
2651 * kernels, where a requeueing work item waiting for something to in process_one_work()
2652 * happen could deadlock with stop_machine as such work item could in process_one_work()
2663 * CPU intensive by wq_worker_tick() if @work hogged CPU longer than in process_one_work()
2685 * may change while processing a work, so this function repeatedly
2686 * fetches a work from the top and executes it.
2694 struct work_struct *work; in process_scheduled_works() local
2697 while ((work = list_first_entry_or_null(&worker->scheduled, in process_scheduled_works()
2703 process_one_work(worker, work); in process_scheduled_works()
2723 * work items regardless of their specific target workqueue. The only
2724 * exception is work items which belong to workqueues with a rescuer which
2764 * preparing to process a work or actually processing it. in worker_thread()
2779 struct work_struct *work = in worker_thread() local
2783 if (assign_work(work, worker, NULL)) in worker_thread()
2790 * pool->lock is held and there's no work to process and no need to in worker_thread()
2810 * Regular work processing on a pool may block trying to create a new
2842 * shouldn't have any work pending, but @wq->maydays may still have in rescuer_thread()
2844 * all the work items before the rescuer got to them. Go through in rescuer_thread()
2857 struct work_struct *work, *n; in rescuer_thread() local
2873 list_for_each_entry_safe(work, n, &pool->worklist, entry) { in rescuer_thread()
2874 if (get_work_pwq(work) == pwq && in rescuer_thread()
2875 assign_work(work, rescuer, &n)) in rescuer_thread()
2883 * The above execution of rescued work items could in rescuer_thread()
2887 * that such back-to-back work items, which may be in rescuer_thread()
2941 * @target_work: work item being flushed (NULL for workqueue flushes)
2971 struct work_struct work; member
2976 static void wq_barrier_func(struct work_struct *work) in wq_barrier_func() argument
2978 struct wq_barrier *barr = container_of(work, struct wq_barrier, work); in wq_barrier_func()
2983 * insert_wq_barrier - insert a barrier work
2986 * @target: target work to attach @barr to
2995 * try_to_grab_pending() can't determine whether the work to be
2997 * flag of the previous work while there must be a valid next work
2998 * after a work with LINKED flag set.
3020 INIT_WORK_ONSTACK(&barr->work, wq_barrier_func); in insert_wq_barrier()
3021 __set_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(&barr->work)); in insert_wq_barrier()
3027 /* The barrier work item does not participate in pwq->nr_active. */ in insert_wq_barrier()
3050 insert_work(pwq, &barr->work, head, work_flags); in insert_wq_barrier()
3057 * @work_color: new work color, < 0 for no-op
3125 * __flush_workqueue - ensure that any scheduled work has run to completion.
3128 * This function sleeps until all work items which were queued on entry
3288 * work items on @wq can queue further work items on it. @wq is flushed
3337 static bool start_flush_work(struct work_struct *work, struct wq_barrier *barr, in start_flush_work() argument
3347 pool = get_work_pool(work); in start_flush_work()
3355 pwq = get_work_pwq(work); in start_flush_work()
3360 worker = find_worker_executing_work(pool, work); in start_flush_work()
3366 check_flush_dependency(pwq->wq, work); in start_flush_work()
3368 insert_wq_barrier(pwq, barr, work, worker); in start_flush_work()
3375 * For single threaded workqueues the deadlock happens when the work in start_flush_work()
3376 * is after the work issuing the flush_work(). For rescuer equipped in start_flush_work()
3393 static bool __flush_work(struct work_struct *work, bool from_cancel) in __flush_work() argument
3400 if (WARN_ON(!work->func)) in __flush_work()
3403 lock_map_acquire(&work->lockdep_map); in __flush_work()
3404 lock_map_release(&work->lockdep_map); in __flush_work()
3406 if (start_flush_work(work, &barr, from_cancel)) { in __flush_work()
3408 destroy_work_on_stack(&barr.work); in __flush_work()
3416 * flush_work - wait for a work to finish executing the last queueing instance
3417 * @work: the work to flush
3419 * Wait until @work has finished execution. @work is guaranteed to be idle
3423 * %true if flush_work() waited for the work to finish execution,
3426 bool flush_work(struct work_struct *work) in flush_work() argument
3428 return __flush_work(work, false); in flush_work()
3434 struct work_struct *work; member
3441 if (cwait->work != key) in cwt_wakefn()
3446 static bool __cancel_work_timer(struct work_struct *work, bool is_dwork) in __cancel_work_timer() argument
3453 ret = try_to_grab_pending(work, is_dwork, &flags); in __cancel_work_timer()
3456 * finish. flush_work() doesn't work for PREEMPT_NONE in __cancel_work_timer()
3457 * because we may get scheduled between @work's completion in __cancel_work_timer()
3460 * as @work is no longer busy, try_to_grab_pending() will in __cancel_work_timer()
3461 * return -ENOENT as @work is still being canceled and the in __cancel_work_timer()
3467 * wake function which matches @work along with exclusive in __cancel_work_timer()
3475 cwait.work = work; in __cancel_work_timer()
3479 if (work_is_canceling(work)) in __cancel_work_timer()
3485 /* tell other tasks trying to grab @work to back off */ in __cancel_work_timer()
3486 mark_work_canceling(work); in __cancel_work_timer()
3490 * This allows canceling during early boot. We know that @work in __cancel_work_timer()
3494 __flush_work(work, true); in __cancel_work_timer()
3496 clear_work_data(work); in __cancel_work_timer()
3505 __wake_up(&cancel_waitq, TASK_NORMAL, 1, work); in __cancel_work_timer()
3511 * cancel_work_sync - cancel a work and wait for it to finish
3512 * @work: the work to cancel
3514 * Cancel @work and wait for its execution to finish. This function
3515 * can be used even if the work re-queues itself or migrates to
3516 * another workqueue. On return from this function, @work is
3519 * cancel_work_sync(&delayed_work->work) must not be used for
3522 * The caller must ensure that the workqueue on which @work was last
3526 * %true if @work was pending, %false otherwise.
3528 bool cancel_work_sync(struct work_struct *work) in cancel_work_sync() argument
3530 return __cancel_work_timer(work, false); in cancel_work_sync()
3536 * @dwork: the delayed work to flush
3538 * Delayed timer is cancelled and the pending work is queued for
3543 * %true if flush_work() waited for the work to finish execution,
3550 __queue_work(dwork->cpu, dwork->wq, &dwork->work); in flush_delayed_work()
3552 return flush_work(&dwork->work); in flush_delayed_work()
3558 * @rwork: the rcu work to flush
3561 * %true if flush_rcu_work() waited for the work to finish execution,
3566 if (test_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(&rwork->work))) { in flush_rcu_work()
3568 flush_work(&rwork->work); in flush_rcu_work()
3571 return flush_work(&rwork->work); in flush_rcu_work()
3576 static bool __cancel_work(struct work_struct *work, bool is_dwork) in __cancel_work() argument
3582 ret = try_to_grab_pending(work, is_dwork, &flags); in __cancel_work()
3588 set_work_pool_and_clear_pending(work, get_work_pool_id(work)); in __cancel_work()
3596 bool cancel_work(struct work_struct *work) in cancel_work() argument
3598 return __cancel_work(work, false); in cancel_work()
3603 * cancel_delayed_work - cancel a delayed work
3612 * The work callback function may still be running on return, unless
3613 * it returns %true and the work doesn't re-arm itself. Explicitly flush or
3620 return __cancel_work(&dwork->work, true); in cancel_delayed_work()
3625 * cancel_delayed_work_sync - cancel a delayed work and wait for it to finish
3626 * @dwork: the delayed work cancel
3635 return __cancel_work_timer(&dwork->work, true); in cancel_delayed_work_sync()
3662 struct work_struct *work = per_cpu_ptr(works, cpu); in schedule_on_each_cpu() local
3664 INIT_WORK(work, func); in schedule_on_each_cpu()
3665 schedule_work_on(cpu, work); in schedule_on_each_cpu()
3679 * @ew: guaranteed storage for the execute work structure (must
3680 * be available when the work executes)
3691 fn(&ew->work); in execute_in_process_context()
3695 INIT_WORK(&ew->work, fn); in execute_in_process_context()
3696 schedule_work(&ew->work); in execute_in_process_context()
3987 * which implies no work queued to the pool, which implies no worker can in put_unbound_pool()
4105 static void pwq_release_workfn(struct kthread_work *work) in pwq_release_workfn() argument
4107 struct pool_workqueue *pwq = container_of(work, struct pool_workqueue, in pwq_release_workfn()
4147 * workqueue's saved_max_active and activate inactive work items
4462 * work items are affine to the pod it was issued on. Older pwqs are released as
4463 * in-flight work items finish. Note that a work item which repeatedly requeues
4503 * executing the work items for the workqueue will lose their CPU affinity and
4506 * responsibility to flush the work item from CPU_DOWN_PREPARE.
4784 * Safely destroy a workqueue. All work currently pending will be done first.
4901 * current_work - retrieve %current task's work struct
4906 * Return: work struct if %current task is a workqueue worker, %NULL otherwise.
4920 * work functions to determine whether it's being run off the rescuer task.
4972 * work_busy - test whether a work is currently pending or running
4973 * @work: the work to be tested
4975 * Test whether @work is currently pending or running. There is no
4982 unsigned int work_busy(struct work_struct *work) in work_busy() argument
4988 if (work_pending(work)) in work_busy()
4992 pool = get_work_pool(work); in work_busy()
4995 if (find_worker_executing_work(pool, work)) in work_busy()
5006 * set_worker_desc - set description for the current work item
5010 * This function can be called by a running work function to describe what
5011 * the work item is about. If the worker task gets dumped, this
5033 * If @task is a worker and currently executing a work item, print out the
5035 * set_worker_desc() by the currently executing work item.
5112 static void pr_cont_work(bool comma, struct work_struct *work, struct pr_cont_work_struct *pcwsp) in pr_cont_work() argument
5114 if (work->func == wq_barrier_func) { in pr_cont_work()
5117 barr = container_of(work, struct wq_barrier, work); in pr_cont_work()
5125 pr_cont_work_flush(comma, work->func, pcwsp); in pr_cont_work()
5133 struct work_struct *work; in show_pwq() local
5163 list_for_each_entry(work, &worker->scheduled, entry) in show_pwq()
5164 pr_cont_work(false, work, &pcws); in show_pwq()
5171 list_for_each_entry(work, &pool->worklist, entry) { in show_pwq()
5172 if (get_work_pwq(work) == pwq) { in show_pwq()
5181 list_for_each_entry(work, &pool->worklist, entry) { in show_pwq()
5182 if (get_work_pwq(work) != pwq) in show_pwq()
5185 pr_cont_work(comma, work, &pcws); in show_pwq()
5186 comma = !(*work_data_bits(work) & WORK_STRUCT_LINKED); in show_pwq()
5196 list_for_each_entry(work, &pwq->inactive_works, entry) { in show_pwq()
5197 pr_cont_work(comma, work, &pcws); in show_pwq()
5198 comma = !(*work_data_bits(work) & WORK_STRUCT_LINKED); in show_pwq()
5231 * drivers that queue work while holding locks in show_one_workqueue()
5264 /* How long the first pending work is waiting for a worker. */ in show_one_worker_pool()
5270 * queue work while holding locks also taken in their write in show_one_worker_pool()
5390 * are a lot of assumptions on strong associations among work, pwq and
5436 * unbound chain execution of currently pending work items. in unbind_workers()
5611 struct work_struct work; member
5617 static void work_for_cpu_fn(struct work_struct *work) in work_for_cpu_fn() argument
5619 struct work_for_cpu *wfc = container_of(work, struct work_for_cpu, work); in work_for_cpu_fn()
5639 INIT_WORK_ONSTACK(&wfc.work, work_for_cpu_fn); in work_on_cpu()
5640 schedule_work_on(cpu, &wfc.work); in work_on_cpu()
5641 flush_work(&wfc.work); in work_on_cpu()
5642 destroy_work_on_stack(&wfc.work); in work_on_cpu()
5921 * max_active RW int : maximum number of in-flight work items
6308 * flush dependency, a concurrency managed work item which stays RUNNING
6330 * Show workers that might prevent the processing of pending work items.
6332 * Pending work items should be handled by another idle worker
6347 * drivers that queue work while holding locks in show_cpu_pool_hog()
6520 * boot code to create workqueues and queue/cancel work items. Actual work item
6658 * been created and work items queued on them, but there are no kworkers
6659 * executing the work items yet. Populate the worker pools with the initial