1/* A GNU-like <signal.h>. 2 3 Copyright (C) 2006-2022 Free Software Foundation, Inc. 4 5 This file is free software: you can redistribute it and/or modify 6 it under the terms of the GNU Lesser General Public License as 7 published by the Free Software Foundation; either version 2.1 of the 8 License, or (at your option) any later version. 9 10 This file 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 Lesser General Public License for more details. 14 15 You should have received a copy of the GNU Lesser 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 OS/2 kLIBC 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__ || defined __KLIBC__) \ 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 80typedef 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 90typedef 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 98extern "C" { 99# endif 100# if !GNULIB_defined_sighandler_t 101typedef 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, 137 const sigset_t *restrict new_mask, 138 sigset_t *restrict old_mask)); 139_GL_CXXALIAS_RPL (pthread_sigmask, int, 140 (int how, 141 const sigset_t *restrict new_mask, 142 sigset_t *restrict old_mask)); 143# else 144# if !(@HAVE_PTHREAD_SIGMASK@ || defined pthread_sigmask) 145_GL_FUNCDECL_SYS (pthread_sigmask, int, 146 (int how, 147 const sigset_t *restrict new_mask, 148 sigset_t *restrict old_mask)); 149# endif 150_GL_CXXALIAS_SYS (pthread_sigmask, int, 151 (int how, 152 const sigset_t *restrict new_mask, 153 sigset_t *restrict old_mask)); 154# endif 155# if __GLIBC__ >= 2 156_GL_CXXALIASWARN (pthread_sigmask); 157# endif 158#elif defined GNULIB_POSIXCHECK 159# undef pthread_sigmask 160# if HAVE_RAW_DECL_PTHREAD_SIGMASK 161_GL_WARN_ON_USE (pthread_sigmask, "pthread_sigmask is not portable - " 162 "use gnulib module pthread_sigmask for portability"); 163# endif 164#endif 165 166 167#if @GNULIB_RAISE@ 168# if @REPLACE_RAISE@ 169# if !(defined __cplusplus && defined GNULIB_NAMESPACE) 170# undef raise 171# define raise rpl_raise 172# endif 173_GL_FUNCDECL_RPL (raise, int, (int sig)); 174_GL_CXXALIAS_RPL (raise, int, (int sig)); 175# else 176# if !@HAVE_RAISE@ 177_GL_FUNCDECL_SYS (raise, int, (int sig)); 178# endif 179_GL_CXXALIAS_SYS (raise, int, (int sig)); 180# endif 181# if __GLIBC__ >= 2 182_GL_CXXALIASWARN (raise); 183# endif 184#elif defined GNULIB_POSIXCHECK 185# undef raise 186/* Assume raise is always declared. */ 187_GL_WARN_ON_USE (raise, "raise can crash on native Windows - " 188 "use gnulib module raise for portability"); 189#endif 190 191 192#if @GNULIB_SIGPROCMASK@ 193# if !@HAVE_POSIX_SIGNALBLOCKING@ 194 195# ifndef GNULIB_defined_signal_blocking 196# define GNULIB_defined_signal_blocking 1 197# endif 198 199/* Maximum signal number + 1. */ 200# ifndef NSIG 201# define NSIG 32 202# endif 203 204/* This code supports only 32 signals. */ 205# if !GNULIB_defined_verify_NSIG_constraint 206typedef int verify_NSIG_constraint[NSIG <= 32 ? 1 : -1]; 207# define GNULIB_defined_verify_NSIG_constraint 1 208# endif 209 210# endif 211 212/* When also using extern inline, suppress the use of static inline in 213 standard headers of problematic Apple configurations, as Libc at 214 least through Libc-825.26 (2013-04-09) mishandles it; see, e.g., 215 <https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html>. 216 Perhaps Apple will fix this some day. */ 217#if (defined _GL_EXTERN_INLINE_IN_USE && defined __APPLE__ \ 218 && (defined __i386__ || defined __x86_64__)) 219# undef sigaddset 220# undef sigdelset 221# undef sigemptyset 222# undef sigfillset 223# undef sigismember 224#endif 225 226/* Test whether a given signal is contained in a signal set. */ 227# if @HAVE_POSIX_SIGNALBLOCKING@ 228/* This function is defined as a macro on Mac OS X. */ 229# if defined __cplusplus && defined GNULIB_NAMESPACE 230# undef sigismember 231# endif 232# else 233_GL_FUNCDECL_SYS (sigismember, int, (const sigset_t *set, int sig) 234 _GL_ARG_NONNULL ((1))); 235# endif 236_GL_CXXALIAS_SYS (sigismember, int, (const sigset_t *set, int sig)); 237_GL_CXXALIASWARN (sigismember); 238 239/* Initialize a signal set to the empty 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 sigemptyset 244# endif 245# else 246_GL_FUNCDECL_SYS (sigemptyset, int, (sigset_t *set) _GL_ARG_NONNULL ((1))); 247# endif 248_GL_CXXALIAS_SYS (sigemptyset, int, (sigset_t *set)); 249_GL_CXXALIASWARN (sigemptyset); 250 251/* Add a signal to a signal set. */ 252# if @HAVE_POSIX_SIGNALBLOCKING@ 253/* This function is defined as a macro on Mac OS X. */ 254# if defined __cplusplus && defined GNULIB_NAMESPACE 255# undef sigaddset 256# endif 257# else 258_GL_FUNCDECL_SYS (sigaddset, int, (sigset_t *set, int sig) 259 _GL_ARG_NONNULL ((1))); 260# endif 261_GL_CXXALIAS_SYS (sigaddset, int, (sigset_t *set, int sig)); 262_GL_CXXALIASWARN (sigaddset); 263 264/* Remove a signal from a signal set. */ 265# if @HAVE_POSIX_SIGNALBLOCKING@ 266/* This function is defined as a macro on Mac OS X. */ 267# if defined __cplusplus && defined GNULIB_NAMESPACE 268# undef sigdelset 269# endif 270# else 271_GL_FUNCDECL_SYS (sigdelset, int, (sigset_t *set, int sig) 272 _GL_ARG_NONNULL ((1))); 273# endif 274_GL_CXXALIAS_SYS (sigdelset, int, (sigset_t *set, int sig)); 275_GL_CXXALIASWARN (sigdelset); 276 277/* Fill a signal set with all possible signals. */ 278# if @HAVE_POSIX_SIGNALBLOCKING@ 279/* This function is defined as a macro on Mac OS X. */ 280# if defined __cplusplus && defined GNULIB_NAMESPACE 281# undef sigfillset 282# endif 283# else 284_GL_FUNCDECL_SYS (sigfillset, int, (sigset_t *set) _GL_ARG_NONNULL ((1))); 285# endif 286_GL_CXXALIAS_SYS (sigfillset, int, (sigset_t *set)); 287_GL_CXXALIASWARN (sigfillset); 288 289/* Return the set of those blocked signals that are pending. */ 290# if !@HAVE_POSIX_SIGNALBLOCKING@ 291_GL_FUNCDECL_SYS (sigpending, int, (sigset_t *set) _GL_ARG_NONNULL ((1))); 292# endif 293_GL_CXXALIAS_SYS (sigpending, int, (sigset_t *set)); 294_GL_CXXALIASWARN (sigpending); 295 296/* If OLD_SET is not NULL, put the current set of blocked signals in *OLD_SET. 297 Then, if SET is not NULL, affect the current set of blocked signals by 298 combining it with *SET as indicated in OPERATION. 299 In this implementation, you are not allowed to change a signal handler 300 while the signal is blocked. */ 301# if !@HAVE_POSIX_SIGNALBLOCKING@ 302# define SIG_BLOCK 0 /* blocked_set = blocked_set | *set; */ 303# define SIG_SETMASK 1 /* blocked_set = *set; */ 304# define SIG_UNBLOCK 2 /* blocked_set = blocked_set & ~*set; */ 305_GL_FUNCDECL_SYS (sigprocmask, int, 306 (int operation, 307 const sigset_t *restrict set, 308 sigset_t *restrict old_set)); 309# endif 310_GL_CXXALIAS_SYS (sigprocmask, int, 311 (int operation, 312 const sigset_t *restrict set, 313 sigset_t *restrict old_set)); 314_GL_CXXALIASWARN (sigprocmask); 315 316/* Install the handler FUNC for signal SIG, and return the previous 317 handler. */ 318# ifdef __cplusplus 319extern "C" { 320# endif 321# if !GNULIB_defined_function_taking_int_returning_void_t 322typedef void (*_gl_function_taking_int_returning_void_t) (int); 323# define GNULIB_defined_function_taking_int_returning_void_t 1 324# endif 325# ifdef __cplusplus 326} 327# endif 328# if !@HAVE_POSIX_SIGNALBLOCKING@ 329# if !(defined __cplusplus && defined GNULIB_NAMESPACE) 330# define signal rpl_signal 331# endif 332_GL_FUNCDECL_RPL (signal, _gl_function_taking_int_returning_void_t, 333 (int sig, _gl_function_taking_int_returning_void_t func)); 334_GL_CXXALIAS_RPL (signal, _gl_function_taking_int_returning_void_t, 335 (int sig, _gl_function_taking_int_returning_void_t func)); 336# else 337/* On OpenBSD, the declaration of 'signal' may not be present at this point, 338 because it occurs in <sys/signal.h>, not <signal.h> directly. */ 339# if defined __OpenBSD__ 340_GL_FUNCDECL_SYS (signal, _gl_function_taking_int_returning_void_t, 341 (int sig, _gl_function_taking_int_returning_void_t func)); 342# endif 343_GL_CXXALIAS_SYS (signal, _gl_function_taking_int_returning_void_t, 344 (int sig, _gl_function_taking_int_returning_void_t func)); 345# endif 346# if __GLIBC__ >= 2 347_GL_CXXALIASWARN (signal); 348# endif 349 350# if !@HAVE_POSIX_SIGNALBLOCKING@ && GNULIB_defined_SIGPIPE 351/* Raise signal SIGPIPE. */ 352_GL_EXTERN_C int _gl_raise_SIGPIPE (void); 353# endif 354 355#elif defined GNULIB_POSIXCHECK 356# undef sigaddset 357# if HAVE_RAW_DECL_SIGADDSET 358_GL_WARN_ON_USE (sigaddset, "sigaddset is unportable - " 359 "use the gnulib module sigprocmask for portability"); 360# endif 361# undef sigdelset 362# if HAVE_RAW_DECL_SIGDELSET 363_GL_WARN_ON_USE (sigdelset, "sigdelset is unportable - " 364 "use the gnulib module sigprocmask for portability"); 365# endif 366# undef sigemptyset 367# if HAVE_RAW_DECL_SIGEMPTYSET 368_GL_WARN_ON_USE (sigemptyset, "sigemptyset is unportable - " 369 "use the gnulib module sigprocmask for portability"); 370# endif 371# undef sigfillset 372# if HAVE_RAW_DECL_SIGFILLSET 373_GL_WARN_ON_USE (sigfillset, "sigfillset is unportable - " 374 "use the gnulib module sigprocmask for portability"); 375# endif 376# undef sigismember 377# if HAVE_RAW_DECL_SIGISMEMBER 378_GL_WARN_ON_USE (sigismember, "sigismember is unportable - " 379 "use the gnulib module sigprocmask for portability"); 380# endif 381# undef sigpending 382# if HAVE_RAW_DECL_SIGPENDING 383_GL_WARN_ON_USE (sigpending, "sigpending is unportable - " 384 "use the gnulib module sigprocmask for portability"); 385# endif 386# undef sigprocmask 387# if HAVE_RAW_DECL_SIGPROCMASK 388_GL_WARN_ON_USE (sigprocmask, "sigprocmask is unportable - " 389 "use the gnulib module sigprocmask for portability"); 390# endif 391#endif /* @GNULIB_SIGPROCMASK@ */ 392 393 394#if @GNULIB_SIGACTION@ 395# if !@HAVE_SIGACTION@ 396 397# if !@HAVE_SIGINFO_T@ 398 399# if !GNULIB_defined_siginfo_types 400 401/* Present to allow compilation, but unsupported by gnulib. */ 402union sigval 403{ 404 int sival_int; 405 void *sival_ptr; 406}; 407 408/* Present to allow compilation, but unsupported by gnulib. */ 409struct siginfo_t 410{ 411 int si_signo; 412 int si_code; 413 int si_errno; 414 pid_t si_pid; 415 uid_t si_uid; 416 void *si_addr; 417 int si_status; 418 long si_band; 419 union sigval si_value; 420}; 421typedef struct siginfo_t siginfo_t; 422 423# define GNULIB_defined_siginfo_types 1 424# endif 425 426# endif /* !@HAVE_SIGINFO_T@ */ 427 428/* We assume that platforms which lack the sigaction() function also lack 429 the 'struct sigaction' type, and vice versa. */ 430 431# if !GNULIB_defined_struct_sigaction 432 433struct sigaction 434{ 435 union 436 { 437 void (*_sa_handler) (int); 438 /* Present to allow compilation, but unsupported by gnulib. POSIX 439 says that implementations may, but not must, make sa_sigaction 440 overlap with sa_handler, but we know of no implementation where 441 they do not overlap. */ 442 void (*_sa_sigaction) (int, siginfo_t *, void *); 443 } _sa_func; 444 sigset_t sa_mask; 445 /* Not all POSIX flags are supported. */ 446 int sa_flags; 447}; 448# define sa_handler _sa_func._sa_handler 449# define sa_sigaction _sa_func._sa_sigaction 450/* Unsupported flags are not present. */ 451# define SA_RESETHAND 1 452# define SA_NODEFER 2 453# define SA_RESTART 4 454 455# define GNULIB_defined_struct_sigaction 1 456# endif 457 458_GL_FUNCDECL_SYS (sigaction, int, (int, const struct sigaction *restrict, 459 struct sigaction *restrict)); 460 461# elif !@HAVE_STRUCT_SIGACTION_SA_SIGACTION@ 462 463# define sa_sigaction sa_handler 464 465# endif /* !@HAVE_SIGACTION@, !@HAVE_STRUCT_SIGACTION_SA_SIGACTION@ */ 466 467_GL_CXXALIAS_SYS (sigaction, int, (int, const struct sigaction *restrict, 468 struct sigaction *restrict)); 469_GL_CXXALIASWARN (sigaction); 470 471#elif defined GNULIB_POSIXCHECK 472# undef sigaction 473# if HAVE_RAW_DECL_SIGACTION 474_GL_WARN_ON_USE (sigaction, "sigaction is unportable - " 475 "use the gnulib module sigaction for portability"); 476# endif 477#endif 478 479/* Some systems don't have SA_NODEFER. */ 480#ifndef SA_NODEFER 481# define SA_NODEFER 0 482#endif 483 484 485#endif /* _@GUARD_PREFIX@_SIGNAL_H */ 486#endif /* _@GUARD_PREFIX@_SIGNAL_H */ 487#endif 488