---
name: "do_signal_stop"
section: "9"
platform: "linux"
package: "linux-manual-3.16"
version: "3.16.56-1+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/do_signal_stop"
---

# do\_signal\_stop(9)

handle group stop for SIGSTOP and other stop signals

## 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