xref: /original-bsd/lib/libc/compat-43/sigpause.2 (revision aa5ce4bb)
1.\" Copyright (c) 1983, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)sigpause.2	8.1 (Berkeley) 06/02/93
7.\"
8.Dd
9.Dt SIGPAUSE 2
10.Os BSD 4
11.Sh NAME
12.Nm sigpause
13.Nd atomically release blocked signals and wait for interrupt
14.Sh SYNOPSIS
15.Fd #include <signal.h>
16.Ft int
17.Fn sigpause "int sigmask"
18.Sh DESCRIPTION
19.Sy This interface is made obsolete by
20.Xr sigsuspend 2 .
21.Pp
22.Fn Sigpause
23assigns
24.Fa sigmask
25to the set of masked signals
26and then waits for a signal to arrive;
27on return the set of masked signals is restored.
28.Fa Sigmask
29is usually 0 to indicate that no
30signals are to be blocked.
31.Fn Sigpause
32always terminates by being interrupted, returning -1 with
33.Va errno
34set to
35.Dv EINTR
36.Sh SEE ALSO
37.Xr sigsuspend 2 ,
38.Xr kill 2 ,
39.Xr sigaction 2 ,
40.Xr sigprocmask 2 ,
41.Xr sigblock 2 ,
42.Xr sigvec 2
43.Sh HISTORY
44The
45.Nm
46function call appeared in
47.Bx 4.2
48and has been deprecated.
49