pkill/pwait: tweak manuals
[dragonfly.git] / usr.bin / pwait / pwait.1
1 .\"
2 .\" Copyright (c) 2004-2009, Jilles Tjoelker
3 .\" All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with
6 .\" or without modification, are permitted provided that the
7 .\" following conditions are met:
8 .\"
9 .\" 1. Redistributions of source code must retain the above
10 .\"    copyright notice, this list of conditions and the
11 .\"    following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the
13 .\"    above copyright notice, this list of conditions and
14 .\"    the following disclaimer in the documentation and/or
15 .\"    other materials provided with the distribution.
16 .\"
17 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
18 .\" CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
19 .\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
21 .\" PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
22 .\" COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY
23 .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25 .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
26 .\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
27 .\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29 .\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
30 .\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
31 .\" OF SUCH DAMAGE.
32 .\"
33 .\" $FreeBSD: head/bin/pwait/pwait.1 233648 2012-03-29 05:02:12Z eadler $
34 .\"
35 .Dd October 12, 2013
36 .Dt PWAIT 1
37 .Os
38 .Sh NAME
39 .Nm pwait
40 .Nd wait for processes to terminate
41 .Sh SYNOPSIS
42 .Nm
43 .Op Fl v
44 .Ar pid ...
45 .Sh DESCRIPTION
46 The
47 .Nm
48 utility will wait until each of the given processes has terminated.
49 .Pp
50 The following option is available:
51 .Bl -tag -width ".Fl v"
52 .It Fl v
53 Print the exit status when each process terminates.
54 .El
55 .Sh EXIT STATUS
56 .Ex -std
57 .Pp
58 Invalid pids elicit a warning message but are otherwise ignored.
59 .Sh SEE ALSO
60 .Xr kill 1 ,
61 .Xr pkill 1 ,
62 .Xr ps 1 ,
63 .Xr wait 1 ,
64 .Xr kqueue 2
65 .Sh NOTES
66 .Nm
67 is not a substitute for the
68 .Xr wait 1
69 builtin
70 as it will not clean up any zombies or state in the parent process.
71 .Sh HISTORY
72 A
73 .Nm
74 command first appeared in SunOS 5.8.
75 This implementation was imported from
76 .Fx
77 into
78 .Dx 3.5 .