fetchmail/fetchmail.init

#! /bin/sh
# Copyright (c) 1995-2008 SuSE Linux AG, Nuernberg, Germany.
# All rights reserved.
#
# Author: Stanislav Brabec <sbrabec@suse.cz>
#
# /etc/init.d/fetchmail
#
### BEGIN INIT INFO
# Provides:          fetchmail
# Required-Start:    $syslog $network $remote_fs sendmail
# Should-Start:
# Required-Stop:     $syslog $network $remote_fs sendmail
# Should-Stop:
# Default-Start:     3 5
# Default-Stop:      0 1 2 6
# Short-Description: Fetch mails for configured users
# Description:       Start fetchmail as root and fetch mails for configured users.
#	You must create configuration file /etc/fetchmailrc first.
### END INIT INFO
# 


# Check for missing binaries (stale symlinks should not happen)
# Note: Special treatment of stop for LSB conformance
FETCHMAIL_BIN=/usr/bin/fetchmail
test -x $FETCHMAIL_BIN || { echo "$FETCHMAIL_BIN not installed"; 
	if [ "$1" = "stop" ]; then exit 0;
	else exit 5; fi; }

# Check for existence of needed config file and read it
FETCHMAIL_CONFIG=/etc/sysconfig/fetchmail
FETCHMAIL_RC=/etc/fetchmailrc
test -r $FETCHMAIL_CONFIG || { echo "$FETCHMAIL_CONFIG not existing";
	if [ "$1" = "stop" ]; then exit 0;
	else exit 6; fi; }
test -r $FETCHMAIL_RC || { echo "$FETCHMAIL_RC not existing";
	if [ "$1" = "stop" ]; then exit 0;
	else exit 6; fi; }

# Read config
FETCHMAIL_POLLING_INTERVAL="600"
FETCHMAIL_FETCHALL="yes"
FETCHMAIL_SILENT="no"
FETCHMAIL_USER="fetchmail"
FETCHMAIL_EXPERT_OPTIONS=""

. $FETCHMAIL_CONFIG

FETCHMAIL_FETCHALL_OPTION=
if [ "$FETCHMAIL_FETCHALL" = "yes" ] ; then
    FETCHMAIL_FETCHALL_OPTION=" -a"
fi
FETCHMAIL_SILENT_OPTION=
if [ "$FETCHMAIL_SILENT" = "yes" ] ; then
    FETCHMAIL_SILENT_OPTION=" -s"
fi

if [ "$FETCHMAIL_USER" = "fetchmail" ] ; then
    if [ -z "$FETCHMAILHOME" ] ; then
	export FETCHMAILHOME=/var/lib/fetchmail
    fi
fi

# 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     be verbose in local rc status and clear it afterwards
#      rc_status -v -r  ditto and clear both the local and overall rc status
#      rc_status -s     display "skipped" and exit with status 3
#      rc_status -u     display "unused" and exit with status 3
#      rc_failed        set local and overall rc status to failed
#      rc_failed <num>  set local and overall rc status to <num>
#      rc_reset         clear both the local and overall rc status
#      rc_exit          exit appropriate to overall rc status
#      rc_active        checks whether a service is activated by symlinks
#      rc_splash arg    sets the boot splash screen to arg (if active)
. /etc/rc.status

# 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       - user had insufficient privileges
# 5       - program is not installed
# 6       - program is not configured
# 7       - program is not running
# 8--199  - reserved (8--99 LSB, 100--149 distrib, 150--199 appl)
# 
# Note that starting an already running service, stopping
# or restarting a not-running service as well as the restart
# with force-reload (in case signaling is not supported) are
# considered a success.

case "$1" in
    oneshot)
	# Check for mails once just now.
	if checkproc $FETCHMAIL_BIN ; then
	    # Trigger fetching of existing daemon. Root UID is OK.
	    su $FETCHMAIL_USER -s /bin/sh -c $FETCHMAIL_BIN
	else
	    startproc -u $FETCHMAIL_USER $FETCHMAIL_BIN -d 0$FETCHMAIL_FETCHALL_OPTION$FETCHMAIL_SILENT_OPTION $FETCHMAIL_EXPERT_OPTIONS -f $FETCHMAIL_RC -L /var/log/fetchmail 2>&1
	fi
	# Remember status and don'ŧ be verbose
	rc_status
	;;
    start)
	if [ $# -ge 2 ]; then
		if echo "$2" | grep -E "^[0-9]+$" >& /dev/null ; then
			FETCHMAIL_POLLING_INTERVAL="$2"
		else
			echo "Invalid polling interval specified: '$2', using default: $FETCHMAIL_POLLING_INTERVAL"
		fi
	fi

	echo -n "Starting fetchmail"
	## Start daemon with startproc(8). If this fails
	## the return value is set appropriately by startproc.
	startproc -u $FETCHMAIL_USER $FETCHMAIL_BIN -d $FETCHMAIL_POLLING_INTERVAL$FETCHMAIL_FETCHALL_OPTION$FETCHMAIL_SILENT_OPTION $FETCHMAIL_EXPERT_OPTIONS -f $FETCHMAIL_RC -L /var/log/fetchmail 2>&1

	# Remember status and be verbose
	rc_status -v
	;;
    stop)
	echo -n "Shutting down fetchmail"
	## Stop daemon with killproc(8) and if this fails
	## killproc sets the return value according to LSB.

	killproc -TERM $FETCHMAIL_BIN

	# Remember status and be verbose
	rc_status -v
	;;
    try-restart|condrestart)
	## Do a restart only if the service was active before.
	## Note: try-restart is now part of LSB (as of 1.9).
	## RH has a similar command named condrestart.
	if test "$1" = "condrestart"; then
		echo "${attn} Use try-restart ${done}(LSB)${attn} rather than condrestart ${warn}(RH)${norm}"
	fi
	$0 status
	if test $? = 0; then
		$0 restart "$2"
	else
		rc_reset	# Not running is not a failure.
	fi
	# 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 "$2"

	# Remember status and be quiet
	rc_status
	;;
    force-reload)
	## Signal the daemon to reload its config. Most daemons
	## do this on signal 1 (SIGHUP).
	## If it does not support it, restart.

	echo -n "Reload service fetchmail"
	## if it supports it:
	killproc -HUP $FETCHMAIL_BIN
	#touch /var/run/fetchmail.pid
	rc_status -v

	## Otherwise:
	#$0 stop  &&  $0 start
	#rc_status
	;;
    reload)
	## Like force-reload, but if daemon does not support
	## signaling, do nothing (!)

	# If it supports signaling:
	echo -n "Reload service fetchmail"
	killproc -HUP $FETCHMAIL_BIN
	#touch /var/run/fetchmail.pid
	rc_status -v
	
	## Otherwise if it does not support reload:
	#rc_failed 3
	#rc_status -v
	;;
    status)
	echo -n "Checking for service fetchmail"
	## 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 up and running
	# 1 - service dead, but /var/run/  pid  file exists
	# 2 - service dead, but /var/lock/ lock file exists
	# 3 - service not running (unused)
	# 4 - service status unknown :-(
	# 5--199 reserved (5--99 LSB, 100--149 distro, 150--199 appl.)
	
	# NOTE: checkproc returns LSB compliant status values.
	checkproc $FETCHMAIL_BIN
	# NOTE: rc_status knows that we called this init script with
	# "status" option and adapts its messages accordingly.
	rc_status -v
	;;
    probe)
	## Optional: Probe for the necessity of a reload, print out the
	## argument to this init script which is required for a reload.
	## Note: probe is not (yet) part of LSB (as of 1.9)

	test $FETCHMAIL_CONFIG -nt /var/run/fetchmail.pid || test $FETCHMAIL_RC -nt /var/run/fetchmail.pid && echo reload
	;;
    *)
	echo "Usage: $0 {oneshot|start|stop|status|try-restart|restart|force-reload|reload} [polling interval]"
	exit 1
	;;
esac
rc_exit