set_worker_desc(9)
β¨ set_worker_desc(9) β a Kernel API Manual moment β¨
okay so bestie, welcome to set_worker_desc, straight out of the Kernel API Manual (yes, the (9) is the section, we love a numbered era). This is the little function that lets your work item introduce itself. main character energy for kernel workers, fr fr π«Ά
πΈ NAME πΈ
set_worker_desc β set description for the current work item π
β SYNOPSIS β
void set_worker_desc (const char *fmt , ... );
like, that's it. that's the whole vibe check. β¨
π ARGUMENTS π
fmtβ aprintf-style format string, iykyk π§...β the arguments for the format string, obviously. the little squad that fills in the blanks π
π¦ DESCRIPTION π¦
okay so here's the tea: a running work function can call this to describe what the work item is actually about. like giving your task a little name tag at the party π
and the payoff? if the worker task gets dumped, this info gets printed out together with it to help debugging. so when things go sideways, your description is right there in the receipts, being iconic and useful π₯
the description can be at mostWORKER_DESC_LENincluding the trailing' 'β so don't get cocky with your string length, bestie. it will not fit and that's on periodt π
π SEE ALSO π
grab a snack, because this list is lowkey enormous and we are NOT skipping a single one. every last reference, coming at you in order π
Kernel file ./kernel/workqueue.c, plus:
for_each_pool(9)for_each_pool_worker(9)for_each_pwq(9)worker_pool_assign_id(9)unbound_effective_cpumask(9)get_work_pool(9)worker_set_flags(9)worker_clr_flags(9)worker_enter_idle(9)worker_leave_idle(9)find_worker_executing_work(9)move_linked_works(9)assign_work(9)kick_pool_pick(9)kick_pool(9)wq_worker_running(9)wq_worker_sleeping(9)wq_worker_tick(9)wq_worker_last_func(9)wq_node_nr_active(9)wq_update_node_max_active(9)get_pwq(9)put_pwq(9)put_pwq_unlocked(9)pwq_tryinc_nr_active(9)pwq_activate_first_inactive(9)unplug_oldest_pwq(9)node_activate_pending_pwq(9)pwq_dec_nr_active(9)pwq_dec_nr_in_flight(9)try_to_grab_pending(9)work_grab_pending(9)insert_work(9)queue_work_on(9)select_numa_node_cpu(9)queue_work_node(9)queue_delayed_work_on(9)mod_delayed_work_on(9)queue_rcu_work(9)worker_attach_to_pool(9)worker_detach_from_pool(9)create_worker(9)set_worker_dying(9)idle_worker_timeout(9)idle_cull_fn(9)maybe_create_worker(9)manage_workers(9)process_one_work(9)process_scheduled_works(9)worker_thread(9)rescuer_thread(9)check_flush_dependency(9)insert_wq_barrier(9)flush_workqueue_prep_pwqs(9)__flush_workqueue(9)drain_workqueue(9)flush_work(9)flush_delayed_work(9)flush_rcu_work(9)cancel_work_sync(9)cancel_delayed_work(9)cancel_delayed_work_sync(9)disable_work(9)disable_work_sync(9)enable_work(9)disable_delayed_work(9)disable_delayed_work_sync(9)enable_delayed_work(9)schedule_on_each_cpu(9)execute_in_process_context(9)free_workqueue_attrs(9)alloc_workqueue_attrs(9)init_worker_pool(9)put_unbound_pool(9)get_unbound_pool(9)wq_calc_pod_cpumask(9)apply_workqueue_attrs(9)unbound_wq_update_pwq(9)wq_adjust_max_active(9)destroy_workqueue(9)workqueue_set_max_active(9)workqueue_set_min_active(9)current_work(9)current_is_workqueue_rescuer(9)current_is_workqueue_mem_reclaim(9)workqueue_congested(9)work_busy(9)print_worker_info(9)show_one_workqueue(9)show_one_worker_pool(9)show_all_workqueues(9)show_freezable_workqueues(9)rebind_workers(9)restore_unbound_workers_cpumask(9)work_on_cpu_key(9)freeze_workqueues_begin(9)freeze_workqueues_busy(9)thaw_workqueues(9)workqueue_unbound_housekeeping_update(9)workqueue_set_unbound_cpumask(9)workqueue_sysfs_register(9)workqueue_sysfs_unregister(9)workqueue_init_early(9)workqueue_init(9)llc_count_cores(9)llc_populate_cpu_shard_id(9)precompute_cache_shard_ids(9)workqueue_init_topology(9)
likeβ¦ that's a whole friend group. obsessed. π
and that's the page, bestie!! footer tea: this one lives in ./kernel, dated October 2026, and it's set_worker_desc(9) β go forth and describe your work items, you absolute icon π§ββοΈβ¨π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms