wait3(2N)                                               wait3(2N)



     NAME
          wait3 - wait for child process to stop or terminate

     SYNOPSIS
          #include <sys/time.h>

          pid = wait3(status, options, 0)
          int pid;
          union wait *status;
          int options;


     DESCRIPTION
          wait3 provides an interface for programs which must not
          block when collecting the status of child processes.  The
          status parameter is defined as above.  The options parameter
          is used to indicate the call should not block if there are
          no processes which wish to report status (WNOHANG), and/or
          that children of the current process that are stopped due to
          a SIGTTIN, SIGTTOU, SIGTSTP, or SIGSTOP signal should also
          have their status reported (WUNTRACED).

          When the WNOHANG option is specified and no processes wish
          to report status, wait3 returns a pid of 0.  The WNOHANG and
          WUNTRACED options may be combined by oring the two values.

     RETURN VALUE
          wait3 returns -1 is there are no children not previously
          waited for; 0 is returned if WNOHANG is specified and there
          are no stopped or exited children.

     SEE ALSO
          exit(2).






















     Page 1                                        (last mod. 1/14/87)