|
|
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.