Wait for an arbitrary process.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

71 lines
1.5 KiB

.TH WAIT 1 2013-03-23 "wait4 @PACKAGE_VERSION]" "wait4 Manual"
.SH NAME
wait4 \- Wait for arbitrary processes
.SH SYNOPSIS
.SY wait4
.RB [ \-h | --help ]
.RB [ \-v | --version ]
.RB [ \-t | --timeout
.IR time ]
.IR pid ...
.YS
.SH DESCRIPTION
.PP
.B wait4
waits for the process(es) identified by the specified PID(s)
to terminate, and reports the termination status of the
process whose PID is specified last.
.SH OPTIONS
.TP
.BR -h ", " --help
Display the help message.
.TP
.BR -v ", " --version
Display the version message.
.TP
.BR -t ", " --timeout " " \fItime\fR
Aborts waiting after the specified
.I time
(in seconds).
.SH NOTES
.PP
.B wait4
depends on the
.BR netlink (7)
interface or the
.BR kevent (2)
system call to fulfill its function properly. On systems
which do not have any of these, a fallback
.BR kill (2)-based
mechanism is used, which suffers from the following
limitations: it does not allow to retrieve the termination
status, and thus
.B wait4
will always return 0; and it can miss the termination of a
process, if its PID gets reused too quickly by a new process.
.PP
When using
.BR netlink (7),
the number of processes to wait for cannot be greater than 251.
.SH REPORTING BUGS
.PP
Report bugs to
.MT @PACKAGE_BUGREPORT@
Damien Goutte-Gattat
.ME .
.SH COPYRIGHT
.ad l
.PP
Copyright \(co 2013 Damien Goutte-Gattat
.PP
This program is released under the GNU General Public License.
See the COPYING file in the source distribution or
.UR http://www.gnu.org/licenses/gpl.html
.UE .