Version 16 (modified by Waldorf, 12 years ago) (diff) |
---|
init.d Script
(for other scripts, see the Scripts page)
Description
Installation
This should be installed at /etc/init.d/ as transmission-daemon. Make the script executable:
chmod +x /etc/init.d/transmission-daemon
Configuration
It's recommended to run Transmission in it's own user. By default, the script is configured to 'transmission'. For the sake of security you shouldn't set a password on this user Try:
$ adduser --disabled-password transmission
However, you can also set the USERNAME to any user you prefer.
For more information, visit the Running Transmission on a headless machine page
Use
Start and stop it manually by calling the init-script yourself.
/etc/init.d/transmission-daemon start
To stop transmission, just call the init-script with the "stop" parameter:
/etc/init.d/transmission-daemon stop
Script "transmission-daemon"
#! /bin/sh ### BEGIN INIT INFO # Provides: transmission-daemon # Required-Start: networking # Required-Stop: networking # Default-Start: 2 3 5 # Default-Stop: 0 1 6 # Short-Description: Start the transmission BitTorrent daemon client. ### END INIT INFO # Original Author: Lennart A. JÃŒtte, based on Rob Howell's script # Modified by Maarten Van Coile & others (on IRC) # Do NOT "set -e" # # ----- CONFIGURATION ----- # # For the default location Transmission uses, visit: # http://trac.transmissionbt.com/wiki/ConfigFiles # For a guide on how set the preferences, visit: # http://trac.transmissionbt.com/wiki/EditConfigFiles # For the available environement variables, visit: # http://trac.transmissionbt.com/wiki/EnvironmentVariables # # The name of the user that should run Transmission. # It's RECOMENDED to run Transmission in it's own user, # by default, this is set to 'transmission'. # For the sake of security you shouldn't set a password # on this user USERNAME=transmission # ----- *ADVANCED* CONFIGURATION ----- # Only change these options if you know what you are doing! # # The folder where Transmission stores the config & web files. # ONLY change this you have it at a non-default location #TRANSMISSION_HOME="/var/config/transmission-daemon" #TRANSMISSION_WEB_HOME="/usr/local/share/" # # The arguments passed on to transmission-daemon. # ONLY change this you need to, otherwise use the # settings file as per above. #TRANSMISSION_ARGS="" # ----- END OF CONFIGURATION ----- # # PATH should only include /usr/* if it runs after the mountnfs.sh script. PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin DESC="bittorrent client" NAME=transmission-daemon DAEMON=$(which $NAME) PIDFILE=/var/run/$NAME.pid SCRIPTNAME=/etc/init.d/$NAME # Exit if the package is not installed [ -x "$DAEMON" ] || exit 0 # Read configuration variable file if it is present [ -r /etc/default/$NAME ] && . /etc/default/$NAME # Load the VERBOSE setting and other rcS variables [ -f /etc/default/rcS ] && . /etc/default/rcS # Define LSB log_* functions. # Depend on lsb-base (>= 3.0-6) to ensure that this file is present. . /lib/lsb/init-functions # # Function that starts the daemon/service # do_start() { # Export the configuration/web directory, if set if [ -n "$TRANSMISSION_HOME" ]; then export TRANSMISSION_HOME fi if [ -n "$TRANSMISSION_WEB_HOME" ]; then export TRANSMISSION_WEB_HOME fi # Return # 0 if daemon has been started # 1 if daemon was already running # 2 if daemon could not be started start-stop-daemon --chuid $USERNAME --start --pidfile $PIDFILE --exec $DAEMON \ --test -- $TRANSMISSION_ARGS > /dev/null \ || return 1 start-stop-daemon --chuid $USERNAME --start --pidfile $PIDFILE --exec $DAEMON \ -- $TRANSMISSION_ARGS \ || return 2 } # # Function that stops the daemon/service # do_stop() { # Return # 0 if daemon has been stopped # 1 if daemon was already stopped # 2 if daemon could not be stopped # other if a failure occurred start-stop-daemon --stop --quiet --retry=TERM/10/KILL/5 --pidfile $PIDFILE --name $NAME RETVAL="$?" [ "$RETVAL" = 2 ] && return 2 # Wait for children to finish too if this is a daemon that forks # and if the daemon is only ever run from this initscript. # If the above conditions are not satisfied then add some other code # that waits for the process to drop all resources that could be # needed by services started subsequently. A last resort is to # sleep for some time. start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON [ "$?" = 2 ] && return 2 # Many daemons don't delete their pidfiles when they exit. rm -f $PIDFILE return "$RETVAL" } case "$1" in start) log_daemon_msg "Starting $DESC" "$NAME" do_start case "$?" in 0|1) log_end_msg 0 ;; 2) log_end_msg 1 ;; esac ;; stop) log_daemon_msg "Stopping $DESC" "$NAME" do_stop case "$?" in 0|1) log_end_msg 0 ;; 2) log_end_msg 1 ;; esac ;; restart|force-reload) # # If the "reload" option is implemented then remove the # 'force-reload' alias # log_daemon_msg "Restarting $DESC" "$NAME" do_stop case "$?" in 0|1) do_start case "$?" in 0) log_end_msg 0 ;; 1) log_end_msg 1 ;; # Old process is still running *) log_end_msg 1 ;; # Failed to start esac ;; *) # Failed to stop log_end_msg 1 ;; esac ;; *) echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2 exit 3 ;; esac :