Table of Contents

The wait builtin command

Synopsis

wait [-f] [-n] [-p VARNAME] [ID...]

Description

The wait builtin command is used to wait for job completion and return exit status.

ID may be an operating system process identifier or a shell job specification.

Options

Option Description
-n Waits for "the next" child to exit (as opposed to "all children" without this option). Accepts a list of IDs (jobs)
-f Waits for the termination of the given ID (instead of waiting for a status change only)
-p VARNAME When waiting for a list (-n) or all jobs, writes the job ID to the job that was actually terminated into the variable VARNAME

Return status

The return status is the return status of the job waited for, or

Status Reason
0 waited for all jobs in shell's job list
1 the given ID is not a valid job or process ID

Examples

Portability considerations

See also