wait(3)                C Library Functions                wait(3)



NAME
     wait - check child process status

SYNTAX
     #include <wait.h>

     int wait_nohang(&wstat);
     int wait_stop(&wstat);
     int wait_stopnohang(&wstat);
     int wait_pid(&wstat,pid);

     int wait_exitcode(wstat);
     int wait_crashed(wstat);
     int wait_stopped(wstat);
     int wait_stopsig(wstat);

     int pid;
     int wstat;

DESCRIPTION
     wait_nohang  looks  for  zombies  (child processes that have
     exited).  If it sees a zombie,  it  eliminates  the  zombie,
     puts  the  zombie's  exit status into wstat, and returns the
     zombie's  process  ID.   If  there  are   several   zombies,
     wait_nohang  picks  one.   If there are children but no zom-
     bies, wait_nohang returns 0.   If  there  are  no  children,
     wait_nohang returns -1, setting errno appropriately.

     wait_stopnohang is similar to wait_nohang, but it also looks
     for children that have stopped.

     wait_stop is similar to wait_stopnohang, but  if  there  are
     children  it  will  pause waiting for one of them to stop or
     exit.

     wait_pid waits for child process pid to exit.  It eliminates
     any  zombie  that  shows  up in the meantime, discarding the
     exit status.

     wait_stop and wait_pid retry upon error_intr.

STATUS PARSING
     If the child stopped, wait_stopped is nonzero;  wait_stopsig
     is the signal that caused the child to stop.

     If  the  child  exited  by  crashing,  wait_stopped is zero;
     wait_crashed is nonzero.

     If  the  child  exited  normally,  wait_stopped   is   zero;
     wait_crashed  is zero; and wait_exitcode is the child's exit
     code.




SunOS 5.5                 Last change:                          1






wait(3)                C Library Functions                wait(3)



SEE ALSO
     wait(2), error(3)