kthreads_upd...housekeeping(9)

💅 kthreads_upd...housekeeping(9) 💅

okay so bestie, welcome to the Kernel API Manual, section 9 — the kthread corner of the kernel, and honestly? it's giving main character energy. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

kthreads_update_housekeeping — Update kthreads affinity on cpuset change 💖

---

🦋 SYNOPSIS 🦋

int kthreads_update_housekeeping (void );

that's it. that's the whole call. no cap. 🫶

---

🎀 ARGUMENTS 🎀

• void — no arguments. not a single one. she takes nothing and she gives everything. 💅

---

🌸 DESCRIPTION 🌸

okay so here's the situation, and honestly it's kind of iconic 👑

When a cpuset changes a partition type to/from "isolated", or updates related cpumasks, this function propagates the housekeeping cpumask change to preferred kthreads affinity. like, it carries the news over to the kthreads so everyone's on the same page. communication queen. 🔥

and then she reports back:

• 0 — successful. slay. everything worked. ✨
• -ENOMEM — a temporary mask couldn't be allocated. 😭 memory said no.
• -EINVAL — internal error. 💀 something went sideways inside, not your fault, but it happened.

fr fr, those three are the only possible outcomes — memorize them, your future self will thank you 🧚

---

🧚 SEE ALSO 🧚

this is the part where I point you at her whole friend group, and bestie, it's a big friend group 🌈

Kernel file ./kernel/kthread.c, plus:

• kthread_should_stop(9)
• kthread_should_park(9)
• kthread_freezable_should_stop(9)
• kthread_func(9)
• kthread_data(9)
• kthread_probe_data(9)
• kthread_complete_and_exit(9)
• kthread_create_on_node(9)
• kthread_bind(9)
• kthread_create_on_cpu(9)
• kthread_unpark(9)
• kthread_park(9)
• kthread_stop(9)
• kthread_stop_put(9)
• kthread_affine_preferred(9)
• kthread_worker_fn(9)
• kthread_create_worker_on_node(9)
• kthread_create_worker_on_cpu(9)
• kthread_queue_work(9)
• kthread_delayed_work_timer_fn(9)
• kthread_queue_delayed_work(9)
• kthread_flush_work(9)
• kthread_mod_delayed_work(9)
• kthread_cancel_work_sync(9)
• kthread_cancel_delayed_work_sync(9)
• kthread_flush_worker(9)
• kthread_destroy_worker(9)
• kthread_use_mm(9)
• kthread_unuse_mm(9)
• kthread_associate_blkcg(9)
• kthread_blkcg(9)

like I said. huge friend group. iykyk 🦋

---

okay that's the whole page bestie, go be brilliant out there 💜

sourced from ./kernel · dated October 2026 · filed under kthreads_upd...housekeeping(9) — mwah, love u, bye 🎀✨