docs/network-configuration.txt

   1 // -*- mode:doc; -*-
   2 // vim: set syntax=asciidoc:
   3
   4 [[network-configuration]]
   5 Network configuration
   6 ~~~~~~~~~~~~~~~~~~~~~
   7
   8 loopback devices
   9 ^^^^^^^^^^^^^^^^
  10
  11 Example for loopback device configuration:
  12
  13 ---------------------
  14 auto lo
  15 iface lo inet loopback
  16 ---------------------
  17
  18 static network configuration
  19 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  20
  21 Example for an ethernet network card:
  22
  23 ---------------------
  24 auto eth0
  25 iface eth0 inet static
  26   address 192.168.1.1
  27   netmask 255.255.255.0
  28   broadcast +
  29   gateway 192.168.1.254
  30 ---------------------
  31
  32 The DNS resolver must be manually configured in /etc/resolv.conf.
  33 The plus for the broadcast value, will calculate the correct broadcast address for the network.
  34
  35 dynamic network configuration
  36 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  37
  38 Example for an ethernet network card:
  39
  40 ---------------------
  41 auto eth0
  42 iface eth0 inet dhcp
  43 ---------------------
  44
  45 bridge configuration
  46 ^^^^^^^^^^^^^^^^^^^^
  47
  48 Example for a network bridge with two ethernet network interfaces and an ip address:
  49
  50 ---------------------
  51 auto br0
  52 iface br0 inet static
  53         address 192.168.99.1
  54         netmask 255.255.255.0
  55         broadcast +
  56         bridge-ports eth0 eth1
  57 ---------------------
  58
  59 Just a bridge without an ip address:
  60 ---------------------
  61 auto br0
  62 iface br0 inet manual
  63          bridge-ports eth0 eth1
  64 ---------------------
  65
  66 You need to install either Busybox brctl applet or the bridge-utils package. The required kernel modules will be automatically selected.
  67
  68 VLAN network interfaces
  69 ^^^^^^^^^^^^^^^^^^^^^^^
  70
  71 Example configuration of a network interface with VLAN ID 8 without any ip configuration:
  72
  73 ---------------------
  74 auto eth0.8
  75 iface eth0.8 inet manual
  76 ---------------------
  77
  78 You need to install Busybox vconfig applet. The required kernel modules will be automatically selected.
  79
  80 PPP over Ethernet
  81 ^^^^^^^^^^^^^^^^^
  82
  83 Typical DSL configuration:
  84
  85 ---------------------
  86 auto ppp0
  87 iface ppp0 inet ppp
  88         use-template pppoe
  89         provider isp
  90         ppp-mtu 1412
  91         ppp-username foo
  92         ppp-password bar
  93         ppp-device eth1
  94 ---------------------
  95
  96 The provider can be used as argument for "pon" and "poff" commands.
  97 You need to install the ppp and ppp-mod-pppoe package. The required kernel modules will be automatically selected.
  98
  99 wireless client configuration
 100 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 101
 102 Example wireless client configuration, secured with WPA2:
 103
 104 ---------------------
 105 auto wlan0
 106 iface wlan0 inet dhcp
 107         wireless-ssid myap
 108         wireless-channel 11
 109         wireless-mode sta
 110         wireless-security wpa2
 111         wireless-passphrase xxxxxx
 112 ---------------------
 113
 114 You need to install iw and wpa_supplicant packages. For older wireless drivers you
 115 need to install wireless-tools instead of iw and use the following variable to choose the right tools:
 116
 117 ---------------------
 118 wireless-extension 1
 119 ---------------------
 120
 121 wireless accesspoint configuration
 122 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 123
 124 To configure an access point use following example:
 125
 126 ---------------------
 127 auto wlan0
 128 iface wlan0 inet static
 129         address 192.168.40.10
 130         netmask 255.255.255.0
 131         broadcast +
 132         wireless-ssid myap
 133         wireless-channel 8
 134         wireless-mode ap
 135         wireless-security wpa2
 136         wireless-passphrase xxxxxx
 137 ---------------------
 138
 139 You need to install hostapd and iw/wireless-tools packages.
 140
 141 hso umts modem
 142 ^^^^^^^^^^^^^^
 143
 144 If you have a HSO UMTS modem, you can use following to configure internet access:
 145 ---------------------
 146 auto hso0
 147 iface hso0 inet manual
 148         pin 1234
 149         apn your.apn
 150 ---------------------
 151
 152 ATM configuration
 153 ^^^^^^^^^^^^^^^^^
 154
 155 For example a configuration on a Linksys AG241 router with integrated DSL modem,
 156 you can configure two ATM devices to distinguish between Internet and IPTV traffic:
 157
 158 ---------------------
 159 auto eth0.1
 160 iface eth0.1 inet manual
 161
 162 auto eth0.8
 163 iface eth0.8 inet manual
 164
 165 auto nas0
 166 iface nas0 inet manual
 167
 168 auto nas1
 169 iface nas1 inet manual
 170         atm-vpi 1
 171         atm-vci 34
 172
 173 auto br0
 174 iface br0 inet manual
 175         bridge-ports eth0.1 nas0
 176
 177 auto br1
 178 iface br1 inet manual
 179         bridge-ports eth0.8 nas1
 180 ---------------------
 181
 182 More network setups can be implemented on request.