siginfo definitions.
[kopensolaris-gnu/glibc.git] / sysdeps / unix / sysv / linux / bits / siginfo.h
1 /* siginfo_t, sigevent and constants.  Linux version.
2    Copyright (C) 1997 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Library General Public License as
7    published by the Free Software Foundation; either version 2 of the
8    License, or (at your option) any later version.
9
10    The GNU C Library 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 GNU
13    Library General Public License for more details.
14
15    You should have received a copy of the GNU Library General Public
16    License along with the GNU C Library; see the file COPYING.LIB.  If not,
17    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18    Boston, MA 02111-1307, USA.  */
19
20 #ifndef _SIGNAL_H
21 # error "Never include this file directly.  Use <signal.h> instead"
22 #endif
23
24 #define SI_MAX_SIZE     128
25 #define SI_PAD_SIZE     ((SI_MAX_SIZE / sizeof (int)) - 3)
26
27 typedef struct siginfo
28   {
29     int si_signo;               /* Signal number.  */
30     int si_errno;               /* If non-zero, an errno value associated with
31                                    this signal, as defined in <errno.h>.  */
32     int si_code;                /* Signal code.  */
33
34     union
35       {
36         int _pad[SI_PAD_SIZE];
37
38          /* kill().  */
39         struct
40           {
41             __pid_t si_pid;     /* Sending process ID.  */
42             __uid_t si_uid;     /* Real user ID of sending process.  */
43           } _kill;
44
45         /* POSIX.1b timers.  */
46         struct
47           {
48             unsigned int _timer1;
49             unsigned int _timer2;
50           } _timer;
51
52         /* POSIX.1b signals.  */
53         struct
54           {
55             __pid_t si_pid;     /* Sending process ID.  */
56             __uid_t si_uid;     /* Real user ID of sending process.  */
57             sigval_t si_sigval; /* Signal value.  */
58           } _rt;
59
60         /* SIGCHLD.  */
61         struct
62           {
63             __pid_t si_pid;     /* Which child.  */
64             int si_status;      /* Exit value or signal.  */
65             __clock_t si_utime;
66             __clock_t si_stime;
67           } _sigchld;
68
69         /* SIGILL, SIGFPE, SIGSEGV, SIGBUS.  */
70         struct
71           {
72             void *si_addr;      /* Faulting insn/memory ref.  */
73           } _sigfault;
74
75         /* SIGPOLL.  */
76         struct
77           {
78             int si_band;        /* Band event for SIGPOLL.  */
79             int si_fd;
80           } _sigpoll;
81       } _sifields;
82   } siginfo_t;
83
84
85 /* X/Open requires some more fields with fixed names.  */
86 #define si_pid          _sifields._kill.si_pid
87 #define si_uid          _sifields._kill.si_uid
88 #define si_status       _sifields._sigchld.si_status
89 #define si_utime        _sifields._sigchld.si_utime
90 #define si_stime        _sifields._sigchld.si_stime
91 #define si_value        _sifields._rt.si_sigval
92 #define si_int          _sifields._rt.si_sigval.sival_int
93 #define si_ptr          _sifields._rt.si_sigval.sival_ptr
94 #define si_addr         _sifields._sigfault.si_addr
95 #define si_band         _sifields._sigpoll.si_band
96 #define si_fd           _sifields._sigpoll.si_fd
97
98
99 /* Values for `si_code'.  Positive values are reserved for kernel-generated
100    signals.  */
101 enum
102 {
103   SI_ASYNCIO = -4,              /* Sent by AIO completion.  */
104 #define SI_ASYNCIO      SI_ASYNCIO
105   SI_MESGQ,                     /* Sent by real time mesq state change.  */
106 #define SI_MESGQ        SI_MESGQ
107   SI_TIMER,                     /* Sent by timer expiration.  */
108 #define SI_TIMER        SI_TIMER
109   SI_QUEUE,                     /* Sent by sigqueue.  */
110 #define SI_QUEUE        SI_QUEUE
111   SI_USER                       /* Sent by kill, sigsend, raise.  */
112 #define SI_USER         SI_USER
113 };
114
115
116 /* `si_code' values for SIGILL signal.  */
117 enum
118 {
119   ILL_ILLOPC = 1,               /* Illegal opcode.  */
120 #define ILL_ILLOPC      ILL_ILLOPC
121   ILL_ILL_OPN,                  /* Illegal operand.  */
122 #define ILL_ILLOPN      ILL_ILLOPN
123   ILL_ILLADR,                   /* Illegal addressing mode.  */
124 #define ILL_ILLADR      ILL_ILLADR
125   ILL_ILLTRP,                   /* Illegal trap. */
126 #define ILL_ILLTRP      ILL_ILLTRP
127   ILL_PRVOPC,                   /* Privileged opcode.  */
128 #define ILL_PRVOPC      ILL_PRVOPC
129   ILL_PRVREG,                   /* Privileged register.  */
130 #define ILL_PRVREG      ILL_PRVREG
131   ILL_COPROC,                   /* Coprocessor error.  */
132 #define ILL_COPROC      ILL_COPROC
133   ILL_BADSTK                    /* Internal stack error.  */
134 #define ILL_BADSTK      ILL_BADSTK
135 };
136
137 /* `si_code' values for SIGFPE signal.  */
138 enum
139 {
140   FPE_INTDIV = 1,               /* Integer divide by zero.  */
141 #define FPE_INTDIV      FPE_INTDIV
142   FPE_INTOVF,                   /* Integer overflow.  */
143 #define FPE_INTOVF      FPE_INTOVF
144   FPE_FLTDIV,                   /* Floating point divide by zero.  */
145 #define FPE_FLTDIV      FPE_FLTDIV
146   FPE_FLTOVF,                   /* Floating point overflow.  */
147 #define FPE_FLTOVF      FPE_FLTOVF
148   FPE_FLTUND,                   /* Floating point underflow.  */
149 #define FPE_FLTUND      FPE_FLTUND
150   FPE_FLTRES,                   /* Floating point inexact result.  */
151 #define FPE_FLTRES      FPE_FLTRES
152   FPE_FLTINV,                   /* Floating point invalid operation.  */
153 #define FPE_FLTINV      FPE_FLTINV
154   FPE_FLTSUB                    /* Subscript out of range.  */
155 #define FPE_FLTSUB      FPE_FLTSUB
156 };
157
158 /* `si_code' values for SIGSEGV signal.  */
159 enum
160 {
161   SEGV_MAPERR = 1,              /* Address not mapped to object.  */
162 #define SEGV_MAPERR     SEGV_MAPERR
163   SEGV_ACCERR                   /* Invalid permissions for mapped object.  */
164 #define SEGV_ACCERR     SEGV_ACCERR
165 };
166
167 /* `si_code' values for SIGBUS signal.  */
168 enum
169 {
170   BUS_ADRALN = 1,               /* Invalid address alignment.  */
171 #define BUS_ADRALN      BUS_ADRALN
172   BUS_ADRERR,                   /* Non-existant physical address.  */
173 #define BUS_ADRERR      BUS_ADRERR
174   BUS_OBJERR                    /* Object specific hardware error.  */
175 #define BUS_OBJERR      BUS_OBJERR
176 };
177
178 /* `si_code' values for SIGTRAP signal.  */
179 enum
180 {
181   TRAP_BRKPT = 1,               /* Process breakpoint.  */
182 #define TRAP_BRKPT      TRAP_BRKPT
183   TRAP_TRACE                    /* Process trace trap.  */
184 #define TRAP_TRACE      TRAP_TRACE
185 };
186
187 /* `si_code' values for SIGCHLD signal.  */
188 enum
189 {
190   CLD_EXITED = 1,               /* Child has exited.  */
191 #define CLD_EXITED      CLD_EXITED
192   CLD_KILLED,                   /* Child was killed.  */
193 #define CLD_KILLED      CLD_KILLED
194   CLD_DUMPED,                   /* Child terminated abnormally.  */
195 #define CLD_DUMPED      CLD_DUMPED
196   CLD_TRAPPED,                  /* Traced child has trapped.  */
197 #define CLD_TRAPPED     CLD_TRAPPED
198   CLD_STOPPED,                  /* Child has stopped.  */
199 #define CLD_STOPPED     CLD_STOPPED
200   CLD_CONTINUED                 /* Stopped child has continued.  */
201 #define CLD_CONTINUED   CLD_CONTINUED
202 };
203
204 /* `si_code' values for SIGPOLL signal.  */
205 enum
206 {
207   POLL_IN = 1,                  /* Data input available.  */
208 #define POLL_IN         POLL_IN
209   POLL_OUT,                     /* Output buffers available.  */
210 #define POLL_OUT        POLL_OUT
211   POLL_MSG,                     /* Input message available.   */
212 #define POLL_MSG        POLL_MSG
213   POLL_ERR,                     /* I/O error.  */
214 #define POLL_ERR        POLL_ERR
215   POLL_PRI,                     /* High priority input available.  */
216 #define POLL_PRI        POLL_PRI
217   POLL_HUP                      /* Device disconnected.  */
218 #define POLL_HUP        POLL_HUP
219 };
220
221
222 /* Structure to transport application-defined values with signals.  */
223 #define SIGEV_MAX_SIZE  64
224 #define SIGEV_PAD_SIZE  ((SIGEV_MAX_SIZE / sizeof (int)) - 3)
225
226 typedef struct sigevent
227   {
228     sigval_t sigev_value;
229     int sigev_signo;
230     int sigev_notify;
231
232     union
233       {
234         int _pad[SIGEV_PAD_SIZE];
235
236         struct
237           {
238             void (*_function) __P ((sigval_t)); /* Function to start.  */
239             void *_attribute;                   /* Really pthread_attr_t.  */
240           } _sigev_thread;
241       } _sigev_un;
242   } sigevent_t;
243
244 /* POSIX names to access some of the members.  */
245 #define sigev_notify_function   _sigev_un._sigev_thread._function
246 #define sigev_notify_attributes _sigev_un._sigev_thread._attribute
247
248 /* `sigev_notify' values.  */
249 enum
250 {
251   SIGEV_SIGNAL = 0,             /* Notify via signal.  */
252 #define SIGEV_SIGNAL    SIGEV_SIGNAL
253   SIGEV_NONE,                   /* Other notification: meaningless.  */
254 #define SIGEV_NONE      SIGEV_NONE
255   SIGEV_THREAD                  /* Deliver via thread creation.  */
256 #define SIGEV_THREAD    SIGEV_THREAD
257 };