/[gentoo]/xml/htdocs/doc/en/openrc-migration.xml
Gentoo

Diff of /xml/htdocs/doc/en/openrc-migration.xml

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

Revision 1.18 Revision 1.22
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.18 2010/07/20 08:51:25 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.22 2011/01/13 03:39:04 robbat2 Exp $ -->
4 4
5<guide link="/doc/en/openrc-migration.xml"> 5<guide link="/doc/en/openrc-migration.xml">
6<title>Baselayout and OpenRC Migration Guide</title> 6<title>Baselayout and OpenRC Migration Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="cardoe"/> 9 <mail link="cardoe"/>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="nightmorph"/> 12 <mail link="nightmorph"/>
13</author> 13</author>
14<author title="Author">
15 <mail link="robbat2"/>
16</author>
14<author title="Contributor"> 17<author title="Contributor">
15 <mail link="uberlord"/> 18 <mail link="uberlord"/>
16</author> 19</author>
17 20
18<abstract> 21<abstract>
22 25
23<!-- The content of this document is licensed under the CC-BY-SA license --> 26<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 27<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 28<license/>
26 29
27<version>2</version> 30<version>4</version>
28<date>2010-07-20</date> 31<date>2011-01-12</date>
29 32
30<chapter> 33<chapter>
31<title>Background</title> 34<title>Background</title>
35
36<!-- =============================================================== -->
32<section> 37<section>
33<title>What's baselayout?</title> 38<title>What's baselayout?</title>
34<body> 39<body>
35 40
36<p> 41<p>
40<path>/usr</path>, <path>/home</path> directories). 45<path>/usr</path>, <path>/home</path> directories).
41</p> 46</p>
42 47
43</body> 48</body>
44</section> 49</section>
50<!-- =============================================================== -->
51
45<section> 52<section>
46<title>What's OpenRC?</title> 53<title>What's OpenRC?</title>
47<body> 54<body>
48 55
49<p> 56<p>
54by <c>sys-freebsd/freebsd-sbin</c>. 61by <c>sys-freebsd/freebsd-sbin</c>.
55</p> 62</p>
56 63
57</body> 64</body>
58</section> 65</section>
66<!-- =============================================================== -->
67
59<section> 68<section>
60<title>So why migrate?</title> 69<title>So why migrate?</title>
61<body> 70<body>
62 71
63<p> 72<p>
84FreeBSD and NetBSD. 93FreeBSD and NetBSD.
85</p> 94</p>
86 95
87</body> 96</body>
88</section> 97</section>
98<!-- =============================================================== -->
99
89</chapter> 100</chapter>
90
91<chapter> 101<chapter>
92<title>Migration to OpenRC</title> 102<title>Migration to OpenRC</title>
103
104<!-- =============================================================== -->
93<section> 105<section>
94<body> 106<body>
95 107
96<p> 108<p>
97Migration to OpenRC is fairly straightforward; it will be pulled in as part of 109Migration to OpenRC is fairly straightforward; it will be pulled in as part of
109verify prior to rebooting. 121verify prior to rebooting.
110</p> 122</p>
111 123
112</body> 124</body>
113</section> 125</section>
126<!-- =============================================================== -->
114 127
115<section id="rc_conf"> 128<section id="rc_conf">
116<title>/etc/conf.d/rc</title> 129<title>/etc/conf.d/rc</title>
117<body> 130<body>
118 131
124delete <path>/etc/conf.d/rc</path>. 137delete <path>/etc/conf.d/rc</path>.
125</p> 138</p>
126 139
127</body> 140</body>
128</section> 141</section>
142<!-- =============================================================== -->
143
129<section id="modules"> 144<section id="modules">
130<title>Kernel modules</title> 145<title>Kernel modules</title>
131<body> 146<body>
132 147
133<p> 148<p>
162In the above examples, the modules and their parameters would only be passed 177In the above examples, the modules and their parameters would only be passed
163to 2.6.x series kernels. The new configuration allows for fine grained 178to 2.6.x series kernels. The new configuration allows for fine grained
164control over the modules and parameters based on kernel version. 179control over the modules and parameters based on kernel version.
165</p> 180</p>
166 181
182<impo>
183The <b>module*</b> variables are not cumulative. The more version-specific
184variables will override the more general variables.
185</impo>
186
187<note>
188Please note the difference between <b>module_</b> and <b>modules_</b>.
189</note>
190
167<p> 191<p>
168An in-depth example would be: 192An in-depth example would be:
169</p> 193</p>
170 194
171<pre caption="detailed example of /etc/conf.d/modules"> 195<pre caption="detailed example of /etc/conf.d/modules">
172<comment># Always load ochi1394 and ieee1394, no matter the kernel version</comment>
173modules="ohci1394 ieee1394"
174<comment># Only load tun and usbserial for 2.6.x series kernels</comment>
175modules_2_6="tun usbserial"
176<comment># Only load cx88_dvb for 2.6.23 kernels</comment>
177modules_2_6_23="cx88_dvb"
178<comment># Only load ivtv for 2.6.23-gentoo-r5</comment> 196<comment># Only load ivtv for 2.6.23-gentoo-r5</comment>
179modules_2_6_23_gentoo_r5="ivtv" 197modules_2_6_23_gentoo_r5="ivtv"
198<comment># Only load cx88_dvb for 2.6.23 kernels (other than -gentoo-r5)</comment>
199modules_2_6_23="cx88_dvb"
200<comment># Only load tun and usbserial for 2.6.x series kernels where x != 23</comment>
201modules_2_6="tun usbserial"
202<comment># Otherwise load ochi1394 and ieee1394</comment>
203modules="ohci1394 ieee1394"
180 204
181<comment># For 2.6.23-gentoo-r5, pass video_br=2 to cx88_dvb</comment> 205<comment># For 2.6.23-gentoo-r5, pass video_br=2 to cx88_dvb</comment>
182module_cx88_dvb_args_2_6_23_gentoo_r5="video_br=2" 206module_cx88_dvb_args_2_6_23_gentoo_r5="video_br=2"
183<comment># For 2.6.x series kernels, always pass vendor and product</comment> 207<comment># For 2.6.x series kernels, always pass vendor and product</comment>
184module_usbserial_args_2_6="vendor=0x1410 product=0x2110" 208module_usbserial_args_2_6="vendor=0x1410 product=0x2110"
185<comment># Always pass debug to ieee1394</comment> 209<comment># Always pass debug to ieee1394</comment>
186module_ieee1394_args="debug" 210module_ieee1394_args="debug"
187</pre> 211</pre>
188 212
189<impo>
190The <b>module*</b> variables are not cumulative. The more version-specific
191variables will override the more general variables.
192</impo>
193
194<note>
195Please note the difference between <b>module_</b> and <b>modules_</b>.
196</note>
197
198</body> 213</body>
199</section> 214</section>
215
216<!-- =============================================================== -->
200<section id="boot"> 217<section id="boot">
201<title>Boot runlevel</title> 218<title>Boot runlevel</title>
202<body> 219<body>
203 220
204<p> 221<p>
248# <i>rc-update add lvm boot</i> 265# <i>rc-update add lvm boot</i>
249</pre> 266</pre>
250 267
251</body> 268</body>
252</section> 269</section>
270<!-- =============================================================== -->
271
253<section> 272<section>
254<title>Udev</title> 273<title>Udev</title>
255<body> 274<body>
256 275
257<p> 276<p>
275# <i>rc-update add udev sysinit</i> 294# <i>rc-update add udev sysinit</i>
276</pre> 295</pre>
277 296
278</body> 297</body>
279</section> 298</section>
299<!-- =============================================================== -->
300
280<section> 301<section>
281<title>Network</title> 302<title>Network</title>
282<body> 303<body>
283 304
284<p> 305<p>
297to re-add them. Simply replace <c>eth0</c> with the name of your network 318to re-add them. Simply replace <c>eth0</c> with the name of your network
298device. 319device.
299</p> 320</p>
300 321
301<p> 322<p>
302Also, <path>/etc/conf.d/net</path> no longer uses bash-style arrays for 323Also, <path>/etc/conf.d/net</path> (oldnet) no longer uses bash-style arrays
303configuration. Please review 324for configuration. Please review
304<path>/usr/share/doc/openrc-&lt;version&gt;/net.example</path> for configuration 325<path>/usr/share/doc/openrc-&lt;version&gt;/net.example</path> for configuration
305instructions. Conversion should be relatively straight-forward, for example a 326instructions. Conversion should be relatively straight-forward, converting to
306static IP assignment would change as follows: 327newlines for seperate entries, for example a static IP assignment would change
328as follows:
307</p> 329</p>
308 330
309<pre caption="Old /etc/conf.d/net style"> 331<pre caption="Old /etc/conf.d/net style">
310config_eth0=( "192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255" ) 332config_eth0=( "192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255" )
311routes_eth0=( "default via 192.168.1.100" ) 333routes_eth0=( "default via 192.168.1.100" "10.0.0.0/8 via 192.168.1.2" )
312</pre> 334</pre>
313 335
314<pre caption="New /etc/conf.d/net style"> 336<pre caption="New /etc/conf.d/net style">
315config_eth0="192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255" 337config_eth0="192.168.1.37 netmask 255.255.255.0 brd 192.168.1.255"
316routes_eth0="default via 192.168.1.100" 338routes_eth0="default via 192.168.1.100
33910.0.0.0/8 via 192.168.1.2"
317</pre> 340</pre>
318 341
319</body> 342</body>
320</section> 343</section>
344<!-- =============================================================== -->
345
321<section> 346<section>
322<title>Clock</title> 347<title>Clock</title>
323<body> 348<body>
324 349
325<p> 350<p>
351America/New_York 376America/New_York
352</pre> 377</pre>
353 378
354</body> 379</body>
355</section> 380</section>
381<!-- =============================================================== -->
382
356<section> 383<section>
357<title>XSESSION</title> 384<title>XSESSION</title>
358<body> 385<body>
359 386
360<p> 387<p>
378~/.bashrc</c>. 405~/.bashrc</c>.
379</impo> 406</impo>
380 407
381</body> 408</body>
382</section> 409</section>
410<!-- =============================================================== -->
411
383<section> 412<section>
384<title>EDITOR and PAGER</title> 413<title>EDITOR and PAGER</title>
385<body> 414<body>
386 415
387<p> 416<p>
398~/.bashrc</c>. 427~/.bashrc</c>.
399</impo> 428</impo>
400 429
401</body> 430</body>
402</section> 431</section>
432<!-- =============================================================== -->
433
403<section> 434<section>
404<title>Boot log</title> 435<title>Boot log</title>
405<body> 436<body>
406 437
407<p> 438<p>
417rc_logger="YES" 448rc_logger="YES"
418</pre> 449</pre>
419 450
420</body> 451</body>
421</section> 452</section>
453<!-- =============================================================== -->
454
422<section> 455<section>
423<title>Finishing up</title> 456<title>Finishing up</title>
424<body> 457<body>
425 458
426<p> 459<p>
430boot. 463boot.
431</p> 464</p>
432 465
433</body> 466</body>
434</section> 467</section>
468<!-- =============================================================== -->
469
470</chapter>
471<chapter>
472<title>Changed functionality</title>
473<!-- =============================================================== -->
474
475<section>
476<title>The pause action</title>
477<body>
478
479<p>
480Previously it was possible to temporarily stop a service without taking down all
481the depending services by using <c>/etc/init.d/service pause</c>. In OpenRC, the
482<c>pause</c> action was removed; this functionality is supported by the
483<c>/etc/init.d/service --nodeps stop</c>, which also works in the old
484baselayout.
485</p>
486
487</body>
488</section>
489<!-- =============================================================== -->
490
435</chapter> 491</chapter>
436</guide> 492</guide>

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.22

  ViewVC Help
Powered by ViewVC 1.1.20