Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-net-advanced.xml hb-net-modules.xml hb-net-start.xml hb-net-wireless.xml hb-working-rcscripts.xml
Date: Sun, 14 Aug 2011 16:12:33
Message-Id: 20110814161214.1AD442004C@flycatcher.gentoo.org
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&amp;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>