from scratch; write to /dev/tty if possible, block interrupts
[unix-history] / usr / src / lib / libc / gen / pause.3
... / ...
CommitLineData
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
5.\" @(#)pause.3 6.1 (Berkeley) %G%
6.\"
7.TH PAUSE 3C ""
8.UC 4
9.SH NAME
10pause \- stop until signal
11.SH SYNOPSIS
12.B pause()
13.SH DESCRIPTION
14.I Pause
15never returns normally.
16It is used to give up control while waiting for
17a signal from
18.IR kill (2)
19or an interval timer, see
20.IR setitimer (2).
21Upon termination of a signal handler started during a
22.I pause,
23the
24.I pause
25call will return.
26.SH "RETURN VALUE
27Always returns \-1.
28.SH ERRORS
29.I Pause
30always returns:
31.TP 15
32[EINTR]
33The call was interrupted.
34.SH "SEE ALSO
35kill(2), select(2), sigpause(2)