nohup/nohup.1

   1 .\"     $NetBSD: nohup.1,v 1.6 1997/10/19 10:23:25 lukem Exp $
   2 .\"
   3 .\" Copyright (c) 1989, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to Berkeley by
   7 .\" the Institute of Electrical and Electronics Engineers, Inc.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\" 3. All advertising materials mentioning features or use of this software
  18 .\"    must display the following acknowledgement:
  19 .\"     This product includes software developed by the University of
  20 .\"     California, Berkeley and its contributors.
  21 .\" 4. Neither the name of the University nor the names of its contributors
  22 .\"    may be used to endorse or promote products derived from this software
  23 .\"    without specific prior written permission.
  24 .\"
  25 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  26 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  27 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  28 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  29 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  30 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  31 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  32 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  33 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  34 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  35 .\" SUCH DAMAGE.
  36 .\"
  37 .\"     @(#)nohup.1     8.1 (Berkeley) 6/6/93
  38 .\"
  39 .Dd June 6, 1993
  40 .Dt NOHUP 1
  41 .Os
  42 .Sh NAME
  43 .Nm nohup
  44 .Nd invoke a command immune to hangups
  45 .Sh SYNOPSIS
  46 .Nm
  47 .Ar utility
  48 .Op Ar arg ...
  49 .Sh DESCRIPTION
  50 The
  51 .Nm
  52 utility invokes
  53 .Ar command
  54 with
  55 its arguments
  56 and at this time sets the signal
  57 .Dv SIGHUP
  58 to be ignored.
  59 If the standard output is a terminal, the standard output is
  60 appended to the file
  61 .Pa nohup.out
  62 in the current directory.
  63 If standard error is a terminal, it is directed to the same place
  64 as the standard output.
  65 .Sh ENVIRONMENT
  66 The following variable is utilized by
  67 .Nm "" .
  68 .Bl -tag -width flag
  69 .It Ev HOME
  70 If the output file
  71 .Pa nohup.out
  72 cannot be created in the current directory, the
  73 .Nm
  74 utility uses the directory named by
  75 .Ev HOME
  76 to create the file.
  77 .El
  78 .Sh DIAGNOSTICS
  79 The
  80 .Nm
  81 utility shall exit with one of the following values:
  82 .Bl -tag -width Ds
  83 .It 126
  84 The
  85 .Ar utility
  86 was found but could not be invoked.
  87 .It 127
  88 The
  89 .Ar utility
  90 could not be found or an error occurred in
  91 .Nm "" .
  92 .El
  93 .Pp
  94 Otherwise, the exit status of
  95 .Nm
  96 shall be that of
  97 .Ar utility .
  98 .Sh SEE ALSO
  99 .Xr signal 3
 100 .Sh STANDARDS
 101 The
 102 .Nm
 103 command is expected to be
 104 .St -p1003.2
 105 compatible.