diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/config.tex | 4 | ||||
-rw-r--r-- | docs/network-scripts.tex | 2 | ||||
-rw-r--r-- | docs/network.tex | 53 |
3 files changed, 40 insertions, 19 deletions
diff --git a/docs/config.tex b/docs/config.tex index 17417c99a..08318b4b6 100644 --- a/docs/config.tex +++ b/docs/config.tex @@ -23,7 +23,7 @@ To be able to load configuration files, you need to include the common functions with: \begin{Verbatim} -. /etc/functions.sh +. /lib/functions.sh \end{Verbatim} Then you can use \texttt{config\_load \textit{<name>}} to load config files. The function @@ -32,7 +32,7 @@ it from \texttt{/etc/config} (which is the most common way of using it). If you want to use special callbacks for sections and/or options, you need to define the following shell functions before running \texttt{config\_load} -(after including \texttt{/etc/functions.sh}): +(after including \texttt{/lib/functions.sh}): \begin{Verbatim} config_cb() { diff --git a/docs/network-scripts.tex b/docs/network-scripts.tex index 4e713953a..7ace9755c 100644 --- a/docs/network-scripts.tex +++ b/docs/network-scripts.tex @@ -4,7 +4,7 @@ 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 +. /lib/functions.sh # common functions include /lib/network # include /lib/network/*.sh scan_interfaces # read and parse the network config \end{Verbatim} diff --git a/docs/network.tex b/docs/network.tex index e4efd8df9..cf1200dcd 100644 --- a/docs/network.tex +++ b/docs/network.tex @@ -22,11 +22,13 @@ of interfaces and add: \end{Verbatim} It is possible to use VLAN tagging on an interface simply by adding the VLAN IDs -to it, e.g. \texttt{eth0.1}. These can be nested as well. See the switch section for +to it, e.g. \texttt{eth0.15}. These can be nested as well. See the switch section for this. \begin{Verbatim} -config inter +config interface + option ifname "eth0.15" + option proto "none" \end{Verbatim} This sets up a simple static configuration for \texttt{eth0}. \texttt{proto} specifies the @@ -54,7 +56,7 @@ config interface "lan" option ifname "eth0" option proto "dhcp" option ipaddr "192.168.1.1" (optional) - option hostname "openwrt" (optional) + option hostname "openwrt" (optional) \end{Verbatim} PPP based protocols (\texttt{pppoe}, \texttt{pptp}, ...) accept these options: @@ -70,7 +72,6 @@ PPP based protocols (\texttt{pppoe}, \texttt{pptp}, ...) accept these options: ",<interval>" to the keepalive value \item{demand} \\ Use Dial on Demand (value specifies the maximum idle time. - \item{server: (pptp)} \\ The remote pptp server IP \end{itemize} @@ -84,7 +85,7 @@ config interface "lan" option proto "pppoe" option username "username" option password "openwrt" - option mtu 1492 (optional) + option mtu "1492" (optional) \end{Verbatim} \subsubsection{Setting up static routes} @@ -96,17 +97,17 @@ Simply add a config section like this: \begin{Verbatim} config route foo - option interface lan - option target 1.1.1.0 - option netmask 255.255.255.0 - option gateway 192.168.1.1 + option interface "lan" + option target "1.1.1.0" + option netmask "255.255.255.0" + option gateway "192.168.1.1" \end{Verbatim} The name for the route section is optional, the \texttt{interface}, \texttt{target} and \texttt{gateway} options are mandatory. Leaving out the \texttt{netmask} option will turn the route into a host route. -\subsubsection{Setting up the switch (currently broadcom only)} +\subsubsection{Setting up the switch (broadcom only)} The switch configuration is set by adding a \texttt{'switch'} config section. Example: @@ -151,6 +152,27 @@ Three interfaces will be automatically created using this switch layout : You can then assign those interfaces to a custom network configuration name like \texttt{lan}, \texttt{wan} or \texttt{dmz} for instance. +\subsubsection{Setting up the switch (swconfig)} + +\emph{swconfig} based configurations have a different structure with one extra +section per vlan. The example below shows a typical configuration: + +\begin{Verbatim} +config 'switch' 'eth0' + option 'reset' '1' + option 'enable_vlan' '1' + +config 'switch_vlan' 'eth0_1' + option 'device' 'eth0' + option 'vlan' '1' + option 'ports' '0 1 2 3 5t' + +config 'switch_vlan' 'eth0_2' + option 'device' 'eth0' + option 'vlan' '2' + option 'ports' '4 5t' +\end{Verbatim} + \subsubsection{Setting up IPv6 connectivity} OpenWrt supports IPv6 connectivity using PPP, Tunnel brokers or static @@ -166,9 +188,9 @@ file and change the settings accordingly : \begin{Verbatim} config 6tunnel option tnlifname 'sixbone' - option remoteip4 '1.0.0.1' - option localip4 '1.0.0.2' - option localip6 '2001::DEAD::BEEF::1' + option remoteip4 '1.0.0.1' + option localip4 '1.0.0.2' + option localip6 '2001::DEAD::BEEF::1' \end{Verbatim} \begin{itemize} @@ -185,7 +207,7 @@ config 6tunnel This address is given by the tunnel broker \end{itemize} -Using the same package you can also setup an IPv6 bridged connection : +Using the same package you can also setup an IPv6 bridged connection: \begin{Verbatim} config 6bridge @@ -197,7 +219,6 @@ and uses ebtables to filter anything that is not IPv6 on the bridge. This configuration is particularly useful if your router is not IPv6 ND proxy capable (see: http://www.rfc-archive.org/getrfc.php?rfc=4389). - IPv6 static addressing is also supported using a similar setup as IPv4 but with the \texttt{ip6} prefixing (when applicable). @@ -205,6 +226,6 @@ IPv4 but with the \texttt{ip6} prefixing (when applicable). config interface "lan" option ifname "eth0" option proto "static" - option ip6addr "fe80::200:ff:fe00:0/64" + option ip6addr "fe80::200:ff:fe00:0/64" option ip6gw "2001::DEAF:BEE:1" \end{Verbatim} |