centos man page for ptrace_trap_notify

PTRACE_TRAP_NOTIFY(9)						   Driver Basics					     PTRACE_TRAP_NOTIFY(9)

NAME
       ptrace_trap_notify - schedule trap to notify ptracer

SYNOPSIS
       void ptrace_trap_notify(struct task_struct * t);

ARGUMENTS
       t
	   tracee wanting to notify tracer

DESCRIPTION
       This function schedules sticky ptrace trap which is cleared on the next TRAP_STOP to notify ptracer of an event.  t must have been seized
       by ptracer.

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

CONTEXT
       Must be called with task->sighand->siglock held.

COPYRIGHT
Kernel Hackers Manual 3.10					     June 2014						     PTRACE_TRAP_NOTIFY(9)