From 00818780b417dc2a6217daaca6cf27dbf1c00894 Mon Sep 17 00:00:00 2001 From: Felix Fietkau Date: Sun, 15 Oct 2006 23:37:53 +0000 Subject: [PATCH] add some documentation for the init scripts SVN-Revision: 5140 --- docs/init-scripts.tex | 61 +++++++++++++++++++++++++++++++++++++++++++ docs/openwrt.tex | 1 + 2 files changed, 62 insertions(+) create mode 100644 docs/init-scripts.tex diff --git a/docs/init-scripts.tex b/docs/init-scripts.tex new file mode 100644 index 0000000000..9d2fd3368b --- /dev/null +++ b/docs/init-scripts.tex @@ -0,0 +1,61 @@ +Because OpenWrt uses its own init script system, all init scripts must be installed +as \texttt{/etc/init.d/\textit{name}} use \texttt{/etc/rc.common} as a wrapper. + +Example: \texttt{/etc/init.d/httpd} + +\begin{Verbatim} +#!/bin/sh /etc/rc.common +# Copyright (C) 2006 OpenWrt.org + +START=50 +start() { + [ -d /www ] && httpd -p 80 -h /www -r OpenWrt +} + +stop() { + killall httpd +} +\end{Verbatim} + +as you can see, the script does not actually parse the command line arguments itself. +This is done by the wrapper script \texttt{/etc/rc.common}. + +\texttt{start()} and \texttt{stop()} are the basic functions, which almost any init +script should provide. \texttt{start()} is called when the user runs \texttt{/etc/init.d/httpd start} +or (if the script is enabled and does not override this behavior) at system boot time. + +Enabling and disabling init scripts is done by running \texttt{/etc/init.d/\textit{name} start} +or \texttt{/etc/init.d/\textit{name} stop}. This creates or removes symbolic links to the +init script in \texttt{/etc/rc.d}, which is processed by \texttt{/etc/init.d/rcS} at boot time. + +The order in which these scripts are run is defined in the variable \texttt{START} in the init +script, which is optional and defaults to \texttt{50}. Changing it requires running +\texttt{/etc/init.d/\textit{name} enable} again. + +You can also override these standard init script functions: +\begin{itemize} + \item \texttt{boot()} \\ + Commands to be run at boot time. Defaults to \texttt{start()} + + \item \texttt{restart()} \\ + Restart your service. Defaults to \texttt{stop(); start()} + + \item \texttt{reload()} \\ + Reload the configuration files for your service. Defaults to \texttt{restart()} + +\end{itemize} + +You can also add custom commands by creating the appropriate functions and referencing them +in the \texttt{EXTRA\_COMMANDS} variable. Helptext is added in \texttt{EXTRA\_HELP}. + +Example: + +\begin{Verbatim} +status() { + # print the status info +} + +EXTRA_COMMANDS="status" +EXTRA_HELP=" status Print the status of the service" +\end{Verbatim} + diff --git a/docs/openwrt.tex b/docs/openwrt.tex index 4eeeb4a4f8..ff58169f3f 100644 --- a/docs/openwrt.tex +++ b/docs/openwrt.tex @@ -25,6 +25,7 @@ \subsection{Hotplug} \subsection{Init scripts} +\include{init-scripts} \subsection{Network scripts} \include{network-scripts}