1 |
swift 11/08/14 16:12:14 |
2 |
|
3 |
Modified: hb-net-advanced.xml hb-net-modules.xml |
4 |
hb-net-start.xml hb-net-wireless.xml |
5 |
hb-working-rcscripts.xml |
6 |
Log: |
7 |
Bug #213988 - Various fixes on OpenRC in handbook |
8 |
|
9 |
Revision Changes Path |
10 |
1.16 xml/htdocs/doc/en/handbook/hb-net-advanced.xml |
11 |
|
12 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?rev=1.16&view=markup |
13 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?rev=1.16&content-type=text/plain |
14 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml?r1=1.15&r2=1.16 |
15 |
|
16 |
Index: hb-net-advanced.xml |
17 |
=================================================================== |
18 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v |
19 |
retrieving revision 1.15 |
20 |
retrieving revision 1.16 |
21 |
diff -u -r1.15 -r1.16 |
22 |
--- hb-net-advanced.xml 13 Feb 2009 04:40:27 -0000 1.15 |
23 |
+++ hb-net-advanced.xml 14 Aug 2011 16:12:13 -0000 1.16 |
24 |
@@ -4,7 +4,7 @@ |
25 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
26 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
27 |
|
28 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.15 2009/02/13 04:40:27 nightmorph Exp $ --> |
29 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-advanced.xml,v 1.16 2011/08/14 16:12:13 swift Exp $ --> |
30 |
|
31 |
<sections> |
32 |
|
33 |
@@ -13,8 +13,8 @@ |
34 |
before we learn about modular networking. |
35 |
</abstract> |
36 |
|
37 |
-<version>8.1</version> |
38 |
-<date>2009-02-12</date> |
39 |
+<version>9</version> |
40 |
+<date>2011-08-13</date> |
41 |
|
42 |
<section> |
43 |
<title>Advanced Configuration</title> |
44 |
@@ -128,44 +128,23 @@ |
45 |
|
46 |
<p> |
47 |
Init scripts in <path>/etc/init.d</path> can depend on a specific network |
48 |
-interface or just net. <c>net</c> can be defined in <path>/etc/conf.d/rc</path> |
49 |
-to mean different things using the <c>RC_NET_STRICT_CHECKING</c> variable. |
50 |
+interface or just net. All network interfaces in Gentoo's init system provide |
51 |
+what is called <e>net</e>. |
52 |
</p> |
53 |
|
54 |
-<table> |
55 |
-<tr> |
56 |
- <th>Value</th> |
57 |
- <th>Description</th> |
58 |
-</tr> |
59 |
-<tr> |
60 |
- <ti><c>none</c></ti> |
61 |
- <ti>The <path>net</path> service is always considered up</ti> |
62 |
-</tr> |
63 |
-<tr> |
64 |
- <ti><c>no</c></ti> |
65 |
- <ti> |
66 |
- This basically means that at least one <path>net.*</path> service besides |
67 |
- <path>net.lo</path> must be up. This can be used by notebook users that |
68 |
- have a WIFI and a static NIC, and only wants one up at any given time to |
69 |
- have the net service seen as up. |
70 |
- </ti> |
71 |
-</tr> |
72 |
-<tr> |
73 |
- <ti><c>lo</c></ti> |
74 |
- <ti> |
75 |
- This is the same as the <c>no</c> option, but <path>net.lo</path> is also |
76 |
- counted. This should be useful to people that do not care about any specific |
77 |
- interface being up at boot. |
78 |
- </ti> |
79 |
-</tr> |
80 |
-<tr> |
81 |
- <ti><c>yes</c></ti> |
82 |
- <ti> |
83 |
- For this ALL network interfaces MUST be up for the <path>net</path> service |
84 |
- to be considered up. |
85 |
- </ti> |
86 |
-</tr> |
87 |
-</table> |
88 |
+<p> |
89 |
+If, in <path>/etc/rc.conf</path>, <c>rc_depend_strict="YES"</c> is set, then all |
90 |
+network interfaces that provide net must be active before a dependency on "net" |
91 |
+is assumed to be met. In other words, if you have a <path>net.eth0</path> and |
92 |
+<path>net.eth1</path> and an init script depends on "net", then both must be |
93 |
+enabled. |
94 |
+</p> |
95 |
+ |
96 |
+<p> |
97 |
+On the other hand, if <c>rc_depend_strict="NO"</c> is set, then the "net" |
98 |
+dependency is marked as resolved the moment at least one network interface is |
99 |
+brought up. |
100 |
+</p> |
101 |
|
102 |
<p> |
103 |
But what about <path>net.br0</path> depending on <path>net.eth0</path> and |
104 |
@@ -176,21 +155,19 @@ |
105 |
</p> |
106 |
|
107 |
<p> |
108 |
-The answer is making your own <c>depend()</c> function in |
109 |
+The answer is defining an <c>rc_need_</c> setting in |
110 |
<path>/etc/conf.d/net</path>. |
111 |
</p> |
112 |
|
113 |
<pre caption="net.br0 dependency in /etc/conf.d/net"> |
114 |
-<comment># You can use any dependency (use, after, before) as found in current scripts</comment> |
115 |
-depend_br0() { |
116 |
- need net.eth0 net.eth1 |
117 |
-} |
118 |
+rc_need_br0="net.eth0 net.eth1" |
119 |
</pre> |
120 |
|
121 |
<p> |
122 |
For a more detailed discussion about dependency, consult the section <uri |
123 |
link="?part=2&chap=4#doc_chap4">Writing Init Scripts</uri> in the Gentoo |
124 |
-Handbook. |
125 |
+Handbook. More information about <path>/etc/rc.conf</path> is available as |
126 |
+comments within that file. |
127 |
</p> |
128 |
|
129 |
</body> |
130 |
|
131 |
|
132 |
|
133 |
1.26 xml/htdocs/doc/en/handbook/hb-net-modules.xml |
134 |
|
135 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.26&view=markup |
136 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.26&content-type=text/plain |
137 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?r1=1.25&r2=1.26 |
138 |
|
139 |
Index: hb-net-modules.xml |
140 |
=================================================================== |
141 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v |
142 |
retrieving revision 1.25 |
143 |
retrieving revision 1.26 |
144 |
diff -u -r1.25 -r1.26 |
145 |
--- hb-net-modules.xml 13 Feb 2009 04:40:27 -0000 1.25 |
146 |
+++ hb-net-modules.xml 14 Aug 2011 16:12:13 -0000 1.26 |
147 |
@@ -4,7 +4,7 @@ |
148 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
149 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
150 |
|
151 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.25 2009/02/13 04:40:27 nightmorph Exp $ --> |
152 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.26 2011/08/14 16:12:13 swift Exp $ --> |
153 |
|
154 |
<sections> |
155 |
|
156 |
@@ -13,8 +13,8 @@ |
157 |
different DHCP clients, setting up bonding, bridging, VLANs and more. |
158 |
</abstract> |
159 |
|
160 |
-<version>8.4</version> |
161 |
-<date>2009-02-12</date> |
162 |
+<version>9</version> |
163 |
+<date>2011-08-13</date> |
164 |
|
165 |
<section> |
166 |
<title>Network Modules</title> |
167 |
@@ -41,16 +41,16 @@ |
168 |
|
169 |
<pre caption="Module preference"> |
170 |
<comment># Prefer iproute2 over ifconfig</comment> |
171 |
-modules=( "iproute2" ) |
172 |
+modules="iproute2" |
173 |
|
174 |
<comment># You can also specify other modules for an interface |
175 |
# In this case we prefer pump over dhcpcd</comment> |
176 |
-modules_eth0=( "pump" ) |
177 |
+modules_eth0="pump" |
178 |
|
179 |
<comment># You can also specify which modules not to use - for example you may be |
180 |
# using a supplicant or linux-wlan-ng to control wireless configuration but |
181 |
# you still want to configure network settings per ESSID associated with.</comment> |
182 |
-modules=( "!iwconfig" ) |
183 |
+modules="!iwconfig" |
184 |
</pre> |
185 |
|
186 |
</body> |
187 |
@@ -74,7 +74,7 @@ |
188 |
# <i>emerge sys-apps/iproute2</i> |
189 |
|
190 |
<comment># To prefer iproute2 over ifconfig if both are installed</comment> |
191 |
-modules=( "iproute2" ) |
192 |
+modules="iproute2" |
193 |
</pre> |
194 |
|
195 |
<p> |
196 |
@@ -84,12 +84,12 @@ |
197 |
</p> |
198 |
|
199 |
<pre caption="ifconfig and iproute2 examples"> |
200 |
-config_eth0=( "192.168.0.2/24" ) |
201 |
-config_eth0=( "192.168.0.2 netmask 255.255.255.0" ) |
202 |
+config_eth0="192.168.0.2/24" |
203 |
+config_eth0="192.168.0.2 netmask 255.255.255.0" |
204 |
|
205 |
<comment># We can also specify broadcast</comment> |
206 |
-config_eth0=( "192.168.0.2/24 brd 192.168.0.255" ) |
207 |
-config_eth0=( "192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" ) |
208 |
+config_eth0="192.168.0.2/24 brd 192.168.0.255" |
209 |
+config_eth0="192.168.0.2 netmask 255.255.255.0 broadcast 192.168.0.255" |
210 |
</pre> |
211 |
|
212 |
</body> |
213 |
@@ -178,9 +178,9 @@ |
214 |
|
215 |
<pre caption="Sample DHCP configuration in /etc/conf.d/net"> |
216 |
<comment># Only needed if you have more than one DHCP module installed</comment> |
217 |
-modules=( "dhcpcd" ) |
218 |
+modules="dhcpcd" |
219 |
|
220 |
-config_eth0=( "dhcp" ) |
221 |
+config_eth0="dhcp" |
222 |
dhcpcd_eth0="-t 10" <comment># Timeout after 10 seconds</comment> |
223 |
dhcp_eth0="release nodns nontp nonis" <comment># Only get an address</comment> |
224 |
</pre> |
225 |
@@ -204,10 +204,6 @@ |
226 |
# <i>emerge net-dialup/ppp</i> |
227 |
</pre> |
228 |
|
229 |
-<note> |
230 |
-If you need PPPoA, then make sure to use >=<c>baselayout-1.12.x</c>. |
231 |
-</note> |
232 |
- |
233 |
<p> |
234 |
Second, create the PPP net script and the net script for the ethernet interface |
235 |
to be used by PPP: |
236 |
@@ -219,7 +215,7 @@ |
237 |
</pre> |
238 |
|
239 |
<p> |
240 |
-Be sure to set RC_NET_STRICT_CHECKING="yes" in <path>/etc/conf.d/rc</path>. |
241 |
+Be sure to set <c>rc_depend_strict</c> to "YES" in <path>/etc/rc.conf</path>. |
242 |
</p> |
243 |
|
244 |
<p> |
245 |
@@ -227,26 +223,23 @@ |
246 |
</p> |
247 |
|
248 |
<pre caption="A basic PPPoE setup"> |
249 |
-config_eth0=( null ) <comment>(Specify your ethernet interface)</comment> |
250 |
-config_ppp0=( "ppp" ) |
251 |
+config_eth0=null <comment>(Specify your ethernet interface)</comment> |
252 |
+config_ppp0="ppp" |
253 |
link_ppp0="eth0" <comment>(Specify your ethernet interface)</comment> |
254 |
-plugins_ppp0=( "pppoe" ) |
255 |
+plugins_ppp0="pppoe" |
256 |
username_ppp0='user' |
257 |
password_ppp0='password' |
258 |
-pppd_ppp0=( |
259 |
- "noauth" |
260 |
- "defaultroute" |
261 |
- "usepeerdns" |
262 |
- "holdoff 3" |
263 |
- "child-timeout 60" |
264 |
- "lcp-echo-interval 15" |
265 |
- "lcp-echo-failure 3" |
266 |
- noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp |
267 |
-) |
268 |
- |
269 |
-depend_ppp0() { |
270 |
- need net.eth0 |
271 |
-} |
272 |
+pppd_ppp0=" |
273 |
+noauth |
274 |
+defaultroute |
275 |
+usepeerdns |
276 |
+holdoff 3 |
277 |
+child-timeout 60 |
278 |
+lcp-echo-interval 15 |
279 |
+lcp-echo-failure 3 |
280 |
+noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp" |
281 |
+ |
282 |
+rc_need_ppp0="net.eth0" |
283 |
</pre> |
284 |
|
285 |
<p> |
286 |
@@ -266,8 +259,10 @@ |
287 |
|
288 |
<impo> |
289 |
Please carefully read the section on ADSL and PPP in |
290 |
-<path>/etc/conf.d/net.example</path>. It contains many more detailed |
291 |
-explanations of all the settings your particular PPP setup will likely need. |
292 |
+<path>/usr/share/doc/openrc-0.8.3-r1/net.example.bz2</path>. It contains many |
293 |
+more detailed explanations of all the settings your particular PPP setup will |
294 |
+likely need. Of course, change <c>0.8.3-r1</c> with the version of OpenRC |
295 |
+installed on your system. |
296 |
</impo> |
297 |
|
298 |
</body> |
299 |
@@ -293,11 +288,11 @@ |
300 |
|
301 |
<pre caption="APIPA configuration in /etc/conf.d/net"> |
302 |
<comment># Try DHCP first - if that fails then fallback to APIPA</comment> |
303 |
-config_eth0=( "dhcp" ) |
304 |
-fallback_eth0=( "apipa" ) |
305 |
+config_eth0="dhcp" |
306 |
+fallback_eth0="apipa" |
307 |
|
308 |
<comment># Just use APIPA</comment> |
309 |
-config_eth0=( "apipa" ) |
310 |
+config_eth0="apipa" |
311 |
</pre> |
312 |
|
313 |
</body> |
314 |
@@ -321,12 +316,10 @@ |
315 |
slaves_bond0="eth0 eth1 eth2" |
316 |
|
317 |
<comment># You may not want to assign an IP to the bonded interface</comment> |
318 |
-config_bond0=( "null" ) |
319 |
+config_bond0="null" |
320 |
|
321 |
<comment># Depend on eth0, eth1 and eth2 as they may require extra configuration</comment> |
322 |
-depend_bond0() { |
323 |
- need net.eth0 net.eth1 net.eth2 |
324 |
-} |
325 |
+rc_need_bond0="net.eth0 net.eth1 net.eth2" |
326 |
</pre> |
327 |
|
328 |
</body> |
329 |
@@ -348,22 +341,20 @@ |
330 |
|
331 |
<pre caption="Bridge configuration in /etc/conf.d/net"> |
332 |
<comment># Configure the bridge - "man brctl" for more details</comment> |
333 |
-brctl_br0=( "setfd 0" "sethello 0" "stp off" ) |
334 |
+brctl_br0="setfd 0" "sethello 0" "stp off" |
335 |
|
336 |
<comment># To add ports to bridge br0</comment> |
337 |
bridge_br0="eth0 eth1" |
338 |
|
339 |
<comment># You need to configure the ports to null values so dhcp does not get started</comment> |
340 |
-config_eth0=( "null" ) |
341 |
-config_eth1=( "null" ) |
342 |
+config_eth0="null" |
343 |
+config_eth1="null" |
344 |
|
345 |
<comment># Finally give the bridge an address - you could use DHCP as well</comment> |
346 |
-config_br0=( "192.168.0.1/24" ) |
347 |
+config_br0="192.168.0.1/24" |
348 |
|
349 |
<comment># Depend on eth0 and eth1 as they may require extra configuration</comment> |
350 |
-depend_br0() { |
351 |
- need net.eth0 net.eth1 |
352 |
-} |
353 |
+rc_need_br0="net.eth0 net.eth1" |
354 |
</pre> |
355 |
|
356 |
<impo> |
357 |
@@ -378,11 +369,8 @@ |
358 |
<body> |
359 |
|
360 |
<p> |
361 |
-You don't need to emerge anything for changing the MAC address of your |
362 |
-interface if you have <c>sys-apps/baselayout-1.11.14</c> or newer and want to |
363 |
-change to a specific MAC address. However, if you need to change to a random MAC |
364 |
-address or have a baselayout older than the version mentioned above, you have |
365 |
-to emerge <c>net-analyzer/macchanger</c> to be able to make use of this feature. |
366 |
+If you need to, you can change the MAC address of your interfaces through |
367 |
+the network configuration file too. |
368 |
</p> |
369 |
|
370 |
<pre caption="MAC Address change example"> |
371 |
@@ -424,7 +412,7 @@ |
372 |
iptunnel_vpn0="mode ipip remote 207.170.82.2 ttl 255" |
373 |
|
374 |
<comment># To configure the interface</comment> |
375 |
-config_vpn0=( "192.168.0.2 peer 192.168.1.1" ) |
376 |
+config_vpn0="192.168.0.2 peer 192.168.1.1" |
377 |
</pre> |
378 |
|
379 |
</body> |
380 |
@@ -451,12 +439,12 @@ |
381 |
|
382 |
<comment># You can also configure the VLAN</comment> |
383 |
<comment># see for vconfig man page for more details</comment> |
384 |
-vconfig_eth0=( "set_name_type VLAN_PLUS_VID_NO_PAD" ) |
385 |
-vconfig_vlan1=( "set_flag 1" "set_egress_map 2 6" ) |
386 |
+vconfig_eth0="set_name_type VLAN_PLUS_VID_NO_PAD" |
387 |
+vconfig_vlan1="set_flag 1" "set_egress_map 2 6" |
388 |
|
389 |
<comment># Configure the interface as usual</comment> |
390 |
-config_vlan1=( "172.16.3.1 netmask 255.255.254.0" ) |
391 |
-config_vlan2=( "172.16.2.1 netmask 255.255.254.0" ) |
392 |
+config_vlan1="172.16.3.1 netmask 255.255.254.0" |
393 |
+config_vlan2="172.16.2.1 netmask 255.255.254.0" |
394 |
</pre> |
395 |
|
396 |
<impo> |
397 |
|
398 |
|
399 |
|
400 |
1.10 xml/htdocs/doc/en/handbook/hb-net-start.xml |
401 |
|
402 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?rev=1.10&view=markup |
403 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?rev=1.10&content-type=text/plain |
404 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml?r1=1.9&r2=1.10 |
405 |
|
406 |
Index: hb-net-start.xml |
407 |
=================================================================== |
408 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v |
409 |
retrieving revision 1.9 |
410 |
retrieving revision 1.10 |
411 |
diff -u -r1.9 -r1.10 |
412 |
--- hb-net-start.xml 15 Apr 2010 06:17:23 -0000 1.9 |
413 |
+++ hb-net-start.xml 14 Aug 2011 16:12:13 -0000 1.10 |
414 |
@@ -4,7 +4,7 @@ |
415 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
416 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
417 |
|
418 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v 1.9 2010/04/15 06:17:23 nightmorph Exp $ --> |
419 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v 1.10 2011/08/14 16:12:13 swift Exp $ --> |
420 |
|
421 |
<sections> |
422 |
|
423 |
@@ -13,8 +13,8 @@ |
424 |
environments. |
425 |
</abstract> |
426 |
|
427 |
-<version>8.1</version> |
428 |
-<date>2010-04-14</date> |
429 |
+<version>9</version> |
430 |
+<date>2011-08-13</date> |
431 |
|
432 |
<section> |
433 |
<title>Getting started</title> |
434 |
@@ -27,10 +27,6 @@ |
435 |
<c>eth1</c>, <c>wlan0</c>, etc. |
436 |
</note> |
437 |
|
438 |
-<note> |
439 |
-This document requires you to run <c>baselayout-1.11.11</c> or better. |
440 |
-</note> |
441 |
- |
442 |
<p> |
443 |
To get started configuring your network card, you need to tell the Gentoo RC |
444 |
system about it. This is done by creating a symbolic link from |
445 |
@@ -51,15 +47,15 @@ |
446 |
|
447 |
<pre caption="Examples for /etc/conf.d/net"> |
448 |
<comment># For DHCP</comment> |
449 |
-config_eth0=( "dhcp" ) |
450 |
+config_eth0="dhcp" |
451 |
|
452 |
<comment># For static IP using CIDR notation</comment> |
453 |
-config_eth0=( "192.168.0.7/24" ) |
454 |
-routes_eth0=( "default via 192.168.0.1" ) |
455 |
+config_eth0="192.168.0.7/24" |
456 |
+routes_eth0="default via 192.168.0.1" |
457 |
|
458 |
<comment># For static IP using netmask notation</comment> |
459 |
-config_eth0=( "192.168.0.7 netmask 255.255.255.0" ) |
460 |
-routes_eth0=( "default via 192.168.0.1" ) |
461 |
+config_eth0="192.168.0.7 netmask 255.255.255.0" |
462 |
+routes_eth0="default via 192.168.0.1" |
463 |
</pre> |
464 |
|
465 |
<note> |
466 |
@@ -88,9 +84,9 @@ |
467 |
</pre> |
468 |
|
469 |
<impo> |
470 |
-When troubleshooting networking, it is recommended to set |
471 |
-<c>RC_VERBOSE="yes"</c> in <path>/etc/conf.d/rc</path> so that you get more |
472 |
-information about what's happening. |
473 |
+When troubleshooting networking, take a look at <path>/var/log/rc.log</path>. |
474 |
+Unless you have <c>rc_logger="NO"</c> set in <path>/etc/rc.conf</path>, you |
475 |
+will find information on the boot activity stored in that log file. |
476 |
</impo> |
477 |
|
478 |
<p> |
479 |
|
480 |
|
481 |
|
482 |
1.20 xml/htdocs/doc/en/handbook/hb-net-wireless.xml |
483 |
|
484 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?rev=1.20&view=markup |
485 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?rev=1.20&content-type=text/plain |
486 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml?r1=1.19&r2=1.20 |
487 |
|
488 |
Index: hb-net-wireless.xml |
489 |
=================================================================== |
490 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v |
491 |
retrieving revision 1.19 |
492 |
retrieving revision 1.20 |
493 |
diff -u -r1.19 -r1.20 |
494 |
--- hb-net-wireless.xml 7 Nov 2010 20:16:49 -0000 1.19 |
495 |
+++ hb-net-wireless.xml 14 Aug 2011 16:12:13 -0000 1.20 |
496 |
@@ -4,7 +4,7 @@ |
497 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
498 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
499 |
|
500 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.19 2010/11/07 20:16:49 nightmorph Exp $ --> |
501 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.20 2011/08/14 16:12:13 swift Exp $ --> |
502 |
|
503 |
<sections> |
504 |
|
505 |
@@ -12,8 +12,8 @@ |
506 |
Wireless configuration can be tricky. Hopefully we'll get you working! |
507 |
</abstract> |
508 |
|
509 |
-<version>9.1</version> |
510 |
-<date>2010-11-07</date> |
511 |
+<version>10</version> |
512 |
+<date>2011-08-13</date> |
513 |
|
514 |
<section> |
515 |
<title>Introduction</title> |
516 |
@@ -113,7 +113,7 @@ |
517 |
|
518 |
<pre caption="configure /etc/conf.d/net for wpa_supplicant"> |
519 |
<comment># Prefer wpa_supplicant over wireless-tools</comment> |
520 |
-modules=( "wpa_supplicant" ) |
521 |
+modules="wpa_supplicant" |
522 |
|
523 |
<comment># It's important that we tell wpa_supplicant which driver we should |
524 |
# be using as it's not very good at guessing yet</comment> |
525 |
@@ -259,7 +259,7 @@ |
526 |
|
527 |
<pre caption="sample iwconfig setup in /etc/conf.d/net"> |
528 |
<comment># Prefer iwconfig over wpa_supplicant</comment> |
529 |
-modules=( "iwconfig" ) |
530 |
+modules="iwconfig" |
531 |
|
532 |
<comment># Configure WEP keys for Access Points called ESSID1 and ESSID2</comment> |
533 |
<comment># You may configure up to 4 WEP keys, but only 1 can be active at |
534 |
@@ -278,7 +278,7 @@ |
535 |
|
536 |
<comment># Sometimes more than one Access Point is visible so we need to |
537 |
# define a preferred order to connect in</comment> |
538 |
-preferred_aps=( "ESSID1" "ESSID2" ) |
539 |
+preferred_aps="'ESSID1' 'ESSID2'" |
540 |
</pre> |
541 |
|
542 |
</body> |
543 |
@@ -340,7 +340,7 @@ |
544 |
|
545 |
<pre caption="blacklist_aps and unique_ap example"> |
546 |
<comment># Sometimes you never want to connect to certain access points</comment> |
547 |
-blacklist_aps=( "ESSID3" "ESSID4" ) |
548 |
+blacklist_aps="'ESSID3' 'ESSID4'" |
549 |
|
550 |
<comment># If you have more than one wireless card, you can say if you want |
551 |
# to allow each card to associate with the same Access Point or not |
552 |
@@ -500,24 +500,24 @@ |
553 |
</impo> |
554 |
|
555 |
<pre caption="override network settings per ESSID"> |
556 |
-config_ESSID1=( "192.168.0.3/24 brd 192.168.0.255" ) |
557 |
-routes_ESSID1=( "default via 192.168.0.1" ) |
558 |
+config_ESSID1="192.168.0.3/24 brd 192.168.0.255" |
559 |
+routes_ESSID1="default via 192.168.0.1" |
560 |
|
561 |
-config_ESSID2=( "dhcp" ) |
562 |
-fallback_ESSID2=( "192.168.3.4/24" ) |
563 |
-fallback_route_ESSID2=( "default via 192.168.3.1" ) |
564 |
+config_ESSID2="dhcp" |
565 |
+fallback_ESSID2="192.168.3.4/24" |
566 |
+fallback_route_ESSID2="default via 192.168.3.1" |
567 |
|
568 |
<comment># We can define nameservers and other things too</comment> |
569 |
<comment># NOTE: DHCP will override these unless it's told not too</comment> |
570 |
-dns_servers_ESSID1=( "192.168.0.1" "192.168.0.2" ) |
571 |
+dns_servers_ESSID1="192.168.0.1 192.168.0.2" |
572 |
dns_domain_ESSID1="some.domain" |
573 |
dns_search_domains_ESSID1="search.this.domain search.that.domain" |
574 |
|
575 |
<comment># You override by the MAC address of the Access Point |
576 |
# This handy if you goto different locations that have the same ESSID</comment> |
577 |
-config_001122334455=( "dhcp" ) |
578 |
+config_001122334455="dhcp" |
579 |
dhcpcd_001122334455="-t 10" |
580 |
-dns_servers_001122334455=( "192.168.0.1" "192.168.0.2" ) |
581 |
+dns_servers_001122334455="192.168.0.1 192.168.0.2" |
582 |
</pre> |
583 |
|
584 |
</body> |
585 |
|
586 |
|
587 |
|
588 |
1.34 xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml |
589 |
|
590 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?rev=1.34&view=markup |
591 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?rev=1.34&content-type=text/plain |
592 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml?r1=1.33&r2=1.34 |
593 |
|
594 |
Index: hb-working-rcscripts.xml |
595 |
=================================================================== |
596 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v |
597 |
retrieving revision 1.33 |
598 |
retrieving revision 1.34 |
599 |
diff -u -r1.33 -r1.34 |
600 |
--- hb-working-rcscripts.xml 12 Aug 2011 19:34:56 -0000 1.33 |
601 |
+++ hb-working-rcscripts.xml 14 Aug 2011 16:12:13 -0000 1.34 |
602 |
@@ -4,7 +4,7 @@ |
603 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
604 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
605 |
|
606 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v 1.33 2011/08/12 19:34:56 swift Exp $ --> |
607 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-rcscripts.xml,v 1.34 2011/08/14 16:12:13 swift Exp $ --> |
608 |
|
609 |
<sections> |
610 |
|
611 |
@@ -778,21 +778,25 @@ |
612 |
|
613 |
<p> |
614 |
Even though <c>net.eth0</c> has been removed from the offline runlevel, |
615 |
-<c>udev</c> will still attempt to start any devices it detects and launch the |
616 |
-appropriate services. Therefore, you will need to add each network service you |
617 |
-do not want started (as well as services for any other devices that may be |
618 |
-started by udev) to <path>/etc/conf.d/rc</path> as shown. |
619 |
+<c>udev</c> might want to attempt to start any devices it detects and launch the |
620 |
+appropriate services, a functionality that is called <e>hotplugging</e>. By |
621 |
+default, Gentoo does not enable hotplugging. |
622 |
</p> |
623 |
|
624 |
-<pre caption="Disabling device initiated services in /etc/conf.d/rc"> |
625 |
-RC_COLDPLUG="yes" |
626 |
-<comment>(Next, specify the services you do not want automatically started)</comment> |
627 |
-RC_PLUG_SERVICES="!net.eth0" |
628 |
+<p> |
629 |
+If you do want to enable hotplugging, but only for a selected set of scripts, |
630 |
+use the <c>rc_hotplug</c> variable in <path>/etc/rc.conf</path>: |
631 |
+</p> |
632 |
+ |
633 |
+<pre caption="Disabling device initiated services in /etc/rc.conf"> |
634 |
+<comment># Allow net.wlan as well as any other service, except those matching net.* |
635 |
+# to be hotplugged</comment> |
636 |
+rc_hotplug="net.wlan !net.*" |
637 |
</pre> |
638 |
|
639 |
<note> |
640 |
For more information on device initiated services, please see the comments |
641 |
-inside <path>/etc/conf.d/rc</path>. |
642 |
+inside <path>/etc/rc.conf</path>. |
643 |
</note> |
644 |
|
645 |
<p> |