Return to wait3.2j CVS log

Up to [Research Unix] / researchv10dc / man / manb

Annotation of researchv10dc/man/manb/wait3.2j, revision 1.1.1.1

1.1       root        1: .TH WAIT3 2J
                      2: .UC 4
                      3: .SH NAME
                      4: wait3 \- wait for process to terminate
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B "#include <wait.h>"
                      8: .B "#include <sys/vtimes.h>"
                      9: .PP
                     10: .B wait3(status, options, vtimep)
                     11: .B union wait status;
                     12: .B int options;
                     13: .B struct vtimes *vtimep;
                     14: .PP
                     15: .B cc ... \-ljobs
                     16: .fi
                     17: .SH DESCRIPTION
                     18: The
                     19: .I status
                     20: and
                     21: .I option
                     22: words are described by definitions and macros in the file
                     23: <wait.h>; the union and its bitfield definitions and associated
                     24: macros given there provide
                     25: convenient and mnemonic access to the word of status returned by a
                     26: .I wait3
                     27: call.
                     28: See this file for more information.
                     29: .PP
                     30: There are two
                     31: .I options,
                     32: which may be combined by
                     33: .IR or ing
                     34: them together.
                     35: The first is WNOHANG which causes the
                     36: .I wait3
                     37: to not hang if there are no
                     38: processes which wish to report status, rather returning a pid of 0 in this
                     39: case as the result of the
                     40: .I wait3.
                     41: The second option is WUNTRACED which causes
                     42: .I wait3
                     43: to return information when children of the current process which are
                     44: stopped but not traced (with
                     45: .IR ptrace (2))
                     46: because they received a SIGTTIN, SIGTTOU, SIGTSTP or SIGSTOP signal.
                     47: See
                     48: .IR sigsys (2))
                     49: for a description of these signals.
                     50: .PP
                     51: The
                     52: .I vtimep
                     53: pointer is an optional structure where a
                     54: .I vtimes
                     55: structure is returned describing the resources used by the terminated
                     56: process and all its children.  This may be given as \*(lq0\*(rq if the
                     57: information is not desired.  Currently this information is not available
                     58: for stopped processes.
                     59: .SH "SEE ALSO"
                     60: wait(2), exit(2), fork(2), sigsys(2)
                     61: .SH DIAGNOSTICS
                     62: Returns
                     63: \-1 if there are no children not previously waited for, or 0 if the WNOHANG
                     64: option is given and there are no stopped or exited children.
                     65: .SH BUGS
                     66: This call is peculiar to this version of UNIX.
                     67: The options and specifications of this system call and even the call itself
                     68: are subject to change.  It may be replaced by other facilities in future
                     69: versions of the system.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.