unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



fg(1)									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 com-
       mand 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:  XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try 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	for-
      mat 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 multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale used to affect the format and contents of diag-
      nostic 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)