summaryrefslogtreecommitdiffstats
path: root/docs/network-scripts.tex
blob: 79a88534178fe20f3bad789019f141d197d9d893 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
\subsubsection{Using the network scripts}

To be able to access the network functions, you need to include
the necessary shell scripts by running:

\begin{Verbatim}
. /etc/functions.sh      # common functions
include /lib/network     # include /lib/network/*.sh
scan_interfaces          # read and parse the network config
\end{Verbatim}

Some protocols, such as PPP might change the configured interface names
at run time (e.g. \texttt{eth0} => \texttt{ppp0} for PPPoE). That's why you have to run
\texttt{scan\_interfaces} instead of reading the values from the config directly.
After running \texttt{scan\_interfaces}, the \texttt{'ifname'} option will always contain
the effective interface name (which is used for IP traffic) and if the
physical device name differs from it, it will be stored in the \texttt{'device'}
option.
That means that running \texttt{config\_get lan ifname}
after \texttt{scan\_interfaces} might not return the same result as running it before.

After running \texttt{scan\_interfaces}, the following functions are available:

\begin{itemize}
	\item{\texttt{find\_config \textit{interface}}} \\
		looks for a network configuration that includes
  		the specified network interface.

	\item{\texttt{setup\_interface \textit{interface [config] [protocol]}}} \\
	  will set up the specified interface, optionally overriding the network configuration
	  name or the protocol that it uses.
\end{itemize}

\subsubsection{Writing protocol handlers}

You can add custom protocol handlers by adding shell scripts to
\texttt{/lib/network}. They provide the following two shell functions:

\begin{Verbatim}
scan_<protocolname>() {
	local config="$1"
	# change the interface names if necessary
}

setup_interface_<protocolname>() {
	local interface="\$1"
	local config="\$2"
	# set up the interface
}
\end{Verbatim}

\texttt{scan\_\textit{protocolname}} is optional and only necessary if your protocol
uses a custom device, e.g. a tunnel or a PPP device.