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