1/* 2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved. 3 * 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ 5 * 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. 14 * 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 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. 25 * 26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ 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 67#include <sys/cdefs.h> 68#include <sys/_types.h> 69 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 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 */ 128#define WNOHANG 0x00000001 /* [XSI] no hang in wait/no child to reap */ 129#define WUNTRACED 0x00000002 /* [XSI] notify on stop, untraced child */ 130 131/* 132 * Macros to test the exit status returned by wait 133 * and extract the relevant values. 134 */ 135#if defined(_POSIX_C_SOURCE) && !defined(_DARWIN_C_SOURCE) 136#define _W_INT(i) (i) 137#else 138#define _W_INT(w) (*(int *)&(w)) /* convert union wait to int */ 139#define WCOREFLAG 0200 140#endif /* (_POSIX_C_SOURCE && !_DARWIN_C_SOURCE) */ 141 142/* These macros are permited, as they are in the implementation namespace */ 143#define _WSTATUS(x) (_W_INT(x) & 0177) 144#define _WSTOPPED 0177 /* _WSTATUS if process is stopped */ 145 146/* 147 * [XSI] The <sys/wait.h> header shall define the following macros for 148 * analysis of process status values 149 */ 150#if __DARWIN_UNIX03 151#define WEXITSTATUS(x) ((_W_INT(x) >> 8) & 0x000000ff) 152#else /* !__DARWIN_UNIX03 */ 153#define WEXITSTATUS(x) (_W_INT(x) >> 8) 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) 159#define WIFEXITED(x) (_WSTATUS(x) == 0) 160#define WIFSIGNALED(x) (_WSTATUS(x) != _WSTOPPED && _WSTATUS(x) != 0) 161#define WTERMSIG(x) (_WSTATUS(x)) 162#if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 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) 167#endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ 168 169/* 170 * [XSI] The following symbolic constants shall be defined as possible 171 * values for the fourth argument to waitid(). 172 */ 173/* WNOHANG already defined for wait4() */ 174/* WUNTRACED defined for wait4() but not for waitid() */ 175#define WEXITED 0x00000004 /* [XSI] Processes which have exitted */ 176#if __DARWIN_UNIX03 177/* waitid() parameter */ 178#define WSTOPPED 0x00000008 /* [XSI] Any child stopped by signal */ 179#endif 180#define WCONTINUED 0x00000010 /* [XSI] Any child stopped then continued */ 181#define WNOWAIT 0x00000020 /* [XSI] Leave process returned waitable */ 182 183 184#if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 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. 198 * If w_stopval==_WSTOPPED, then the second structure describes 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 { 207#if __DARWIN_BYTE_ORDER == __DARWIN_LITTLE_ENDIAN 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 213#if __DARWIN_BYTE_ORDER == __DARWIN_BIG_ENDIAN 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 { 226#if __DARWIN_BYTE_ORDER == __DARWIN_LITTLE_ENDIAN 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 231#if __DARWIN_BYTE_ORDER == __DARWIN_BIG_ENDIAN 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 244#endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ 245 246#if !(__DARWIN_UNIX03 - 0) 247/* 248 * Stopped state value; cannot use waitid() parameter of the same name 249 * in the same scope 250 */ 251#define WSTOPPED _WSTOPPED 252#endif /* !__DARWIN_UNIX03 */ 253 254#ifndef KERNEL 255__BEGIN_DECLS 256pid_t wait(int *) __DARWIN_ALIAS_C(wait); 257pid_t waitpid(pid_t, int *, int) __DARWIN_ALIAS_C(waitpid); 258#ifndef _ANSI_SOURCE 259int waitid(idtype_t, id_t, siginfo_t *, int) __DARWIN_ALIAS_C(waitid); 260#endif /* !_ANSI_SOURCE */ 261#if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 262pid_t wait3(int *, int, struct rusage *); 263pid_t wait4(pid_t, int *, int, struct rusage *); 264#endif /* (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ 265__END_DECLS 266#endif 267#endif /* !_SYS_WAIT_H_ */ 268