Print this page
12745 man page typos
*** 43,69 ****
.\" Copyright 1989 AT&T
.\" Copyright 1992 X/Open Company Limited
.\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
.\"
! .TH WAIT 1 "Mar 13, 2008"
.SH NAME
wait \- await process completion
.SH SYNOPSIS
- .LP
.nf
.fi
.SS "/bin/sh"
- .LP
.nf
\fBwait\fR [\fIpid\fR]...
.fi
.SS "/bin/jsh /bin/ksh /usr/xpg4/bin/sh"
- .LP
.nf
\fBwait\fR [\fIpid\fR]...
.fi
.LP
--- 43,66 ----
.\" Copyright 1989 AT&T
.\" Copyright 1992 X/Open Company Limited
.\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
.\"
! .TH WAIT 1 "May 17, 2020"
.SH NAME
wait \- await process completion
.SH SYNOPSIS
.nf
.fi
.SS "/bin/sh"
.nf
\fBwait\fR [\fIpid\fR]...
.fi
.SS "/bin/jsh /bin/ksh /usr/xpg4/bin/sh"
.nf
\fBwait\fR [\fIpid\fR]...
.fi
.LP
*** 70,93 ****
.nf
\fBwait\fR [% \fIjobid\fR...]
.fi
.SS "/bin/csh"
- .LP
.nf
\fBwait\fR
.fi
.SS "ksh93"
- .LP
.nf
\fBwait\fR [\fIjob...\fR]
.fi
.SH DESCRIPTION
- .sp
- .LP
The shell itself executes \fBwait\fR, without creating a new process. If you
get the error message \fBcannot fork,too many processes\fR, try using the
\fBwait\fR command to clean up your background processes. If this doesn't help,
the system process table is probably full or you have too many active
foreground processes. There is a limit to the number of process \fBID\fRs
--- 67,86 ----
*** 95,106 ****
.sp
.LP
Not all the processes of a pipeline with three or more stages are children of
the shell, and thus cannot be waited for.
.SS "/bin/sh, /bin/jsh"
- .sp
- .LP
Wait for your background process whose process \fBID\fR is \fIpid\fR and report
its termination status. If \fIpid\fR is omitted, all your shell's currently
active background processes are waited for and the return code is \fB0\fR. The
\fBwait\fR utility accepts a job identifier, when Job Control is enabled (jsh),
and the argument, \fIjobid\fR, is preceded by a percent sign (\fB%\fR).
--- 88,97 ----
*** 107,122 ****
.sp
.LP
If \fIpid\fR is not an active process \fBID,\fR the \fBwait\fR utility returns
immediately and the return code is \fB0\fR.
.SS "csh"
- .sp
- .LP
Wait for your background processes.
.SS "ksh"
- .sp
- .LP
When an asynchronous list is started by the shell, the process \fBID\fR of the
last command in each element of the asynchronous list becomes known in the
current shell execution environment.
.sp
.LP
--- 98,109 ----
*** 136,147 ****
.sp
.LP
The known process \fBID\fRs are applicable only for invocations of \fBwait\fR
in the current shell execution environment.
.SS "ksh93"
- .sp
- .LP
wait with no operands, waits until all jobs known to the invoking shell have
terminated. If one or more job operands are specified, wait waits until all of
them have completed. Each job can be specified as one of the following:
.sp
.ne 2
--- 123,132 ----
*** 210,225 ****
Refers to the previous job
.RE
.sp
.LP
! If one ore more job operands is a process id or process group id not known by
the current shell environment, \fBwait\fR treats each of them as if it were a
process that exited with status 127.
.SH OPERANDS
- .sp
- .LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIpid\fR\fR
--- 195,208 ----
Refers to the previous job
.RE
.sp
.LP
! If one or more job operands is a process id or process group id not known by
the current shell environment, \fBwait\fR treats each of them as if it were a
process that exited with status 127.
.SH OPERANDS
The following operands are supported:
.sp
.ne 2
.na
\fB\fIpid\fR\fR
*** 240,251 ****
invocations of \fBwait\fR in the current shell execution environment, and only
on systems supporting the job control option.
.RE
.SH USAGE
- .sp
- .LP
On most implementations, \fBwait\fR is a shell built-in. If it is called in a
subshell or separate utility execution environment, such as one of the
following,
.sp
.in +2
--- 223,232 ----
*** 260,270 ****
.sp
.LP
it returns immediately because there is no known process \fBID\fRs to wait for
in those environments.
.SH EXAMPLES
- .LP
\fBExample 1 \fRUsing A Script To Identify The Termination Signal
.sp
.LP
Although the exact value used when a process is terminated by a signal is
unspecified, if it is known that a signal terminated a process, a script can
--- 241,250 ----
*** 313,331 ****
.fi
.in -2
.sp
.SH ENVIRONMENT VARIABLES
- .sp
- .LP
See \fBenviron\fR(5) for descriptions of the following environment variables
that affect the execution of \fBwait\fR: \fBLANG\fR, \fBLC_ALL\fR,
\fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
.SH EXIT STATUS
.SS "ksh93"
- .sp
- .LP
The following exit values are returned by the \fBwait\fR built-in in
\fBksh93\fR:
.sp
.ne 2
.na
--- 293,307 ----
*** 345,356 ****
\fIjob\fR is a process id or process group id that is unknown to the current
shell environment.
.RE
.SH ATTRIBUTES
- .sp
- .LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
--- 321,330 ----
*** 363,371 ****
_
Standard See \fBstandards\fR(5).
.TE
.SH SEE ALSO
- .sp
- .LP
\fBcsh\fR(1), \fBjobs\fR(1), \fBksh\fR(1), \fBksh93\fR(1), \fBsh\fR(1),
\fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)
--- 337,343 ----