HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man2/!!!intro.2
________________________________________________________________
___ ___
w
wait(2) wait(2)
WIFEXITED(stat_val)
Evaluates to a non-zero value if status was returned for a child process that
terminated normally.
WEXITSTATUS(stat_val)
If the value of WIFEXITED(stat_val) is non-zero, this macro evalu-
ates to the low-order 8 bits of the status argument that the child process
passed to _exit() or exit(), or the value the child process returned
from main().
WIFSIGNALED(stat_val)
Evaluates to non-zero value if status was returned for a child process that
terminated due to the receipt of a signal that was not caught (see
<signal.h>).
WTERMSIG(stat_val)
If the value of WIFSIGNALED(stat_val) is non-zero, this macro
evaluates to the number of the signal that caused the termination of the
child process.
WIFSTOPPED(stat_val)
Evaluates to a non-zero value if status was returned for a child process that
is currently stopped.
WSTOPSIG(stat_val)
If the value of WIFSTOPPED(stat_val)
is non-zero, this macro evalu-
ates to the number of the signal that caused the child process to stop.
WIFCONTINUED(stat_val)
Evaluates to a non-zero value if status was returned for a child process that
has continued from a job control stop.
If the information pointed to by stat_loc was stored by a call to
waitpid() that specified the
WUN-
TRACED
flag and did not specify the WCONTINUED flag, exactly one of the macros
WIFEXITED(*stat_loc)
, WIFSIGNALED(*stat_loc), and WIFSTOPPED(*stat_loc)
will
evaluate to a non-zero value.
If the information pointed to by stat_loc was stored by a call to
waitpid() that specified the
WUN-
TRACED
and WCONTINUED flags, exactly one of the macros WIFEXITED(*stat_loc)
,
WIFSIGNALED(*stat_loc)
, WIFSTOPPED(*stat_loc), and WIFCONTINUED (*stat_loc)
will evaluate to a non-zero value.
If the information pointed to by stat_loc was stored by a call to waitpid() that did not specify the
WUN-
TRACED
or WCONTINUED flags, or by a call to the wait() function, exactly one of the macros
WIFEXITED(*stat_loc)
and WIFSIGNALED(*stat_loc) will evaluate to a non-zero value.
If the information pointed to by stat_loc was stored by a call to
waitpid() that did not specify the WUN-
TRACED
flag and specified the WCONTINUED flag, by a call to the wait() function, exactly one of the
macros WIFEXITED(*stat_loc), WIFSIGNALED(*stat_loc), and
WIFCONTINUED(*stat_loc) will evaluate to a non-zero value.
There may be additional implementation-dependent circumstances under which
wait() or waitpid()
report status. This will not occur unless the calling process or one of its child processes explicitly makes use
of a non-standard extension. In these cases the interpretation of the reported status is
implementation-dependent.
If a parent process terminates without waiting for all of its child processes to terminate, the remaining
child processes will be assigned a new parent process ID corresponding to an implementation-dependent
system process.
RETURN VALUE
If wait() or waitpid() returns because the status of a child process is available, these functions will
return a value equal to the process ID of the child process for which status is reported. If wait() or
waitpid() returns due to the delivery of a signal to the calling process, −1 will be returned and errno
will be set to EINTR.Ifwaitpid() was invoked with WNOHANG set in options, it has at least one child
process specified by pid for which status is not available, and status is not available for any process
specified by pid, 0 will be returned. Otherwise, (pid_t)−1 will be returned, and
errno will be set to indi-
cate the error.
Section 2−−450 − 2 − HP-UX Release 11i: December 2000
___
___