Official Debian rc.local

Prev		Next

Summary

Debian's official rc.local is /etc/rc.local. It is provided by the 'initscripts ' package.

Analysis

$ ls -l /etc/init.d/rc.local /etc/rc.local -rwxr-xr-x 1 root root 801 09-08 02:29 /etc/init.d/rc.local -rwxr-xr-x 1 root root 306 09-29 10:33 /etc/rc.local

Example 1. File /etc/init.d/rc.local

#! /bin/sh
### BEGIN INIT INFO
# Provides:          rc.local
# Required-Start:    $local_fs $remote_fs
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:
# Short-Description: Run /etc/rc.local if it exist
### END INIT INFO

[...]

do_start() {
        if [ -x /etc/rc.local ]; then
                [ "$VERBOSE" != no ] && log_begin_msg "Running local boot scripts (/etc/rc.local)"
                /etc/rc.local
                [ "$VERBOSE" != no ] && log_end_msg $?
        fi
}

case "$1" in
    start)
        do_start
        ;;
    restart|reload|force-reload)
        echo "Error: argument '$1' not supported" >&2
        exit 3
        ;;

[...]

$ grep rc.local /etc/runlevel.conf
99      -       2,3,4,5         /etc/init.d/rc.local

I.e., the /etc/init.d/rc.local starts /etc/rc.local, which is:

Example 2. File /etc/rc.local

#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

exit 0

$ dpkg -S /etc/init.d/rc.local
initscripts: /etc/init.d/rc.local

$ apt-cache show initscripts
Package: initscripts
Priority: required
[...]
Description: Scripts for initializing and shutting down the system
 The scripts in this package initialize a standard Debian
 GNU/Linux system at boot time and finalize it at halt or
 reboot time.
Tag: admin::boot, admin::power-management, interface::daemon, role::sw:utility, use::configuring

documented on: 2006.10.31