[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
This commit is contained in:
Glenn Strauss 2017-01-23 06:01:28 -05:00
parent 739ccb5de0
commit 92c724eac6
8 changed files with 43 additions and 247 deletions

View File

@ -986,7 +986,6 @@ AC_CONFIG_FILES([Makefile src/Makefile
doc/config/vhosts.d/Makefile \
doc/config/Makefile \
doc/scripts/Makefile \
doc/initscripts/Makefile \
doc/systemd/Makefile \
doc/outdated/Makefile \
doc/Makefile \

View File

@ -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

View File

@ -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"
##
#######################################################################

40
doc/initscripts.txt Normal file
View File

@ -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

View File

@ -1 +0,0 @@
EXTRA_DIST=rc.lighttpd rc.lighttpd.redhat sysconfig.lighttpd

View File

@ -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

View File

@ -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

View File

@ -1 +0,0 @@
LIGHTTPD_CONF_PATH=/etc/lighttpd/lighttpd.conf