fg(1)fg(1)NAMEfg - run jobs in the foreground
SYNOPSISfg [job_id]
DESCRIPTION
If job control is enabled (see the description of set -m), the fg utility
will move a background job from the current environment into the
foreground.
Using fg to place a job into the foreground will remove its process ID
from the list of those "known in the current shell execution environment.
OPERANDS
The following operand is supported:
job_id Specify the job to be run as a foreground job. If no job_id
operand is given, the job_id for the job that was most recently
suspended, placed in the background or run as a background job
will be used. The format of job_id is described in the entry for
job control job ID in the sh(1) manpage.
STDOUT
The fg utility writes the command line of the job to standard output in
the following format:
"%s\n", <command>
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
CONSEQUENCES OF ERRORS
If job control is disabled, the fg utility will exit with an error and no
job will be placed in the foreground.
APPLICATION USAGE
The fg utility will not work as expected when it is operating in its own
utility execution environment because that environment will have no
applicable jobs to manipulate. See the APPLICATION USAGE section for bg.
For this reason, fg is generally implemented as a shell regular built-in.
SEE ALSObg(1), kill(1), jobs(1), sh(1), wait(1).
Page 1
