ptrace_trap_notify(9)

🎀 NAME 🎀

ptrace_trap_notify — schedule trap to notify ptracer. Like the name says, bestie: it schedules a trap so the ptracer gets a lil notification. 👑

✨ SYNOPSIS ✨

void ptrace_trap_notify (struct task_struct *t );

🫶 ARGUMENTS 🫶

• t — the tracee that's wanting to notify its tracer 💌

💅 DESCRIPTION 💅

This function schedules a sticky ptrace trap, and that trap is cleared on the next TRAP_STOP so the ptracer gets notified of an event. ✨ And hello? t must have been seized by the ptracer — that's the vibe check.

If t is running, the STOP trap will be taken. If t is trapped for STOP and the ptracer is listening for events, the tracee is woken up so it can re-trap for the new event. If t is trapped otherwise, the STOP trap will eventually be taken without returning to userland after the existing traps are finished by PTRACE_CONT. 😌

🔒 CONTEXT 🔒

⚠️ Must be called with task->sighand->siglock held. That's not optional, bestie — lock check or it's giving bad vibes. 💀

🌈 SEE ALSO 🌈

Kernel file ./kernel/signal.c plus the whole squad:

• task_set_jobctl_pending(9)
• task_clear_jobctl_trapping(9)
• task_clear_jobctl_pending(9)
• task_participate_group_stop(9)
• force_sig_seccomp(9)
• do_notify_parent_cldstop(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)

okay that's the whole page, bestie 💖 it's from ./kernel and dated October 2026 — mwah, go call it with the lock held 🎀✨