The fg built-in resumes a job in the foreground.

Syntax

  • fg [job…]

Description

The fg built-in brings the specified job to the foreground and sends the SIGCONT signal to the job. As a result, the job is resumed in the foreground (if it has been suspended). The built-in then waits for the job to finish and returns the exit status of it.

The name of the job is printed when the job is resumed.

The built-in can be used only when job control is enabled.

Operands

job

The job ID of the job to be resumed.

If more than one job is specified, they are resumed in order, one at a time. The current job is resumed if none is specified.

The percent sign (%) at the beginning of a job ID can be omitted if the shell is not in the POSIXly-correct mode.

Exit status

The exit status of the fg built-in is that of the (last) job resumed. The exit status is non-zero when there was some error.

Notes

The fg built-in is a semi-special built-in.

You cannot specify more than one job in the POSIXly-correct mode.