nohup(1) nohup(1)
NAME
nohup - run a command immune to hangups and quits
SYNOPSIS
nohup command [argument ...]
DESCRIPTION
nohup executes a command or shell script, ignoring the signals SIGHUP
(signal number 1) and SIGQUIT (signal number 3). nohup can be used to
prevent a process from being terminated when you log out from a termi-
nal.
Before the call
If you wish to use nohup with a pipe or a list of commands, you must
put the relevant pipeline or command list in a file and run the file
as a shell script under nohup's management.
ARGUMENTS
command [argument ...]
Any command or shell script. You can pass arguments to command by
entering them after the command as usual.
If the standard output and standard error of command have not
been redirected, they will be written to a file called nohup.out
in the current directory.
If you are not permitted to create the file nohup.out in the
current directory (i.e. you have no write permission for this
directory) or if you do not have write permission for the file
nohup.out in the current directory, the output will be redirected
to the file $HOME/nohup.out.
If the file nohup.out or $HOME/nohup.out does not exist, a corre-
sponding file is created which has exclusive permissions for the
user executing the call; otherwise, the output is appended to the
existing file.
EXIT STATUS
126 The specified command exists, but cannot be executed.
127 The specified command cannot be found or an error occurred for
the nohup command.
If command was called, nohup returns the exit status of the executed
command command.
Page 1 Reliant UNIX 5.44 Printed 11/98
nohup(1) nohup(1)
ERROR MESSAGE
nohup: cannot open/create nohup.out
You are not allowed to create a file called nohup.out in the current
working directory or in $HOME, or you are not allowed to write to
existing nohup.out files in those directories.
ENVIRONMENT VARIABLE
HOME The value of the environment variable HOME is used to determine
the directory in which the file nohup.out is to be created in
cases where nohup.out in the current directory is write-protec-
ted or where you are not allowed to create files in the current
directory.
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed. If LCMESSAGES is undefined or is defined
as the null string, it defaults to the value of LANG. If LANG is like-
wise undefined or null, the system acts as if it were not internation-
alized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
EXAMPLE
You initiate the following job and set it to run in the background:
$ nohup program &
sending output to nohup.out
You then log out. program is not terminated, since it is immune to the
quit signal. The output is written to a file called nohup.out.
FILES
nohup.out
File located in the current directory which receives the standard
output and standard error output from commands executed under
nohup.
$HOME/nohup.out
The standard output and standard error output of commands exe-
cuted under nohup are sent to this file if the nohup.out file in
the current directory is write-protected or if you are not
allowed to create this file in the current directory (because you
do not have write permission there).
SEE ALSO
chmod(1), kill(1), nice(1), sh(1), signal(2).
Page 2 Reliant UNIX 5.44 Printed 11/98