X-Git-Url: http://git.ozo.com/?a=blobdiff_plain;f=docs%2Finit-scripts.tex;fp=docs%2Finit-scripts.tex;h=0000000000000000000000000000000000000000;hb=882f4d2d63272abce8c1966983aa10178e2e971f;hp=c8b07500b39e975e9dd499e9337d8f56712d366a;hpb=c0e66478b520b07c33343161f722351f5f858990;p=lede-git%2F.git diff --git a/docs/init-scripts.tex b/docs/init-scripts.tex deleted file mode 100644 index c8b07500b3..0000000000 --- a/docs/init-scripts.tex +++ /dev/null @@ -1,60 +0,0 @@ -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} enable} -or \texttt{/etc/init.d/\textit{name} disable}. 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. 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} -