summaryrefslogtreecommitdiff
path: root/docs/network-scripts.tex
diff options
context:
space:
mode:
authorAlberto Bursi <alberto.bursi@outlook.it>2016-11-28 20:28:12 +0100
committerJohn Crispin <john@phrozen.org>2016-11-29 21:12:08 +0100
commit882f4d2d63272abce8c1966983aa10178e2e971f (patch)
tree68687b152130405452a1ad9b930ff2971378834c /docs/network-scripts.tex
parentc0e66478b520b07c33343161f722351f5f858990 (diff)
downloadmtk-20170518-882f4d2d63272abce8c1966983aa10178e2e971f.zip
mtk-20170518-882f4d2d63272abce8c1966983aa10178e2e971f.tar.gz
mtk-20170518-882f4d2d63272abce8c1966983aa10178e2e971f.tar.bz2
docs: deleting docs because they are obsolete
the docs in /docs folder are pretty much obsolete and in a not very friendly format (latex, that requires to be compiled), leaving them there only causes confusion. LEDE documentation's place is the wiki, or the site. Signed-off-by: Alberto Bursi <alberto.bursi@outlook.it>
Diffstat (limited to 'docs/network-scripts.tex')
-rw-r--r--docs/network-scripts.tex55
1 files changed, 0 insertions, 55 deletions
diff --git a/docs/network-scripts.tex b/docs/network-scripts.tex
deleted file mode 100644
index 7ace975..0000000
--- a/docs/network-scripts.tex
+++ /dev/null
@@ -1,55 +0,0 @@
-\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}
-. /lib/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 (e.g: PPPoE, PPPoA, ATM, PPTP ...)
-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.
-