File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / srclib / signal.in.h
Revision 1.1.1.3 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Wed Mar 17 13:38:46 2021 UTC (3 years, 3 months ago) by misho
Branches: libiconv, MAIN
CVS tags: v1_16p0, HEAD
libiconv 1.16

    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>