Document -i, --interpreted flag.

This commit is contained in:
Roy Marples 2009-04-22 10:49:07 +00:00
parent f326f688f6
commit 953b0b7435

View File

@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd April 19, 2009 .Dd April 22, 2009
.Dt START-STOP-DAEMON 8 SMM .Dt START-STOP-DAEMON 8 SMM
.Os OpenRC .Os OpenRC
.Sh NAME .Sh NAME
@ -52,14 +52,6 @@ are provided, then we assume we are starting the daemon.
If a daemon cannot background by itself, nor create a pidfile, If a daemon cannot background by itself, nor create a pidfile,
.Nm .Nm
can do it for the daemon in a secure fashion. can do it for the daemon in a secure fashion.
.Nm
also ensures that a daemon really has started by checking to see if it still
exists for a short time after it has started. This is because some badly
written daemons like to daemonize before checking their configuration, doing
sanity checks, etc. Likewise,
.Nm
ensures that a daemon really stops as well, again by using the information
above to ensure that it's not running.
.Pp .Pp
If If
.Nm .Nm
@ -84,6 +76,16 @@ listed in the
Match the process Match the process
.Ar name .Ar name
instead of a pidfile or executable. instead of a pidfile or executable.
.It Fl i , -interpreted
When matching process name, we should ensure that the correct interpreter
is also matched.
So if the daemon foo starts off like so
.D1 #!/usr/bin/perl -w
then
.Nm
matches the process
.D1 /usr/bin/perl -w foo
If an interpreted daemon changes it's process name then this won't work.
.It Fl u , -user Ar user Ns Op : Ns Ar group .It Fl u , -user Ar user Ns Op : Ns Ar group
Start the daemon as the Start the daemon as the
.Ar user .Ar user
@ -155,10 +157,9 @@ but with the standard error output.
These options are only used for stopping daemons: These options are only used for stopping daemons:
.Bl -tag -width indent .Bl -tag -width indent
.It Fl R , -retry Ar timeout | Ar signal Ns / Ns Ar timeout .It Fl R , -retry Ar timeout | Ar signal Ns / Ns Ar timeout
You can either specify a timeout or a multiple signal/timeout pairs as a You can either specify a timeout in seconds or a multiple signal/timeout
stopping schedule. pairs as a stopping schedule.
If not specified then a default value of SIGTERM/0 is If not specified then a default value of SIGTERM/5 is assumed.
assumed.
.El .El
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Va SSD_NICELEVEL .Va SSD_NICELEVEL