Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WAIT(2)			      System Calls Manual		       WAIT(2)

NAME
       wait - wait for process to terminate

SYNOPSIS
       wait(status)
       int *status;

       wait(0)

DESCRIPTION
       Wait  causes  its  caller to delay until	a signal is received or	one of
       its child processes terminates.	If any child has died since  the  last
       wait,  return is	immediate; if there are	no children, return is immedi-
       ate with	the error bit set (resp. with a	value of  -1  returned).   The
       normal  return  yields  the process ID of the terminated	child.	In the
       case of several children	several	wait calls are needed to learn of  all
       the deaths.

       If  (int)status	is  nonzero,  the high byte of the word	pointed	to re-
       ceives the low byte of the argument of exit when	the child  terminated.
       The  low	byte receives the termination status of	the process.  See sig-
       nal(2) for a list of termination	statuses (signals); 0 status indicates
       normal  termination.  A special status (0177) is	returned for a stopped
       process which has not terminated	and can	be restarted.  See  ptrace(2).
       If  the	0200 bit of the	termination status is set, a core image	of the
       process was produced by the system.

       If the parent process terminates	without	waiting	on its	children,  the
       initialization process (process ID = 1) inherits	the children.

SEE ALSO
       exit(2),	fork(2), signal(2)

DIAGNOSTICS
       Returns -1 if there are no children not previously waited for.

ASSEMBLER
       (wait = 7.)
       sys wait
       (process	ID in r0)
       (status in r1)

       The  high byte of the status is the low byte of r0 in the child at ter-
       mination.

								       WAIT(2)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS | ASSEMBLER

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=wait&sektion=2&manpath=Unix+Seventh+Edition>

home | help