posix/waitpid.c

   1 /* Copyright (C) 1991-2023 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, see
  16    <https://www.gnu.org/licenses/>.  */
  17
  18 #include <errno.h>
  19 #include <stdlib.h>
  20 #include <sys/wait.h>
  21
  22
  23 /* Wait for a child matching PID to die.
  24    If PID is greater than 0, match any process whose process ID is PID.
  25    If PID is (pid_t) -1, match any process.
  26    If PID is (pid_t) 0, match any process with the
  27    same process group as the current process.
  28    If PID is less than -1, match any process whose
  29    process group is the absolute value of PID.
  30    If the WNOHANG bit is set in OPTIONS, and that child
  31    is not already dead, return (pid_t) 0.  If successful,
  32    return PID and store the dead child's status in STAT_LOC.
  33    Return (pid_t) -1 for errors.  If the WUNTRACED bit is set in OPTIONS,
  34    return status for stopped children; otherwise don't.  */
  35 pid_t
  36 __waitpid (pid_t pid, int *stat_loc, int options)
  37 {
  38   return __wait4 (pid, stat_loc, options, NULL);
  39 }
  40 libc_hidden_def (__waitpid)
  41 weak_alias (__waitpid, waitpid)