netdev-linux: Factor out obtaining an RTNL socket.
[openvswitch] / lib / daemon.man
1 .TP
2 \fB--pidfile\fR[\fB=\fIpidfile\fR]
3 Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating
4 the PID of the running process.  If \fIpidfile\fR is not specified, or
5 if it does not begin with \fB/\fR, then it is created in
6 \fB@RUNDIR@\fR.
7 .
8 .TP
9 \fB--overwrite-pidfile\fR
10 By default, when \fB--pidfile\fR is specified and the specified pidfile 
11 already exists and is locked by a running process, \fB\*(PN\fR refuses 
12 to start.  Specify \fB--overwrite-pidfile\fR to cause it to instead 
13 overwrite the pidfile.
14 .IP
15 When \fB--pidfile\fR is not specified, this option has no effect.
16 .
17 .TP
18 \fB--detach\fR
19 Causes \fB\*(PN\fR to detach itself from the foreground session and
20 run as a background process.
21 .
22 .TP
23 \fB--monitor\fR
24 Creates an additional process to monitor the \fB\*(PN\fR daemon.  If
25 the daemon dies due to a signal that indicates a programming error
26 (e.g. \fBSIGSEGV\fR, \fBSIGABRT\fR), then the monitor process starts a
27 new copy of it.  If the daemon die or exits for another reason, the
28 monitor process exits.
29 .IP
30 This option is normally used with \fB--detach\fR, but it also
31 functions without it.
32 .
33 .TP
34 \fB--no-chdir\fR
35 By default, when \fB--detach\fR is specified, \fB\*(PN\fR 
36 changes its current working directory to the root directory after it 
37 detaches.  Otherwise, invoking \fB\*(PN\fR from a carelessly chosen 
38 directory would prevent the administrator from unmounting the file 
39 system that holds that directory.
40 .IP
41 Specifying \fB--no-chdir\fR suppresses this behavior, preventing
42 \fB\*(PN\fR from changing its current working directory.  This may be 
43 useful for collecting core files, since it is common behavior to write 
44 core dumps into the current working directory and the root directory 
45 is not a good directory to use.
46 .IP
47 This option has no effect when \fB--detach\fR is not specified.