[doc] doc/initscripts.txt (fixes #2782)

add doc/initscripts.txt with description of lighttpd signal handling
  and links to the initscripts of various operating system distros

remove doc/initscripts/*

x-ref:
  "init scripts outdated, should be removed"
  https://redmine.lighttpd.net/issues/2782

7 files changed, 43 insertions, 246 deletions

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 23c99ffe..7cdd17d1 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,6 +1,7 @@
-SUBDIRS=config scripts initscripts systemd outdated
+SUBDIRS=config scripts systemd outdated
 dist_man8_MANS=lighttpd.8 lighttpd-angel.8
 
 EXTRA_DIST= \
+	initscripts.txt \
 	newstyle.css \
 	oldstyle.css
diff --git a/doc/config/lighttpd.conf b/doc/config/lighttpd.conf
index 28297402..4794eb80 100644
--- a/doc/config/lighttpd.conf
+++ b/doc/config/lighttpd.conf
@@ -486,6 +486,6 @@ server.upload-dirs = ( "/var/tmp" )
 ## custom includes like vhosts.
 ##
 #include "conf.d/config.conf"
-#include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
+#include "/etc/lighttpd/vhosts.d/*.conf"
 ##
 #######################################################################
diff --git a/doc/initscripts.txt b/doc/initscripts.txt
new file mode 100644
index 00000000..44ea53fc
--- /dev/null
+++ b/doc/initscripts.txt
@@ -0,0 +1,40 @@
+* lighttpd responds to the following signals:
+
+SIGINT  - shut down gracefully  (finish serving existing connections and exit)
+SIGTERM - shut down immediately (terminate existing connections and exit)
+SIGHUP  - re-open log files     (NOTE: does not reload lighttpd configuration)
+
+
+* lighttpd graceful restart
+
+https://blog.lighttpd.net/articles/2005/09/02/graceful-restart/
+The current recommended way to reload lighttpd config is to gracefully stop
+and then to restart lighttpd.
+
+
+* lighttpd initscripts
+
+Depending on the operating system and distribution brand, there are many
+ways to set up lighttpd to run as a daemon when the system starts up, and
+to send signals to lighttpd for start/stop/restart/etc.
+
+Rather than attempting to maintain scripts for an unknown number of distros,
+here are links to a few, which can be used as examples.
+
+Arch:
+https://git.archlinux.org/svntogit/packages.git/tree/trunk?h=packages/lighttpd
+
+Debian:
+https://anonscm.debian.org/cgit/pkg-lighttpd/lighttpd.git/tree/debian
+
+Fedora:
+http://pkgs.fedoraproject.org/cgit/rpms/lighttpd.git/tree/
+
+Gentoo:
+https://gitweb.gentoo.org/repo/gentoo.git/tree/www-servers/lighttpd/files
+
+openSUSE:
+https://build.opensuse.org/package/show/server:http/lighttpd
+
+Additional, updated information may be found at
+https://redmine.lighttpd.net/projects/lighttpd/wiki/InstallFromSource
diff --git a/doc/initscripts/Makefile.am b/doc/initscripts/Makefile.am
deleted file mode 100644
index dfed8581..00000000
--- a/doc/initscripts/Makefile.am
+++ /dev/null
@@ -1 +0,0 @@
-EXTRA_DIST=rc.lighttpd rc.lighttpd.redhat sysconfig.lighttpd
diff --git a/doc/initscripts/rc.lighttpd b/doc/initscripts/rc.lighttpd
deleted file mode 100755
index da0d2449..00000000
--- a/doc/initscripts/rc.lighttpd
+++ /dev/null
@@ -1,155 +0,0 @@
-#! /bin/sh
-# Copyright (c) 1995-2002 SuSE Linux AG, Nuernberg, Germany.
-# All rights reserved.
-#
-# Author: Kurt Garloff <feedback@suse.de>
-#
-# /etc/init.d/FOO
-#
-#   and symbolic its link
-#
-# /(usr/)sbin/rcFOO
-#
-# LSB compliant service control script; see http://www.linuxbase.org/spec/
-#
-# System startup script for some example service or daemon FOO (template)
-#
-### BEGIN INIT INFO
-# Provides: FOO
-# Required-Start: $remote_fs $syslog
-# Required-Stop:  $remote_fs $syslog
-# Default-Start:  3 5
-# Default-Stop:   0 1 2 6
-# Description:    Start FOO to allow XY and provide YZ
-#	continued on second line by '#<TAB>'
-### END INIT INFO
-#
-# Note on Required-Start: It does specify the init script ordering,
-# not real dependencies. Depencies have to be handled by admin
-# resp. the configuration tools (s)he uses.
-
-# Source SuSE config (if still necessary, most info has been moved)
-test -r /etc/rc.config && . /etc/rc.config
-
-# Check for missing binaries (stale symlinks should not happen)
-LIGHTTPD_BIN=/usr/sbin/lighttpd
-test -x $LIGHTTPD_BIN || exit 5
-
-# Check for existence of needed config file and read it
-LIGHTTPD_CONFIG=/etc/sysconfig/lighttpd
-test -r $LIGHTTPD_CONFIG || exit 6
-. $LIGHTTPD_CONFIG
-
-# Shell functions sourced from /etc/rc.status:
-#      rc_check         check and set local and overall rc status
-#      rc_status        check and set local and overall rc status
-#      rc_status -v     ditto but be verbose in local rc status
-#      rc_status -v -r  ditto and clear the local rc status
-#      rc_failed        set local and overall rc status to failed
-#      rc_failed <num>  set local and overall rc status to <num><num>
-#      rc_reset         clear local rc status (overall remains)
-#      rc_exit          exit appropriate to overall rc status
-#      rc_active	checks whether a service is activated by symlinks
-. /etc/rc.status
-
-# First reset status of this service
-rc_reset
-
-# Return values acc. to LSB for all commands but status:
-# 0 - success
-# 1 - generic or unspecified error
-# 2 - invalid or excess argument(s)
-# 3 - unimplemented feature (e.g. "reload")
-# 4 - insufficient privilege
-# 5 - program is not installed
-# 6 - program is not configured
-# 7 - program is not running
-#
-# Note that starting an already running service, stopping
-# or restarting a not-running service as well as the restart
-# with force-reload (in case signalling is not supported) are
-# considered a success.
-
-case "$1" in
-    start)
-	echo -n "Starting lighttpd"
-	## Start daemon with startproc(8). If this fails
-	## the echo return value is set appropriate.
-
-	# NOTE: startproc returns 0, even if service is
-	# already running to match LSB spec.
-	startproc $LIGHTTPD_BIN -f $LIGHTTPD_CONF_PATH
-
-	# Remember status and be verbose
-	rc_status -v
-	;;
-    stop)
-	echo -n "Shutting down lighttpd"
-	## Stop daemon with killproc(8) and if this fails
-	## set echo the echo return value.
-
-	killproc -TERM $LIGHTTPD_BIN
-
-	# Remember status and be verbose
-	rc_status -v
-	;;
-    try-restart)
-	## Stop the service and if this succeeds (i.e. the
-	## service was running before), start it again.
-	## Note: try-restart is not (yet) part of LSB (as of 0.7.5)
-	$0 status >/dev/null &&  $0 restart
-
-	# Remember status and be quiet
-	rc_status
-	;;
-    restart)
-	## Stop the service and regardless of whether it was
-	## running or not, start it again.
-	$0 stop
-	$0 start
-
-	# Remember status and be quiet
-	rc_status
-	;;
-    force-reload|reload)
-	## Like force-reload, but if daemon does not support
-	## signalling, do nothing (!)
-
-	# If it supports signalling:
-	echo -n "Reload service LIGHTTPD"
-	killproc -INT $LIGHTTPD_BIN
-	$0 start
-	touch /var/run/lighttpd.pid
-	rc_status -v
-
-	## Otherwise if it does not support reload:
-	#rc_failed 3
-	#rc_status -v
-	;;
-    status)
-	echo -n "Checking for service LIGHTTPD: "
-	## Check status with checkproc(8), if process is running
-	## checkproc will return with exit status 0.
-
-	# Return value is slightly different for the status command:
-	# 0 - service running
-	# 1 - service dead, but /var/run/  pid  file exists
-	# 2 - service dead, but /var/lock/ lock file exists
-	# 3 - service not running
-
-	# NOTE: checkproc returns LSB compliant status values.
-	checkproc $LIGHTTPD_BIN
-	rc_status -v
-	;;
-    probe)
-	## Optional: Probe for the necessity of a reload,
-	## print out the argument which is required for a reload.
-
-	test /etc/lighttpd/lighttpd.conf -nt /var/run/lighttpd.pid && echo reload
-	;;
-    *)
-	echo "Usage: $0 {start|stop|status|try-restart|restart|force-reload|reload|probe}"
-	exit 1
-	;;
-esac
-rc_exit
diff --git a/doc/initscripts/rc.lighttpd.redhat b/doc/initscripts/rc.lighttpd.redhat
deleted file mode 100755
index e22d551d..00000000
--- a/doc/initscripts/rc.lighttpd.redhat
+++ /dev/null
@@ -1,87 +0,0 @@
-#!/bin/sh
-#
-# lighttpd     Startup script for the lighttpd server
-#
-# chkconfig: - 85 15
-# description: Lightning fast webserver with light system requirements
-#
-# processname: lighttpd
-# config: /etc/lighttpd/lighttpd.conf
-# config: /etc/sysconfig/lighttpd
-# pidfile: /var/run/lighttpd.pid
-#
-# Note: pidfile is assumed to be created
-# by lighttpd (config: server.pid-file).
-# If not, uncomment 'pidof' line.
-
-# Source function library
-. /etc/rc.d/init.d/functions
-
-if [ -f /etc/sysconfig/lighttpd ]; then
-	. /etc/sysconfig/lighttpd
-fi
-
-if [ -z "$LIGHTTPD_CONF_PATH" ]; then
-	LIGHTTPD_CONF_PATH="/etc/lighttpd/lighttpd.conf"
-fi
-
-prog="lighttpd"
-lighttpd="/usr/sbin/lighttpd"
-RETVAL=0
-
-start() {
-	echo -n $"Starting $prog: "
-	daemon $lighttpd -f $LIGHTTPD_CONF_PATH
-	RETVAL=$?
-	echo
-	[ $RETVAL -eq 0 ] && touch /var/lock/subsys/$prog
-	return $RETVAL
-}
-
-stop() {
-	echo -n $"Stopping $prog: "
-	killproc $lighttpd
-	RETVAL=$?
-	echo
-	[ $RETVAL -eq 0 ] && rm -f /var/lock/subsys/$prog
-	return $RETVAL
-}
-
-reload() {
-	echo -n $"Reloading $prog: "
-	killproc $lighttpd -HUP
-	RETVAL=$?
-	echo
-	return $RETVAL
-}
-
-case "$1" in
-	start)
-		start
-		;;
-	stop)
-		stop
-		;;
-	restart)
-		stop
-		start
-		;;
-	condrestart)
-		if [ -f /var/lock/subsys/$prog ]; then
-			stop
-			start
-		fi
-		;;
-	reload)
-		reload
-		;;
-	status)
-		status $lighttpd
-		RETVAL=$?
-		;;
-	*)
-		echo $"Usage: $0 {start|stop|restart|condrestart|reload|status}"
-		RETVAL=1
-esac
-
-exit $RETVAL
diff --git a/doc/initscripts/sysconfig.lighttpd b/doc/initscripts/sysconfig.lighttpd
deleted file mode 100644
index c8154c96..00000000
--- a/doc/initscripts/sysconfig.lighttpd
+++ /dev/null
@@ -1 +0,0 @@
-LIGHTTPD_CONF_PATH=/etc/lighttpd/lighttpd.conf