wait3(2N)                                               wait3(2N)



NAME
     wait3 - wait for child process to stop or terminate

SYNOPSIS
     #include <sys/wait.h>

     int wait3 (status, options, 0)
     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 that the call should not block if there
     are no processes which wish to report status (WNOHANG).  In
     addition, it indicates that any 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.

     The declaration of union wait is found in <sys/wait.h>.  The
     third argument, 0, is a placeholder.  The ``normal case'' is
     the same as wait(2).

STATUS MESSAGES AND VALUES
     The wait3 command returns -1 if 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), wait(2)



















January 1992                                                    1