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$ 34.\" 35.Dd January 26, 2020 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 t Ar duration 44.Op Fl ov 45.Ar pid 46\&... 47.Sh DESCRIPTION 48The 49.Nm 50utility will wait until each of the given processes has terminated. 51.Pp 52The following option is available: 53.Bl -tag -width indent 54.It Fl o 55Exit when any of the given processes has terminated. 56.It Fl t Ar duration 57If any process is still running after 58.Ar duration , 59.Nm 60will exit. 61The 62.Ar duration 63value can be integer or decimal numbers. 64Values without unit symbols are interpreted as seconds. 65.Pp 66Supported unit symbols are: 67.Bl -tag -width indent -compact 68.It s 69seconds 70.It m 71minutes 72.It h 73hours 74.El 75.It Fl v 76Print the exit status when each process terminates. 77.El 78.Sh EXIT STATUS 79The 80.Nm 81utility exits 0 on success, and >0 if an error occurs. 82.Pp 83If the 84.Fl t 85flag is specified and a timeout occurs, the exit status will be 124. 86.Pp 87Invalid pids elicit a warning message but are otherwise ignored. 88.Sh SEE ALSO 89.Xr kill 1 , 90.Xr pkill 1 , 91.Xr ps 1 , 92.Xr wait 1 , 93.Xr kqueue 2 94.Sh NOTES 95.Nm 96is not a substitute for the 97.Xr wait 1 98builtin 99as it will not clean up any zombies or state in the parent process. 100.Sh HISTORY 101A 102.Nm 103command first appeared in SunOS 5.8. 104