/[gentoo]/xml/htdocs/doc/en/handbook/hb-net-modules.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-net-modules.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.1 Revision 1.2
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>
42modules=( "!iwconfig" ) 42modules=( "!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>
54You need one of these to do any kind of network configuration. 53You need one of these to do any kind of network configuration.
55</p> 54</p>
56 55
57<p> 56<p>
58ifconfig is the current Gentoo default and it's included in the system profile.<br/> 57ifconfig is the current Gentoo default and it's included in the system profile.<br/>
59iproute2 is a more powerful and flexible package, but it's not included by default. 58iproute2 is a more powerful and flexible package, but it's not included by
59default.
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>
66modules=( "iproute2" ) 66modules=( "iproute2" )
67</pre> 67</pre>
68 68
69<p> 69<p>
70As both ifconfig and iproute2 do very similar things we allow their basic configuration 70As both ifconfig and iproute2 do very similar things we allow their basic
71to work with each other. For example both the below code snippets work regardless of 71configuration to work with each other. For example both the below code
72which module you are using. 72snippets 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">
76config_eth0=( "192.168.0.2/24" ) 76config_eth0=( "192.168.0.2/24" )
77config_eth0=( "192.168.0.2 netmask 255.255.255.0" ) 77config_eth0=( "192.168.0.2 netmask 255.255.255.0" )
81config_eth0=( "192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" ) 81config_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>
96other things like wireless, ppp or other things if required before you can use 95other things like wireless, ppp or other things if required before you can use
97DHCP. 96DHCP.
98</p> 97</p>
99 98
100<p> 99<p>
101DHCP can be provided by dhclient, dhcpcd, dhclient, pump or udhcpc. Each DHCP module 100DHCP can be provided by dhclient, dhcpcd, dhclient, pump or udhcpc. Each DHCP
102has its pros and cons - here's a quick run down. 101module 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>
167If you have more than one DHCP client installed, you need to specify which 166If you have more than one DHCP client installed, you need to specify which
168one to use - otherwise we default to dhcpcd if available. 167one to use - otherwise we default to dhcpcd if available.
199default so you don't need to specify this anymore. 198default 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>
270config_eth0=( "apipa" ) 267config_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>
344documentation. 339documentation.
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>
378mac_eth0="random-full" 372mac_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>
401config_vpn0=( "192.168.0.2 peer 192.168.1.1" ) 394config_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>
412For VLAN support, emerge net-misc/vconfig 404For 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 408Virtual LAN is a group of network devices that behave as if they were
416connected to a single network segment - even though they may not be. 409connected to a single network segment - even though they may not be.
417VLAN members can only see members of the same VLAN even though they may 410VLAN members can only see members of the same VLAN even though they may
418share the same physical network. 411share the same physical network.
419</p> 412</p>
420 413

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

  ViewVC Help
Powered by ViewVC 1.1.20