From e2b4e6a9873d6e53d5b51e527b58ea3a1aa60532 Mon Sep 17 00:00:00 2001 From: nbd Date: Wed, 20 Sep 2006 16:51:34 +0000 Subject: remove old junk from docs/, add some info about the network config format git-svn-id: svn://svn.openwrt.org/openwrt/branches/buildroot-ng/openwrt@4805 3c298f89-4303-0410-b956-a3cf2f4a3e73 --- docs/network.txt | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 docs/network.txt (limited to 'docs/network.txt') diff --git a/docs/network.txt b/docs/network.txt new file mode 100644 index 000000000..5610e1d6d --- /dev/null +++ b/docs/network.txt @@ -0,0 +1,50 @@ + Network configuration in buildroot-ng + + +The network configuration in buildroot-ng is stored in /etc/config/network +and is divided into interface configurations. +Each interface configuration either refers directly to an ethernet/wifi +interface (eth0, wl0, ..) or to a bridge containing multiple interfaces. +It looks like this: + + config interface "lan" + option ifname "eth0" + option proto "static" + option ipaddr "192.168.1.1" + option netmask "255.255.255.0" + option gateway "192.168.1.254" + option dns "192.168.1.254" + +"ifname" specifies the Linux interface name. +If you want to use bridging on one or more interfaces, set "ifname" to a list +of interfaces and add: + option type "bridge" + +It is possible to use VLAN tagging on an interface simply by adding the VLAN IDs +to it, e.g. "eth0.1". These can be nested as well. + +This sets up a simple static configuration for eth0. "proto" specifies the +'protocol' used for the interface. The default image usually provides 'none' +'static', 'dhcp' and 'pppoe'. Others can be added by installing additional +packages. + +When using the 'static' method like in the example, the options "ipaddr" and +"netmask" are mandatory, while "gateway" and "dns" are optional. +DHCP currently only accepts "ipaddr" (IP address to request from the server) +and "hostname" (client hostname identify as) - both are optional. + +PPP based protocols (pppoe, pptp, ...) accept these options: + username: + The PPP username (usually with PAP authentication) + password: + The PPP password + keepalive: + Ping the PPP server (using LCP). The value of this option + specifies the maximum number of failed pings before reconnecting. + The ping interval defaults to 5, but can be changed by appending + "," to the keepalive value + demand: + Use Dial on Demand (value specifies the maximum idle time) + +For all protocol types, you can also specify the MTU by using the "mtu" option. + -- cgit v1.2.3 From 1865d33d87a05f53a490fe60b8448554bb21c649 Mon Sep 17 00:00:00 2001 From: nbd Date: Sat, 23 Sep 2006 18:03:25 +0000 Subject: add switch config info to network documentation git-svn-id: svn://svn.openwrt.org/openwrt/branches/buildroot-ng/openwrt@4836 3c298f89-4303-0410-b956-a3cf2f4a3e73 --- docs/network.txt | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) (limited to 'docs/network.txt') diff --git a/docs/network.txt b/docs/network.txt index 5610e1d6d..69dbaa60b 100644 --- a/docs/network.txt +++ b/docs/network.txt @@ -45,6 +45,35 @@ PPP based protocols (pppoe, pptp, ...) accept these options: "," to the keepalive value demand: Use Dial on Demand (value specifies the maximum idle time) + + (pptp) + server: The remote pptp server IP For all protocol types, you can also specify the MTU by using the "mtu" option. + + + + Setting up the switch (currently broadcom only) + + +The switch configuration is set by adding a 'switch' config section. +Example: + + config switch eth0 + option vlan0 "1 2 3 4 5*" + option vlan1 "0 5" + +On Broadcom hardware the section name needs to be eth0, as the switch driver +does not detect the switch on any other physical device. +Every vlan option needs to have the name vlan where is the VLAN number +as used in the switch driver. +As value it takes a list of ports with these optional suffixes: + + '*': Set the default VLAN (PVID) of the Port to the current VLAN + 'u': Force the port to be untagged + 't': Force the port to be tagged + +The CPU port defaults to tagged, all other ports to untagged. +On Broadcom hardware the CPU port is always 5. The other ports may vary with +different hardware. -- cgit v1.2.3