]>
Commit | Line | Data |
---|---|---|
1c79356b | 1 | /* |
5d5c5d0d A |
2 | * Copyright (c) 2000 Apple Computer, Inc. All rights reserved. |
3 | * | |
2d21ac55 | 4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
1c79356b | 5 | * |
2d21ac55 A |
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. | |
8f6c56a5 | 14 | * |
2d21ac55 A |
15 | * Please obtain a copy of the License at |
16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. | |
17 | * | |
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 | |
8f6c56a5 A |
20 | * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
21 | * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, | |
2d21ac55 A |
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. | |
8f6c56a5 | 25 | * |
2d21ac55 | 26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
1c79356b A |
27 | */ |
28 | /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */ | |
29 | /* | |
30 | * Copyright (c) 1982, 1986, 1989, 1993, 1994 | |
31 | * The Regents of the University of California. All rights reserved. | |
32 | * | |
33 | * Redistribution and use in source and binary forms, with or without | |
34 | * modification, are permitted provided that the following conditions | |
35 | * are met: | |
36 | * 1. Redistributions of source code must retain the above copyright | |
37 | * notice, this list of conditions and the following disclaimer. | |
38 | * 2. Redistributions in binary form must reproduce the above copyright | |
39 | * notice, this list of conditions and the following disclaimer in the | |
40 | * documentation and/or other materials provided with the distribution. | |
41 | * 3. All advertising materials mentioning features or use of this software | |
42 | * must display the following acknowledgement: | |
43 | * This product includes software developed by the University of | |
44 | * California, Berkeley and its contributors. | |
45 | * 4. Neither the name of the University nor the names of its contributors | |
46 | * may be used to endorse or promote products derived from this software | |
47 | * without specific prior written permission. | |
48 | * | |
49 | * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
50 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
51 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
52 | * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
53 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
54 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
55 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
56 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
57 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
58 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
59 | * SUCH DAMAGE. | |
60 | * | |
61 | * @(#)wait.h 8.2 (Berkeley) 7/10/94 | |
62 | */ | |
63 | ||
64 | #ifndef _SYS_WAIT_H_ | |
65 | #define _SYS_WAIT_H_ | |
66 | ||
91447636 A |
67 | #include <sys/cdefs.h> |
68 | #include <sys/_types.h> | |
69 | ||
1c79356b A |
70 | /* |
71 | * This file holds definitions relevent to the wait4 system call | |
72 | * and the alternate interfaces that use it (wait, wait3, waitpid). | |
73 | */ | |
74 | ||
91447636 A |
75 | /* |
76 | * [XSI] The type idtype_t shall be defined as an enumeration type whose | |
77 | * possible values shall include at least P_ALL, P_PID, and P_PGID. | |
78 | */ | |
79 | typedef enum { | |
80 | P_ALL, | |
81 | P_PID, | |
82 | P_PGID | |
83 | } idtype_t; | |
84 | ||
85 | /* | |
86 | * [XSI] The id_t and pid_t types shall be defined as described | |
87 | * in <sys/types.h> | |
88 | */ | |
89 | #ifndef _PID_T | |
90 | typedef __darwin_pid_t pid_t; | |
91 | #define _PID_T | |
92 | #endif | |
93 | ||
94 | #ifndef _ID_T | |
95 | typedef __darwin_id_t id_t; | |
96 | #define _ID_T | |
97 | #endif | |
98 | ||
99 | /* | |
100 | * [XSI] The siginfo_t type shall be defined as described in <signal.h> | |
101 | * [XSI] The rusage structure shall be defined as described in <sys/resource.h> | |
102 | * [XSI] Inclusion of the <sys/wait.h> header may also make visible all | |
103 | * symbols from <signal.h> and <sys/resource.h> | |
104 | * | |
105 | * NOTE: This requirement is currently being satisfied by the direct | |
106 | * inclusion of <sys/signal.h> and <sys/resource.h>, below. | |
107 | * | |
108 | * Software should not depend on the exposure of anything other | |
109 | * than the types siginfo_t and struct rusage as a result of | |
110 | * this inclusion. If you depend on any types or manifest | |
111 | * values othe than siginfo_t and struct rusage from either of | |
112 | * those files, you should explicitly include them yourself, as | |
113 | * well, or in future releases your stware may not compile | |
114 | * without modification. | |
115 | */ | |
116 | #include <sys/signal.h> /* [XSI] for siginfo_t */ | |
117 | #include <sys/resource.h> /* [XSI] for struct rusage */ | |
118 | ||
119 | /* | |
120 | * Option bits for the third argument of wait4. WNOHANG causes the | |
121 | * wait to not hang if there are no stopped or terminated processes, rather | |
122 | * returning an error indication in this case (pid==0). WUNTRACED | |
123 | * indicates that the caller should receive status about untraced children | |
124 | * which stop due to signals. If children are stopped and a wait without | |
125 | * this option is done, it is as though they were still running... nothing | |
126 | * about them is returned. | |
127 | */ | |
2d21ac55 A |
128 | #define WNOHANG 0x00000001 /* [XSI] no hang in wait/no child to reap */ |
129 | #define WUNTRACED 0x00000002 /* [XSI] notify on stop, untraced child */ | |
91447636 | 130 | |
1c79356b A |
131 | /* |
132 | * Macros to test the exit status returned by wait | |
133 | * and extract the relevant values. | |
134 | */ | |
2d21ac55 | 135 | #if defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE) |
1c79356b A |
136 | #define _W_INT(i) (i) |
137 | #else | |
138 | #define _W_INT(w) (*(int *)&(w)) /* convert union wait to int */ | |
139 | #define WCOREFLAG 0200 | |
2d21ac55 | 140 | #endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */ |
1c79356b | 141 | |
91447636 | 142 | /* These macros are permited, as they are in the implementation namespace */ |
1c79356b A |
143 | #define _WSTATUS(x) (_W_INT(x) & 0177) |
144 | #define _WSTOPPED 0177 /* _WSTATUS if process is stopped */ | |
91447636 A |
145 | |
146 | /* | |
147 | * [XSI] The <sys/wait.h> header shall define the following macros for | |
148 | * analysis of process status values | |
149 | */ | |
2d21ac55 A |
150 | #if __DARWIN_UNIX03 |
151 | #define WEXITSTATUS(x) ((_W_INT(x) >> 8) & 0x000000ff) | |
152 | #else /* !__DARWIN_UNIX03 */ | |
91447636 | 153 | #define WEXITSTATUS(x) (_W_INT(x) >> 8) |
2d21ac55 A |
154 | #endif /* !__DARWIN_UNIX03 */ |
155 | /* 0x13 == SIGCONT */ | |
156 | #define WSTOPSIG(x) (_W_INT(x) >> 8) | |
157 | #define WIFCONTINUED(x) (_WSTATUS(x) == _WSTOPPED && WSTOPSIG(x) == 0x13) | |
158 | #define WIFSTOPPED(x) (_WSTATUS(x) == _WSTOPPED && WSTOPSIG(x) != 0x13) | |
91447636 A |
159 | #define WIFEXITED(x) (_WSTATUS(x) == 0) |
160 | #define WIFSIGNALED(x) (_WSTATUS(x) != _WSTOPPED && _WSTATUS(x) != 0) | |
1c79356b | 161 | #define WTERMSIG(x) (_WSTATUS(x)) |
2d21ac55 | 162 | #if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) |
1c79356b A |
163 | #define WCOREDUMP(x) (_W_INT(x) & WCOREFLAG) |
164 | ||
165 | #define W_EXITCODE(ret, sig) ((ret) << 8 | (sig)) | |
166 | #define W_STOPCODE(sig) ((sig) << 8 | _WSTOPPED) | |
2d21ac55 | 167 | #endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ |
1c79356b A |
168 | |
169 | /* | |
91447636 A |
170 | * [XSI] The following symbolic constants shall be defined as possible |
171 | * values for the fourth argument to waitid(). | |
1c79356b | 172 | */ |
91447636 A |
173 | /* WNOHANG already defined for wait4() */ |
174 | /* WUNTRACED defined for wait4() but not for waitid() */ | |
2d21ac55 A |
175 | #define WEXITED 0x00000004 /* [XSI] Processes which have exitted */ |
176 | #if __DARWIN_UNIX03 | |
91447636 | 177 | /* waitid() parameter */ |
2d21ac55 | 178 | #define WSTOPPED 0x00000008 /* [XSI] Any child stopped by signal */ |
91447636 | 179 | #endif |
2d21ac55 A |
180 | #define WCONTINUED 0x00000010 /* [XSI] Any child stopped then continued */ |
181 | #define WNOWAIT 0x00000020 /* [XSI] Leave process returned waitable */ | |
91447636 | 182 | |
1c79356b | 183 | |
2d21ac55 | 184 | #if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) |
1c79356b A |
185 | /* POSIX extensions and 4.2/4.3 compatability: */ |
186 | ||
187 | /* | |
188 | * Tokens for special values of the "pid" parameter to wait4. | |
189 | */ | |
190 | #define WAIT_ANY (-1) /* any process */ | |
191 | #define WAIT_MYPGRP 0 /* any process in my process group */ | |
192 | ||
193 | #include <machine/endian.h> | |
194 | ||
195 | /* | |
196 | * Deprecated: | |
197 | * Structure of the information in the status word returned by wait4. | |
2d21ac55 | 198 | * If w_stopval==_WSTOPPED, then the second structure describes |
1c79356b A |
199 | * the information returned, else the first. |
200 | */ | |
201 | union wait { | |
202 | int w_status; /* used in syscall */ | |
203 | /* | |
204 | * Terminated process status. | |
205 | */ | |
206 | struct { | |
91447636 | 207 | #if __DARWIN_BYTE_ORDER == __DARWIN_LITTLE_ENDIAN |
1c79356b A |
208 | unsigned int w_Termsig:7, /* termination signal */ |
209 | w_Coredump:1, /* core dump indicator */ | |
210 | w_Retcode:8, /* exit code if w_termsig==0 */ | |
211 | w_Filler:16; /* upper bits filler */ | |
212 | #endif | |
91447636 | 213 | #if __DARWIN_BYTE_ORDER == __DARWIN_BIG_ENDIAN |
1c79356b A |
214 | unsigned int w_Filler:16, /* upper bits filler */ |
215 | w_Retcode:8, /* exit code if w_termsig==0 */ | |
216 | w_Coredump:1, /* core dump indicator */ | |
217 | w_Termsig:7; /* termination signal */ | |
218 | #endif | |
219 | } w_T; | |
220 | /* | |
221 | * Stopped process status. Returned | |
222 | * only for traced children unless requested | |
223 | * with the WUNTRACED option bit. | |
224 | */ | |
225 | struct { | |
91447636 | 226 | #if __DARWIN_BYTE_ORDER == __DARWIN_LITTLE_ENDIAN |
1c79356b A |
227 | unsigned int w_Stopval:8, /* == W_STOPPED if stopped */ |
228 | w_Stopsig:8, /* signal that stopped us */ | |
229 | w_Filler:16; /* upper bits filler */ | |
230 | #endif | |
91447636 | 231 | #if __DARWIN_BYTE_ORDER == __DARWIN_BIG_ENDIAN |
1c79356b A |
232 | unsigned int w_Filler:16, /* upper bits filler */ |
233 | w_Stopsig:8, /* signal that stopped us */ | |
234 | w_Stopval:8; /* == W_STOPPED if stopped */ | |
235 | #endif | |
236 | } w_S; | |
237 | }; | |
238 | #define w_termsig w_T.w_Termsig | |
239 | #define w_coredump w_T.w_Coredump | |
240 | #define w_retcode w_T.w_Retcode | |
241 | #define w_stopval w_S.w_Stopval | |
242 | #define w_stopsig w_S.w_Stopsig | |
243 | ||
2d21ac55 A |
244 | #endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ |
245 | ||
246 | #if !(__DARWIN_UNIX03 - 0) | |
91447636 A |
247 | /* |
248 | * Stopped state value; cannot use waitid() parameter of the same name | |
249 | * in the same scope | |
250 | */ | |
1c79356b | 251 | #define WSTOPPED _WSTOPPED |
2d21ac55 | 252 | #endif /* !__DARWIN_UNIX03 */ |
1c79356b A |
253 | |
254 | #ifndef KERNEL | |
1c79356b | 255 | __BEGIN_DECLS |
2d21ac55 A |
256 | pid_t wait(int *) __DARWIN_ALIAS_C(wait); |
257 | pid_t waitpid(pid_t, int *, int) __DARWIN_ALIAS_C(waitpid); | |
91447636 | 258 | #ifndef _ANSI_SOURCE |
2d21ac55 | 259 | int waitid(idtype_t, id_t, siginfo_t *, int) __DARWIN_ALIAS_C(waitid); |
91447636 | 260 | #endif /* !_ANSI_SOURCE */ |
2d21ac55 | 261 | #if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) |
91447636 A |
262 | pid_t wait3(int *, int, struct rusage *); |
263 | pid_t wait4(pid_t, int *, int, struct rusage *); | |
2d21ac55 | 264 | #endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ |
1c79356b A |
265 | __END_DECLS |
266 | #endif | |
267 | #endif /* !_SYS_WAIT_H_ */ |