Re: s-s-d and manpage updates

[Guillem Jover <guillem@debian.org>]

Hi,

On Mon, 2008-01-28 at 16:47:24 -0500, Justin Pryzby wrote:
> Some changes for your consideration.

Thanks for the improvements.

> --- /usr/share/man/man8/start-stop-daemon.8.gz
> +++ /tmp/startstop-daemon.8.gz.12569	2008-01-28 16:42:20.000000000 -0500
> +.SH NOTES
> +.B --exec
> +can fail to detect a running daemon after the executable is replaced (eg.
> +during a package upgrade), since the executable is stored with a different
> +inode.
> +.

This I've not merged, as it's not supposed to fail in that case. If there's
a problem, that'd be a bug in s-s-d, and should probably be fixed.

> +.SH EXAMPLE
> +.TP
> +.RB "Start the " food " daemon, unless one is already running (a process named food, running as user food, with pid in food.pid):"
> +.nf
> +start-stop-daemon --start --oknodo --user food --name food --pidfile /var/run/food.pid --startas /usr/sbin/food --chuid food -- --daemon
> +.fi
> +.TP
> +.RB "Send " SIGTERM " to " food " and wait up to 5 seconds for it to stop:"
> +.nf
> +start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry 5
> +.fi
> +.TP
> +.RB "Demonstration of a custom schedule for stopping " food :
> +.nf
> +start-stop-daemon --stop --oknodo --user food --name food --pidfile /var/run/food.pid --retry=TERM/30/KILL/5
> +.fi
> +.LP
> +.

And this part I've slightly reformatted.

thanks,
guillem