Replace FSF snail mail address with URLs.
[glibc.git] / sysdeps / unix / sysv / linux / bits / siginfo.h
blobecef39da6a749de054e33a776e68f54ebc99ddd6
1 /* siginfo_t, sigevent and constants. Linux version.
2 Copyright (C) 1997-2002, 2003, 2011 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
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 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <http://www.gnu.org/licenses/>. */
19 #if !defined _SIGNAL_H && !defined __need_siginfo_t \
20 && !defined __need_sigevent_t
21 # error "Never include this file directly. Use <signal.h> instead"
22 #endif
24 #include <bits/wordsize.h>
26 #if (!defined __have_sigval_t \
27 && (defined _SIGNAL_H || defined __need_siginfo_t \
28 || defined __need_sigevent_t))
29 # define __have_sigval_t 1
31 /* Type for data associated with a signal. */
32 typedef union sigval
34 int sival_int;
35 void *sival_ptr;
36 } sigval_t;
37 #endif
39 #if (!defined __have_siginfo_t \
40 && (defined _SIGNAL_H || defined __need_siginfo_t))
41 # define __have_siginfo_t 1
43 # define __SI_MAX_SIZE 128
44 # if __WORDSIZE == 64
45 # define __SI_PAD_SIZE ((__SI_MAX_SIZE / sizeof (int)) - 4)
46 # else
47 # define __SI_PAD_SIZE ((__SI_MAX_SIZE / sizeof (int)) - 3)
48 # endif
50 typedef struct siginfo
52 int si_signo; /* Signal number. */
53 int si_errno; /* If non-zero, an errno value associated with
54 this signal, as defined in <errno.h>. */
55 int si_code; /* Signal code. */
57 union
59 int _pad[__SI_PAD_SIZE];
61 /* kill(). */
62 struct
64 __pid_t si_pid; /* Sending process ID. */
65 __uid_t si_uid; /* Real user ID of sending process. */
66 } _kill;
68 /* POSIX.1b timers. */
69 struct
71 int si_tid; /* Timer ID. */
72 int si_overrun; /* Overrun count. */
73 sigval_t si_sigval; /* Signal value. */
74 } _timer;
76 /* POSIX.1b signals. */
77 struct
79 __pid_t si_pid; /* Sending process ID. */
80 __uid_t si_uid; /* Real user ID of sending process. */
81 sigval_t si_sigval; /* Signal value. */
82 } _rt;
84 /* SIGCHLD. */
85 struct
87 __pid_t si_pid; /* Which child. */
88 __uid_t si_uid; /* Real user ID of sending process. */
89 int si_status; /* Exit value or signal. */
90 __clock_t si_utime;
91 __clock_t si_stime;
92 } _sigchld;
94 /* SIGILL, SIGFPE, SIGSEGV, SIGBUS. */
95 struct
97 void *si_addr; /* Faulting insn/memory ref. */
98 } _sigfault;
100 /* SIGPOLL. */
101 struct
103 long int si_band; /* Band event for SIGPOLL. */
104 int si_fd;
105 } _sigpoll;
106 } _sifields;
107 } siginfo_t;
110 /* X/Open requires some more fields with fixed names. */
111 # define si_pid _sifields._kill.si_pid
112 # define si_uid _sifields._kill.si_uid
113 # define si_timerid _sifields._timer.si_tid
114 # define si_overrun _sifields._timer.si_overrun
115 # define si_status _sifields._sigchld.si_status
116 # define si_utime _sifields._sigchld.si_utime
117 # define si_stime _sifields._sigchld.si_stime
118 # define si_value _sifields._rt.si_sigval
119 # define si_int _sifields._rt.si_sigval.sival_int
120 # define si_ptr _sifields._rt.si_sigval.sival_ptr
121 # define si_addr _sifields._sigfault.si_addr
122 # define si_band _sifields._sigpoll.si_band
123 # define si_fd _sifields._sigpoll.si_fd
126 /* Values for `si_code'. Positive values are reserved for kernel-generated
127 signals. */
128 enum
130 SI_ASYNCNL = -60, /* Sent by asynch name lookup completion. */
131 # define SI_ASYNCNL SI_ASYNCNL
132 SI_TKILL = -6, /* Sent by tkill. */
133 # define SI_TKILL SI_TKILL
134 SI_SIGIO, /* Sent by queued SIGIO. */
135 # define SI_SIGIO SI_SIGIO
136 SI_ASYNCIO, /* Sent by AIO completion. */
137 # define SI_ASYNCIO SI_ASYNCIO
138 SI_MESGQ, /* Sent by real time mesq state change. */
139 # define SI_MESGQ SI_MESGQ
140 SI_TIMER, /* Sent by timer expiration. */
141 # define SI_TIMER SI_TIMER
142 SI_QUEUE, /* Sent by sigqueue. */
143 # define SI_QUEUE SI_QUEUE
144 SI_USER, /* Sent by kill, sigsend. */
145 # define SI_USER SI_USER
146 SI_KERNEL = 0x80 /* Send by kernel. */
147 #define SI_KERNEL SI_KERNEL
151 /* `si_code' values for SIGILL signal. */
152 enum
154 ILL_ILLOPC = 1, /* Illegal opcode. */
155 # define ILL_ILLOPC ILL_ILLOPC
156 ILL_ILLOPN, /* Illegal operand. */
157 # define ILL_ILLOPN ILL_ILLOPN
158 ILL_ILLADR, /* Illegal addressing mode. */
159 # define ILL_ILLADR ILL_ILLADR
160 ILL_ILLTRP, /* Illegal trap. */
161 # define ILL_ILLTRP ILL_ILLTRP
162 ILL_PRVOPC, /* Privileged opcode. */
163 # define ILL_PRVOPC ILL_PRVOPC
164 ILL_PRVREG, /* Privileged register. */
165 # define ILL_PRVREG ILL_PRVREG
166 ILL_COPROC, /* Coprocessor error. */
167 # define ILL_COPROC ILL_COPROC
168 ILL_BADSTK /* Internal stack error. */
169 # define ILL_BADSTK ILL_BADSTK
172 /* `si_code' values for SIGFPE signal. */
173 enum
175 FPE_INTDIV = 1, /* Integer divide by zero. */
176 # define FPE_INTDIV FPE_INTDIV
177 FPE_INTOVF, /* Integer overflow. */
178 # define FPE_INTOVF FPE_INTOVF
179 FPE_FLTDIV, /* Floating point divide by zero. */
180 # define FPE_FLTDIV FPE_FLTDIV
181 FPE_FLTOVF, /* Floating point overflow. */
182 # define FPE_FLTOVF FPE_FLTOVF
183 FPE_FLTUND, /* Floating point underflow. */
184 # define FPE_FLTUND FPE_FLTUND
185 FPE_FLTRES, /* Floating point inexact result. */
186 # define FPE_FLTRES FPE_FLTRES
187 FPE_FLTINV, /* Floating point invalid operation. */
188 # define FPE_FLTINV FPE_FLTINV
189 FPE_FLTSUB /* Subscript out of range. */
190 # define FPE_FLTSUB FPE_FLTSUB
193 /* `si_code' values for SIGSEGV signal. */
194 enum
196 SEGV_MAPERR = 1, /* Address not mapped to object. */
197 # define SEGV_MAPERR SEGV_MAPERR
198 SEGV_ACCERR /* Invalid permissions for mapped object. */
199 # define SEGV_ACCERR SEGV_ACCERR
202 /* `si_code' values for SIGBUS signal. */
203 enum
205 BUS_ADRALN = 1, /* Invalid address alignment. */
206 # define BUS_ADRALN BUS_ADRALN
207 BUS_ADRERR, /* Non-existant physical address. */
208 # define BUS_ADRERR BUS_ADRERR
209 BUS_OBJERR /* Object specific hardware error. */
210 # define BUS_OBJERR BUS_OBJERR
213 /* `si_code' values for SIGTRAP signal. */
214 enum
216 TRAP_BRKPT = 1, /* Process breakpoint. */
217 # define TRAP_BRKPT TRAP_BRKPT
218 TRAP_TRACE /* Process trace trap. */
219 # define TRAP_TRACE TRAP_TRACE
222 /* `si_code' values for SIGCHLD signal. */
223 enum
225 CLD_EXITED = 1, /* Child has exited. */
226 # define CLD_EXITED CLD_EXITED
227 CLD_KILLED, /* Child was killed. */
228 # define CLD_KILLED CLD_KILLED
229 CLD_DUMPED, /* Child terminated abnormally. */
230 # define CLD_DUMPED CLD_DUMPED
231 CLD_TRAPPED, /* Traced child has trapped. */
232 # define CLD_TRAPPED CLD_TRAPPED
233 CLD_STOPPED, /* Child has stopped. */
234 # define CLD_STOPPED CLD_STOPPED
235 CLD_CONTINUED /* Stopped child has continued. */
236 # define CLD_CONTINUED CLD_CONTINUED
239 /* `si_code' values for SIGPOLL signal. */
240 enum
242 POLL_IN = 1, /* Data input available. */
243 # define POLL_IN POLL_IN
244 POLL_OUT, /* Output buffers available. */
245 # define POLL_OUT POLL_OUT
246 POLL_MSG, /* Input message available. */
247 # define POLL_MSG POLL_MSG
248 POLL_ERR, /* I/O error. */
249 # define POLL_ERR POLL_ERR
250 POLL_PRI, /* High priority input available. */
251 # define POLL_PRI POLL_PRI
252 POLL_HUP /* Device disconnected. */
253 # define POLL_HUP POLL_HUP
256 # undef __need_siginfo_t
257 #endif /* !have siginfo_t && (have _SIGNAL_H || need siginfo_t). */
260 #if (defined _SIGNAL_H || defined __need_sigevent_t) \
261 && !defined __have_sigevent_t
262 # define __have_sigevent_t 1
264 /* Structure to transport application-defined values with signals. */
265 # define __SIGEV_MAX_SIZE 64
266 # if __WORDSIZE == 64
267 # define __SIGEV_PAD_SIZE ((__SIGEV_MAX_SIZE / sizeof (int)) - 4)
268 # else
269 # define __SIGEV_PAD_SIZE ((__SIGEV_MAX_SIZE / sizeof (int)) - 3)
270 # endif
272 typedef struct sigevent
274 sigval_t sigev_value;
275 int sigev_signo;
276 int sigev_notify;
278 union
280 int _pad[__SIGEV_PAD_SIZE];
282 /* When SIGEV_SIGNAL and SIGEV_THREAD_ID set, LWP ID of the
283 thread to receive the signal. */
284 __pid_t _tid;
286 struct
288 void (*_function) (sigval_t); /* Function to start. */
289 void *_attribute; /* Really pthread_attr_t. */
290 } _sigev_thread;
291 } _sigev_un;
292 } sigevent_t;
294 /* POSIX names to access some of the members. */
295 # define sigev_notify_function _sigev_un._sigev_thread._function
296 # define sigev_notify_attributes _sigev_un._sigev_thread._attribute
298 /* `sigev_notify' values. */
299 enum
301 SIGEV_SIGNAL = 0, /* Notify via signal. */
302 # define SIGEV_SIGNAL SIGEV_SIGNAL
303 SIGEV_NONE, /* Other notification: meaningless. */
304 # define SIGEV_NONE SIGEV_NONE
305 SIGEV_THREAD, /* Deliver via thread creation. */
306 # define SIGEV_THREAD SIGEV_THREAD
308 SIGEV_THREAD_ID = 4 /* Send signal to specific thread. */
309 #define SIGEV_THREAD_ID SIGEV_THREAD_ID
312 #endif /* have _SIGNAL_H. */