kthread_run_on_cpu(9)

💅 kthread_run_on_cpu(9) 💅

okay so this is a page from the Kernel API Manual, and it’s lowkey iconic: kthread_run_on_cpu(9). We’re talking about creating and waking a cpu bound thread, and the vibes are very “kernel thread main character energy.” ✨

🎀 NAME 🎀

kthread_run_on_cpu — create and wake a cpu bound thread. periodt. That’s the whole name-section mood, fr fr. 🫶

🌸 SYNOPSIS 🌸

no cap, here’s the exact signature — keep it cute and keep it literal:

struct task_struct * kthread_run_on_cpu (int (*threadfn)(void *data) ,
void *data , unsigned int cpu , const char *namefmt );

💖 ARGUMENTS 💖

• threadfn — the function to run until signal_pending(current). like, it keeps doing its thing until that signal situation shows up. ⭐
• data — data ptr for threadfn. simple, clean, a little pointer bestie. 🍓
• cpu — The cpu on which the thread should be bound, 💅
• namefmt — printf-style name for the thread. Format is restricted to "name.*u". Code fills in cpu number. iykyk — the format is not freestyle, bestie. 🌈

🔥 DESCRIPTION 🔥

Convenient wrapper for kthread_create_on_cpu followed by wake_up_process. that’s it, that’s the function, and it ate. 💅

Returns the kthread or ERR_PTR(-ENOMEM). so the return vibe check is: kthread on the happy path, ERR_PTR(-ENOMEM) when memory says no. 😭

bestie reminder: those literal names and tokens are not decorative — they’re the actual API. no cap. 🎀

🦋 SEE ALSO 🦋

• Kernel file ./include/linux/kthread.h 📁
• kthread_create(9) ✨
• kthread_run(9) 🌸
• kthread_run_worker(9) 💜
• kthread_run_worker_on_cpu(9) 🦋

okay bye bestie, mwah 💋 — this page’s source/version is ./include/linux, dated October 2026. 💖✨🫶