Debian Codegraph @

upstream/debian-unstable/man2/pause.2

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