centos man page for do_signal_stop

DO_SIGNAL_STOP(9)						   Driver Basics						 DO_SIGNAL_STOP(9)

NAME
       do_signal_stop - handle group stop for SIGSTOP and other stop signals

SYNOPSIS
       bool do_signal_stop(int signr);

ARGUMENTS
       signr
	   signr causing group stop if initiating

DESCRIPTION
       If JOBCTL_STOP_PENDING is not set yet, initiate group stop with signr and participate in it. If already set, participate in the existing
       group stop. If participated in a group stop (and thus slept), true is returned with siglock released.

       If ptraced, this function doesn't handle stop itself. Instead, JOBCTL_TRAP_STOP is scheduled and false is returned with siglock untouched.
       The caller must ensure that INTERRUPT trap handling takes places afterwards.

CONTEXT
       Must be called with current->sighand->siglock held, which is released on true return.

RETURNS
       false if group stop is already cancelled or ptrace trap is scheduled.  true if participated in group stop.

COPYRIGHT
Kernel Hackers Manual 3.10					     June 2014							 DO_SIGNAL_STOP(9)