Click this button to go to the index for this section.

fg(1)
NAME
  fg - Runs jobs in the foreground

SYNOPSIS
  fg [job_id...]

				     Note

       The C shell has a built-in version of the fg command.  If you are
       using the C shell, and want to guarantee that you are using the
       command described here, you must specify the full path /usr/bin/fg.
       See the csh(1) reference page for a description of the built-in
       command.

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  fg:  XPG4, XPG4-UNIX

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

OPTIONS
  None

OPERANDS
  job_id
      Specifies 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 is used.  The
      format of job_id is described in the Jobs section of the ksh(1)
      reference page.

DESCRIPTION
  If job control is enabled (see the description of set -m in the ksh(1)
  reference page), the fg utility moves a background job from the current
  environment into the foreground.

  Using fg to place a job into the foreground removes its process ID from the
  list of those "known in the current shell execution environment"; see the
  Jobs section of the ksh(1) reference page.






RESTRICTIONS
   1.  If job control is disabled, the fg utility exits with an error and no
       job is placed in the foreground.

   2.  The fg utility does not work as expected when it is operating in its
       own utility execution environment because that environment has no
       applicable jobs to manipulate.

EXIT STATUS
  The following exit values are returned:

  0   Successful completion.

  >0  An error occurred.

ENVIRONMENT VARIABLES
  The following environment variables affect the execution of fg:

  LANG
      Provides a default value for the internationalization variables that
      are unset or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables contain an invalid setting, the utility behaves as if none of
      the variables had been defined.

  LC_ALL
      If set to a non-empty string value, overrides the values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for the interpretation of sequences of bytes of
      text data as characters (for example, single-byte as opposed to
      multibyte characters in arguments).

  LC_MESSAGES
      Determines the locale used to affect the format and contents of
      diagnostic messages written to standard error.

  NLSPATH
      Determines the location of message catalogues for the processing of
      LC_MESSAGES.

SEE ALSO
  Commands:  bg(1), csh(1), jobs(1), kill(1), ksh(1), sh(1p), wait(1)

  Standards:  standards(5)