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.

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

COPYRIGHT
Kernel Hackers Manual 4.8.                 January 2017                         DO_SIGNAL_STOP(9)