fg(1)                                                                    fg(1)


NAME
     fg - run jobs in the foreground

SYNOPSIS
     fg [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 ALSO
     bg(1), kill(1), jobs(1), sh(1), wait(1).


                                                                        Page 1