'\" t
.\"     Title: do_signal_stop
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: January 2017
.\"    Manual: Driver Basics
.\"    Source: Kernel Hackers Manual 4.8.15
.\"  Language: English
.\"
.TH "DO_SIGNAL_STOP" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Driver Basics"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
do_signal_stop \- handle group stop for SIGSTOP and other stop signals
.SH "SYNOPSIS"
.HP \w'bool\ do_signal_stop('u
.BI "bool do_signal_stop(int\ " "signr" ");"
.SH "ARGUMENTS"
.PP
\fIsignr\fR
.RS 4
signr causing group stop if initiating
.RE
.SH "DESCRIPTION"
.PP
If
\fBJOBCTL_STOP_PENDING\fR
is not set yet, initiate group stop with
\fIsignr\fR
and participate in it\&. If already set, participate in the existing group stop\&. If participated in a group stop (and thus slept),
\fBtrue\fR
is returned with siglock released\&.
.PP
If ptraced, this function doesn\*(Aqt handle stop itself\&. Instead,
\fBJOBCTL_TRAP_STOP\fR
is scheduled and
\fBfalse\fR
is returned with siglock untouched\&. The caller must ensure that INTERRUPT trap handling takes places afterwards\&.
.SH "CONTEXT"
.PP
Must be called with
\fIcurrent\fR\->sighand\->siglock held, which is released on
\fBtrue\fR
return\&.
.SH "RETURN"
.PP
\fBfalse\fR
if group stop is already cancelled or ptrace trap is scheduled\&.
\fBtrue\fR
if participated in group stop\&.
.SH "COPYRIGHT"
.br