Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

exit(2)

wait(2)

waitpid(2)

exit(3C)

wstat(5)

NAME

wstat − wait status

SYNOPSIS

#include <sys/wait.h>

DESCRIPTION

When a process waits for status from its children via either the wait or waitpid function, the status returned may be evaluated with the following macros, defined in sys/wait.h. These macros evaluate to integral expressions.  The stat argument to these macros is the integer value returned from wait or waitpid. 

WIFEXITED(stat) Evaluates to a non-zero value if status was returned for a child process that terminated normally. 

WEXITSTATUS(stat)
If the value of WIFEXITED(stat) is non-zero, this macro evaluates to the exit code that the child process passed to _exit() (see exit(2)) or exit(3C), or the value that the child process returned from main. 

WIFSIGNALED(stat)
Evaluates to a non-zero value if status was returned for a child process that terminated due to the receipt of a signal.

WTERMSIG(stat) If the value of WIFSIGNALED(stat) is non-zero, this macro evaluates to the number of the signal that caused the termination of the child process. 

WIFSTOPPED(stat)
Evaluates to a non-zero value if status was returned for a child process that is currently stopped.

WSTOPSIG(stat) If the value of WIFSTOPPED(stat) is non-zero, this macro evaluates to the number of the signal that caused the child process to stop. 

WIFCONTINUED(stat)
Evaluates to a non-zero value if status was returned for a child process that has continued.

WCOREDUMP(stat)
If the value of WIFSIGNALED (stat) is non-zero, this macro evaluates to a non-zero value if a core image of the terminated child was created. 

SEE ALSO

exit(2), wait(2), waitpid(2), exit(3C)

SunOS 5.1/SPARC  —  Last change: 10 Sep 1991

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026