2015-03-04 19:36:12 +03:00
|
|
|
.\" $NetBSD: pwait.1,v 1.4 2015/03/04 16:36:12 christos Exp $
|
2015-03-03 00:43:39 +03:00
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 2004-2009, Jilles Tjoelker
|
|
|
|
|
.\" All rights reserved.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with
|
|
|
|
|
.\" or without modification, are permitted provided that the
|
|
|
|
|
.\" following conditions are met:
|
|
|
|
|
.\"
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above
|
|
|
|
|
.\" copyright notice, this list of conditions and the
|
|
|
|
|
.\" following disclaimer.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the
|
|
|
|
|
.\" above copyright notice, this list of conditions and
|
|
|
|
|
.\" the following disclaimer in the documentation and/or
|
|
|
|
|
.\" other materials provided with the distribution.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
|
|
|
|
|
.\" CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
|
|
|
|
|
.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
|
|
|
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
|
|
|
|
|
.\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
|
|
|
.\" COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY
|
|
|
|
|
.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
|
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
|
|
.\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
|
|
|
|
|
.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
|
|
|
.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
|
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
|
|
|
.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
|
|
|
|
|
.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
|
|
|
|
|
.\" OF SUCH DAMAGE.
|
|
|
|
|
.\"
|
|
|
|
|
.\" $FreeBSD: head/bin/pwait/pwait.1 233648 2012-03-29 05:02:12Z eadler $
|
|
|
|
|
.\"
|
2015-03-04 19:36:12 +03:00
|
|
|
.Dd March 4, 2015
|
2015-03-03 00:43:39 +03:00
|
|
|
.Dt PWAIT 1
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm pwait
|
|
|
|
|
.Nd wait for processes to terminate
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
2015-03-04 19:36:12 +03:00
|
|
|
.Op Fl isv
|
2015-03-03 22:59:48 +03:00
|
|
|
.Op Fl t Ar timeout
|
2015-03-03 00:43:39 +03:00
|
|
|
.Ar pid
|
|
|
|
|
\&...
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility will wait until each of the given processes has terminated.
|
|
|
|
|
.Pp
|
|
|
|
|
The following option is available:
|
|
|
|
|
.Bl -tag -width indent
|
2015-03-04 19:36:12 +03:00
|
|
|
.It Fl i
|
|
|
|
|
Don't wait for all the processes, exit after the first process or group
|
|
|
|
|
of processes exit.
|
2015-03-03 00:53:48 +03:00
|
|
|
.It Fl s
|
2015-03-03 22:59:48 +03:00
|
|
|
Exit with the status code of the first non-zero exit status pid, or
|
|
|
|
|
if timed out exit with
|
|
|
|
|
.Dv 255 .
|
|
|
|
|
.It Fl t Ar timeout
|
|
|
|
|
Only wait for
|
|
|
|
|
.Ar timeout
|
|
|
|
|
seconds before exiting.
|
2015-03-03 00:43:39 +03:00
|
|
|
.It Fl v
|
|
|
|
|
Print the exit status when each process terminates.
|
|
|
|
|
.El
|
|
|
|
|
.Sh DIAGNOSTICS
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility returns 0 on success, and >0 if an error occurs.
|
|
|
|
|
.Pp
|
|
|
|
|
Invalid pids elicit a warning message but are otherwise ignored.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr kill 1 ,
|
|
|
|
|
.Xr pkill 1 ,
|
|
|
|
|
.Xr ps 1 ,
|
|
|
|
|
.Xr wait 1 ,
|
|
|
|
|
.Xr kqueue 2
|
|
|
|
|
.Sh NOTES
|
|
|
|
|
.Nm
|
|
|
|
|
is not a substitute for the
|
|
|
|
|
.Xr wait 1
|
|
|
|
|
builtin
|
|
|
|
|
as it will not clean up any zombies or state in the parent process.
|
|
|
|
|
.Sh HISTORY
|
|
|
|
|
A
|
|
|
|
|
.Nm
|
|
|
|
|
command first appeared in SunOS 5.8.
|
