usr/src/lib/libc/compat-43/sigpause.2

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)sigpause.2	6.1 (Berkeley) %G%
.\"
.TH SIGPAUSE 2 ""
.UC 4
.SH NAME
sigpause \- atomically release blocked signals and wait for interrupt
.SH SYNOPSIS
.ft B
sigpause(sigmask)
.br
int sigmask;
.ft R
.SH DESCRIPTION
.I Sigpause
assigns
.I sigmask
to the set of masked signals
and then waits for a signal to arrive;
on return the set of masked signals is restored.
.I Sigmask
is usually 0 to indicate that no
signals are now to be blocked.
.I Sigpause
always terminates by being interrupted, returning \-1 with
.I errno
set to EINTR.
.PP
In normal usage, a signal is blocked using
.IR sigblock (2),
to begin a critical section, variables modified on the occurance
of the signal are examined to determine that there is no work
to be done, and the process pauses awaiting work by using
.I sigpause
with the mask returned by
.IR sigblock .
.SH SEE ALSO
sigblock(2), sigvec(2)
Commit	Line	Data
	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	.\" @(#)sigpause.2 6.1 (Berkeley) %G%
	6	.\"
	7	.TH SIGPAUSE 2 ""
	8	.UC 4
	9	.SH NAME
	10	sigpause \- atomically release blocked signals and wait for interrupt
	11	.SH SYNOPSIS
	12	.ft B
	13	sigpause(sigmask)
	14	.br
	15	int sigmask;
	16	.ft R
	17	.SH DESCRIPTION
	18	.I Sigpause
	19	assigns
	20	.I sigmask
	21	to the set of masked signals
	22	and then waits for a signal to arrive;
	23	on return the set of masked signals is restored.
	24	.I Sigmask
	25	is usually 0 to indicate that no
	26	signals are now to be blocked.
	27	.I Sigpause
	28	always terminates by being interrupted, returning \-1 with
	29	.I errno
	30	set to EINTR.
	31	.PP
	32	In normal usage, a signal is blocked using
	33	.IR sigblock (2),
	34	to begin a critical section, variables modified on the occurance
	35	of the signal are examined to determine that there is no work
	36	to be done, and the process pauses awaiting work by using
	37	.I sigpause
	38	with the mask returned by
	39	.IR sigblock .
	40	.SH SEE ALSO
	41	sigblock(2), sigvec(2)