summaryrefslogtreecommitdiff
path: root/docs/network-configuration.txt
blob: ea869c0bc24685ecf6c7b8bdf2f731cb24eb8962 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
// -*- mode:doc; -*-
// vim: set syntax=asciidoc:

[[network-configuration]]
Network configuration 
~~~~~~~~~~~~~~~~~~~~~

loopback devices
^^^^^^^^^^^^^^^^

Example for loopback device configuration:

---------------------
auto lo
iface lo inet loopback
---------------------

static network configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Example for an ethernet network card:

---------------------
auto eth0
iface eth0 inet static
  address 192.168.1.1
  netmask 255.255.255.0
  broadcast +
  gateway 192.168.1.254
---------------------

The DNS resolver must be manually configured in /etc/resolv.conf.
The plus for the broadcast value, will calculate the correct broadcast address for the network.

dynamic network configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Example for an ethernet network card:

---------------------
auto eth0
iface eth0 inet dhcp
---------------------

bridge configuration
^^^^^^^^^^^^^^^^^^^^

Example for a network bridge with two ethernet network interfaces and an ip address:

---------------------
auto br0 
iface br0 inet static
        address 192.168.99.1
        netmask 255.255.255.0
        broadcast +
        bridge-ports eth0 eth1
---------------------

Just a bridge without an ip address:
---------------------
auto br0 
iface br0 inet manual
         bridge-ports eth0 eth1
---------------------

You need to install either Busybox brctl applet or the bridge-utils package. The required kernel modules will be automatically selected.

VLAN network interfaces
^^^^^^^^^^^^^^^^^^^^^^^

Example configuration of a network interface with VLAN ID 8 without any ip configuration:

---------------------
auto eth0.8
iface eth0.8 inet manual
---------------------

You need to install Busybox vconfig applet. The required kernel modules will be automatically selected.

PPP over Ethernet
^^^^^^^^^^^^^^^^^

Typical DSL configuration:

---------------------
auto ppp0
iface ppp0 inet ppp
	use-template pppoe
	provider isp
	ppp-mtu 1412
	ppp-username foo
	ppp-password bar
	ppp-device eth1
---------------------

The provider can be used as argument for "pon" and "poff" commands.
You need to install the ppp and ppp-mod-pppoe package. The required kernel modules will be automatically selected.

wireless client configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Example wireless client configuration, secured with WPA2:

---------------------
auto wlan0
iface wlan0 inet dhcp
        wireless-ssid myap
        wireless-channel 11
        wireless-mode sta
        wireless-security wpa2
        wireless-passphrase xxxxxx
---------------------

You need to install iw and wpa_supplicant packages. For older wireless drivers you
need to install wireless-tools instead of iw and use the following variable to choose the right tools:

---------------------
wireless-extension 1 
---------------------

wireless accesspoint configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

To configure an access point use following example:

---------------------
auto wlan0
iface wlan0 inet static
        address 192.168.40.10
        netmask 255.255.255.0
        broadcast +
        wireless-ssid myap
        wireless-channel 8
        wireless-mode ap
        wireless-security wpa2
        wireless-passphrase xxxxxx
---------------------

You need to install hostapd and iw/wireless-tools packages.

hso umts modem
^^^^^^^^^^^^^^

If you have a HSO UMTS modem, you can use following to configure internet access:
---------------------
auto hso0
iface hso0 inet manual
	pin 1234
	apn your.apn
---------------------

ATM configuration
^^^^^^^^^^^^^^^^^

For example a configuration on a Linksys AG241 router with integrated DSL modem,
you can configure two ATM devices to distinguish between Internet and IPTV traffic:

---------------------
auto eth0.1 
iface eth0.1 inet manual

auto eth0.8
iface eth0.8 inet manual

auto nas0
iface nas0 inet manual

auto nas1
iface nas1 inet manual
        atm-vpi 1
        atm-vci 34

auto br0
iface br0 inet manual
        bridge-ports eth0.1 nas0

auto br1
iface br1 inet manual
        bridge-ports eth0.8 nas1
---------------------

More network setups can be implemented on request.