fg(1) [osf1 man page]
fg(1) General Commands Manual 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: XCU5.0 Refer to the standards(5) reference page for more information about industry standards and associated tags. OPTIONS
None OPERANDS
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 cur- rent 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 environ- ment"; see the Jobs section of the ksh(1) reference page. RESTRICTIONS
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
The following exit values are returned: Successful completion. An error occurred. ENVIRONMENT VARIABLES
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 vari- ables 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
Commands: bg(1), csh(1), jobs(1), kill(1), ksh(1), sh(1p), wait(1) Standards: standards(5) fg(1)
Check Out this Related Man Page
cd(1) General Commands Manual cd(1) NAME
cd - Changes the current working directory SYNOPSIS
cd [directory] Note The C shell has a built-in version of the cd 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/cd. 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: cd: XCU5.0 Refer to the standards(5) reference page for more information about industry standards and associated tags. OPTIONS
None OPERANDS
The pathname (either full or relative) to be used as the new working directory. If (hyphen) is specified as the directory, the cd command changes your current (working) directory to the directory name saved in the environment variable OLDPWD. DESCRIPTION
The cd command moves you from your present directory to another directory. You must have execute (search) permission in the specified directory. If you do not specify a directory, cd moves you to your login directory ($HOME in ksh and sh environments, or $home in csh environment). If the specified directory name is a full pathname, it becomes the current working directory. A full pathname begins with a / (slash) for the root directory, with a . (dot) for the current working directory, or with a .. (dot dot) for the parent directory. If the directory name is not a full pathname, cd searches for it relative to one of the paths specified by the $CDPATH shell variable (or $cdpath csh vari- able). This variable has the same syntax as, and similar semantics to, the $PATH shell variable (or $path csh variable). EXIT STATUS
The following exit values are returned: The directory was successfully changed. An error occurred. EXAMPLES
To change to your home directory, enter: cd To change to a new directory, enter: cd /usr/include This changes the current working directory to /usr/include. Now file pathnames that do not begin with / or ../ specify files located in /usr/include. To go down one level of the directory tree, enter: cd sys If the current working directory is /usr/include and if it contains a subdirectory named sys, then /usr/include/sys becomes the cur- rent working directory. To go up one level of the directory tree, enter: cd .. The special filename .. (dot dot) always refers to the directory immediately above the current working directory. ENVIRONMENT VARIABLES
The following environment variables affect the execution of cd: A colon-separated list of pathnames that refer to directories. If the directory operand does not begin with a / (slash) character, and the first component is not (dot) or cd command will search for directory relative to each directory named in the CDPATH variable, in the order listed. The new working directory will be set to the first matching directory found. An empty string in place of a directory pathname represents the current directory. If CDPATH is not set, it will be treated as if it were an empty string. The name of the home directory, used when no directory operand is specified. 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 char- acters in arguments). Determines the locale for the format and contents of diagnostic messages written to standard error. Determines the location of message catalogues for the processing of LC_MESSAGES. A pathname of the previous working directory, used by the cd - form of the command. The cd command sets this variable to your current working directory before changing to a new current directory. A pathname of the current working directory, set by the cd command after it has changed to that directory. SEE ALSO
Commands: csh(1), ksh(1), pwd(1), Bourne shell sh(1b), POSIX shell sh(1p) Functions: chdir(2) Environment: environ(5) Standards: standards(5) cd(1)