From da8d1d84fd46e61eec0772ff339fde0952777a5f Mon Sep 17 00:00:00 2001 From: Denys Vlasenko Date: Tue, 7 Nov 2023 15:59:11 +0100 Subject: start-stop-daemon: update comment, no code changes Signed-off-by: Denys Vlasenko --- debianutils/start_stop_daemon.c | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/debianutils/start_stop_daemon.c b/debianutils/start_stop_daemon.c index 750167349..8573c6990 100644 --- a/debianutils/start_stop_daemon.c +++ b/debianutils/start_stop_daemon.c @@ -17,6 +17,10 @@ One (only) of these must be given: -S,--start Start -K,--stop Stop -T,--status Check for the existence of a process, return exitcode (since version 1.16.1) + 0 - program is running + 1 - program is not running and the pid file exists. + 3 - program is not running. + 4 - can't determine program status. Search for matching processes. If --stop is given, stop all matching processes (by sending a signal). @@ -45,9 +49,10 @@ Options which are valid for --start only: -a,--startas NAME argv[0] (defaults to EXECUTABLE) -b,--background Put process into background -O,--output FILE Redirect stdout and stderr to FILE when forcing the - daemon into the background (since version 1.20.6). Only - relevant when using --background. - Probably O_CREAT|O_TRUNC? What if execv fails - where does error msg go? "Old" stderr? FILE? Nowhere? + daemon into the background (since version 1.20.6). + Requires --background and absolute pathname (tested with 1.21.22). + Uses O_CREAT|O_APPEND! + If execv fails, error message goes to FILE. -N,--nicelevel N Add N to process' nice level -c,--chuid USER[:[GRP]] Change to specified user [and group] -m,--make-pidfile Write PID to the pidfile @@ -66,6 +71,11 @@ Options which are valid for --start only: When not specified, start-stop-daemon will change directory to the root directory before starting the process. ^^^^ Seems to be false, no default "/" chdir is done. + Tested -S with 1.21.22: + "start-stop-daemon -S -n pwd -a /bin/pwd" is the minimum needed to run pwd. + "start-stop-daemon -S -n pwd -x /bin/pwd" works too. + "start-stop-daemon -S -a /bin/pwd -x /bin/pwd" works too. + Earlier versions were less picky (which?) Options which are valid for --stop only: -s,--signal SIG Signal to send (default:TERM) -- cgit v1.2.3