robbat2 11/01/13 04:26:14 Modified: openrc-migration.xml Log: Document rc_sys setting.
Revision Changes Path 1.23 xml/htdocs/doc/en/openrc-migration.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?rev=1.23&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?rev=1.23&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openrc-migration.xml?r1=1.22&r2=1.23 Index: openrc-migration.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v retrieving revision 1.22 retrieving revision 1.23 diff -p -w -b -B -u -u -r1.22 -r1.23 --- openrc-migration.xml 13 Jan 2011 03:39:04 -0000 1.22 +++ openrc-migration.xml 13 Jan 2011 04:26:14 -0000 1.23 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.22 2011/01/13 03:39:04 robbat2 Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openrc-migration.xml,v 1.23 2011/01/13 04:26:14 robbat2 Exp $ --> <guide link="/doc/en/openrc-migration.xml"> <title>Baselayout and OpenRC Migration Guide</title> @@ -452,6 +452,93 @@ rc_logger="YES" </section> <!-- =============================================================== --> +<section id="rc_sys"> +<title>System sub-types: Virtualization special cases</title> +<body> + +<p> +In the early versions of OpenRC, we explictly detected multiple types of +virtualization, and used that detection to note when certain init scripts +should be skipped, using the <b>keyword</b> call in the <b>depend</b> +functions. +</p> + +<p> +However, as of the 0.7.0 release, you are required to explicitly configure the +sub-type using the <b>rc_sys</b> variable in <path>/etc/rc.conf</path>. +</p> + +<impo> +If you do not have any specific sub-type, please use the default of an empty +string <b>""</b>. If the variable is unset, you will be given a warning and we +will attempt to use the old detection algorithm. +</impo> + +<pre caption="Setting system sub-type to none in /etc/rc.conf"> +rc_sys="" +</pre> + +<p>The detection algorithm had to be replaced with manual configuration due to +the introduction of new sub-types and changes to the kernel that made prior +detection unreliable.</p> + +<table> +<tr> + <th>Subtype</th> + <th>Description</th> + <th>Notes</th> +</tr> +<tr> + <ti></ti> + <ti>Default, no sub-type</ti> + <ti>Not the same as unset; FreeBSD, Linux & NetBSD</ti> +</tr> +<tr> + <ti>jail</ti> + <ti>FreeBSD jails</ti> + <ti></ti> +</tr> +<tr> + <ti>lxc</ti> + <ti>Linux Containers</ti> + <ti>Not auto-detected</ti> +</tr> +<tr> + <ti>openvz</ti> + <ti>Linux OpenVZ</ti> + <ti></ti> +</tr> +<tr> + <ti>prefix</ti> + <ti>Prefix</ti> + <ti>Not auto-detected; FreeBSD, Linux & NetBSD</ti> +</tr> +<tr> + <ti>uml</ti> + <ti>Usermode Linux</ti> + <ti></ti> +</tr> +<tr> + <ti>vserver</ti> + <ti>Linux vserver</ti> + <ti></ti> +</tr> +<tr> + <ti>xen0</ti> + <ti>Xen0 Domain</ti> + <ti>Linux & NetBSD</ti> +</tr> +<tr> + <ti>xenU</ti> + <ti>XenU Domain</ti> + <ti>Linux & NetBSD</ti> +</tr> +</table> + +</body> +</section> +<!-- =============================================================== --> + <section> <title>Finishing up</title> <body>
