2 * Copyright (c) 1982, 1986, 1989, 1991, 1993
3 * The Regents of the University of California. All rights reserved.
4 * (c) UNIX System Laboratories, Inc.
5 * All or some portions of this file are derived from material licensed
6 * to the University of California by American Telephone and Telegraph
7 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8 * the permission of UNIX System Laboratories, Inc.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. All advertising materials mentioning features or use of this software
19 * must display the following acknowledgement:
20 * This product includes software developed by the University of
21 * California, Berkeley and its contributors.
22 * 4. Neither the name of the University nor the names of its contributors
23 * may be used to endorse or promote products derived from this software
24 * without specific prior written permission.
26 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 * @(#)signal.h 8.4 (Berkeley) 5/4/95
39 * $FreeBSD: src/sys/sys/signal.h,v 1.23.2.2 2001/04/19 01:38:35 alfred Exp $
40 * $DragonFly: src/sys/sys/signal.h,v 1.3 2003/08/20 07:31:21 rob Exp $
43 #ifndef _SYS_SIGNAL_H_
44 #define _SYS_SIGNAL_H_
46 #include <sys/cdefs.h>
47 #include <sys/_posix.h>
53 #define _SIG_MAXSIG 128
54 #define _SIG_IDX(sig) ((sig) - 1)
55 #define _SIG_WORD(sig) (_SIG_IDX(sig) >> 5)
56 #define _SIG_BIT(sig) (1 << (_SIG_IDX(sig) & 31))
57 #define _SIG_VALID(sig) ((sig) < _SIG_MAXSIG && (sig) > 0)
60 * System defined signals.
62 #define SIGHUP 1 /* hangup */
63 #define SIGINT 2 /* interrupt */
64 #define SIGQUIT 3 /* quit */
65 #define SIGILL 4 /* illegal instr. (not reset when caught) */
67 #define SIGTRAP 5 /* trace trap (not reset when caught) */
69 #define SIGABRT 6 /* abort() */
71 #define SIGIOT SIGABRT /* compatibility */
72 #define SIGEMT 7 /* EMT instruction */
74 #define SIGFPE 8 /* floating point exception */
75 #define SIGKILL 9 /* kill (cannot be caught or ignored) */
77 #define SIGBUS 10 /* bus error */
79 #define SIGSEGV 11 /* segmentation violation */
81 #define SIGSYS 12 /* non-existent system call invoked */
83 #define SIGPIPE 13 /* write on a pipe with no one to read it */
84 #define SIGALRM 14 /* alarm clock */
85 #define SIGTERM 15 /* software termination signal from kill */
87 #define SIGURG 16 /* urgent condition on IO channel */
89 #define SIGSTOP 17 /* sendable stop signal not from tty */
90 #define SIGTSTP 18 /* stop signal from tty */
91 #define SIGCONT 19 /* continue a stopped process */
92 #define SIGCHLD 20 /* to parent on child stop or exit */
93 #define SIGTTIN 21 /* to readers pgrp upon background tty read */
94 #define SIGTTOU 22 /* like TTIN if (tp->t_local<OSTOP) */
96 #define SIGIO 23 /* input/output possible signal */
97 #define SIGXCPU 24 /* exceeded CPU time limit */
98 #define SIGXFSZ 25 /* exceeded file size limit */
99 #define SIGVTALRM 26 /* virtual time alarm */
100 #define SIGPROF 27 /* profiling time alarm */
101 #define SIGWINCH 28 /* window size changes */
102 #define SIGINFO 29 /* information request */
104 #define SIGUSR1 30 /* user defined signal 1 */
105 #define SIGUSR2 31 /* user defined signal 2 */
108 * Type of a signal handling function.
110 * Language spec sez signal handlers take exactly one arg, even though we
111 * actually supply three. Ugh!
113 * We don't try to hide the difference by leaving out the args because
114 * that would cause warnings about conformant programs. Nonconformant
115 * programs can avoid the warnings by casting to (__sighandler_t *) or
116 * sig_t before calling signal() or assigning to sa_handler or sv_handler.
118 * The kernel should reverse the cast before calling the function. It
119 * has no way to do this, but on most machines 1-arg and 3-arg functions
120 * have the same calling protocol so there is no problem in practice.
121 * A bit in sa_flags could be used to specify the number of args.
123 typedef void __sighandler_t (int);
125 #define SIG_DFL ((__sighandler_t *)0)
126 #define SIG_IGN ((__sighandler_t *)1)
127 #define SIG_ERR ((__sighandler_t *)-1)
129 #if defined(_P1003_1B_VISIBLE) || defined(_KERNEL)
131 /* Members as suggested by Annex C of POSIX 1003.1b. */
137 int sigev_notify; /* Notification type */
139 int __sigev_signo; /* Signal number */
140 int __sigev_notify_kqueue;
142 union sigval sigev_value; /* Signal value */
144 #define sigev_signo __sigev_u.__sigev_signo
145 #define sigev_notify_kqueue __sigev_u.__sigev_notify_kqueue
147 #define SIGEV_NONE 0 /* No async notification */
148 #define SIGEV_SIGNAL 1 /* Generate a queued signal */
149 #define SIGEV_KEVENT 3 /* Generate a kevent */
151 typedef struct __siginfo {
152 int si_signo; /* signal number */
153 int si_errno; /* errno association */
155 * Cause of signal, one of the SI_ macros or signal-specific
156 * values, i.e. one of the FPE_... values for SIGFPE. This
157 * value is equivalent to the second argument to an old-style
158 * FreeBSD signal handler.
160 int si_code; /* signal code */
161 int si_pid; /* sending process */
162 unsigned int si_uid; /* sender's ruid */
163 int si_status; /* exit value */
164 void *si_addr; /* faulting instruction */
165 union sigval si_value; /* signal value */
166 long si_band; /* band event for SIGPOLL */
167 int __spare__[7]; /* gimme some slack */
169 #endif /* _P1003_1B_VISIBLE */
171 typedef struct __sigset {
172 unsigned int __bits[_SIG_WORDS];
176 * XXX - there are some nasty dependencies on include file order. Now that
177 * sigset_t has been defined we can include the MD header.
179 #include <machine/signal.h> /* sig_atomic_t; trap codes; sigcontext */
181 #if !defined(_ANSI_SOURCE)
186 * Signal vector "template" used in sigaction call.
190 void (*__sa_handler) (int);
191 void (*__sa_sigaction) (int, struct __siginfo *,
193 } __sigaction_u; /* signal handler */
194 int sa_flags; /* see signal options below */
195 sigset_t sa_mask; /* signal mask to apply */
198 /* if SA_SIGINFO is set, sa_sigaction is to be used instead of sa_handler. */
199 #define sa_handler __sigaction_u.__sa_handler
201 #define SA_NOCLDSTOP 0x0008 /* do not generate SIGCHLD on child stop */
203 #if !defined(_POSIX_SOURCE)
205 #define sa_sigaction __sigaction_u.__sa_sigaction
207 #define SA_ONSTACK 0x0001 /* take signal on signal stack */
208 #define SA_RESTART 0x0002 /* restart system call on signal return */
209 #define SA_RESETHAND 0x0004 /* reset to SIG_DFL when taking signal */
210 #define SA_NODEFER 0x0010 /* don't mask the signal we're delivering */
211 #define SA_NOCLDWAIT 0x0020 /* don't keep zombies around */
212 #define SA_SIGINFO 0x0040 /* signal handler with SA_SIGINFO args */
214 #define SA_USERTRAMP 0x0100 /* do not bounce off kernel's sigtramp */
217 #define NSIG 32 /* number of old signals (counting 0) */
219 /* POSIX 1003.1b required values. */
220 #define SI_USER 0x10001
221 #define SI_QUEUE 0x10002
222 #define SI_TIMER 0x10003
223 #define SI_ASYNCIO 0x10004
224 #define SI_MESGQ 0x10005
226 /* Additional FreeBSD values. */
227 #define SI_UNDEFINED 0
229 typedef void __siginfohandler_t (int, struct __siginfo *, void *);
231 typedef __sighandler_t *sig_t; /* type of pointer to a signal function */
234 typedef _BSD_SIZE_T_ size_t;
239 * Structure used in sigaltstack call.
241 typedef struct sigaltstack {
242 char *ss_sp; /* signal stack base */
243 size_t ss_size; /* signal stack length */
244 int ss_flags; /* SS_DISABLE and/or SS_ONSTACK */
247 #define SS_ONSTACK 0x0001 /* take signal on alternate stack */
248 #define SS_DISABLE 0x0004 /* disable taking signals on alternate stack */
249 #define MINSIGSTKSZ 8192 /* minimum allowable stack */
250 #define SIGSTKSZ (MINSIGSTKSZ + 32768) /* recommended stack size */
252 /* Have enough typedefs for this now. XXX */
253 #include <sys/ucontext.h>
257 * Signal vector "template" used in sigvec call.
260 __sighandler_t *sv_handler; /* signal handler */
261 int sv_mask; /* signal mask to apply */
262 int sv_flags; /* see signal options below */
265 #define SV_ONSTACK SA_ONSTACK
266 #define SV_INTERRUPT SA_RESTART /* same bit, opposite sense */
267 #define SV_RESETHAND SA_RESETHAND
268 #define SV_NODEFER SA_NODEFER
269 #define SV_NOCLDSTOP SA_NOCLDSTOP
270 #define SV_SIGINFO SA_SIGINFO
271 #define sv_onstack sv_flags /* isn't compatibility wonderful! */
274 * Structure used in sigstack call.
277 char *ss_sp; /* signal stack pointer */
278 int ss_onstack; /* current status */
282 * Macro for converting signal number to a mask suitable for
285 #define sigmask(m) (1 << ((m)-1))
287 #define BADSIG SIG_ERR
289 #endif /* !_POSIX_SOURCE */
292 * Flags for sigprocmask:
294 #define SIG_BLOCK 1 /* block specified signal set */
295 #define SIG_UNBLOCK 2 /* unblock specified signal set */
296 #define SIG_SETMASK 3 /* set specified signal set */
298 #endif /* !_ANSI_SOURCE */
301 * For historical reasons; programs expect signal's return value to be
302 * defined by <sys/signal.h>.
305 __sighandler_t *signal (int, __sighandler_t *);
308 #endif /* !_SYS_SIGNAL_H_ */