xref: /freebsd/bin/pwait/pwait.1 (revision 0e5e4167809165c2be4f8ddd88aa8a4084c7e02d)
10e5e4167SJilles Tjoelker.\"
20e5e4167SJilles Tjoelker.\" Copyright (c) 2004-2009, Jilles Tjoelker
30e5e4167SJilles Tjoelker.\" All rights reserved.
40e5e4167SJilles Tjoelker.\"
50e5e4167SJilles Tjoelker.\" Redistribution and use in source and binary forms, with
60e5e4167SJilles Tjoelker.\" or without modification, are permitted provided that the
70e5e4167SJilles Tjoelker.\" following conditions are met:
80e5e4167SJilles Tjoelker.\"
90e5e4167SJilles Tjoelker.\" 1. Redistributions of source code must retain the above
100e5e4167SJilles Tjoelker.\"    copyright notice, this list of conditions and the
110e5e4167SJilles Tjoelker.\"    following disclaimer.
120e5e4167SJilles Tjoelker.\" 2. Redistributions in binary form must reproduce the
130e5e4167SJilles Tjoelker.\"    above copyright notice, this list of conditions and
140e5e4167SJilles Tjoelker.\"    the following disclaimer in the documentation and/or
150e5e4167SJilles Tjoelker.\"    other materials provided with the distribution.
160e5e4167SJilles Tjoelker.\"
170e5e4167SJilles Tjoelker.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
180e5e4167SJilles Tjoelker.\" CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
190e5e4167SJilles Tjoelker.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
200e5e4167SJilles Tjoelker.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
210e5e4167SJilles Tjoelker.\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
220e5e4167SJilles Tjoelker.\" COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY
230e5e4167SJilles Tjoelker.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
240e5e4167SJilles Tjoelker.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
250e5e4167SJilles Tjoelker.\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
260e5e4167SJilles Tjoelker.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
270e5e4167SJilles Tjoelker.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
280e5e4167SJilles Tjoelker.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
290e5e4167SJilles Tjoelker.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
300e5e4167SJilles Tjoelker.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
310e5e4167SJilles Tjoelker.\" OF SUCH DAMAGE.
320e5e4167SJilles Tjoelker.\"
330e5e4167SJilles Tjoelker.\" $FreeBSD$
340e5e4167SJilles Tjoelker.\"
350e5e4167SJilles Tjoelker.Dd November 1, 2009
360e5e4167SJilles Tjoelker.Os
370e5e4167SJilles Tjoelker.Dt PWAIT 1
380e5e4167SJilles Tjoelker.Sh NAME
390e5e4167SJilles Tjoelker.Nm pwait
400e5e4167SJilles Tjoelker.Nd wait for processes to terminate
410e5e4167SJilles Tjoelker.Sh SYNOPSIS
420e5e4167SJilles Tjoelker.Nm
430e5e4167SJilles Tjoelker.Op Fl v
440e5e4167SJilles Tjoelker.Ar pid
450e5e4167SJilles Tjoelker\&...
460e5e4167SJilles Tjoelker.Sh DESCRIPTION
470e5e4167SJilles TjoelkerThe
480e5e4167SJilles Tjoelker.Nm
490e5e4167SJilles Tjoelkerutility will wait until each of the given processes has terminated.
500e5e4167SJilles Tjoelker.Pp
510e5e4167SJilles TjoelkerThe following option is available:
520e5e4167SJilles Tjoelker.Bl -tag -width indent
530e5e4167SJilles Tjoelker.It Fl v
540e5e4167SJilles TjoelkerPrint the exit status when each process terminates.
550e5e4167SJilles Tjoelker.El
560e5e4167SJilles Tjoelker.Sh DIAGNOSTICS
570e5e4167SJilles Tjoelker.Pp
580e5e4167SJilles TjoelkerThe
590e5e4167SJilles Tjoelker.Nm
600e5e4167SJilles Tjoelkerutility returns 0 on success, and >0 if an error occurs.
610e5e4167SJilles Tjoelker.Pp
620e5e4167SJilles TjoelkerInvalid pids elicit a warning message but are otherwise ignored.
630e5e4167SJilles Tjoelker.Sh SEE ALSO
640e5e4167SJilles Tjoelker.Xr kill 1 ,
650e5e4167SJilles Tjoelker.Xr pkill 1 ,
660e5e4167SJilles Tjoelker.Xr ps 1 ,
670e5e4167SJilles Tjoelker.Xr wait 1 ,
680e5e4167SJilles Tjoelker.Xr kqueue 2
690e5e4167SJilles Tjoelker.Sh NOTES
700e5e4167SJilles Tjoelker.Nm
710e5e4167SJilles Tjoelkeris not a substitute for the
720e5e4167SJilles Tjoelker.Xr wait 1
730e5e4167SJilles Tjoelkerbuiltin
740e5e4167SJilles Tjoelkeras it will not clean up any zombies or state in the parent process.
750e5e4167SJilles Tjoelker.Sh HISTORY
760e5e4167SJilles TjoelkerA
770e5e4167SJilles Tjoelker.Nm
780e5e4167SJilles Tjoelkercommand first appeared in SunOS 5.8.
79