From b7b56df70790aa17eed47c31a3a588a557f64d41 Mon Sep 17 00:00:00 2001 From: Nicolas Thill Date: Tue, 8 Nov 2011 22:47:49 +0000 Subject: [PATCH] package/base-files: enhance & cleanup service wrappers * add service_check function for checking if a process is alive * add service_signal for sending arbitrary signals to a process * change service_stop to send a TERM signal first, wait for the process to die and send a KILL signal if it doen't * have service_kill print a warning on STDERR stating it has been deprecated SVN-Revision: 28865 --- package/base-files/Makefile | 2 +- package/base-files/files/lib/functions.sh | 66 ++++++++++++++--------- 2 files changed, 41 insertions(+), 27 deletions(-) diff --git a/package/base-files/Makefile b/package/base-files/Makefile index e29e63b3d9..6e41f04589 100644 --- a/package/base-files/Makefile +++ b/package/base-files/Makefile @@ -10,7 +10,7 @@ include $(TOPDIR)/rules.mk include $(INCLUDE_DIR)/kernel.mk PKG_NAME:=base-files -PKG_RELEASE:=90 +PKG_RELEASE:=91 PKG_FILE_DEPENDS:=$(PLATFORM_DIR)/ $(GENERIC_PLATFORM_DIR)/base-files/ PKG_BUILD_DEPENDS:=opkg/host diff --git a/package/base-files/files/lib/functions.sh b/package/base-files/files/lib/functions.sh index 82e8932da1..389f8eb98d 100755 --- a/package/base-files/files/lib/functions.sh +++ b/package/base-files/files/lib/functions.sh @@ -1,5 +1,5 @@ #!/bin/sh -# Copyright (C) 2006 OpenWrt.org +# Copyright (C) 2006-2011 OpenWrt.org # Copyright (C) 2006 Fokus Fraunhofer @@ -281,17 +281,19 @@ uci_apply_defaults() { # Usage: service ACTION EXEC ARGS... # # Action: -# -S,--start start EXEC, passing it ARGS as its arguments -# -K,--stop stop EXEC (send it a $SERVICE_SIG_STOP signal) -# -R,--reload reload EXEC (send it a $SERVICE_SIG_RELOAD signal) +# -C check if EXEC is alive +# -S start EXEC, passing it ARGS as its arguments +# -K kill EXEC, sending it a TERM signal if not specified otherwise # -# Environment variables used: +# Environment variables exposed: # SERVICE_DAEMONIZE run EXEC in background # SERVICE_WRITE_PID create a pid file and use it # SERVICE_USE_PID assume EXEC creates its own pid file and use it # SERVICE_PID_FILE pid file to use (default to /var/run/EXEC.pid) -# SERVICE_SIG_RELOAD signal used for reloading -# SERVICE_SIG_STOP signal used for stopping +# SERVICE_SIG signal to send when using -K +# SERVICE_SIG_RELOAD default signal used for reloading +# SERVICE_SIG_STOP default signal used for stopping +# SERVICE_STOP_TIME time to wait for a process to stop gracefully before killing it # SERVICE_UID user EXEC should be run as # SERVICE_GID group EXEC should be run as # @@ -302,25 +304,20 @@ uci_apply_defaults() { SERVICE_QUIET=1 SERVICE_SIG_RELOAD="HUP" SERVICE_SIG_STOP="TERM" +SERVICE_STOP_TIME=5 service() { local ssd - local ssd_pid_file - local ssd_sig - local ssd_start ssd="${SERVICE_DEBUG:+echo }start-stop-daemon${SERVICE_QUIET:+ -q}" case "$1" in - -S|--start|start) - ssd="$ssd -S" - ssd_start=1 + -C) + ssd="$ssd -K -t" ;; - -K|--stop|stop) - ssd="$ssd -K" - ssd_sig="$SERVICE_SIG_STOP" + -S) + ssd="$ssd -S${SERVICE_DAEMONIZE:+ -b}${SERVICE_WRITE_PID:+ -m}" ;; - -R|--reload|reload) - ssd="$ssd -K" - ssd_sig="$SERVICE_SIG_RELOAD" + -K) + ssd="$ssd -K${SERVICE_SIG:+ -s $SERVICE_SIG}" ;; *) echo "ssd: unknow action '$1'" 1>&2 @@ -336,28 +333,45 @@ service() { ssd="$ssd -p ${SERVICE_PID_FILE:-/var/run/${1##*/}.pid}" fi ssd="$ssd${SERVICE_UID:+ -c $SERVICE_UID${SERVICE_GID:+:$SERVICE_GID}}" - if [ -n "$ssd_start" ]; then - ssd="$ssd${SERVICE_DAEMONIZE:+ -b}${SERVICE_WRITE_PID:+ -m}" - else - ssd="$ssd${ssd_sig:+ -s $ssd_sig}" - fi shift $ssd${1:+ -- "$@"} } +service_check() { + service -C "$@" +} + +service_signal() { + SERVICE_SIG="${SERVICE_SIG:-USR1}" service -K "$@" +} + service_start() { service -S "$@" } service_stop() { - service -K "$@" + local try + SERVICE_SIG="${SERVICE_SIG:-$SERVICE_SIG_STOP}" service -K "$@" + while [ $((try++)) -lt $SERVICE_STOP_TIME ]; do + service -C "$@" || return 0 + sleep 1 + done + SERVICE_SIG="KILL" service -K "$@" + sleep 1 + ! service -C "$@" } service_reload() { - service -R "$@" + SERVICE_SIG="${SERVICE_SIG:-$SERVICE_SIG_RELOAD}" service -K "$@" } service_kill() { + cat 1>&2 << __END_OF_WARNING__ +# +# WARNING: the 'service_kill' function is now deprecated and might be +# removed soon. Consider using the other new service_* wrappers instead. +# +__END_OF_WARNING__ local name="${1}" local pid="${2:-$(pidof "$name")}" local grace="${3:-5}"