wait_task_stopped(9)

🎀 NAME 🎀

okay so bestie, this is wait_task_stopped(9) from the Kernel API Manual, and it's literally here to Wait for %TASK_STOPPED or %TASK_TRACED. no cap. 💅

✨ SYNOPSIS ✨

int wait_task_stopped (struct wait_opts *wo , int ptrace , struct
       task_struct *p );

copy that signature exactly, bestie — commas, spaces, semicolon, all of it. 🫶

🌸 ARGUMENTS 🌸

• wo — wait options. the options bag, basically.
• ptrace — is the wait for ptrace.
• p — task to wait for. the task we're waiting on, periodt.

💅 DESCRIPTION 💅

So the job is: handle sys_wait4 work for p in state TASK_STOPPED or TASK_TRACED. that's it, that's the function. iconic. ✨

🔒 CONTEXT 🔒

Context is read_lock(tasklist_lock), which is released if the return value is non-zero. Also, it grabs and releases p->sighand->siglock. so yeah, lock business is happening — don't forget it. 💀

🧚 RETURN 🧚

• 0 — the wait condition didn't exist, and the search for other wait conditions should continue. keep looking, bestie. 👀
• Non-zero return — -errno on failure and p's pid on success. this implies that tasklist_lock is released and the wait condition search should terminate. so stop searching when you see it. 🔥

🌈 SEE ALSO 🌈

Kernel file ./kernel/exit.c — go read it, iykyk. 📖

mwah 💋 — source/version: ./kernel; date: October 2026. that's the cute little footer sign-off, bestie, byeeee 🫶💖