- Add support for attaching alternative DLTs to an interface.
[dragonfly.git] / sys / sys / wait.h
1 /*
2  * Copyright (c) 1982, 1986, 1989, 1993, 1994
3  *      The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *      This product includes software developed by the University of
16  *      California, Berkeley and its contributors.
17  * 4. Neither the name of the University nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  *      @(#)wait.h      8.2 (Berkeley) 7/10/94
34  * $FreeBSD: src/sys/sys/wait.h,v 1.11 1999/12/29 04:24:50 peter Exp $
35  * $DragonFly: src/sys/sys/wait.h,v 1.4 2004/09/23 16:11:47 joerg Exp $
36  */
37
38 #ifndef _SYS_WAIT_H_
39 #define _SYS_WAIT_H_
40
41 /*
42  * This file holds definitions relevant to the wait4 system call
43  * and the alternate interfaces that use it (wait, wait3, waitpid).
44  */
45
46 /*
47  * Macros to test the exit status returned by wait
48  * and extract the relevant values.
49  */
50 #ifdef _POSIX_SOURCE
51 #define _W_INT(i)       (i)
52 #else
53 #define _W_INT(w)       (*(int *)&(w))  /* convert union wait to int */
54 #define WCOREFLAG       0200
55 #endif
56
57 #define _WSTATUS(x)     (_W_INT(x) & 0177)
58 #define _WSTOPPED       0177            /* _WSTATUS if process is stopped */
59 #define WIFSTOPPED(x)   (_WSTATUS(x) == _WSTOPPED)
60 #define WSTOPSIG(x)     (_W_INT(x) >> 8)
61 #define WIFSIGNALED(x)  (_WSTATUS(x) != _WSTOPPED && _WSTATUS(x) != 0)
62 #define WTERMSIG(x)     (_WSTATUS(x))
63 #define WIFEXITED(x)    (_WSTATUS(x) == 0)
64 #define WEXITSTATUS(x)  (_W_INT(x) >> 8)
65 #ifndef _POSIX_SOURCE
66 #define WCOREDUMP(x)    (_W_INT(x) & WCOREFLAG)
67
68 #define W_EXITCODE(ret, sig)    ((ret) << 8 | (sig))
69 #define W_STOPCODE(sig)         ((sig) << 8 | _WSTOPPED)
70 #endif
71
72 /*
73  * Option bits for the third argument of wait4.  WNOHANG causes the
74  * wait to not hang if there are no stopped or terminated processes, rather
75  * returning an error indication in this case (pid==0).  WUNTRACED
76  * indicates that the caller should receive status about untraced children
77  * which stop due to signals.  If children are stopped and a wait without
78  * this option is done, it is as though they were still running... nothing
79  * about them is returned.
80  */
81 #define WNOHANG         1       /* don't hang in wait */
82 #define WUNTRACED       2       /* tell about stopped, untraced children */
83 #define WLINUXCLONE     0x80000000       /* wait for kthread spawned from linux_clone */
84
85 #ifndef _POSIX_SOURCE
86 /* POSIX extensions and 4.2/4.3 compatibility: */
87
88 /*
89  * Tokens for special values of the "pid" parameter to wait4.
90  */
91 #define WAIT_ANY        (-1)    /* any process */
92 #define WAIT_MYPGRP     0       /* any process in my process group */
93
94 #include <machine/endian.h>
95
96 /*
97  * Deprecated:
98  * Structure of the information in the status word returned by wait4.
99  * If w_stopval==WSTOPPED, then the second structure describes
100  * the information returned, else the first.
101  */
102 union wait {
103         int     w_status;               /* used in syscall */
104         /*
105          * Terminated process status.
106          */
107         struct {
108 #if _BYTE_ORDER == _LITTLE_ENDIAN
109                 unsigned int    w_Termsig:7,    /* termination signal */
110                                 w_Coredump:1,   /* core dump indicator */
111                                 w_Retcode:8,    /* exit code if w_termsig==0 */
112                                 w_Filler:16;    /* upper bits filler */
113 #elif _BYTE_ORDER == _BIG_ENDIAN
114                 unsigned int    w_Filler:16,    /* upper bits filler */
115                                 w_Retcode:8,    /* exit code if w_termsig==0 */
116                                 w_Coredump:1,   /* core dump indicator */
117                                 w_Termsig:7;    /* termination signal */
118 #else
119 #error "Byte order not implemented"
120 #endif
121         } w_T;
122         /*
123          * Stopped process status.  Returned
124          * only for traced children unless requested
125          * with the WUNTRACED option bit.
126          */
127         struct {
128 #if _BYTE_ORDER == _LITTLE_ENDIAN
129                 unsigned int    w_Stopval:8,    /* == W_STOPPED if stopped */
130                                 w_Stopsig:8,    /* signal that stopped us */
131                                 w_Filler:16;    /* upper bits filler */
132 #elif _BYTE_ORDER == _BIG_ENDIAN
133                 unsigned int    w_Filler:16,    /* upper bits filler */
134                                 w_Stopsig:8,    /* signal that stopped us */
135                                 w_Stopval:8;    /* == W_STOPPED if stopped */
136 #else
137 #error "Byte order not implemented"
138 #endif
139         } w_S;
140 };
141 #define w_termsig       w_T.w_Termsig
142 #define w_coredump      w_T.w_Coredump
143 #define w_retcode       w_T.w_Retcode
144 #define w_stopval       w_S.w_Stopval
145 #define w_stopsig       w_S.w_Stopsig
146
147 #define WSTOPPED        _WSTOPPED
148 #endif /* _POSIX_SOURCE */
149
150 #ifndef _KERNEL
151 #include <sys/types.h>
152 #include <sys/cdefs.h>
153
154 __BEGIN_DECLS
155 struct rusage;  /* forward declaration */
156
157 pid_t   wait (int *);
158 pid_t   waitpid (pid_t, int *, int);
159 #ifndef _POSIX_SOURCE
160 pid_t   wait3 (int *, int, struct rusage *);
161 pid_t   wait4 (pid_t, int *, int, struct rusage *);
162 #endif
163 __END_DECLS
164 #endif
165
166 #endif