Back to index

glibc  2.9
siginfo.h
Go to the documentation of this file.
00001 /* siginfo_t, sigevent and constants.  S/390 version.
00002    Copyright (C) 2001, 2002, 2003 Free Software Foundation, Inc.
00003    This file is part of the GNU C Library.
00004 
00005    The GNU C Library is free software; you can redistribute it and/or
00006    modify it under the terms of the GNU Lesser General Public
00007    License as published by the Free Software Foundation; either
00008    version 2.1 of the License, or (at your option) any later version.
00009 
00010    The GNU C Library is distributed in the hope that it will be useful,
00011    but WITHOUT ANY WARRANTY; without even the implied warranty of
00012    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013    Lesser General Public License for more details.
00014 
00015    You should have received a copy of the GNU Lesser General Public
00016    License along with the GNU C Library; if not, write to the Free
00017    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
00018    02111-1307 USA.  */
00019 
00020 #if !defined _SIGNAL_H && !defined __need_siginfo_t \
00021     && !defined __need_sigevent_t
00022 # error "Never include this file directly.  Use <signal.h> instead"
00023 #endif
00024 
00025 #include <bits/wordsize.h>
00026 
00027 #if (!defined __have_sigval_t \
00028      && (defined _SIGNAL_H || defined __need_siginfo_t \
00029          || defined __need_sigevent_t))
00030 # define __have_sigval_t    1
00031 
00032 /* Type for data associated with a signal.  */
00033 typedef union sigval
00034   {
00035     int sival_int;
00036     void *sival_ptr;
00037   } sigval_t;
00038 #endif
00039 
00040 #if (!defined __have_siginfo_t \
00041      && (defined _SIGNAL_H || defined __need_siginfo_t))
00042 # define __have_siginfo_t   1
00043 
00044 # define __SI_MAX_SIZE         128
00045 # if __WORDSIZE == 64
00046 #  define __SI_PAD_SIZE     ((__SI_MAX_SIZE / sizeof (int)) - 4)
00047 # else
00048 #  define __SI_PAD_SIZE     ((__SI_MAX_SIZE / sizeof (int)) - 3)
00049 # endif
00050 
00051 typedef struct siginfo
00052   {
00053     int si_signo;           /* Signal number.  */
00054     int si_errno;           /* If non-zero, an errno value associated with
00055                                this signal, as defined in <errno.h>.  */
00056     int si_code;            /* Signal code.       */
00057 
00058     union
00059       {
00060        int _pad[__SI_PAD_SIZE];
00061 
00062         /* kill().  */
00063        struct
00064          {
00065            __pid_t si_pid;  /* Sending process ID.      */
00066            __uid_t si_uid;  /* Real user ID of sending process.  */
00067          } _kill;
00068 
00069        /* POSIX.1b timers.  */
00070        struct
00071          {
00072            int si_tid;             /* Timer ID.  */
00073            int si_overrun;  /* Overrun count.  */
00074            sigval_t si_sigval;     /* Signal value.  */
00075          } _timer;
00076 
00077        /* POSIX.1b signals.  */
00078        struct
00079          {
00080            __pid_t si_pid;  /* Sending process ID.      */
00081            __uid_t si_uid;  /* Real user ID of sending process.  */
00082            sigval_t si_sigval;     /* Signal value.  */
00083          } _rt;
00084 
00085        /* SIGCHLD.  */
00086        struct
00087          {
00088            __pid_t si_pid;  /* Which child.       */
00089            __uid_t si_uid;  /* Real user ID of sending process.  */
00090            int si_status;   /* Exit value or signal.  */
00091            __clock_t si_utime;
00092            __clock_t si_stime;
00093          } _sigchld;
00094 
00095        /* SIGILL, SIGFPE, SIGSEGV, SIGBUS.  */
00096        struct
00097          {
00098            void *si_addr;   /* Faulting insn/memory ref.  */
00099             int si_trapno;
00100          } _sigfault;
00101 
00102        /* SIGPOLL.  */
00103        struct
00104          {
00105            long int si_band;       /* Band event for SIGPOLL.  */
00106            int si_fd;
00107          } _sigpoll;
00108       } _sifields;
00109   } siginfo_t;
00110 
00111 
00112 /* X/Open requires some more fields with fixed names.  */
00113 # define si_pid             _sifields._kill.si_pid
00114 # define si_uid             _sifields._kill.si_uid
00115 # define si_timerid  _sifields._timer.si_tid
00116 # define si_overrun  _sifields._timer.si_overrun
00117 # define si_status   _sifields._sigchld.si_status
00118 # define si_utime    _sifields._sigchld.si_utime
00119 # define si_stime    _sifields._sigchld.si_stime
00120 # define si_value    _sifields._rt.si_sigval
00121 # define si_int             _sifields._rt.si_sigval.sival_int
00122 # define si_ptr             _sifields._rt.si_sigval.sival_ptr
00123 # define si_addr     _sifields._sigfault.si_addr
00124 # define si_trapno   _sifields._sigfault.si_trapno
00125 # define si_band     _sifields._sigpoll.si_band
00126 # define si_fd              _sifields._sigpoll.si_fd
00127 
00128 
00129 /* Values for `si_code'.  Positive values are reserved for kernel-generated
00130    signals.  */
00131 enum
00132 {
00133   SI_ASYNCNL = -60,         /* Sent by asynch name lookup completion.  */
00134 # define SI_ASYNCNL  SI_ASYNCNL
00135   SI_TKILL = -6,            /* Sent by tkill.  */
00136 # define SI_TKILL    SI_TKILL
00137   SI_SIGIO,                 /* Sent by queued SIGIO. */
00138 # define SI_SIGIO    SI_SIGIO
00139   SI_ASYNCIO,               /* Sent by AIO completion.  */
00140 # define SI_ASYNCIO  SI_ASYNCIO
00141   SI_MESGQ,                 /* Sent by real time mesq state change.    */
00142 # define SI_MESGQ    SI_MESGQ
00143   SI_TIMER,                 /* Sent by timer expiration.  */
00144 # define SI_TIMER    SI_TIMER
00145   SI_QUEUE,                 /* Sent by sigqueue.  */
00146 # define SI_QUEUE    SI_QUEUE
00147   SI_USER,                  /* Sent by kill, sigsend, raise.  */
00148 # define SI_USER     SI_USER
00149   SI_KERNEL = 0x80          /* Send by kernel.  */
00150 #define SI_KERNEL    SI_KERNEL
00151 };
00152 
00153 
00154 /* `si_code' values for SIGILL signal.    */
00155 enum
00156 {
00157   ILL_ILLOPC = 1,           /* Illegal opcode.  */
00158 # define ILL_ILLOPC  ILL_ILLOPC
00159   ILL_ILLOPN,               /* Illegal operand.  */
00160 # define ILL_ILLOPN  ILL_ILLOPN
00161   ILL_ILLADR,               /* Illegal addressing mode.  */
00162 # define ILL_ILLADR  ILL_ILLADR
00163   ILL_ILLTRP,               /* Illegal trap. */
00164 # define ILL_ILLTRP  ILL_ILLTRP
00165   ILL_PRVOPC,               /* Privileged opcode.  */
00166 # define ILL_PRVOPC  ILL_PRVOPC
00167   ILL_PRVREG,               /* Privileged register.      */
00168 # define ILL_PRVREG  ILL_PRVREG
00169   ILL_COPROC,               /* Coprocessor error.  */
00170 # define ILL_COPROC  ILL_COPROC
00171   ILL_BADSTK                /* Internal stack error.  */
00172 # define ILL_BADSTK  ILL_BADSTK
00173 };
00174 
00175 /* `si_code' values for SIGFPE signal.    */
00176 enum
00177 {
00178   FPE_INTDIV = 1,           /* Integer divide by zero.  */
00179 # define FPE_INTDIV  FPE_INTDIV
00180   FPE_INTOVF,               /* Integer overflow.  */
00181 # define FPE_INTOVF  FPE_INTOVF
00182   FPE_FLTDIV,               /* Floating point divide by zero.  */
00183 # define FPE_FLTDIV  FPE_FLTDIV
00184   FPE_FLTOVF,               /* Floating point overflow.  */
00185 # define FPE_FLTOVF  FPE_FLTOVF
00186   FPE_FLTUND,               /* Floating point underflow.  */
00187 # define FPE_FLTUND  FPE_FLTUND
00188   FPE_FLTRES,               /* Floating point inexact result.  */
00189 # define FPE_FLTRES  FPE_FLTRES
00190   FPE_FLTINV,               /* Floating point invalid operation.  */
00191 # define FPE_FLTINV  FPE_FLTINV
00192   FPE_FLTSUB                /* Subscript out of range.  */
00193 # define FPE_FLTSUB  FPE_FLTSUB
00194 };
00195 
00196 /* `si_code' values for SIGSEGV signal.    */
00197 enum
00198 {
00199   SEGV_MAPERR = 1,          /* Address not mapped to object.  */
00200 # define SEGV_MAPERR SEGV_MAPERR
00201   SEGV_ACCERR               /* Invalid permissions for mapped object.  */
00202 # define SEGV_ACCERR SEGV_ACCERR
00203 };
00204 
00205 /* `si_code' values for SIGBUS signal.    */
00206 enum
00207 {
00208   BUS_ADRALN = 1,           /* Invalid address alignment.  */
00209 # define BUS_ADRALN  BUS_ADRALN
00210   BUS_ADRERR,               /* Non-existant physical address.  */
00211 # define BUS_ADRERR  BUS_ADRERR
00212   BUS_OBJERR                /* Object specific hardware error.  */
00213 # define BUS_OBJERR  BUS_OBJERR
00214 };
00215 
00216 /* `si_code' values for SIGTRAP signal.    */
00217 enum
00218 {
00219   TRAP_BRKPT = 1,           /* Process breakpoint.      */
00220 # define TRAP_BRKPT  TRAP_BRKPT
00221   TRAP_TRACE                /* Process trace trap.      */
00222 # define TRAP_TRACE  TRAP_TRACE
00223 };
00224 
00225 /* `si_code' values for SIGCHLD signal.    */
00226 enum
00227 {
00228   CLD_EXITED = 1,           /* Child has exited.  */
00229 # define CLD_EXITED  CLD_EXITED
00230   CLD_KILLED,               /* Child was killed.  */
00231 # define CLD_KILLED  CLD_KILLED
00232   CLD_DUMPED,               /* Child terminated abnormally.     */
00233 # define CLD_DUMPED  CLD_DUMPED
00234   CLD_TRAPPED,                     /* Traced child has trapped.  */
00235 # define CLD_TRAPPED CLD_TRAPPED
00236   CLD_STOPPED,                     /* Child has stopped.  */
00237 # define CLD_STOPPED CLD_STOPPED
00238   CLD_CONTINUED                    /* Stopped child has continued.     */
00239 # define CLD_CONTINUED      CLD_CONTINUED
00240 };
00241 
00242 /* `si_code' values for SIGPOLL signal.    */
00243 enum
00244 {
00245   POLL_IN = 1,                     /* Data input available.  */
00246 # define POLL_IN     POLL_IN
00247   POLL_OUT,                 /* Output buffers available.  */
00248 # define POLL_OUT    POLL_OUT
00249   POLL_MSG,                 /* Input message available.   */
00250 # define POLL_MSG    POLL_MSG
00251   POLL_ERR,                 /* I/O error.  */
00252 # define POLL_ERR    POLL_ERR
00253   POLL_PRI,                 /* High priority input available.  */
00254 # define POLL_PRI    POLL_PRI
00255   POLL_HUP                  /* Device disconnected.      */
00256 # define POLL_HUP    POLL_HUP
00257 };
00258 
00259 # undef __need_siginfo_t
00260 #endif /* !have siginfo_t && (have _SIGNAL_H || need siginfo_t).  */
00261 
00262 
00263 #if (defined _SIGNAL_H || defined __need_sigevent_t) \
00264     && !defined __have_sigevent_t
00265 # define __have_sigevent_t  1
00266 
00267 /* Structure to transport application-defined values with signals.  */
00268 # define __SIGEV_MAX_SIZE   64
00269 # if __WORDSIZE == 64
00270 #  define __SIGEV_PAD_SIZE  ((__SIGEV_MAX_SIZE / sizeof (int)) - 4)
00271 # else
00272 #  define __SIGEV_PAD_SIZE  ((__SIGEV_MAX_SIZE / sizeof (int)) - 3)
00273 # endif
00274 
00275 typedef struct sigevent
00276   {
00277     sigval_t sigev_value;
00278     int sigev_signo;
00279     int sigev_notify;
00280 
00281     union
00282       {
00283        int _pad[__SIGEV_PAD_SIZE];
00284 
00285        struct
00286          {
00287            void (*_function) (sigval_t);  /* Function to start.        */
00288            void *_attribute;                     /* Really pthread_attr_t.  */
00289          } _sigev_thread;
00290       } _sigev_un;
00291   } sigevent_t;
00292 
00293 /* POSIX names to access some of the members.  */
00294 # define sigev_notify_function      _sigev_un._sigev_thread._function
00295 # define sigev_notify_attributes _sigev_un._sigev_thread._attribute
00296 
00297 /* `sigev_notify' values.  */
00298 enum
00299 {
00300   SIGEV_SIGNAL = 0,         /* Notify via signal.  */
00301 # define SIGEV_SIGNAL       SIGEV_SIGNAL
00302   SIGEV_NONE,               /* Other notification: meaningless.  */
00303 # define SIGEV_NONE  SIGEV_NONE
00304   SIGEV_THREAD,                    /* Deliver via thread creation.     */
00305 # define SIGEV_THREAD       SIGEV_THREAD
00306 
00307   SIGEV_THREAD_ID = 4              /* Send signal to specific thread.  */
00308 #define SIGEV_THREAD_ID     SIGEV_THREAD_ID
00309 };
00310 
00311 #endif /* have _SIGNAL_H.  */