X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;ds=sidebyside;f=lib%2Fdaemon.man;h=4ab9823c3a7662513338c942f442f5c088c8ef30;hb=7d78f21c057ff50a823220d809ac38c3d907243c;hp=4ab65680680a449f54fb2db7cbe798aa4c0a9292;hpb=064af42167bf4fc9aaea2702d80ce08074b889c0;p=sliver-openvswitch.git diff --git a/lib/daemon.man b/lib/daemon.man index 4ab656806..4ab9823c3 100644 --- a/lib/daemon.man +++ b/lib/daemon.man @@ -1,21 +1,52 @@ +The following options are valid on POSIX based platforms. .TP -\fB-P\fR[\fIpidfile\fR], \fB--pidfile\fR[\fB=\fIpidfile\fR] +\fB\-\-pidfile\fR[\fB=\fIpidfile\fR] Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating -the PID of the running process. If \fIpidfile\fR is not specified, or +the PID of the running process. If the \fIpidfile\fR argument is not +specified, or if it does not begin with \fB/\fR, then it is created in \fB@RUNDIR@\fR. - +.IP +If \fB\-\-pidfile\fR is not specified, no pidfile is created. +. .TP -\fB-f\fR, \fB--force\fR -By default, when \fB-P\fR or \fB--pidfile\fR is specified and the -specified pidfile already exists and is locked by a running process, -\fB\*(PN\fR refuses to start. Specify \fB-f\fR or \fB--force\fR -to cause it to instead overwrite the pidfile. - -When \fB-P\fR or \fB--pidfile\fR is not specified, this option has no -effect. - +\fB\-\-overwrite\-pidfile\fR +By default, when \fB\-\-pidfile\fR is specified and the specified pidfile +already exists and is locked by a running process, \fB\*(PN\fR refuses +to start. Specify \fB\-\-overwrite\-pidfile\fR to cause it to instead +overwrite the pidfile. +.IP +When \fB\-\-pidfile\fR is not specified, this option has no effect. +. .TP -\fB-D\fR, \fB--detach\fR +\fB\-\-detach\fR Causes \fB\*(PN\fR to detach itself from the foreground session and -run as a background process. +run as a background process. \*(DD +. +.TP +\fB\-\-monitor\fR +Creates an additional process to monitor the \fB\*(PN\fR daemon. If +the daemon dies due to a signal that indicates a programming error +(\fBSIGABRT\fR, \fBSIGALRM\fR, \fBSIGBUS\fR, \fBSIGFPE\fR, +\fBSIGILL\fR, \fBSIGPIPE\fR, \fBSIGSEGV\fR, \fBSIGXCPU\fR, or +\fBSIGXFSZ\fR) then the monitor process starts a new copy of it. If +the daemon dies or exits for another reason, the monitor process exits. +.IP +This option is normally used with \fB\-\-detach\fR, but it also +functions without it. +. +.TP +\fB\-\-no\-chdir\fR +By default, when \fB\-\-detach\fR is specified, \fB\*(PN\fR +changes its current working directory to the root directory after it +detaches. Otherwise, invoking \fB\*(PN\fR from a carelessly chosen +directory would prevent the administrator from unmounting the file +system that holds that directory. +.IP +Specifying \fB\-\-no\-chdir\fR suppresses this behavior, preventing +\fB\*(PN\fR from changing its current working directory. This may be +useful for collecting core files, since it is common behavior to write +core dumps into the current working directory and the root directory +is not a good directory to use. +.IP +This option has no effect when \fB\-\-detach\fR is not specified.