/[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.17 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.17 2009/11/30 07:39:15 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>1.11</version> 30<version>4</version>
28<date>2009-11-29</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<note>
190Please note the difference between <b>module_</b> and <b>modules_</b>.
191</note>
192
193</body> 213</body>
194</section> 214</section>
215
216<!-- =============================================================== -->
195<section id="boot"> 217<section id="boot">
196<title>Boot runlevel</title> 218<title>Boot runlevel</title>
197<body> 219<body>
198 220
199<p> 221<p>
243# <i>rc-update add lvm boot</i> 265# <i>rc-update add lvm boot</i>
244</pre> 266</pre>
245 267
246</body> 268</body>
247</section> 269</section>
270<!-- =============================================================== -->
271
248<section> 272<section>
249<title>Udev</title> 273<title>Udev</title>
250<body> 274<body>
251 275
252<p> 276<p>
270# <i>rc-update add udev sysinit</i> 294# <i>rc-update add udev sysinit</i>
271</pre> 295</pre>
272 296
273</body> 297</body>
274</section> 298</section>
299<!-- =============================================================== -->
300
275<section> 301<section>
276<title>Network</title> 302<title>Network</title>
277<body> 303<body>
278 304
279<p> 305<p>
292to 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
293device. 319device.
294</p> 320</p>
295 321
296<p> 322<p>
297Also, <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
298configuration. Please review 324for configuration. Please review
299<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
300instructions. Conversion should be relatively straight-forward, for example a 326instructions. Conversion should be relatively straight-forward, converting to
301static IP assignment would change as follows: 327newlines for seperate entries, for example a static IP assignment would change
328as follows:
302</p> 329</p>
303 330
304<pre caption="Old /etc/conf.d/net style"> 331<pre caption="Old /etc/conf.d/net style">
305config_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" )
306routes_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" )
307</pre> 334</pre>
308 335
309<pre caption="New /etc/conf.d/net style"> 336<pre caption="New /etc/conf.d/net style">
310config_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"
311routes_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"
312</pre> 340</pre>
313 341
314</body> 342</body>
315</section> 343</section>
344<!-- =============================================================== -->
345
316<section> 346<section>
317<title>Clock</title> 347<title>Clock</title>
318<body> 348<body>
319 349
320<p> 350<p>
346America/New_York 376America/New_York
347</pre> 377</pre>
348 378
349</body> 379</body>
350</section> 380</section>
381<!-- =============================================================== -->
382
351<section> 383<section>
352<title>XSESSION</title> 384<title>XSESSION</title>
353<body> 385<body>
354 386
355<p> 387<p>
373~/.bashrc</c>. 405~/.bashrc</c>.
374</impo> 406</impo>
375 407
376</body> 408</body>
377</section> 409</section>
410<!-- =============================================================== -->
411
378<section> 412<section>
379<title>EDITOR and PAGER</title> 413<title>EDITOR and PAGER</title>
380<body> 414<body>
381 415
382<p> 416<p>
393~/.bashrc</c>. 427~/.bashrc</c>.
394</impo> 428</impo>
395 429
396</body> 430</body>
397</section> 431</section>
432<!-- =============================================================== -->
433
398<section> 434<section>
399<title>Boot log</title> 435<title>Boot log</title>
400<body> 436<body>
401 437
402<p> 438<p>
412rc_logger="YES" 448rc_logger="YES"
413</pre> 449</pre>
414 450
415</body> 451</body>
416</section> 452</section>
453<!-- =============================================================== -->
454
417<section> 455<section>
418<title>Finishing up</title> 456<title>Finishing up</title>
419<body> 457<body>
420 458
421<p> 459<p>
425boot. 463boot.
426</p> 464</p>
427 465
428</body> 466</body>
429</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
430</chapter> 491</chapter>
431</guide> 492</guide>

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

  ViewVC Help
Powered by ViewVC 1.1.20