| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 5 | <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 6 | |
6 | |
| 7 | <sections> |
7 | <sections> |
| 8 | |
8 | |
| 9 | <version>1.0</version> |
9 | <version>1.0</version> |
| 10 | <date>2005-06-06</date> |
10 | <date>2005-06-06</date> |
| … | |
… | |
| 42 | modules=( "!iwconfig" ) |
42 | modules=( "!iwconfig" ) |
| 43 | </pre> |
43 | </pre> |
| 44 | |
44 | |
| 45 | </body> |
45 | </body> |
| 46 | </section> |
46 | </section> |
| 47 | |
|
|
| 48 | <section> |
47 | <section> |
| 49 | <title>Interface Handlers</title> |
48 | <title>Interface Handlers</title> |
| 50 | <body> |
49 | <body> |
| 51 | |
50 | |
| 52 | <p> |
51 | <p> |
| … | |
… | |
| 54 | You need one of these to do any kind of network configuration. |
53 | You need one of these to do any kind of network configuration. |
| 55 | </p> |
54 | </p> |
| 56 | |
55 | |
| 57 | <p> |
56 | <p> |
| 58 | ifconfig is the current Gentoo default and it's included in the system profile.<br/> |
57 | ifconfig is the current Gentoo default and it's included in the system profile.<br/> |
| 59 | iproute2 is a more powerful and flexible package, but it's not included by default. |
58 | iproute2 is a more powerful and flexible package, but it's not included by |
|
|
59 | default. |
| 60 | </p> |
60 | </p> |
| 61 | |
61 | |
| 62 | <pre caption="To install iproute2"> |
62 | <pre caption="To install iproute2"> |
| 63 | # <i>emerge sys-apps/iproute2</i> |
63 | # <i>emerge sys-apps/iproute2</i> |
| 64 | |
64 | |
| 65 | <comment># To prefer iproute2 over ifconfig if both are installed</comment> |
65 | <comment># To prefer iproute2 over ifconfig if both are installed</comment> |
| 66 | modules=( "iproute2" ) |
66 | modules=( "iproute2" ) |
| 67 | </pre> |
67 | </pre> |
| 68 | |
68 | |
| 69 | <p> |
69 | <p> |
| 70 | As both ifconfig and iproute2 do very similar things we allow their basic configuration |
70 | As both ifconfig and iproute2 do very similar things we allow their basic |
| 71 | to work with each other. For example both the below code snippets work regardless of |
71 | configuration to work with each other. For example both the below code |
| 72 | which module you are using. |
72 | snippets work regardless of which module you are using. |
| 73 | </p> |
73 | </p> |
| 74 | |
74 | |
| 75 | <pre caption="ifconfig and iproute2 examples"> |
75 | <pre caption="ifconfig and iproute2 examples"> |
| 76 | config_eth0=( "192.168.0.2/24" ) |
76 | config_eth0=( "192.168.0.2/24" ) |
| 77 | config_eth0=( "192.168.0.2 netmask 255.255.255.0" ) |
77 | config_eth0=( "192.168.0.2 netmask 255.255.255.0" ) |
| … | |
… | |
| 81 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" ) |
81 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" ) |
| 82 | </pre> |
82 | </pre> |
| 83 | |
83 | |
| 84 | </body> |
84 | </body> |
| 85 | </section> |
85 | </section> |
| 86 | |
|
|
| 87 | <section id="dhcp"> |
86 | <section id="dhcp"> |
| 88 | <title>DHCP</title> |
87 | <title>DHCP</title> |
| 89 | <body> |
88 | <body> |
| 90 | |
89 | |
| 91 | <p> |
90 | <p> |
| … | |
… | |
| 96 | other things like wireless, ppp or other things if required before you can use |
95 | other things like wireless, ppp or other things if required before you can use |
| 97 | DHCP. |
96 | DHCP. |
| 98 | </p> |
97 | </p> |
| 99 | |
98 | |
| 100 | <p> |
99 | <p> |
| 101 | DHCP can be provided by dhclient, dhcpcd, dhclient, pump or udhcpc. Each DHCP module |
100 | DHCP can be provided by dhclient, dhcpcd, dhclient, pump or udhcpc. Each DHCP |
| 102 | has its pros and cons - here's a quick run down. |
101 | module has its pros and cons - here's a quick run down. |
| 103 | </p> |
102 | </p> |
| 104 | |
103 | |
| 105 | <table> |
104 | <table> |
| 106 | <tr> |
105 | <tr> |
| 107 | <th>DHCP Module</th> |
106 | <th>DHCP Module</th> |
| 108 | <th>Package</th> |
107 | <th>Package</th> |
| 109 | <th>Pros</th> |
108 | <th>Pros</th> |
| 110 | <th>Cons</th> |
109 | <th>Cons</th> |
| 111 | </tr> |
110 | </tr> |
| 112 | <tr> |
111 | <tr> |
| 113 | <ti>dhclient</ti> |
112 | <ti>dhclient</ti> |
| 114 | <ti>net-misc/dhcp</ti> |
113 | <ti>net-misc/dhcp</ti> |
| 115 | <ti> |
114 | <ti> |
| 116 | Made by ISC, the same people who make the BIND DNS software<br /> |
115 | Made by ISC, the same people who make the BIND DNS software<br /> |
| 117 | Very configurable |
116 | Very configurable |
| 118 | </ti> |
117 | </ti> |
| 119 | <ti> |
118 | <ti> |
| 120 | Configuration is overly complex<br /> |
119 | Configuration is overly complex<br /> |
| 121 | Software is quite bloated<br /> |
120 | Software is quite bloated<br /> |
| 122 | Cannot get NTP servers from DHCP<br /> |
121 | Cannot get NTP servers from DHCP<br /> |
| 123 | Does not send hostname by default |
122 | Does not send hostname by default |
| 124 | </ti> |
123 | </ti> |
| 125 | </tr> |
124 | </tr> |
| 126 | <tr> |
125 | <tr> |
| 127 | <ti>dhcpcd</ti> |
126 | <ti>dhcpcd</ti> |
| 128 | <ti>net-misc/dhcpcd</ti> |
127 | <ti>net-misc/dhcpcd</ti> |
| 129 | <ti> |
128 | <ti> |
| 130 | Long time Gentoo default<br /> |
129 | Long time Gentoo default<br /> |
| 131 | No reliance on outside tools |
130 | No reliance on outside tools |
| 132 | </ti> |
131 | </ti> |
| 133 | <ti> |
132 | <ti> |
| 134 | No longer maintained upstream<br /> |
133 | No longer maintained upstream<br /> |
| 135 | Can be slow at times<br /> |
134 | Can be slow at times<br /> |
| 136 | Does not daemonize when lease is infinite |
135 | Does not daemonize when lease is infinite |
| 137 | </ti> |
136 | </ti> |
| 138 | </tr> |
137 | </tr> |
| 139 | <tr> |
138 | <tr> |
| 140 | <ti>pump</ti> |
139 | <ti>pump</ti> |
| 141 | <ti>net-misc/pump</ti> |
140 | <ti>net-misc/pump</ti> |
| 142 | <ti> |
141 | <ti> |
| 143 | Lightweight<br /> |
142 | Lightweight<br /> |
| 144 | No reliance on outside tools |
143 | No reliance on outside tools |
| 145 | </ti> |
144 | </ti> |
| 146 | <ti> |
145 | <ti> |
| 147 | No longer maintained upstream<br /> |
146 | No longer maintained upstream<br /> |
| 148 | Unreliable, especially over modems<br /> |
147 | Unreliable, especially over modems<br /> |
| 149 | Cannot get NIS servers from DHCP |
148 | Cannot get NIS servers from DHCP |
| 150 | </ti> |
149 | </ti> |
| 151 | </tr> |
150 | </tr> |
| 152 | <tr> |
151 | <tr> |
| 153 | <ti>udhcpc</ti> |
152 | <ti>udhcpc</ti> |
| 154 | <ti>net-misc/udhcp</ti> |
153 | <ti>net-misc/udhcp</ti> |
| 155 | <ti> |
154 | <ti> |
| 156 | Lightweight - smallest dhcp client around<br /> |
155 | Lightweight - smallest dhcp client around<br /> |
| 157 | Made for embedded systems |
156 | Made for embedded systems |
| 158 | </ti> |
157 | </ti> |
| 159 | <ti> |
158 | <ti> |
| 160 | Unproven - no distro uses it by default<br /> |
159 | Unproven - no distro uses it by default<br /> |
| 161 | Cannot define a timeout beyond 3 seconds |
160 | Cannot define a timeout beyond 3 seconds |
| 162 | </ti> |
161 | </ti> |
| 163 | </tr> |
162 | </tr> |
| 164 | </table> |
163 | </table> |
| 165 | |
164 | |
| 166 | <p> |
165 | <p> |
| 167 | If you have more than one DHCP client installed, you need to specify which |
166 | If you have more than one DHCP client installed, you need to specify which |
| 168 | one to use - otherwise we default to dhcpcd if available. |
167 | one to use - otherwise we default to dhcpcd if available. |
| … | |
… | |
| 199 | default so you don't need to specify this anymore. |
198 | default so you don't need to specify this anymore. |
| 200 | </note> |
199 | </note> |
| 201 | |
200 | |
| 202 | </body> |
201 | </body> |
| 203 | </section> |
202 | </section> |
| 204 | |
|
|
| 205 | <section> |
203 | <section> |
| 206 | <title>ADSL Modem</title> |
204 | <title>ADSL Modem</title> |
| 207 | <body> |
205 | <body> |
| 208 | |
206 | |
| 209 | <p> |
207 | <p> |
| … | |
… | |
| 239 | "username" * "password" |
237 | "username" * "password" |
| 240 | </pre> |
238 | </pre> |
| 241 | |
239 | |
| 242 | </body> |
240 | </body> |
| 243 | </section> |
241 | </section> |
| 244 | |
|
|
| 245 | <section id="apipa"> |
242 | <section id="apipa"> |
| 246 | <title>APIPA (Automatic Private IP Addressing)</title> |
243 | <title>APIPA (Automatic Private IP Addressing)</title> |
| 247 | <body> |
244 | <body> |
| 248 | |
245 | |
| 249 | <p> |
246 | <p> |
| … | |
… | |
| 270 | config_eth0=( "apipa" ) |
267 | config_eth0=( "apipa" ) |
| 271 | </pre> |
268 | </pre> |
| 272 | |
269 | |
| 273 | </body> |
270 | </body> |
| 274 | </section> |
271 | </section> |
| 275 | |
|
|
| 276 | <section> |
272 | <section> |
| 277 | <title>Bonding</title> |
273 | <title>Bonding</title> |
| 278 | <body> |
274 | <body> |
| 279 | |
275 | |
| 280 | <p> |
276 | <p> |
| … | |
… | |
| 300 | } |
296 | } |
| 301 | </pre> |
297 | </pre> |
| 302 | |
298 | |
| 303 | </body> |
299 | </body> |
| 304 | </section> |
300 | </section> |
| 305 | |
|
|
| 306 | <section> |
301 | <section> |
| 307 | <title>Bridging (802.1d support)</title> |
302 | <title>Bridging (802.1d support)</title> |
| 308 | <body> |
303 | <body> |
| 309 | |
304 | |
| 310 | <p> |
305 | <p> |
| … | |
… | |
| 344 | documentation. |
339 | documentation. |
| 345 | </impo> |
340 | </impo> |
| 346 | |
341 | |
| 347 | </body> |
342 | </body> |
| 348 | </section> |
343 | </section> |
| 349 | |
|
|
| 350 | <section> |
344 | <section> |
| 351 | <title>MAC Address</title> |
345 | <title>MAC Address</title> |
| 352 | <body> |
346 | <body> |
| 353 | |
347 | |
| 354 | <p> |
348 | <p> |
| … | |
… | |
| 378 | mac_eth0="random-full" |
372 | mac_eth0="random-full" |
| 379 | </pre> |
373 | </pre> |
| 380 | |
374 | |
| 381 | </body> |
375 | </body> |
| 382 | </section> |
376 | </section> |
| 383 | |
|
|
| 384 | <section> |
377 | <section> |
| 385 | <title>Tunnelling</title> |
378 | <title>Tunnelling</title> |
| 386 | <body> |
379 | <body> |
| 387 | |
380 | |
| 388 | <p> |
381 | <p> |
| … | |
… | |
| 401 | config_vpn0=( "192.168.0.2 peer 192.168.1.1" ) |
394 | config_vpn0=( "192.168.0.2 peer 192.168.1.1" ) |
| 402 | </pre> |
395 | </pre> |
| 403 | |
396 | |
| 404 | </body> |
397 | </body> |
| 405 | </section> |
398 | </section> |
| 406 | |
|
|
| 407 | <section> |
399 | <section> |
| 408 | <title>VLAN (802.1q support)</title> |
400 | <title>VLAN (802.1q support)</title> |
| 409 | <body> |
401 | <body> |
| 410 | |
402 | |
| 411 | <p> |
403 | <p> |
| 412 | For VLAN support, emerge net-misc/vconfig |
404 | For VLAN support, emerge net-misc/vconfig |
| 413 | </p> |
405 | </p> |
| 414 | |
406 | |
|
|
407 | <p> |
| 415 | <p>Virtual LAN is a group of network devices that behave as if they were |
408 | Virtual LAN is a group of network devices that behave as if they were |
| 416 | connected to a single network segment - even though they may not be. |
409 | connected to a single network segment - even though they may not be. |
| 417 | VLAN members can only see members of the same VLAN even though they may |
410 | VLAN members can only see members of the same VLAN even though they may |
| 418 | share the same physical network. |
411 | share the same physical network. |
| 419 | </p> |
412 | </p> |
| 420 | |
413 | |