177 lines
6.1 KiB
C
177 lines
6.1 KiB
C
/* Copyright (C) 1991, 92, 93, 94, 96, 97, 98 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 <sys/wait.h>
|
|
*/
|
|
|
|
#ifndef _SYS_WAIT_H
|
|
#define _SYS_WAIT_H 1
|
|
|
|
#include <features.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
#include <bits/types.h>
|
|
|
|
#if defined __USE_XOPEN && !defined pid_t
|
|
typedef __pid_t pid_t;
|
|
# define pid_t pid_t
|
|
#endif
|
|
|
|
/* This will define the `W*' macros for the flag
|
|
bits to `waitpid', `wait3', and `wait4'. */
|
|
#include <bits/waitflags.h>
|
|
|
|
#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. */
|
|
|
|
# if defined __GNUC__ && !defined __cplusplus
|
|
# 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'. The funky union
|
|
causes redeclarations with ether `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 || defined __cplusplus
|
|
# 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 <bits/waitstatus.h>
|
|
|
|
#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
|
|
|
|
/* The following values are used by the `waitid' function. */
|
|
#if defined __USE_SVID || defined __USE_XOPEN
|
|
typedef enum
|
|
{
|
|
P_ALL, /* Wait for any child. */
|
|
P_PID, /* Wait for specified process. */
|
|
P_PGID /* Wait for members of process group. */
|
|
} idtype_t;
|
|
#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));
|
|
|
|
#if defined __USE_SVID || defined __USE_XOPEN
|
|
# define __need_siginfo_t
|
|
# include <bits/siginfo.h>
|
|
/* Wait for a childing matching IDTYPE and ID to change the status and
|
|
place appropriate information in *INFOP.
|
|
If IDTYPE is P_PID, match any process whose process ID is ID.
|
|
If IDTYPE is P_PGID, match any process whose process group is ID.
|
|
If IDTYPE is P_ALL, match any process.
|
|
If the WNOHANG bit is set in OPTIONS, and that child
|
|
is not already dead, clear *INFOP and return 0. If successful, store
|
|
exit code and status in *INFOP. */
|
|
extern int waitid __P ((idtype_t __idtype, __id_t __id, siginfo_t *__infop,
|
|
int __options));
|
|
#endif
|
|
|
|
#if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
|
|
/* This being here makes the prototypes valid whether or not
|
|
we have already included <sys/resource.h> 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));
|
|
#endif
|
|
|
|
#ifdef __USE_BSD
|
|
/* This being here makes the prototypes valid whether or not
|
|
we have already included <sys/resource.h> 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));
|
|
#endif /* Use BSD. */
|
|
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* sys/wait.h */
|