]> git.saurik.com Git - apple/xnu.git/blame - bsd/sys/wait.h
xnu-1228.tar.gz
[apple/xnu.git] / bsd / sys / wait.h
CommitLineData
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 */
79typedef 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
90typedef __darwin_pid_t pid_t;
91#define _PID_T
92#endif
93
94#ifndef _ID_T
95typedef __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 */
201union 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
256pid_t wait(int *) __DARWIN_ALIAS_C(wait);
257pid_t waitpid(pid_t, int *, int) __DARWIN_ALIAS_C(waitpid);
91447636 258#ifndef _ANSI_SOURCE
2d21ac55 259int 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
262pid_t wait3(int *, int, struct rusage *);
263pid_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_ */