kthread_park(9)

📦 version 7.3.1, in nixpkgs unstable

💤 kthread_park(9) — from the Kernel API Manual, bestie

okay so picture this: it's the kthread_park(9) page, it lives in the Kernel API Manual, and it's here to teach you how to put a kernel thread in timeout 😌✨

✨ NAME ✨

kthread_park — park a thread created by kthread_create(). like, send it to its little parking spot and let it chill 🅿️🦋

🌸 SYNOPSIS 🌸

int kthread_park (struct task_struct *k );

🎀 ARGUMENTS 🎀

  • k — the thread created by kthread_create. that's your girl. that's who we're parking 💅

💖 DESCRIPTION 💖

so what actually happens: it sets kthread_should_park for k to return true, wakes it up, and then waits for it to return. the way it's giving "I texted you, I woke you, now I'm waiting for a reply" 😭📱

fun fact that's actually iconic: you can call this right after kthread_create instead of calling wake_up_process — the thread will park without calling threadfn. no function call, no problem, she just naps 😴✨

returns 0 if the thread is parked 🌈 and -ENOSYS if the thread exited 💀 and if it's called by the kthread itself, then just the park bit is set. that's it. that's the whole vibe 🫶

🦋 SEE ALSO 🦋

Kernel file ./kernel/kthread.c — and literally the whole kthread fam, no cap 👑

friend check: this is the <pink>./kernel</pink> kernel source tree, dated October 2026, and that's the whole page bestie — go park something 💜✨🎀
📦 where this page comes from