+---
+---
Network configuration
=====================
-include::uci_menu.inc[]
-
== Network configuration
The central network configuration is located in the file **'/etc/config/network'**. This configuration file is responsible for defining _switch VLANs_, _interface configurations_ and _network routes_.
The 'switch' section is responsible for partitioning the switch into several _VLANs_ which appear as independent interfaces in the system although they share the same hardware. **Not every OpenWrt supported device (or architecture, like x86) has a programmable switch**, therefore this section might not be present on some platforms. Please also note, that some switches only support 4Bit-VLANs.
-There are currently two different configuration formats in use, one for the legacy '/proc/switch/' API and one for the newer swconfig-based switch configuration.
-
-=== /proc/switch ===
-
-This variant is actually only found on Broadcom devices like the WRT54GL.
-
-A typical configuration for it looks like this:
-
-----
-config 'switch' 'eth0'
- option 'vlan0' '0 1 2 3 5*'
- option 'vlan1' '4 5'
-----
-
-The 'eth0' identifier specifies the switch the section is belonging to.
-VLANs are defined by 'vlan#' options with '#' being the VLAN number.
-
-=== swconfig ===
-
-The newer swconfig framework is intended to replace the legacy switch configuration.
-
-Configuration for swconfig have a slightly different structure with one extra section per VLAN.
The example below shows a typical configuration:
----
=== Protocol "pptp" (Point-to-Point Tunneling Protocol) ===
-*CAUTION*: The package 'pptp' must be installed to use PPtP. You need to have another section to configure the "parent" device, and you might need to add "<vpn>" to your "wan" zone in the firewall (<vpn> being the "logical interface name" of this section).
+*CAUTION*: The package 'ppp-mod-pptp' must be installed to use PPtP. You need to have another section to configure the "parent" device, and you might need to add "<vpn>" to your "wan" zone in the firewall (<vpn> being the "logical interface name" of this section).
[cols="4*1,4",options="header"]
|====
| 'server' | ip address | yes | _(none)_ | Remote PPtP server
| 'username' | string | no(?) | _(none)_ | Username for PAP/CHAP authentication
| 'password' | string | no(?) | _(none)_ | Password for PAP/CHAP authentication
-| 'keepalive' | integer | no | ? | Number of attempts to reconnect
-| 'defaultroute' | boolean | no | '1' | Whether to create a default route over the tunnel
-| 'peerdns' | boolean | no | '1' |Use PPTP-provided DNS server(s)
-| 'delegate' | boolean | no | ? |Use builtin IPv6-management
-| 'iface' | string | no(?) | 'pptp-<vpn>' | Name of the physical interface. Defaults to 'pptp-<vpn>' no matter what you use
+| 'keepalive' | number | no | _(none)_ | Number of unanswered echo requests before considering the peer dead. The interval between echo requests is 5 seconds.
+| 'demand' | number | no | _(none)_ | Number of seconds to wait before closing the connection due to inactivity
+| 'defaultroute' | boolean | no | '1' | Replace existing default route on PPtP connect
+| 'peerdns' | boolean | no | '1' | Use peer-assigned DNS server(s)
+| 'dns' | list of ip addresses | no | _(none)_ | Override peer-assigned DNS server(s)
+| 'ipv6' | boolean | no | '0' | Enable IPv6 on the PPtP link
+| 'pppd_options' | string | no | _(none)_ | Additional command line arguments to pass to the pppd daemon
|====
=== Protocol "6in4" (IPv6-in-IPv4 Tunnel) ===