2 * Copyright (c) 2000-2006 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1982, 1986, 1989, 1991, 1993
31 * The Regents of the University of California. All rights reserved.
32 * (c) UNIX System Laboratories, Inc.
33 * All or some portions of this file are derived from material licensed
34 * to the University of California by American Telephone and Telegraph
35 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
36 * the permission of UNIX System Laboratories, Inc.
38 * Redistribution and use in source and binary forms, with or without
39 * modification, are permitted provided that the following conditions
41 * 1. Redistributions of source code must retain the above copyright
42 * notice, this list of conditions and the following disclaimer.
43 * 2. Redistributions in binary form must reproduce the above copyright
44 * notice, this list of conditions and the following disclaimer in the
45 * documentation and/or other materials provided with the distribution.
46 * 3. All advertising materials mentioning features or use of this software
47 * must display the following acknowledgement:
48 * This product includes software developed by the University of
49 * California, Berkeley and its contributors.
50 * 4. Neither the name of the University nor the names of its contributors
51 * may be used to endorse or promote products derived from this software
52 * without specific prior written permission.
54 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
55 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
56 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
57 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
58 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
59 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
60 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
61 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
62 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
63 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
66 * @(#)signal.h 8.2 (Berkeley) 1/21/94
69 #ifndef _SYS_SIGNAL_H_
70 #define _SYS_SIGNAL_H_
72 #include <sys/cdefs.h>
73 #include <sys/appleapiopts.h>
75 #define __DARWIN_NSIG 32 /* counting 0; could be 33 (mask is 1-32) */
77 #if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
78 #define NSIG __DARWIN_NSIG
81 #include <machine/signal.h> /* sigcontext; codes for SIGILL, SIGFPE */
83 #define SIGHUP 1 /* hangup */
84 #define SIGINT 2 /* interrupt */
85 #define SIGQUIT 3 /* quit */
86 #define SIGILL 4 /* illegal instruction (not reset when caught) */
87 #define SIGTRAP 5 /* trace trap (not reset when caught) */
88 #define SIGABRT 6 /* abort() */
89 #if (defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE))
90 #define SIGPOLL 7 /* pollable event ([XSR] generated, not supported) */
91 #else /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
92 #define SIGIOT SIGABRT /* compatibility */
93 #define SIGEMT 7 /* EMT instruction */
94 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
95 #define SIGFPE 8 /* floating point exception */
96 #define SIGKILL 9 /* kill (cannot be caught or ignored) */
97 #define SIGBUS 10 /* bus error */
98 #define SIGSEGV 11 /* segmentation violation */
99 #define SIGSYS 12 /* bad argument to system call */
100 #define SIGPIPE 13 /* write on a pipe with no one to read it */
101 #define SIGALRM 14 /* alarm clock */
102 #define SIGTERM 15 /* software termination signal from kill */
103 #define SIGURG 16 /* urgent condition on IO channel */
104 #define SIGSTOP 17 /* sendable stop signal not from tty */
105 #define SIGTSTP 18 /* stop signal from tty */
106 #define SIGCONT 19 /* continue a stopped process */
107 #define SIGCHLD 20 /* to parent on child stop or exit */
108 #define SIGTTIN 21 /* to readers pgrp upon background tty read */
109 #define SIGTTOU 22 /* like TTIN for output if (tp->t_local<OSTOP) */
110 #if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
111 #define SIGIO 23 /* input/output possible signal */
113 #define SIGXCPU 24 /* exceeded CPU time limit */
114 #define SIGXFSZ 25 /* exceeded file size limit */
115 #define SIGVTALRM 26 /* virtual time alarm */
116 #define SIGPROF 27 /* profiling time alarm */
117 #if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
118 #define SIGWINCH 28 /* window size changes */
119 #define SIGINFO 29 /* information request */
121 #define SIGUSR1 30 /* user defined signal 1 */
122 #define SIGUSR2 31 /* user defined signal 2 */
124 #if defined(_ANSI_SOURCE) || __DARWIN_UNIX03 || defined(__cplusplus)
126 * Language spec sez we must list exactly one parameter, even though we
127 * actually supply three. Ugh!
128 * SIG_HOLD is chosen to avoid KERN_SIG_* values in <sys/signalvar.h>
130 #define SIG_DFL (void (*)(int))0
131 #define SIG_IGN (void (*)(int))1
132 #define SIG_HOLD (void (*)(int))5
133 #define SIG_ERR ((void (*)(int))-1)
135 /* DO NOT REMOVE THE COMMENTED OUT int: fixincludes needs to see them */
136 #define SIG_DFL (void (*)(/*int*/))0
137 #define SIG_IGN (void (*)(/*int*/))1
138 #define SIG_HOLD (void (*)(/*int*/))5
139 #define SIG_ERR ((void (*)(/*int*/))-1)
143 #include <sys/_types.h>
145 #define __need_mcontext_t
146 #define __need_stack_t
147 #define __need_ucontext_t
148 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
149 #if defined(__ppc__) || defined(__ppc64__)
150 #define __need_mcontext64_t
151 #define __need_ucontext64_t
152 #endif /* __ppc__ || __ppc64__ */
153 #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */
154 #include <sys/_structs.h>
158 typedef __darwin_pid_t pid_t
;
161 #ifndef _PTHREAD_ATTR_T
162 #define _PTHREAD_ATTR_T
163 typedef __darwin_pthread_attr_t pthread_attr_t
;
168 typedef __darwin_sigset_t sigset_t
;
173 typedef __darwin_size_t
size_t;
178 typedef __darwin_uid_t uid_t
;
182 /* Members as suggested by Annex C of POSIX 1003.1b. */
187 #define SIGEV_NONE 0 /* No async notification */
188 #define SIGEV_SIGNAL 1 /* aio - completion notification */
189 #define SIGEV_THREAD 3 /* A notification function will be called to perform notification */
192 int sigev_notify
; /* Notification type */
193 int sigev_signo
; /* Signal number */
194 union sigval sigev_value
; /* Signal value */
195 void (*sigev_notify_function
)(union sigval
); /* Notification function */
196 pthread_attr_t
*sigev_notify_attributes
; /* Notification attributes */
199 #ifdef BSD_KERNEL_PRIVATE
203 int pad
; /* assumes Motorolla byte order */
206 user_addr_t sival_ptr
;
209 struct user_sigevent
{
210 int sigev_notify
; /* Notification type */
211 int sigev_signo
; /* Signal number */
212 union user_sigval sigev_value
; /* Signal value */
213 user_addr_t sigev_notify_function
; /* Notify function */
214 user_addr_t sigev_notify_attributes
; /* Notify attributes */
217 #endif /* BSD_KERNEL_PRIVATE */
219 typedef struct __siginfo
{
220 int si_signo
; /* signal number */
221 int si_errno
; /* errno association */
222 int si_code
; /* signal code */
223 pid_t si_pid
; /* sending process */
224 uid_t si_uid
; /* sender's ruid */
225 int si_status
; /* exit value */
226 void *si_addr
; /* faulting instruction */
227 union sigval si_value
; /* signal value */
228 long si_band
; /* band event for SIGPOLL */
229 unsigned long __pad
[7]; /* Reserved for Future Use */
232 #ifdef BSD_KERNEL_PRIVATE
234 typedef struct __user_siginfo
{
235 int si_signo
; /* signal number */
236 int si_errno
; /* errno association */
237 int si_code
; /* signal code */
238 pid_t si_pid
; /* sending process */
239 uid_t si_uid
; /* sender's ruid */
240 int si_status
; /* exit value */
241 user_addr_t si_addr
; /* faulting instruction (see below) */
242 union user_sigval si_value
; /* signal value */
243 user_long_t si_band
; /* band event for SIGPOLL */
244 user_ulong_t pad
[7]; /* Reserved for Future Use */
247 #endif /* BSD_KERNEL_PRIVATE */
250 * When the signal is SIGILL or SIGFPE, si_addr contains the address of
251 * the faulting instruction.
252 * When the signal is SIGSEGV or SIGBUS, si_addr contains the address of
253 * the faulting memory reference. Although for x86 there are cases of SIGSEGV
254 * for which si_addr cannot be determined and is NULL.
255 * If the signal is SIGCHLD, the si_pid field will contain the child process ID,
256 * si_status contains the exit value or signal and
257 * si_uid contains the real user ID of the process that sent the signal.
260 /* Values for si_code */
262 /* Codes for SIGILL */
263 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
264 #define ILL_NOOP 0 /* if only I knew... */
266 #define ILL_ILLOPC 1 /* [XSI] illegal opcode */
267 #define ILL_ILLTRP 2 /* [XSI] illegal trap */
268 #define ILL_PRVOPC 3 /* [XSI] privileged opcode */
269 #define ILL_ILLOPN 4 /* [XSI] illegal operand -NOTIMP */
270 #define ILL_ILLADR 5 /* [XSI] illegal addressing mode -NOTIMP */
271 #define ILL_PRVREG 6 /* [XSI] privileged register -NOTIMP */
272 #define ILL_COPROC 7 /* [XSI] coprocessor error -NOTIMP */
273 #define ILL_BADSTK 8 /* [XSI] internal stack error -NOTIMP */
275 /* Codes for SIGFPE */
276 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
277 #define FPE_NOOP 0 /* if only I knew... */
279 #define FPE_FLTDIV 1 /* [XSI] floating point divide by zero */
280 #define FPE_FLTOVF 2 /* [XSI] floating point overflow */
281 #define FPE_FLTUND 3 /* [XSI] floating point underflow */
282 #define FPE_FLTRES 4 /* [XSI] floating point inexact result */
283 #define FPE_FLTINV 5 /* [XSI] invalid floating point operation */
284 #define FPE_FLTSUB 6 /* [XSI] subscript out of range -NOTIMP */
285 #define FPE_INTDIV 7 /* [XSI] integer divide by zero -NOTIMP */
286 #define FPE_INTOVF 8 /* [XSI] integer overflow -NOTIMP */
288 /* Codes for SIGSEGV */
289 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
290 #define SEGV_NOOP 0 /* if only I knew... */
292 #define SEGV_MAPERR 1 /* [XSI] address not mapped to object */
293 #define SEGV_ACCERR 2 /* [XSI] invalid permission for mapped object */
295 /* Codes for SIGBUS */
296 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
297 #define BUS_NOOP 0 /* if only I knew... */
299 #define BUS_ADRALN 1 /* [XSI] Invalid address alignment */
300 #define BUS_ADRERR 2 /* [XSI] Nonexistent physical address -NOTIMP */
301 #define BUS_OBJERR 3 /* [XSI] Object-specific HW error - NOTIMP */
303 /* Codes for SIGTRAP */
304 #define TRAP_BRKPT 1 /* [XSI] Process breakpoint -NOTIMP */
305 #define TRAP_TRACE 2 /* [XSI] Process trace trap -NOTIMP */
307 /* Codes for SIGCHLD */
308 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
309 #define CLD_NOOP 0 /* if only I knew... */
311 #define CLD_EXITED 1 /* [XSI] child has exited */
312 #define CLD_KILLED 2 /* [XSI] terminated abnormally, no core file */
313 #define CLD_DUMPED 3 /* [XSI] terminated abnormally, core file */
314 #define CLD_TRAPPED 4 /* [XSI] traced child has trapped */
315 #define CLD_STOPPED 5 /* [XSI] child has stopped */
316 #define CLD_CONTINUED 6 /* [XSI] stopped child has continued */
318 /* Codes for SIGPOLL */
319 #define POLL_IN 1 /* [XSR] Data input available */
320 #define POLL_OUT 2 /* [XSR] Output buffers available */
321 #define POLL_MSG 3 /* [XSR] Input message available */
322 #define POLL_ERR 4 /* [XSR] I/O error */
323 #define POLL_PRI 5 /* [XSR] High priority input available */
324 #define POLL_HUP 6 /* [XSR] Device disconnected */
326 /* union for signal handlers */
327 union __sigaction_u
{
328 void (*__sa_handler
)(int);
329 void (*__sa_sigaction
)(int, struct __siginfo
*,
333 /* Signal vector template for Kernel user boundary */
335 union __sigaction_u __sigaction_u
; /* signal handler */
336 void (*sa_tramp
)(void *, int, int, siginfo_t
*, void *);
337 sigset_t sa_mask
; /* signal mask to apply */
338 int sa_flags
; /* see signal options below */
342 * Signal vector "template" used in sigaction call.
345 union __sigaction_u __sigaction_u
; /* signal handler */
346 sigset_t sa_mask
; /* signal mask to apply */
347 int sa_flags
; /* see signal options below */
350 #ifdef BSD_KERNEL_PRIVATE
351 #include <machine/types.h>
353 union __user_sigaction_u
{
354 user_addr_t __sa_handler
;
355 user_addr_t __sa_sigaction
;
358 struct user_sigaction
{
359 union __user_sigaction_u __sigaction_u
; /* signal handler */
360 sigset_t sa_mask
; /* signal mask to apply */
361 int sa_flags
; /* see signal options below */
364 struct __user_sigaction
{
365 union __user_sigaction_u __sigaction_u
; /* signal handler */
366 user_addr_t sa_tramp
; /* signal mask to apply */
367 sigset_t sa_mask
; /* signal mask to apply */
368 int sa_flags
; /* see signal options below */
374 #define SIG_DFL ((user_addr_t)0LL)
375 #define SIG_IGN ((user_addr_t)1LL)
376 #define SIG_ERR ((user_addr_t)-1LL)
378 #endif /* BSD_KERNEL_PRIVATE */
381 /* if SA_SIGINFO is set, sa_sigaction is to be used instead of sa_handler. */
382 #define sa_handler __sigaction_u.__sa_handler
383 #define sa_sigaction __sigaction_u.__sa_sigaction
385 #define SA_ONSTACK 0x0001 /* take signal on signal stack */
386 #define SA_RESTART 0x0002 /* restart system on signal return */
387 #ifdef BSD_KERNEL_PRIVATE
388 #define SA_DISABLE 0x0004 /* disable taking signals on alternate stack - for user_sigaltstack.ss_flags only */
389 #endif /* BSD_KERNEL_PRIVATE */
390 #define SA_RESETHAND 0x0004 /* reset to SIG_DFL when taking signal */
391 #define SA_NOCLDSTOP 0x0008 /* do not generate SIGCHLD on child stop */
392 #define SA_NODEFER 0x0010 /* don't mask the signal we're delivering */
393 #define SA_NOCLDWAIT 0x0020 /* don't keep zombies around */
394 #define SA_SIGINFO 0x0040 /* signal handler with SA_SIGINFO args */
395 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
396 #define SA_USERTRAMP 0x0100 /* do not bounce off kernel's sigtramp */
397 /* This will provide 64bit register set in a 32bit user address space */
398 #define SA_64REGSET 0x0200 /* signal handler with SA_SIGINFO args with 64bit regs information */
399 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
401 /* the following are the only bits we support from user space, the
402 * rest are for kernel use only.
404 #define SA_USERSPACE_MASK (SA_ONSTACK | SA_RESTART | SA_RESETHAND | SA_NOCLDSTOP | SA_NODEFER | SA_NOCLDWAIT | SA_SIGINFO)
407 * Flags for sigprocmask:
409 #define SIG_BLOCK 1 /* block specified signal set */
410 #define SIG_UNBLOCK 2 /* unblock specified signal set */
411 #define SIG_SETMASK 3 /* set specified signal set */
413 /* POSIX 1003.1b required values. */
414 #define SI_USER 0x10001 /* [CX] signal from kill() */
415 #define SI_QUEUE 0x10002 /* [CX] signal from sigqueue() */
416 #define SI_TIMER 0x10003 /* [CX] timer expiration */
417 #define SI_ASYNCIO 0x10004 /* [CX] aio request completion */
418 #define SI_MESGQ 0x10005 /* [CX] from message arrival on empty queue */
420 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
421 typedef void (*sig_t
)(int); /* type of signal function */
425 * Structure used in sigaltstack call.
427 #ifdef BSD_KERNEL_PRIVATE
429 struct user_sigaltstack
{
430 user_addr_t ss_sp
; /* signal stack base */
431 user_size_t ss_size
; /* signal stack length */
432 int ss_flags
__attribute((aligned(8))); /* SA_DISABLE and/or SA_ONSTACK */
435 #endif /* BSD_KERNEL_PRIVATE */
437 #define SS_ONSTACK 0x0001 /* take signal on signal stack */
438 #define SS_DISABLE 0x0004 /* disable taking signals on alternate stack */
439 #define MINSIGSTKSZ 32768 /* (32K)minimum allowable stack */
440 #define SIGSTKSZ 131072 /* (128K)recommended stack size */
442 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
445 * Signal vector "template" used in sigvec call.
448 void (*sv_handler
)(int); /* signal handler */
449 int sv_mask
; /* signal mask to apply */
450 int sv_flags
; /* see signal options below */
453 #define SV_ONSTACK SA_ONSTACK
454 #define SV_INTERRUPT SA_RESTART /* same bit, opposite sense */
455 #define SV_RESETHAND SA_RESETHAND
456 #define SV_NODEFER SA_NODEFER
457 #define SV_NOCLDSTOP SA_NOCLDSTOP
458 #define SV_SIGINFO SA_SIGINFO
460 #define sv_onstack sv_flags /* isn't compatibility wonderful! */
461 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
464 * Structure used in sigstack call.
467 char *ss_sp
; /* signal stack pointer */
468 int ss_onstack
; /* current status */
471 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
473 * Macro for converting signal number to a mask suitable for
476 #define sigmask(m) (1 << ((m)-1))
478 #ifdef BSD_KERNEL_PRIVATE
480 * signals delivered on a per-thread basis.
482 #define threadmask (sigmask(SIGILL)|sigmask(SIGTRAP)|\
483 sigmask(SIGIOT)|sigmask(SIGEMT)|\
484 sigmask(SIGFPE)|sigmask(SIGBUS)|\
485 sigmask(SIGSEGV)|sigmask(SIGSYS)|\
487 #endif /* BSD_KERNEL_PRIVATE */
489 #define BADSIG SIG_ERR
491 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
492 #endif /* !_ANSI_SOURCE */
495 * For historical reasons; programs expect signal's return value to be
496 * defined by <sys/signal.h>.
499 void (*signal(int, void (*)(int)))(int);
501 #endif /* !_SYS_SIGNAL_H_ */