Scroll to navigation

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

June 2024 Kernel Hackers Manual 3.10