]> git.saurik.com Git - apple/libc.git/blob - gen/daemon.3
Libc-498.1.5.tar.gz
[apple/libc.git] / gen / daemon.3
1 .\" Copyright (c) 1993
2 .\" The Regents of the University of California. All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
19 .\"
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 .\" SUCH DAMAGE.
31 .\"
32 .\" @(#)daemon.3 8.1 (Berkeley) 6/9/93
33 .\" $FreeBSD: src/lib/libc/gen/daemon.3,v 1.14 2003/11/10 22:04:51 ghelmer Exp $
34 .\"
35 .Dd June 9, 1993
36 .Dt DAEMON 3
37 .Os
38 .Sh NAME
39 .Nm daemon
40 .Nd run in the background
41 .Sh LIBRARY
42 .Lb libc
43 .Sh SYNOPSIS
44 .In stdlib.h
45 .Ft int
46 .Fn daemon "int nochdir" "int noclose"
47 .Sh DESCRIPTION
48 The
49 .Fn daemon
50 function is for programs wishing to detach themselves from the
51 controlling terminal and run in the background as system daemons.
52 On Mac OS X, the use of this API is discouraged in favor of using
53 .Xr launchd 8 .
54 .Pp
55 Unless the argument
56 .Fa nochdir
57 is non-zero,
58 .Fn daemon
59 changes the current working directory to the root
60 .Pq Pa / .
61 .Pp
62 Unless the argument
63 .Fa noclose
64 is non-zero,
65 .Fn daemon
66 will redirect standard input, standard output, and standard error to
67 .Pa /dev/null .
68 .Sh RETURN VALUES
69 .Rv -std daemon
70 .Sh ERRORS
71 The
72 .Fn daemon
73 function may fail and set
74 .Va errno
75 for any of the errors specified for the library functions
76 .Xr fork 2
77 and
78 .Xr setsid 2 .
79 .Sh SEE ALSO
80 .Xr fork 2 ,
81 .Xr setsid 2 ,
82 .Xr sigaction 2
83 .Sh HISTORY
84 The
85 .Fn daemon
86 function first appeared in
87 .Bx 4.4 .
88 .Sh CAVEATS
89 Unless the
90 .Fa noclose
91 argument is non-zero,
92 .Fn daemon
93 will close the first three file descriptors and redirect them to
94 .Pa /dev/null .
95 Normally, these correspond to standard input, standard output, and
96 standard error.
97 However, if any of those file descriptors refer to something else, they
98 will still be closed, resulting in incorrect behavior of the calling program.
99 This can happen if any of standard input, standard output, or standard
100 error have been closed before the program was run.
101 Programs using
102 .Fn daemon
103 should therefore either call
104 .Fn daemon
105 before opening any files or sockets, or verify that any file
106 descriptors obtained have values greater than 2.
107 .Pp
108 The
109 .Fn daemon
110 function temporarily ignores
111 .Dv SIGHUP
112 while calling
113 .Xr setsid 2
114 to prevent a parent session group leader's calls to
115 .Xr fork 2
116 and then
117 .Xr _exit 2
118 from prematurely terminating the child process.