1: /* A GNU-like <signal.h>.
2:
3: Copyright (C) 2006-2019 Free Software Foundation, Inc.
4:
5: This program is free software: you can redistribute it and/or modify
6: it under the terms of the GNU General Public License as published by
7: the Free Software Foundation; either version 3 of the License, or
8: (at your option) any later version.
9:
10: This program is distributed in the hope that it will be useful,
11: but WITHOUT ANY WARRANTY; without even the implied warranty of
12: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13: GNU General Public License for more details.
14:
15: You should have received a copy of the GNU General Public License
16: along with this program. If not, see <https://www.gnu.org/licenses/>. */
17:
18: #if __GNUC__ >= 3
19: @PRAGMA_SYSTEM_HEADER@
20: #endif
21: @PRAGMA_COLUMNS@
22:
23: #if defined __need_sig_atomic_t || defined __need_sigset_t || defined _GL_ALREADY_INCLUDING_SIGNAL_H || (defined _SIGNAL_H && !defined __SIZEOF_PTHREAD_MUTEX_T)
24: /* Special invocation convention:
25: - Inside glibc header files.
26: - On glibc systems we have a sequence of nested includes
27: <signal.h> -> <ucontext.h> -> <signal.h>.
28: In this situation, the functions are not yet declared, therefore we cannot
29: provide the C++ aliases.
30: - On glibc systems with GCC 4.3 we have a sequence of nested includes
31: <csignal> -> </usr/include/signal.h> -> <sys/ucontext.h> -> <signal.h>.
32: In this situation, some of the functions are not yet declared, therefore
33: we cannot provide the C++ aliases. */
34:
35: # @INCLUDE_NEXT@ @NEXT_SIGNAL_H@
36:
37: #else
38: /* Normal invocation convention. */
39:
40: #ifndef _@GUARD_PREFIX@_SIGNAL_H
41:
42: #define _GL_ALREADY_INCLUDING_SIGNAL_H
43:
44: /* Define pid_t, uid_t.
45: Also, mingw defines sigset_t not in <signal.h>, but in <sys/types.h>.
46: On Solaris 10, <signal.h> includes <sys/types.h>, which eventually includes
47: us; so include <sys/types.h> now, before the second inclusion guard. */
48: #include <sys/types.h>
49:
50: /* The include_next requires a split double-inclusion guard. */
51: #@INCLUDE_NEXT@ @NEXT_SIGNAL_H@
52:
53: #undef _GL_ALREADY_INCLUDING_SIGNAL_H
54:
55: #ifndef _@GUARD_PREFIX@_SIGNAL_H
56: #define _@GUARD_PREFIX@_SIGNAL_H
57:
58: /* Mac OS X 10.3, FreeBSD 6.4, OpenBSD 3.8, OSF/1 4.0, Solaris 2.6, Android
59: declare pthread_sigmask in <pthread.h>, not in <signal.h>.
60: But avoid namespace pollution on glibc systems.*/
61: #if (@GNULIB_PTHREAD_SIGMASK@ || defined GNULIB_POSIXCHECK) \
62: && ((defined __APPLE__ && defined __MACH__) \
63: || defined __FreeBSD__ || defined __OpenBSD__ || defined __osf__ \
64: || defined __sun || defined __ANDROID__) \
65: && ! defined __GLIBC__
66: # include <pthread.h>
67: #endif
68:
69: /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
70:
71: /* The definition of _GL_ARG_NONNULL is copied here. */
72:
73: /* The definition of _GL_WARN_ON_USE is copied here. */
74:
75: /* On AIX, sig_atomic_t already includes volatile. C99 requires that
76: 'volatile sig_atomic_t' ignore the extra modifier, but C89 did not.
77: Hence, redefine this to a non-volatile type as needed. */
78: #if ! @HAVE_TYPE_VOLATILE_SIG_ATOMIC_T@
79: # if !GNULIB_defined_sig_atomic_t
80: typedef int rpl_sig_atomic_t;
81: # undef sig_atomic_t
82: # define sig_atomic_t rpl_sig_atomic_t
83: # define GNULIB_defined_sig_atomic_t 1
84: # endif
85: #endif
86:
87: /* A set or mask of signals. */
88: #if !@HAVE_SIGSET_T@
89: # if !GNULIB_defined_sigset_t
90: typedef unsigned int sigset_t;
91: # define GNULIB_defined_sigset_t 1
92: # endif
93: #endif
94:
95: /* Define sighandler_t, the type of signal handlers. A GNU extension. */
96: #if !@HAVE_SIGHANDLER_T@
97: # ifdef __cplusplus
98: extern "C" {
99: # endif
100: # if !GNULIB_defined_sighandler_t
101: typedef void (*sighandler_t) (int);
102: # define GNULIB_defined_sighandler_t 1
103: # endif
104: # ifdef __cplusplus
105: }
106: # endif
107: #endif
108:
109:
110: #if @GNULIB_SIGNAL_H_SIGPIPE@
111: # ifndef SIGPIPE
112: /* Define SIGPIPE to a value that does not overlap with other signals. */
113: # define SIGPIPE 13
114: # define GNULIB_defined_SIGPIPE 1
115: /* To actually use SIGPIPE, you also need the gnulib modules 'sigprocmask',
116: 'write', 'stdio'. */
117: # endif
118: #endif
119:
120:
121: /* Maximum signal number + 1. */
122: #ifndef NSIG
123: # if defined __TANDEM
124: # define NSIG 32
125: # endif
126: #endif
127:
128:
129: #if @GNULIB_PTHREAD_SIGMASK@
130: # if @REPLACE_PTHREAD_SIGMASK@
131: # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
132: # undef pthread_sigmask
133: # define pthread_sigmask rpl_pthread_sigmask
134: # endif
135: _GL_FUNCDECL_RPL (pthread_sigmask, int,
136: (int how, const sigset_t *new_mask, sigset_t *old_mask));
137: _GL_CXXALIAS_RPL (pthread_sigmask, int,
138: (int how, const sigset_t *new_mask, sigset_t *old_mask));
139: # else
140: # if !(@HAVE_PTHREAD_SIGMASK@ || defined pthread_sigmask)
141: _GL_FUNCDECL_SYS (pthread_sigmask, int,
142: (int how, const sigset_t *new_mask, sigset_t *old_mask));
143: # endif
144: _GL_CXXALIAS_SYS (pthread_sigmask, int,
145: (int how, const sigset_t *new_mask, sigset_t *old_mask));
146: # endif
147: _GL_CXXALIASWARN (pthread_sigmask);
148: #elif defined GNULIB_POSIXCHECK
149: # undef pthread_sigmask
150: # if HAVE_RAW_DECL_PTHREAD_SIGMASK
151: _GL_WARN_ON_USE (pthread_sigmask, "pthread_sigmask is not portable - "
152: "use gnulib module pthread_sigmask for portability");
153: # endif
154: #endif
155:
156:
157: #if @GNULIB_RAISE@
158: # if @REPLACE_RAISE@
159: # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
160: # undef raise
161: # define raise rpl_raise
162: # endif
163: _GL_FUNCDECL_RPL (raise, int, (int sig));
164: _GL_CXXALIAS_RPL (raise, int, (int sig));
165: # else
166: # if !@HAVE_RAISE@
167: _GL_FUNCDECL_SYS (raise, int, (int sig));
168: # endif
169: _GL_CXXALIAS_SYS (raise, int, (int sig));
170: # endif
171: _GL_CXXALIASWARN (raise);
172: #elif defined GNULIB_POSIXCHECK
173: # undef raise
174: /* Assume raise is always declared. */
175: _GL_WARN_ON_USE (raise, "raise can crash on native Windows - "
176: "use gnulib module raise for portability");
177: #endif
178:
179:
180: #if @GNULIB_SIGPROCMASK@
181: # if !@HAVE_POSIX_SIGNALBLOCKING@
182:
183: # ifndef GNULIB_defined_signal_blocking
184: # define GNULIB_defined_signal_blocking 1
185: # endif
186:
187: /* Maximum signal number + 1. */
188: # ifndef NSIG
189: # define NSIG 32
190: # endif
191:
192: /* This code supports only 32 signals. */
193: # if !GNULIB_defined_verify_NSIG_constraint
194: typedef int verify_NSIG_constraint[NSIG <= 32 ? 1 : -1];
195: # define GNULIB_defined_verify_NSIG_constraint 1
196: # endif
197:
198: # endif
199:
200: /* When also using extern inline, suppress the use of static inline in
201: standard headers of problematic Apple configurations, as Libc at
202: least through Libc-825.26 (2013-04-09) mishandles it; see, e.g.,
203: <https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html>.
204: Perhaps Apple will fix this some day. */
205: #if (defined _GL_EXTERN_INLINE_IN_USE && defined __APPLE__ \
206: && (defined __i386__ || defined __x86_64__))
207: # undef sigaddset
208: # undef sigdelset
209: # undef sigemptyset
210: # undef sigfillset
211: # undef sigismember
212: #endif
213:
214: /* Test whether a given signal is contained in a signal set. */
215: # if @HAVE_POSIX_SIGNALBLOCKING@
216: /* This function is defined as a macro on Mac OS X. */
217: # if defined __cplusplus && defined GNULIB_NAMESPACE
218: # undef sigismember
219: # endif
220: # else
221: _GL_FUNCDECL_SYS (sigismember, int, (const sigset_t *set, int sig)
222: _GL_ARG_NONNULL ((1)));
223: # endif
224: _GL_CXXALIAS_SYS (sigismember, int, (const sigset_t *set, int sig));
225: _GL_CXXALIASWARN (sigismember);
226:
227: /* Initialize a signal set to the empty set. */
228: # if @HAVE_POSIX_SIGNALBLOCKING@
229: /* This function is defined as a macro on Mac OS X. */
230: # if defined __cplusplus && defined GNULIB_NAMESPACE
231: # undef sigemptyset
232: # endif
233: # else
234: _GL_FUNCDECL_SYS (sigemptyset, int, (sigset_t *set) _GL_ARG_NONNULL ((1)));
235: # endif
236: _GL_CXXALIAS_SYS (sigemptyset, int, (sigset_t *set));
237: _GL_CXXALIASWARN (sigemptyset);
238:
239: /* Add a signal to a signal set. */
240: # if @HAVE_POSIX_SIGNALBLOCKING@
241: /* This function is defined as a macro on Mac OS X. */
242: # if defined __cplusplus && defined GNULIB_NAMESPACE
243: # undef sigaddset
244: # endif
245: # else
246: _GL_FUNCDECL_SYS (sigaddset, int, (sigset_t *set, int sig)
247: _GL_ARG_NONNULL ((1)));
248: # endif
249: _GL_CXXALIAS_SYS (sigaddset, int, (sigset_t *set, int sig));
250: _GL_CXXALIASWARN (sigaddset);
251:
252: /* Remove a signal from a signal set. */
253: # if @HAVE_POSIX_SIGNALBLOCKING@
254: /* This function is defined as a macro on Mac OS X. */
255: # if defined __cplusplus && defined GNULIB_NAMESPACE
256: # undef sigdelset
257: # endif
258: # else
259: _GL_FUNCDECL_SYS (sigdelset, int, (sigset_t *set, int sig)
260: _GL_ARG_NONNULL ((1)));
261: # endif
262: _GL_CXXALIAS_SYS (sigdelset, int, (sigset_t *set, int sig));
263: _GL_CXXALIASWARN (sigdelset);
264:
265: /* Fill a signal set with all possible signals. */
266: # if @HAVE_POSIX_SIGNALBLOCKING@
267: /* This function is defined as a macro on Mac OS X. */
268: # if defined __cplusplus && defined GNULIB_NAMESPACE
269: # undef sigfillset
270: # endif
271: # else
272: _GL_FUNCDECL_SYS (sigfillset, int, (sigset_t *set) _GL_ARG_NONNULL ((1)));
273: # endif
274: _GL_CXXALIAS_SYS (sigfillset, int, (sigset_t *set));
275: _GL_CXXALIASWARN (sigfillset);
276:
277: /* Return the set of those blocked signals that are pending. */
278: # if !@HAVE_POSIX_SIGNALBLOCKING@
279: _GL_FUNCDECL_SYS (sigpending, int, (sigset_t *set) _GL_ARG_NONNULL ((1)));
280: # endif
281: _GL_CXXALIAS_SYS (sigpending, int, (sigset_t *set));
282: _GL_CXXALIASWARN (sigpending);
283:
284: /* If OLD_SET is not NULL, put the current set of blocked signals in *OLD_SET.
285: Then, if SET is not NULL, affect the current set of blocked signals by
286: combining it with *SET as indicated in OPERATION.
287: In this implementation, you are not allowed to change a signal handler
288: while the signal is blocked. */
289: # if !@HAVE_POSIX_SIGNALBLOCKING@
290: # define SIG_BLOCK 0 /* blocked_set = blocked_set | *set; */
291: # define SIG_SETMASK 1 /* blocked_set = *set; */
292: # define SIG_UNBLOCK 2 /* blocked_set = blocked_set & ~*set; */
293: _GL_FUNCDECL_SYS (sigprocmask, int,
294: (int operation, const sigset_t *set, sigset_t *old_set));
295: # endif
296: _GL_CXXALIAS_SYS (sigprocmask, int,
297: (int operation, const sigset_t *set, sigset_t *old_set));
298: _GL_CXXALIASWARN (sigprocmask);
299:
300: /* Install the handler FUNC for signal SIG, and return the previous
301: handler. */
302: # ifdef __cplusplus
303: extern "C" {
304: # endif
305: # if !GNULIB_defined_function_taking_int_returning_void_t
306: typedef void (*_gl_function_taking_int_returning_void_t) (int);
307: # define GNULIB_defined_function_taking_int_returning_void_t 1
308: # endif
309: # ifdef __cplusplus
310: }
311: # endif
312: # if !@HAVE_POSIX_SIGNALBLOCKING@
313: # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
314: # define signal rpl_signal
315: # endif
316: _GL_FUNCDECL_RPL (signal, _gl_function_taking_int_returning_void_t,
317: (int sig, _gl_function_taking_int_returning_void_t func));
318: _GL_CXXALIAS_RPL (signal, _gl_function_taking_int_returning_void_t,
319: (int sig, _gl_function_taking_int_returning_void_t func));
320: # else
321: _GL_CXXALIAS_SYS (signal, _gl_function_taking_int_returning_void_t,
322: (int sig, _gl_function_taking_int_returning_void_t func));
323: # endif
324: _GL_CXXALIASWARN (signal);
325:
326: # if !@HAVE_POSIX_SIGNALBLOCKING@ && GNULIB_defined_SIGPIPE
327: /* Raise signal SIGPIPE. */
328: _GL_EXTERN_C int _gl_raise_SIGPIPE (void);
329: # endif
330:
331: #elif defined GNULIB_POSIXCHECK
332: # undef sigaddset
333: # if HAVE_RAW_DECL_SIGADDSET
334: _GL_WARN_ON_USE (sigaddset, "sigaddset is unportable - "
335: "use the gnulib module sigprocmask for portability");
336: # endif
337: # undef sigdelset
338: # if HAVE_RAW_DECL_SIGDELSET
339: _GL_WARN_ON_USE (sigdelset, "sigdelset is unportable - "
340: "use the gnulib module sigprocmask for portability");
341: # endif
342: # undef sigemptyset
343: # if HAVE_RAW_DECL_SIGEMPTYSET
344: _GL_WARN_ON_USE (sigemptyset, "sigemptyset is unportable - "
345: "use the gnulib module sigprocmask for portability");
346: # endif
347: # undef sigfillset
348: # if HAVE_RAW_DECL_SIGFILLSET
349: _GL_WARN_ON_USE (sigfillset, "sigfillset is unportable - "
350: "use the gnulib module sigprocmask for portability");
351: # endif
352: # undef sigismember
353: # if HAVE_RAW_DECL_SIGISMEMBER
354: _GL_WARN_ON_USE (sigismember, "sigismember is unportable - "
355: "use the gnulib module sigprocmask for portability");
356: # endif
357: # undef sigpending
358: # if HAVE_RAW_DECL_SIGPENDING
359: _GL_WARN_ON_USE (sigpending, "sigpending is unportable - "
360: "use the gnulib module sigprocmask for portability");
361: # endif
362: # undef sigprocmask
363: # if HAVE_RAW_DECL_SIGPROCMASK
364: _GL_WARN_ON_USE (sigprocmask, "sigprocmask is unportable - "
365: "use the gnulib module sigprocmask for portability");
366: # endif
367: #endif /* @GNULIB_SIGPROCMASK@ */
368:
369:
370: #if @GNULIB_SIGACTION@
371: # if !@HAVE_SIGACTION@
372:
373: # if !@HAVE_SIGINFO_T@
374:
375: # if !GNULIB_defined_siginfo_types
376:
377: /* Present to allow compilation, but unsupported by gnulib. */
378: union sigval
379: {
380: int sival_int;
381: void *sival_ptr;
382: };
383:
384: /* Present to allow compilation, but unsupported by gnulib. */
385: struct siginfo_t
386: {
387: int si_signo;
388: int si_code;
389: int si_errno;
390: pid_t si_pid;
391: uid_t si_uid;
392: void *si_addr;
393: int si_status;
394: long si_band;
395: union sigval si_value;
396: };
397: typedef struct siginfo_t siginfo_t;
398:
399: # define GNULIB_defined_siginfo_types 1
400: # endif
401:
402: # endif /* !@HAVE_SIGINFO_T@ */
403:
404: /* We assume that platforms which lack the sigaction() function also lack
405: the 'struct sigaction' type, and vice versa. */
406:
407: # if !GNULIB_defined_struct_sigaction
408:
409: struct sigaction
410: {
411: union
412: {
413: void (*_sa_handler) (int);
414: /* Present to allow compilation, but unsupported by gnulib. POSIX
415: says that implementations may, but not must, make sa_sigaction
416: overlap with sa_handler, but we know of no implementation where
417: they do not overlap. */
418: void (*_sa_sigaction) (int, siginfo_t *, void *);
419: } _sa_func;
420: sigset_t sa_mask;
421: /* Not all POSIX flags are supported. */
422: int sa_flags;
423: };
424: # define sa_handler _sa_func._sa_handler
425: # define sa_sigaction _sa_func._sa_sigaction
426: /* Unsupported flags are not present. */
427: # define SA_RESETHAND 1
428: # define SA_NODEFER 2
429: # define SA_RESTART 4
430:
431: # define GNULIB_defined_struct_sigaction 1
432: # endif
433:
434: _GL_FUNCDECL_SYS (sigaction, int, (int, const struct sigaction *restrict,
435: struct sigaction *restrict));
436:
437: # elif !@HAVE_STRUCT_SIGACTION_SA_SIGACTION@
438:
439: # define sa_sigaction sa_handler
440:
441: # endif /* !@HAVE_SIGACTION@, !@HAVE_STRUCT_SIGACTION_SA_SIGACTION@ */
442:
443: _GL_CXXALIAS_SYS (sigaction, int, (int, const struct sigaction *restrict,
444: struct sigaction *restrict));
445: _GL_CXXALIASWARN (sigaction);
446:
447: #elif defined GNULIB_POSIXCHECK
448: # undef sigaction
449: # if HAVE_RAW_DECL_SIGACTION
450: _GL_WARN_ON_USE (sigaction, "sigaction is unportable - "
451: "use the gnulib module sigaction for portability");
452: # endif
453: #endif
454:
455: /* Some systems don't have SA_NODEFER. */
456: #ifndef SA_NODEFER
457: # define SA_NODEFER 0
458: #endif
459:
460:
461: #endif /* _@GUARD_PREFIX@_SIGNAL_H */
462: #endif /* _@GUARD_PREFIX@_SIGNAL_H */
463: #endif
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>