release/src/router/p910nd/p910nd.init

   1 #!/bin/bash
   2 #
   3 #     LSB system startup script for service/daemon p910nd
   4 #     Copyright (C) 1995--2005  Kurt Garloff, SUSE / Novell Inc.
   5 #     Copyright (C) 2008        Ken Yap
   6 #
   7 #     This library is free software; you can redistribute it and/or modify it
   8 #     under the terms of the GNU Lesser General Public License as published by
   9 #     the Free Software Foundation; either version 2.1 of the License, or (at
  10 #     your option) any later version.
  11 #
  12 #     This library is distributed in the hope that it will be useful, but
  13 #     WITHOUT ANY WARRANTY; without even the implied warranty of
  14 #     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 #     Lesser General Public License for more details.
  16 #
  17 #     You should have received a copy of the GNU Lesser General Public
  18 #     License along with this library; if not, write to the Free Software
  19 #     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
  20 #     USA.
  21 #
  22 # /etc/init.d/p910nd
  23 #   and its symbolic link
  24 # /(usr/)sbin/rcp910nd
  25 #
  26 # Template system startup script for some example service/daemon p910nd
  27 #
  28 # LSB compatible service control script; see http://www.linuxbase.org/spec/
  29 #
  30 # Note: This template uses functions rc_XXX defined in /etc/rc.status on
  31 # UnitedLinux/SUSE/Novell based Linux distributions. If you want to base your
  32 # script on this template and ensure that it works on non UL based LSB
  33 # compliant Linux distributions, you either have to provide the rc.status
  34 # functions from UL or change the script to work without them.
  35 # See skeleton.compat for a template that works with other distros as well.
  36 #
  37 # chkconfig: 35 90 10
  38 # description: p910nd daemon providing network printer access
  39 #
  40 ### BEGIN INIT INFO
  41 # Provides:          p910nd
  42 # Required-Start:    $syslog
  43 # Should-Start:
  44 # Required-Stop:     $syslog
  45 # Should-Stop:
  46 # Default-Start:     3 5
  47 # Default-Stop:      0 1 2 6
  48 # Short-Description: p910nd daemon providing network printer access
  49 # Description:       Start p910nd to provide port 9100+n printer service
  50 ### END INIT INFO
  51 #
  52 # Any extensions to the keywords given above should be preceeded by
  53 # X-VendorTag- according to LSB.
  54 #
  55 # Notes on Required-Start/Should-Start:
  56 # * There are two different issues that are solved by Required-Start
  57 #    and Should-Start
  58 # (a) Hard dependencies: This is used by the runlevel editor to determine
  59 #     which services absolutely need to be started to make the start of
  60 #     this service make sense. Example: nfsserver should have
  61 #     Required-Start: $portmap
  62 #     Also, required services are started before the dependent ones.
  63 #     The runlevel editor will warn about such missing hard dependencies
  64 #     and suggest enabling. During system startup, you may expect an error,
  65 #     if the dependency is not fulfilled.
  66 # (b) Specifying the init script ordering, not real (hard) dependencies.
  67 #     This is needed by insserv to determine which service should be
  68 #     started first (and at a later stage what services can be started
  69 #     in parallel). The tag Should-Start: is used for this.
  70 #     It tells, that if a service is available, it should be started
  71 #     before. If not, never mind.
  72 # * When specifying hard dependencies or ordering requirements, you can
  73 #   use names of services (contents of their Provides: section)
  74 #   or pseudo names starting with a $. The following ones are available
  75 #   according to LSB (1.1):
  76 #       $local_fs               all local file systems are mounted
  77 #                               (most services should need this!)
  78 #       $remote_fs              all remote file systems are mounted
  79 #                               (note that /usr may be remote, so
  80 #                                many services should Require this!)
  81 #       $syslog                 system logging facility up
  82 #       $network                low level networking (eth card, ...)
  83 #       $named                  hostname resolution available
  84 #       $netdaemons             all network daemons are running
  85 #   The $netdaemons pseudo service has been removed in LSB 1.2.
  86 #   For now, we still offer it for backward compatibility.
  87 #   These are new (LSB 1.2):
  88 #       $time                   the system time has been set correctly
  89 #       $portmap                SunRPC portmapping service available
  90 #   UnitedLinux/SUSE/Novell extensions:
  91 #       $ALL                    indicates that a script should be inserted
  92 #                               at the end
  93 # * The services specified in the stop tags
  94 #   (Required-Stop/Should-Stop)
  95 #   specify which services need to be still running when this service
  96 #   is shut down. Often the entries there are just copies or a subset
  97 #   from the respective start tag.
  98 # * Should-Start/Stop are now part of LSB as of 2.0,
  99 #   formerly SUSE/Unitedlinux used X-UnitedLinux-Should-Start/-Stop.
 100 #   insserv does support both variants.
 101 # * X-UnitedLinux-Default-Enabled: yes/no is used at installation time
 102 #   (%fillup_and_insserv macro in %post of many RPMs) to specify whether
 103 #   a startup script should default to be enabled after installation.
 104 #
 105 # Note on runlevels:
 106 # 0 - halt/poweroff                     6 - reboot
 107 # 1 - single user                       2 - multiuser without network exported
 108 # 3 - multiuser w/ network (text mode)  5 - multiuser w/ network and X11 (xdm)
 109 #
 110 # Note on script names:
 111 # http://www.linuxbase.org/spec/refspecs/LSB_1.3.0/gLSB/gLSB/scrptnames.html
 112 # A registry has been set up to manage the init script namespace.
 113 # http://www.lanana.org/
 114 # Please use the names already registered or register one or use a
 115 # vendor prefix.
 116
 117
 118 # Check for missing binaries (stale symlinks should not happen)
 119 # Note: Special treatment of stop for LSB conformance
 120 P910ND_BIN=/usr/sbin/p910nd
 121 test -x $P910ND_BIN || { echo "$P910ND_BIN not installed";
 122         if [ "$1" = "stop" ]; then exit 0;
 123         else exit 5; fi; }
 124
 125 # Check for existence of needed config file and read it
 126 P910ND_CONFIG=/etc/sysconfig/p910nd
 127 test -r $P910ND_CONFIG || { echo "$P910ND_CONFIG not found";
 128         if [ "$1" = "stop" ]; then exit 0;
 129         else exit 6; fi; }
 130
 131 # Read config
 132 . $P910ND_CONFIG
 133
 134 # Source LSB init functions
 135 # providing start_daemon, killproc, pidofproc,
 136 # log_success_msg, log_failure_msg and log_warning_msg.
 137 # This is currently not used by UnitedLinux based distributions and
 138 # not needed for init scripts for UnitedLinux only. If it is used,
 139 # the functions from rc.status should not be sourced or used.
 140 #. /lib/lsb/init-functions
 141
 142 # Shell functions sourced from /etc/rc.status:
 143 #      rc_check         check and set local and overall rc status
 144 #      rc_status        check and set local and overall rc status
 145 #      rc_status -v     be verbose in local rc status and clear it afterwards
 146 #      rc_status -v -r  ditto and clear both the local and overall rc status
 147 #      rc_status -s     display "skipped" and exit with status 3
 148 #      rc_status -u     display "unused" and exit with status 3
 149 #      rc_failed        set local and overall rc status to failed
 150 #      rc_failed <num>  set local and overall rc status to <num>
 151 #      rc_reset         clear both the local and overall rc status
 152 #      rc_exit          exit appropriate to overall rc status
 153 #      rc_active        checks whether a service is activated by symlinks
 154
 155 # Use the SUSE rc_ init script functions;
 156 # emulate them on LSB, RH and other systems
 157
 158 # Default: Assume sysvinit binaries exist
 159 start_daemon() { /sbin/start_daemon ${1+"$@"}; }
 160 killproc()     { /sbin/killproc     ${1+"$@"}; }
 161 pidofproc()    { /sbin/pidofproc    ${1+"$@"}; }
 162 checkproc()    { /sbin/checkproc    ${1+"$@"}; }
 163 if test -e /etc/rc.status; then
 164     # SUSE rc script library
 165     . /etc/rc.status
 166 else
 167     export LC_ALL=POSIX
 168     _cmd=$1
 169     declare -a _SMSG
 170     if test "${_cmd}" = "status"; then
 171         _SMSG=(running dead dead unused unknown reserved)
 172         _RC_UNUSED=3
 173     else
 174         _SMSG=(done failed failed missed failed skipped unused failed failed reserved)
 175         _RC_UNUSED=6
 176     fi
 177     if test -e /lib/lsb/init-functions; then
 178         # LSB
 179         . /lib/lsb/init-functions
 180         echo_rc()
 181         {
 182             if test ${_RC_RV} = 0; then
 183                 log_success_msg "  [${_SMSG[${_RC_RV}]}] "
 184             else
 185                 log_failure_msg "  [${_SMSG[${_RC_RV}]}] "
 186             fi
 187         }
 188         # TODO: Add checking for lockfiles
 189         checkproc() { return pidofproc ${1+"$@"} >/dev/null 2>&1; }
 190     elif test -e /etc/init.d/functions; then
 191         # RHAT
 192         . /etc/init.d/functions
 193         echo_rc()
 194         {
 195             #echo -n "  [${_SMSG[${_RC_RV}]}] "
 196             if test ${_RC_RV} = 0; then
 197                 success "  [${_SMSG[${_RC_RV}]}] "
 198             else
 199                 failure "  [${_SMSG[${_RC_RV}]}] "
 200             fi
 201         }
 202         checkproc() { return status ${1+"$@"}; }
 203         start_daemon() { return daemon ${1+"$@"}; }
 204     else
 205         # emulate it
 206         echo_rc() { echo "  [${_SMSG[${_RC_RV}]}] "; }
 207     fi
 208     rc_reset() { _RC_RV=0; }
 209     rc_failed()
 210     {
 211         if test -z "$1"; then
 212             _RC_RV=1;
 213         elif test "$1" != "0"; then
 214             _RC_RV=$1;
 215         fi
 216         return ${_RC_RV}
 217     }
 218     rc_check()
 219     {
 220         return rc_failed $?
 221     }
 222     rc_status()
 223     {
 224         rc_failed $?
 225         if test "$1" = "-r"; then _RC_RV=0; shift; fi
 226         if test "$1" = "-s"; then rc_failed 5; echo_rc; rc_failed 3; shift; fi
 227         if test "$1" = "-u"; then rc_failed ${_RC_UNUSED}; echo_rc; rc_failed 3; shift; fi
 228         if test "$1" = "-v"; then echo_rc; shift; fi
 229         if test "$1" = "-r"; then _RC_RV=0; shift; fi
 230         return ${_RC_RV}
 231     }
 232     rc_exit() { exit ${_RC_RV}; }
 233     rc_active()
 234     {
 235         if test -z "$RUNLEVEL"; then read RUNLEVEL REST < <(/sbin/runlevel); fi
 236         if test -e /etc/init.d/S[0-9][0-9]${1}; then return 0; fi
 237         return 1
 238     }
 239 fi
 240
 241 # Reset status of this service
 242 rc_reset
 243
 244 # Return values acc. to LSB for all commands but status:
 245 # 0       - success
 246 # 1       - generic or unspecified error
 247 # 2       - invalid or excess argument(s)
 248 # 3       - unimplemented feature (e.g. "reload")
 249 # 4       - user had insufficient privileges
 250 # 5       - program is not installed
 251 # 6       - program is not configured
 252 # 7       - program is not running
 253 # 8--199  - reserved (8--99 LSB, 100--149 distrib, 150--199 appl)
 254 #
 255 # Note that starting an already running service, stopping
 256 # or restarting a not-running service as well as the restart
 257 # with force-reload (in case signaling is not supported) are
 258 # considered a success.
 259
 260 case "$1" in
 261     start)
 262         echo -n "Starting p910nd "
 263         ## Start daemon with startproc(8). If this fails
 264         ## the return value is set appropriately by startproc.
 265         startproc $P910ND_BIN $P910ND_OPTS $P910ND_NUM
 266
 267         # Remember status and be verbose
 268         rc_status -v
 269         ;;
 270     stop)
 271         echo -n "Shutting down p910nd "
 272         ## Stop daemon with killproc(8) and if this fails
 273         ## killproc sets the return value according to LSB.
 274
 275         killproc -TERM $P910ND_BIN
 276
 277         # Remember status and be verbose
 278         rc_status -v
 279         ;;
 280     try-restart|condrestart)
 281         ## Do a restart only if the service was active before.
 282         ## Note: try-restart is now part of LSB (as of 1.9).
 283         ## RH has a similar command named condrestart.
 284         if test "$1" = "condrestart"; then
 285                 echo "${attn} Use try-restart ${done}(LSB)${attn} rather than condrestart ${warn}(RH)${norm}"
 286         fi
 287         $0 status
 288         if test $? = 0; then
 289                 $0 restart
 290         else
 291                 rc_reset        # Not running is not a failure.
 292         fi
 293         # Remember status and be quiet
 294         rc_status
 295         ;;
 296     restart)
 297         ## Stop the service and regardless of whether it was
 298         ## running or not, start it again.
 299         $0 stop
 300         $0 start
 301
 302         # Remember status and be quiet
 303         rc_status
 304         ;;
 305     force-reload)
 306         ## Signal the daemon to reload its config. Most daemons
 307         ## do this on signal 1 (SIGHUP).
 308         ## If it does not support it, restart the service if it
 309         ## is running.
 310
 311         echo -n "Reload service p910nd "
 312         ## if it supports it:
 313         #killproc -HUP $P910ND_BIN
 314         #touch /var/run/p910nd.pid
 315         #rc_status -v
 316
 317         ## Otherwise:
 318         $0 try-restart
 319         rc_status
 320         ;;
 321     reload)
 322         ## Like force-reload, but if daemon does not support
 323         ## signaling, do nothing (!)
 324
 325         # If it supports signaling:
 326         echo -n "Reload service p910nd "
 327         #killproc -HUP $P910ND_BIN
 328         #touch /var/run/p910nd.pid
 329         #rc_status -v
 330
 331         ## Otherwise if it does not support reload:
 332         rc_failed 3
 333         rc_status -v
 334         ;;
 335     status)
 336         echo -n "Checking for service p910nd "
 337         ## Check status with checkproc(8), if process is running
 338         ## checkproc will return with exit status 0.
 339
 340         # Return value is slightly different for the status command:
 341         # 0 - service up and running
 342         # 1 - service dead, but /var/run/  pid  file exists
 343         # 2 - service dead, but /var/lock/ lock file exists
 344         # 3 - service not running (unused)
 345         # 4 - service status unknown :-(
 346         # 5--199 reserved (5--99 LSB, 100--149 distro, 150--199 appl.)
 347
 348         # NOTE: checkproc returns LSB compliant status values.
 349         checkproc $P910ND_BIN
 350         # NOTE: rc_status knows that we called this init script with
 351         # "status" option and adapts its messages accordingly.
 352         rc_status -v
 353         ;;
 354     *)
 355         echo "Usage: $0 {start|stop|status|try-restart|restart|force-reload|reload}"
 356         exit 1
 357         ;;
 358 esac
 359 rc_exit