This is an old revision of the document!

The wait builtin command

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

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

  • if ID is a job specification, it waits for all processes in the pipeline of this job
  • waits for a specific job (asynchronous command) and report its exit status if one or more ID is given
  • waits for all running jobs (asynchronous commands)
  • waits for "the next" job (-n option)
  • waits for termination instead of status change (-f option)

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

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, sets the job ID to the job that was actually terminated

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
This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information
You could leave a comment if you were logged in.
  • commands/builtin/wait.1593327370.txt
  • Last modified: 2020/06/28 06:56
  • by thebonsai