summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authornbd <nbd@3c298f89-4303-0410-b956-a3cf2f4a3e73>2006-10-15 23:37:53 +0000
committernbd <nbd@3c298f89-4303-0410-b956-a3cf2f4a3e73>2006-10-15 23:37:53 +0000
commit367563c4ddbe2277b34e888985bed2b6072d4179 (patch)
tree71972354847d1f4ce7d47636ba211f02d9ffedc9 /docs
parentf35283ae4398fef78d72204142554689979a7bb6 (diff)
add some documentation for the init scripts
git-svn-id: svn://svn.openwrt.org/openwrt/trunk@5140 3c298f89-4303-0410-b956-a3cf2f4a3e73
Diffstat (limited to 'docs')
-rw-r--r--docs/init-scripts.tex61
-rw-r--r--docs/openwrt.tex1
2 files changed, 62 insertions, 0 deletions
diff --git a/docs/init-scripts.tex b/docs/init-scripts.tex
new file mode 100644
index 000000000..9d2fd3368
--- /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 4eeeb4a4f..ff58169f3 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}