United States-English |
|
|
HP-UX Reference > Wwait3(2)HP-UX 11i Version 3: February 2007 |
|
NAMEwait3(), wait4() — wait for child process to change state SYNOPSIS
#include <sys/wait.h> pid_t wait3 (int *stat_loc, int options, struct rusage *resource_usage); pid_t wait4 (pid_t pid, int *stat_loc, int options, struct rusage *resource_usage); DESCRIPTIONThe wait3() and wait4() functions allow the calling process to obtain various status information for a caller's child process based on the options specified. If status information is available for two or more child processes, the order of which process to report status on is not defined. The wait4() function is similar to wait3(), except that wait4() waits for a specific child as indicated by the pid parameter. Note that the following call wait3(stat_loc, options, resource_usage); is equivalent to the call: waitpid((pid_t)-1, stat_loc, options); Note that the following call wait4(pid, stat_loc, options, resource_usage); is equivalent to the call: waitpid(pid, stat_loc, options); In both of the previous prototypes, on successful completion, if the resource_usage argument to wait3() or wait4() is not a null pointer, the rusage structure that the resource_usage argument points to is filled in for the child process identified by the return value. The pid argument specifies a child process for which status is requested. The following rules define which status information is returned:
The stat_loc argument is the address where status about the specified child process is placed. The options argument is constructed from the bitwise-inclusive OR of zero or more of the following flags defined in the <sys/wait.h> header file:
The resource_usage argument points to the resource utilization structure. APPLICATION USAGEThreads ConsiderationsIn a multi-threaded application, only the calling thread is suspended by wait3() and wait4(). The wait3() and wait4() functions will not return until all threads in the process have reached the desired state. For example, wait3() and wait4() will not return until all threads have terminated. If the WUNTRACED or WCONTINUED options are specified, wait3() and wait4() will not return until all threads have stopped or continued respectively. RETURN VALUEIf wait3(), wait4(), or waitpid() returns because the status of a child process is available, the return value is the process ID of that child process. If wait3(), wait4(), or waitpid() returns due to the receipt of a signal, the return value receives a -1 and errno is set to EINTR. If wait3() or wait4() was called with the WNOHANG options argument where status is not available for any process specified by the pid argument, 0 will be returned. Otherwise, (pid_t) -1 will be returned and errno will be set to indicate the error. ERRORSIf wait3() or wait4() fails, errno is set to one of the following values:
WARNINGSThe behavior of wait3() and wait4() is affected if the SIGCLD signal is set to SIG_IGN. See the WARNINGS section of signal(5). Signal handlers that cause system calls to be restarted can affect the EINTR condition described above (see bsdproc(3C) and sigaction(2)). |
Printable version | ||
|