Back to index

glibc  2.9
siginfo.h
Go to the documentation of this file.
00001 /* siginfo_t, sigevent and constants.  Linux version.
00002    Copyright (C) 1997-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          } _sigfault;
00100 
00101        /* SIGPOLL.  */
00102        struct
00103          {
00104            long int si_band;       /* Band event for SIGPOLL.  */
00105            int si_fd;
00106          } _sigpoll;
00107       } _sifields;
00108   } siginfo_t;
00109 
00110 
00111 /* X/Open requires some more fields with fixed names.  */
00112 # define si_pid             _sifields._kill.si_pid
00113 # define si_uid             _sifields._kill.si_uid
00114 # define si_timerid  _sifields._timer.si_tid
00115 # define si_overrun  _sifields._timer.si_overrun
00116 # define si_status   _sifields._sigchld.si_status
00117 # define si_utime    _sifields._sigchld.si_utime
00118 # define si_stime    _sifields._sigchld.si_stime
00119 # define si_value    _sifields._rt.si_sigval
00120 # define si_int             _sifields._rt.si_sigval.sival_int
00121 # define si_ptr             _sifields._rt.si_sigval.sival_ptr
00122 # define si_addr     _sifields._sigfault.si_addr
00123 # define si_band     _sifields._sigpoll.si_band
00124 # define si_fd              _sifields._sigpoll.si_fd
00125 
00126 
00127 /* Values for `si_code'.  Positive values are reserved for kernel-generated
00128    signals.  */
00129 enum
00130 {
00131   SI_ASYNCNL = -60,         /* Sent by asynch name lookup completion.  */
00132 # define SI_ASYNCNL  SI_ASYNCNL
00133   SI_TKILL = -6,            /* Sent by tkill.  */
00134 # define SI_TKILL    SI_TKILL
00135   SI_SIGIO,                 /* Sent by queued SIGIO. */
00136 # define SI_SIGIO    SI_SIGIO
00137   SI_ASYNCIO,               /* Sent by AIO completion.  */
00138 # define SI_ASYNCIO  SI_ASYNCIO
00139   SI_MESGQ,                 /* Sent by real time mesq state change.  */
00140 # define SI_MESGQ    SI_MESGQ
00141   SI_TIMER,                 /* Sent by timer expiration.  */
00142 # define SI_TIMER    SI_TIMER
00143   SI_QUEUE,                 /* Sent by sigqueue.  */
00144 # define SI_QUEUE    SI_QUEUE
00145   SI_USER,                  /* Sent by kill, sigsend, raise.  */
00146 # define SI_USER     SI_USER
00147   SI_KERNEL = 0x80          /* Send by kernel.  */
00148 #define SI_KERNEL    SI_KERNEL
00149 };
00150 
00151 
00152 /* `si_code' values for SIGILL signal.  */
00153 enum
00154 {
00155   ILL_ILLOPC = 1,           /* Illegal opcode.  */
00156 # define ILL_ILLOPC  ILL_ILLOPC
00157   ILL_ILLOPN,               /* Illegal operand.  */
00158 # define ILL_ILLOPN  ILL_ILLOPN
00159   ILL_ILLADR,               /* Illegal addressing mode.  */
00160 # define ILL_ILLADR  ILL_ILLADR
00161   ILL_ILLTRP,               /* Illegal trap. */
00162 # define ILL_ILLTRP  ILL_ILLTRP
00163   ILL_PRVOPC,               /* Privileged opcode.  */
00164 # define ILL_PRVOPC  ILL_PRVOPC
00165   ILL_PRVREG,               /* Privileged register.  */
00166 # define ILL_PRVREG  ILL_PRVREG
00167   ILL_COPROC,               /* Coprocessor error.  */
00168 # define ILL_COPROC  ILL_COPROC
00169   ILL_BADSTK                /* Internal stack error.  */
00170 # define ILL_BADSTK  ILL_BADSTK
00171 };
00172 
00173 /* `si_code' values for SIGFPE signal.  */
00174 enum
00175 {
00176   FPE_INTDIV = 1,           /* Integer divide by zero.  */
00177 # define FPE_INTDIV  FPE_INTDIV
00178   FPE_INTOVF,               /* Integer overflow.  */
00179 # define FPE_INTOVF  FPE_INTOVF
00180   FPE_FLTDIV,               /* Floating point divide by zero.  */
00181 # define FPE_FLTDIV  FPE_FLTDIV
00182   FPE_FLTOVF,               /* Floating point overflow.  */
00183 # define FPE_FLTOVF  FPE_FLTOVF
00184   FPE_FLTUND,               /* Floating point underflow.  */
00185 # define FPE_FLTUND  FPE_FLTUND
00186   FPE_FLTRES,               /* Floating point inexact result.  */
00187 # define FPE_FLTRES  FPE_FLTRES
00188   FPE_FLTINV,               /* Floating point invalid operation.  */
00189 # define FPE_FLTINV  FPE_FLTINV
00190   FPE_FLTSUB                /* Subscript out of range.  */
00191 # define FPE_FLTSUB  FPE_FLTSUB
00192 };
00193 
00194 /* `si_code' values for SIGSEGV signal.  */
00195 enum
00196 {
00197   SEGV_MAPERR = 1,          /* Address not mapped to object.  */
00198 # define SEGV_MAPERR SEGV_MAPERR
00199   SEGV_ACCERR               /* Invalid permissions for mapped object.  */
00200 # define SEGV_ACCERR SEGV_ACCERR
00201 };
00202 
00203 /* `si_code' values for SIGBUS signal.  */
00204 enum
00205 {
00206   BUS_ADRALN = 1,           /* Invalid address alignment.  */
00207 # define BUS_ADRALN  BUS_ADRALN
00208   BUS_ADRERR,               /* Non-existant physical address.  */
00209 # define BUS_ADRERR  BUS_ADRERR
00210   BUS_OBJERR                /* Object specific hardware error.  */
00211 # define BUS_OBJERR  BUS_OBJERR
00212 };
00213 
00214 /* `si_code' values for SIGTRAP signal.  */
00215 enum
00216 {
00217   TRAP_BRKPT = 1,           /* Process breakpoint.  */
00218 # define TRAP_BRKPT  TRAP_BRKPT
00219   TRAP_TRACE                /* Process trace trap.  */
00220 # define TRAP_TRACE  TRAP_TRACE
00221 };
00222 
00223 /* `si_code' values for SIGCHLD signal.  */
00224 enum
00225 {
00226   CLD_EXITED = 1,           /* Child has exited.  */
00227 # define CLD_EXITED  CLD_EXITED
00228   CLD_KILLED,               /* Child was killed.  */
00229 # define CLD_KILLED  CLD_KILLED
00230   CLD_DUMPED,               /* Child terminated abnormally.  */
00231 # define CLD_DUMPED  CLD_DUMPED
00232   CLD_TRAPPED,                     /* Traced child has trapped.  */
00233 # define CLD_TRAPPED CLD_TRAPPED
00234   CLD_STOPPED,                     /* Child has stopped.  */
00235 # define CLD_STOPPED CLD_STOPPED
00236   CLD_CONTINUED                    /* Stopped child has continued.  */
00237 # define CLD_CONTINUED      CLD_CONTINUED
00238 };
00239 
00240 /* `si_code' values for SIGPOLL signal.  */
00241 enum
00242 {
00243   POLL_IN = 1,                     /* Data input available.  */
00244 # define POLL_IN     POLL_IN
00245   POLL_OUT,                 /* Output buffers available.  */
00246 # define POLL_OUT    POLL_OUT
00247   POLL_MSG,                 /* Input message available.   */
00248 # define POLL_MSG    POLL_MSG
00249   POLL_ERR,                 /* I/O error.  */
00250 # define POLL_ERR    POLL_ERR
00251   POLL_PRI,                 /* High priority input available.  */
00252 # define POLL_PRI    POLL_PRI
00253   POLL_HUP                  /* Device disconnected.  */
00254 # define POLL_HUP    POLL_HUP
00255 };
00256 
00257 # undef __need_siginfo_t
00258 #endif /* !have siginfo_t && (have _SIGNAL_H || need siginfo_t).  */
00259 
00260 
00261 #if (defined _SIGNAL_H || defined __need_sigevent_t) \
00262     && !defined __have_sigevent_t
00263 # define __have_sigevent_t  1
00264 
00265 /* Structure to transport application-defined values with signals.  */
00266 # define __SIGEV_MAX_SIZE   64
00267 # if __WORDSIZE == 64
00268 #  define __SIGEV_PAD_SIZE  ((__SIGEV_MAX_SIZE / sizeof (int)) - 4)
00269 # else
00270 #  define __SIGEV_PAD_SIZE  ((__SIGEV_MAX_SIZE / sizeof (int)) - 3)
00271 # endif
00272 
00273 typedef struct sigevent
00274   {
00275     sigval_t sigev_value;
00276     int sigev_signo;
00277     int sigev_notify;
00278 
00279     union
00280       {
00281        int _pad[__SIGEV_PAD_SIZE];
00282 
00283        /* When SIGEV_SIGNAL and SIGEV_THREAD_ID set, LWP ID of the
00284           thread to receive the signal.  */
00285        __pid_t _tid;
00286 
00287        struct
00288          {
00289            void (*_function) (sigval_t);  /* Function to start.  */
00290            void *_attribute;                     /* Really pthread_attr_t.  */
00291          } _sigev_thread;
00292       } _sigev_un;
00293   } sigevent_t;
00294 
00295 /* POSIX names to access some of the members.  */
00296 # define sigev_notify_function   _sigev_un._sigev_thread._function
00297 # define sigev_notify_attributes _sigev_un._sigev_thread._attribute
00298 
00299 /* `sigev_notify' values.  */
00300 enum
00301 {
00302   SIGEV_SIGNAL = 0,         /* Notify via signal.  */
00303 # define SIGEV_SIGNAL       SIGEV_SIGNAL
00304   SIGEV_NONE,               /* Other notification: meaningless.  */
00305 # define SIGEV_NONE  SIGEV_NONE
00306   SIGEV_THREAD,                    /* Deliver via thread creation.  */
00307 # define SIGEV_THREAD       SIGEV_THREAD
00308 
00309   SIGEV_THREAD_ID = 4              /* Send signal to specific thread.  */
00310 #define SIGEV_THREAD_ID     SIGEV_THREAD_ID
00311 };
00312 
00313 #endif /* have _SIGNAL_H.  */