chiark / gitweb /
Commit as 2.1.0.
[mLib] / daemonize.h
1 /* -*-c-*-
2  *
3  * $Id$
4  *
5  * Become a daemon, detaching from terminals
6  *
7  * (c) 2007 Straylight/Edgeware
8  */
9
10 /*----- Licensing notice --------------------------------------------------*
11  *
12  * This file is part of the mLib utilities library.
13  *
14  * mLib is free software; you can redistribute it and/or modify
15  * it under the terms of the GNU Library General Public License as
16  * published by the Free Software Foundation; either version 2 of the
17  * License, or (at your option) any later version.
18  *
19  * mLib is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  * GNU Library General Public License for more details.
23  *
24  * You should have received a copy of the GNU Library General Public
25  * License along with mLib; if not, write to the Free
26  * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
27  * MA 02111-1307, USA.
28  */
29
30 #ifndef MLIB_DAEMONIZE_H
31 #define MLIB_DAEMONIZE_H
32
33 #ifdef __cplusplus
34   extern "C" {
35 #endif
36
37 /*----- Functions provided ------------------------------------------------*/
38
39 /* --- @detachtty@ --- *
40  *
41  * Arguments:   ---
42  *
43  * Returns:     ---
44  *
45  * Use:         Detaches from the current terminal and ensures it can never
46  *              acquire a new one.  Calls @fork@.
47  */
48
49 extern void detachtty(void);
50
51 /* --- @daemonize@ --- *
52  *
53  * Arguments:   ---
54  *
55  * Returns:     Zero if OK, nonzero on failure.
56  *
57  * Use:         Becomes a daemon.
58  */
59
60 extern int daemonize(void);
61
62 /*----- That's all, folks -------------------------------------------------*/
63
64 #ifdef __cplusplus
65   }
66 #endif
67
68 #endif