Gentoo Archives: gentoo-doc-cvs

From: "Robin H. Johnson (robbat2)" <robbat2@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: openrc-migration.xml
Date: Thu, 13 Jan 2011 05:03:45
Message-Id: 20110113042614.55E3320054@flycatcher.gentoo.org
1 robbat2 11/01/13 04:26:14
2
3 Modified: openrc-migration.xml
4 Log:
5 Document rc_sys setting.
6
7 Revision Changes Path
8 1.23 xml/htdocs/doc/en/openrc-migration.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?rev=1.23&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?rev=1.23&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?r1=1.22&r2=1.23
13
14 Index: openrc-migration.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v
17 retrieving revision 1.22
18 retrieving revision 1.23
19 diff -p -w -b -B -u -u -r1.22 -r1.23
20 --- openrc-migration.xml 13 Jan 2011 03:39:04 -0000 1.22
21 +++ openrc-migration.xml 13 Jan 2011 04:26:14 -0000 1.23
22 @@ -1,6 +1,6 @@
23 <?xml version='1.0' encoding='UTF-8'?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.22 2011/01/13 03:39:04 robbat2 Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.23 2011/01/13 04:26:14 robbat2 Exp $ -->
27
28 <guide link="/doc/en/openrc-migration.xml">
29 <title>Baselayout and OpenRC Migration Guide</title>
30 @@ -452,6 +452,93 @@ rc_logger="YES"
31 </section>
32 <!-- =============================================================== -->
33
34 +<section id="rc_sys">
35 +<title>System sub-types: Virtualization special cases</title>
36 +<body>
37 +
38 +<p>
39 +In the early versions of OpenRC, we explictly detected multiple types of
40 +virtualization, and used that detection to note when certain init scripts
41 +should be skipped, using the <b>keyword</b> call in the <b>depend</b>
42 +functions.
43 +</p>
44 +
45 +<p>
46 +However, as of the 0.7.0 release, you are required to explicitly configure the
47 +sub-type using the <b>rc_sys</b> variable in <path>/etc/rc.conf</path>.
48 +</p>
49 +
50 +<impo>
51 +If you do not have any specific sub-type, please use the default of an empty
52 +string <b>""</b>. If the variable is unset, you will be given a warning and we
53 +will attempt to use the old detection algorithm.
54 +</impo>
55 +
56 +<pre caption="Setting system sub-type to none in /etc/rc.conf">
57 +rc_sys=""
58 +</pre>
59 +
60 +<p>The detection algorithm had to be replaced with manual configuration due to
61 +the introduction of new sub-types and changes to the kernel that made prior
62 +detection unreliable.</p>
63 +
64 +<table>
65 +<tr>
66 + <th>Subtype</th>
67 + <th>Description</th>
68 + <th>Notes</th>
69 +</tr>
70 +<tr>
71 + <ti></ti>
72 + <ti>Default, no sub-type</ti>
73 + <ti>Not the same as unset; FreeBSD, Linux &amp; NetBSD</ti>
74 +</tr>
75 +<tr>
76 + <ti>jail</ti>
77 + <ti>FreeBSD jails</ti>
78 + <ti></ti>
79 +</tr>
80 +<tr>
81 + <ti>lxc</ti>
82 + <ti>Linux Containers</ti>
83 + <ti>Not auto-detected</ti>
84 +</tr>
85 +<tr>
86 + <ti>openvz</ti>
87 + <ti>Linux OpenVZ</ti>
88 + <ti></ti>
89 +</tr>
90 +<tr>
91 + <ti>prefix</ti>
92 + <ti>Prefix</ti>
93 + <ti>Not auto-detected; FreeBSD, Linux &amp; NetBSD</ti>
94 +</tr>
95 +<tr>
96 + <ti>uml</ti>
97 + <ti>Usermode Linux</ti>
98 + <ti></ti>
99 +</tr>
100 +<tr>
101 + <ti>vserver</ti>
102 + <ti>Linux vserver</ti>
103 + <ti></ti>
104 +</tr>
105 +<tr>
106 + <ti>xen0</ti>
107 + <ti>Xen0 Domain</ti>
108 + <ti>Linux &amp; NetBSD</ti>
109 +</tr>
110 +<tr>
111 + <ti>xenU</ti>
112 + <ti>XenU Domain</ti>
113 + <ti>Linux &amp; NetBSD</ti>
114 +</tr>
115 +</table>
116 +
117 +</body>
118 +</section>
119 +<!-- =============================================================== -->
120 +
121 <section>
122 <title>Finishing up</title>
123 <body>