do_notify_parent_cldstop(9)
β¨ do_notify_parent_cldstop(9) β¨
okay so bestie, we're in the Kernel API Manual today and the function we're stanning is do_notify_parent_cldstop β say it with me, it's a whole mouthful but it's iconic. π
π NAME π
do_notify_parent_cldstop β notify parent of stopped/continued state change
like literally the whole job is "hey parent, something changed" and honestly? relatable. π
π¦ SYNOPSIS π¦
void do_notify_parent_cldstop (struct task_struct *tsk , bool
for_ptracer , int why );
no cap, that's the whole signature. three args, zero drama. β¨
πΈ ARGUMENTS πΈ
tskβ the task that's out here reporting the state change. main character energy fr fr. πfor_ptracerβ this one's a yes/no baddie: the notification is for the ptracer. that's it, that's the whole flag. π«Άwhyβ the reason, and it's one ofCLD_{CONTINUED|STOPPED|TRAPPED}to report. pick one, bestie, it's giving multiple choice. π
π DESCRIPTION π
Notifies tsk's parent that the stopped/continued state has changed. like a little "hey mom, status update" text but for processes. π
So here's the tea: if for_ptracer is false, then tsk's group leader notifies to its real parent. If it's true, then tsk reports to tsk->parent, which should be the ptracer. two different pathways, both valid, both slay. β¨
π₯ CONTEXT π₯
β οΈ Must be called with tasklist_lock at least read locked.
not me reminding you twice β but like, genuinely, do not skip this. it's a lock requirement, not a suggestion, bestie. π
π§ SEE ALSO π§
Kernel file ./kernel/signal.c and the whole friend group:
task_set_jobctl_pending(9)task_clear_jobctl_trapping(9)task_clear_jobctl_pending(9)task_participate_group_stop(9)ptrace_trap_notify(9)force_sig_seccomp(9)do_signal_stop(9)do_jobctl_trap(9)do_freezer_trap(9)signal_delivered(9)sys_restart_syscall(9)set_current_blocked(9)sys_rt_sigprocmask(9)sys_rt_sigpending(9)copy_siginfo_to_external32(9)do_sigtimedwait(9)sys_rt_sigtimedwait(9)sys_kill(9)sys_pidfd_send_signal(9)sys_tgkill(9)sys_tkill(9)sys_rt_sigqueueinfo(9)sys_sigpending(9)sys_sigprocmask(9)sys_rt_sigaction(9)sys_rt_sigsuspend(9)
that's 26 entries, i counted, and yes i listed every single one because we don't do "etc." in this house. π
okay that's the whole page!! π this little cutie lives in ./kernel and the version stamp is October 2026 β remember when that felt like the future?? anyway, mwah, go read signal.c, ily, bye!! πβ¨π
π¦ 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