NAME    [Toc]    [Back]

       fg - Runs jobs in the foreground

SYNOPSIS    [Toc]    [Back]

       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    [Toc]    [Back]

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

       fg:  XCU5.0

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

OPTIONS    [Toc]    [Back]

       None

OPERANDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       If job control is disabled, the fg utility exits  with  an
       error  and  no  job  is  placed in the foreground.  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    [Toc]    [Back]

       The following exit values are returned: Successful completion.
  An error occurred.

ENVIRONMENT VARIABLES    [Toc]    [Back]

       The  following  environment variables affect the execution
       of fg: 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.  If set to a non-empty
       string value, overrides the values of all the other internationalization
  variables.  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).  Determines the locale  used  to
       affect  the  format  and  contents  of diagnostic messages
       written to standard error.   Determines  the  location  of
       message catalogues for the processing of LC_MESSAGES.

SEE ALSO    [Toc]    [Back]

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

       Standards:  standards(5)



                                                            fg(1)