]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man2/pause.2
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
[thirdparty/man-pages.git] / man2 / pause.2
CommitLineData
fea681da
MK
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
4.\"
5.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.
8.\"
9.\" Permission is granted to copy and distribute modified versions of this
10.\" manual under the conditions for verbatim copying, provided that the
11.\" entire resulting derived work is distributed under the terms of a
12.\" permission notice identical to this one.
c13182ef 13.\"
fea681da
MK
14.\" Since the Linux kernel and libraries are constantly changing, this
15.\" manual page may be incorrect or out-of-date. The author(s) assume no
16.\" responsibility for errors or omissions, or for damages resulting from
17.\" the use of the information contained herein. The author(s) may not
18.\" have taken the same level of care in the production of this manual,
19.\" which is licensed free of charge, as they might when working
20.\" professionally.
c13182ef 21.\"
fea681da
MK
22.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.
24.\"
25.\" Modified by Michael Haardt (michael@moria.de)
26.\" Modified Sat Jul 24 14:48:00 1993 by Rik Faith (faith@cs.unc.edu)
27.\" Modified 1995 by Mike Battersby (mib@deakin.edu.au)
28.\" Modified 2000 by aeb, following Michael Kerrisk
29.\"
30.TH PAUSE 2 1995-08-31 "Linux" "Linux Programmer's Manual"
31.SH NAME
32pause \- wait for signal
33.SH SYNOPSIS
34.B #include <unistd.h>
35.sp
36.B int pause(void);
37.SH DESCRIPTION
38The
e511ffb6 39.BR pause ()
fea681da
MK
40library function causes the invoking process (or thread) to sleep
41until a signal is received that either terminates it or causes it
42to call a signal-catching function.
43.\" The
44.\" .B pause
45.\" system call causes the invoking process to sleep until a signal
46.\" is received.
47.SH "RETURN VALUE"
48The
b4692225 49.BR pause ()
fea681da 50function only returns when a signal was caught and the
c13182ef
MK
51signal-catching function returned.
52In this case
b4692225 53.BR pause ()
fea681da
MK
54returns \-1, and
55.I errno
56is set to
57.\" .BR ERESTARTNOHAND .
58.BR EINTR .
59.SH ERRORS
60.TP
61.B EINTR
62a signal was caught and the signal-catching function returned.
63.SH "CONFORMING TO"
97c1eac8 64SVr4, 4.3BSD, POSIX.1-2001.
fea681da
MK
65.SH "SEE ALSO"
66.BR kill (2),
67.BR select (2),
b4692225
MK
68.BR signal (2),
69.BR sigsuspend (2).