Debian Codegraph @

upstream/debian-trixie/man2/pause.2

raw
1 .\" Copyright (c) 1992 Drew Eckhardt ([email protected]), March 28, 1992
2 .\"
3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
4 .\"
5 .\" Modified by Michael Haardt ([email protected])
6 .\" Modified Sat Jul 24 14:48:00 1993 by Rik Faith ([email protected])
7 .\" Modified 1995 by Mike Battersby ([email protected])
8 .\" Modified 2000 by aeb, following Michael Kerrisk
9 .\"
10 .TH pause 2 2024-05-02 "Linux man-pages 6.9.1"
11 .SH NAME
12 pause \- wait for signal
13 .SH LIBRARY
14 Standard C library
15 .RI ( libc ", " \-lc )
16 .SH SYNOPSIS
17 .nf
18 .B #include <unistd.h>
19 .P
20 .B int pause(void);
21 .fi
22 .SH DESCRIPTION
23 .BR pause ()
24 causes the calling process (or thread) to sleep
25 until a signal is delivered that either terminates the process or causes
26 the invocation of a signal-catching function.
27 .SH RETURN VALUE
28 .BR pause ()
29 returns only when a signal was caught and the
30 signal-catching function returned.
31 In this case,
32 .BR pause ()
33 returns \-1, and
34 .I errno
35 is set to
36 .\" .BR ERESTARTNOHAND .
37 .BR EINTR .
38 .SH ERRORS
39 .TP
40 .B EINTR
41 a signal was caught and the signal-catching function returned.
42 .SH STANDARDS
43 POSIX.1-2008.
44 .SH HISTORY
45 POSIX.1-2001, SVr4, 4.3BSD.
46 .SH SEE ALSO
47 .BR kill (2),
48 .BR select (2),
49 .BR signal (2),
50 .BR sigsuspend (2)