1 .\" Copyright (c) 1983, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 4. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" @(#)sigpause.2 8.1 (Berkeley) 6/2/93
31 .\" Part of the content of the man page was derived from
32 .\" The Open Group Base Specifications Issue 7
33 .\" IEEE Std 1003.1-2008
44 .Nd legacy interface for signal management
52 .Fn sigignore "int sig"
54 .Fn xsi_sigpause "int sigmask"
56 .Fn sigrelse "int sig"
58 .Fn sigset "int" "void (*disp)(int)"
60 .Fn sigpause "int sigmask"
62 .Sy This interface is made obsolete by
69 function modifies signal dispositions.
72 argument specifies the signal, which may be any signal except
78 argument specifies the signal's disposition,
82 or the address of a signal handler.
87 is the address of a signal handler, the
90 to the signal mask of the calling process before executing the signal
91 handler; when the signal handler returns, the system restores the
92 signal mask of the calling process to its state prior to the delivery
101 is added to the signal
102 mask of the calling process and
104 disposition remains unchanged.
112 is removed from the signal mask of the calling process.
118 to the signal mask of the calling process.
124 from the signal mask of the calling process.
128 function sets the disposition of
137 from the signal mask of the calling process and suspend the calling process
138 until a signal is received.
141 function restores the signal mask of the process to its original state before
149 to the set of masked signals
150 and then waits for a signal to arrive;
151 on return the set of masked signals is restored.
155 is usually 0 to indicate that no
156 signals are to be blocked.
163 always terminate by being interrupted, returning -1 with
168 Upon successful completion,
172 if the signal had been blocked and the signal's previous disposition if
173 it had not been blocked.
178 set to indicate the error.
180 For all other functions, upon successful completion, 0 is returned.
181 Otherwise, -1 is returned and
183 is set to indicate the error:
189 is not a valid signal number.
195 functions, an attempt was made to catch or ignore
210 function is implemented for compatibility with historic
213 An incompatible interface by the same name, which used a single signal number
214 rather than a mask, was present in
216 and was copied from there into the
217 .Sy X/Open System Interfaces
222 implements it under the name
230 functions are implemented for compatibility with
240 and has been deprecated.
241 All other functions appeared in
243 and were deprecated before being implemented.