From b9fa0f85a26cd8e512d9941f6e203e9fc7d59109 Mon Sep 17 00:00:00 2001 From: Joachim Nilsson Date: Wed, 3 Aug 2016 11:12:56 +0200 Subject: [PATCH] Update inline documentation for Debian finit.conf Signed-off-by: Joachim Nilsson --- contrib/debian/finit.conf | 30 +++++++++++++----------------- 1 file changed, 13 insertions(+), 17 deletions(-) diff --git a/contrib/debian/finit.conf b/contrib/debian/finit.conf index a6362ed1..4a4148ae 100644 --- a/contrib/debian/finit.conf +++ b/contrib/debian/finit.conf @@ -1,6 +1,8 @@ # /etc/finit.conf: Example for Debian GNU/Linux 8.5 +# Here we use one big (?) finit.conf, but all non-bootstrap services +# can just as easily be listed in a separate /etc/finit.d/*.conf -# The host directive is a fallback/alternative if /etc/hostname is missing +# The host directive is a fallback if /etc/hostname is missing host jessie # The user directive is only for the startx directive, which in turn is @@ -14,14 +16,14 @@ module evdev module loop module psmouse -# Runlevel to start after bootstrap, runlevel 'S'. Change this to -# 3 to start XDM at boot. Reminds you a bit of /etc/inittab huh? +# Runlevel to start after bootstrap, runlevel 'S'. +# Change this to 3 to start XDM at boot. runlevel 2 # Some services may need to start very early, e.g. a watchdog daemon. -# Runlevel [S] (bootStrap) is useful for that, it cannot be restarted -# either, so tasks and run directives usually live here. Please note, -# te run directive is blocking, so be careful! +# Runlevel [S] (bootStrap) is useful for that. It cannot be switched +# to at runtime either, so tasks and run directives usually live here. +# Please note, the run directive is blocking, so be careful! #service [S12345] /sbin/watchdogd -n -- Watchdog daemon #run [S] /sbin/probe -- system probe #run [S] /sbin/setupd --bootstrap -- system bootstrap @@ -30,7 +32,10 @@ service [S12345] /usr/sbin/rsyslogd -n -- Syslog daemon # Network bringup script not needed if /etc/network/interfaces is used #network service networking start -# Regular services to be monitored and respawned as needed +# Regular services to be monitored and respawned as needed. Here we use +# a (svc) condition, the listed service must be started (waits for the +# PID file to be created in /run/*.pid) before starting either service, +# (net) conditions are also available. service [2345] log /usr/sbin/acpid -f -- ACPI daemon service [2345] /usr/sbin/sshd -D -- SSH daemon @@ -47,18 +52,9 @@ runparts /etc/start.d # |-- S17kbd # `- S18console-setup -# Alternative using tasks instead of runparts. Tasks are one-shot per -# runlevel, so will run once, in parallel when switching to an allowed -# runlevel. The following commented out example default to runlevels -# [2345]. Another approach for keyboard-setup & C:o that only need to -# run once per boot, is to run them in [S] or put them in /etc/rc.local -#task log /etc/init.d/keyboard-setup start -- Setting up preliminary keymap -#task log /etc/init.d/kbd start -- Preparing console - # Virtual consoles to start getty on. Runlevels, speed & $TERM optional # TTYs are also services, sort of, but they are guaranteed to start at -# the very end of the boot sequence. +# the very end of the boot sequence. Finit comes with a built-in getty. tty [12345] /dev/tty1 115200 vt100 tty [2345] /dev/tty2 38400 linux tty [2345] /dev/tty3 38400 linux -