|
|
1.1 root 1: .\" Copyright (c) 1983 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)sigpause.2 6.5 (Berkeley) 7/1/90
19: .\"
20: .TH SIGPAUSE 2 "July 1, 1990"
21: .UC 4
22: .SH NAME
23: sigpause \- atomically release blocked signals and wait for interrupt
24: .SH SYNOPSIS
25: .ft B
26: sigpause(sigmask)
27: .br
28: int sigmask;
29: .ft R
30: .SH DESCRIPTION
31: .B "This interface is made obsolete by sigsuspend(2).
32: .LP
33: .I Sigpause
34: assigns
35: .I sigmask
36: to the set of masked signals
37: and then waits for a signal to arrive;
38: on return the set of masked signals is restored.
39: .I Sigmask
40: is usually 0 to indicate that no
41: signals are now to be blocked.
42: .I Sigpause
43: always terminates by being interrupted, returning \-1 with
44: .I errno
45: set to EINTR.
46: .PP
47: In normal usage, a signal is blocked using
48: .IR sigblock (2),
49: to begin a critical section, variables modified on the occurrence
50: of the signal are examined to determine that there is no work
51: to be done, and the process pauses awaiting work by using
52: .I sigpause
53: with the mask returned by
54: .IR sigblock .
55: .SH SEE ALSO
56: sigsuspend(2), kill(2), sigaction(2), sigprocmask(2),
57: sigblock(2), sigvec(2)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.