/* Copyright (C) 1991, 92, 93, 94, 96 Free Software Foundation, Inc. This file is part of the GNU C Library. The GNU C Library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. The GNU C Library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with the GNU C Library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /* * POSIX Standard: 3.2.1 Wait for Process Termination */ #ifndef _SYS_WAIT_H #define _SYS_WAIT_H 1 #include __BEGIN_DECLS #include /* This will define the `W*' macros for the flag bits to `waitpid', `wait3', and `wait4'. */ #include #ifdef __USE_BSD /* Lots of hair to allow traditional BSD use of `union wait' as well as POSIX.1 use of `int' for the status word. */ #ifdef __GNUC__ #define __WAIT_INT(status) \ (__extension__ ({ union { __typeof(status) __in; int __i; } __u; \ __u.__in = (status); __u.__i; })) #else #define __WAIT_INT(status) (*(int *) &(status)) #endif /* This is the type of the argument to `wait'. NOTE: Since this functionality is volatile, I'm disabling the use of it for now. With GCC 2.6.1 and later, the funky union causes redeclarations with either `int *' or `union wait *' to be allowed without complaint. __WAIT_STATUS_DEFN is the type used in the actual function definitions. */ #if (!defined (__GNUC__) || __GNUC__ < 2 || \ /*(__GNUC__ == 2 && __GNUC_MINOR__ < 6)*/ 1) #define __WAIT_STATUS __ptr_t #define __WAIT_STATUS_DEFN __ptr_t #else /* This works in GCC 2.6.1 and later. */ typedef union { union wait *__uptr; int *__iptr; } __WAIT_STATUS __attribute__ ((transparent_union)); #define __WAIT_STATUS_DEFN int * #endif #else /* Don't use BSD. */ #define __WAIT_INT(status) (status) #define __WAIT_STATUS int * #define __WAIT_STATUS_DEFN int * #endif /* Use BSD. */ /* This will define all the `__W*' macros. */ #include #define WEXITSTATUS(status) __WEXITSTATUS(__WAIT_INT(status)) #define WTERMSIG(status) __WTERMSIG(__WAIT_INT(status)) #define WSTOPSIG(status) __WSTOPSIG(__WAIT_INT(status)) #define WIFEXITED(status) __WIFEXITED(__WAIT_INT(status)) #define WIFSIGNALED(status) __WIFSIGNALED(__WAIT_INT(status)) #define WIFSTOPPED(status) __WIFSTOPPED(__WAIT_INT(status)) #ifdef __USE_BSD #define WCOREFLAG __WCOREFLAG #define WCOREDUMP(status) __WCOREDUMP(__WAIT_INT(status)) #define W_EXITCODE(ret, sig) __W_EXITCODE(ret, sig) #define W_STOPCODE(sig) __W_STOPCODE(sig) #endif /* Wait for a child to die. When one does, put its status in *STAT_LOC and return its process ID. For errors, return (pid_t) -1. */ extern __pid_t __wait __P ((__WAIT_STATUS __stat_loc)); extern __pid_t wait __P ((__WAIT_STATUS __stat_loc)); #ifdef __USE_BSD /* Special values for the PID argument to `waitpid' and `wait4'. */ #define WAIT_ANY (-1) /* Any process. */ #define WAIT_MYPGRP 0 /* Any process in my process group. */ #endif /* Wait for a child matching PID to die. If PID is greater than 0, match any process whose process ID is PID. If PID is (pid_t) -1, match any process. If PID is (pid_t) 0, match any process with the same process group as the current process. If PID is less than -1, match any process whose process group is the absolute value of PID. If the WNOHANG bit is set in OPTIONS, and that child is not already dead, return (pid_t) 0. If successful, return PID and store the dead child's status in STAT_LOC. Return (pid_t) -1 for errors. If the WUNTRACED bit is set in OPTIONS, return status for stopped children; otherwise don't. */ extern __pid_t __waitpid __P ((__pid_t __pid, int *__stat_loc, int __options)); extern __pid_t waitpid __P ((__pid_t __pid, int *__stat_loc, int __options)); #if defined(__USE_BSD) || defined(__USE_XOPEN_EXTENDED) /* This being here makes the prototypes valid whether or not we have already included to define `struct rusage'. */ struct rusage; /* Wait for a child to exit. When one does, put its status in *STAT_LOC and return its process ID. For errors return (pid_t) -1. If USAGE is not nil, store information about the child's resource usage there. If the WUNTRACED bit is set in OPTIONS, return status for stopped children; otherwise don't. */ extern __pid_t __wait3 __P ((__WAIT_STATUS __stat_loc, int __options, struct rusage * __usage)); extern __pid_t wait3 __P ((__WAIT_STATUS __stat_loc, int __options, struct rusage * __usage)); #endif #ifdef __USE_BSD /* This being here makes the prototypes valid whether or not we have already included to define `struct rusage'. */ struct rusage; /* PID is like waitpid. Other args are like wait3. */ extern __pid_t __wait4 __P ((__pid_t __pid, __WAIT_STATUS __stat_loc, int __options, struct rusage *__usage)); extern __pid_t wait4 __P ((__pid_t __pid, __WAIT_STATUS __stat_loc, int __options, struct rusage *__usage)); #endif /* Use BSD. */ __END_DECLS #endif /* sys/wait.h */