[unix-history] / usr / src / lib / libc / gen / pause.3

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)pause.3	6.3 (Berkeley) %G%
.\"
.TH PAUSE 3 ""
.UC 4
.SH NAME
pause \- stop until signal
.SH SYNOPSIS
.B pause()
.SH DESCRIPTION
.ft B
Pause is made obsolete by sigpause(3).
.ft R
.PP
.I Pause
never returns normally.
It is used to give up control while waiting for
a signal from
.IR kill (2)
or an interval timer, see
.IR setitimer (2).
Upon termination of a signal handler started during a
.I pause,
the
.I pause
call will return.
.SH "RETURN VALUE
Always returns \-1.
.SH ERRORS
.I Pause
always returns:
.TP 15
[EINTR]
The call was interrupted.
.SH "SEE ALSO
kill(2), select(2), sigpause(2)
Commit	Line	Data
3619c480 KM	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	.\"
79e6b3c8	5	.\" @(#)pause.3 6.3 (Berkeley) %G%
3619c480	6	.\"
e3800388	7	.TH PAUSE 3 ""
3619c480 KM	8	.UC 4
	9	.SH NAME
	10	pause \- stop until signal
	11	.SH SYNOPSIS
	12	.B pause()
	13	.SH DESCRIPTION
e3800388 KB	14	.ft B
	15	Pause is made obsolete by sigpause(3).
	16	.ft R
	17	.PP
3619c480 KM	18	.I Pause
	19	never returns normally.
	20	It is used to give up control while waiting for
	21	a signal from
	22	.IR kill (2)
3eee9a2c KM	23	or an interval timer, see
3eee9a2c KM	24	.IR setitimer (2).
3619c480 KM	25	Upon termination of a signal handler started during a
	26	.I pause,
	27	the
	28	.I pause
	29	call will return.
3eee9a2c KM	30	.SH "RETURN VALUE
	31	Always returns \-1.
	32	.SH ERRORS
	33	.I Pause
	34	always returns:
	35	.TP 15
	36	[EINTR]
	37	The call was interrupted.
	38	.SH "SEE ALSO
	39	kill(2), select(2), sigpause(2)