dev-manual: Read-thru edits for "Selecting an Initialization Manager"

Mainly changed the way I referred to Systemd and SysVinit.  I was
rendering them in a courier font, which was not correct.

(From yocto-docs rev: 179ae65ffdfcf59c36e4a3d315855d50722ad890)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2014-03-19 06:44:38 -06:00 committed by Richard Purdie
parent 80e7223d89
commit d8b69fb4de
1 changed files with 16 additions and 69 deletions

View File

@ -5304,64 +5304,51 @@
<title>Selecting an Initialization Manager</title> <title>Selecting an Initialization Manager</title>
<para> <para>
By default, the Yocto Project uses By default, the Yocto Project uses SysVinit as the initialization
<filename>SysVinit</filename> as the initialization manager. manager.
However, support also exists for <filename>systemd</filename>, However, support also exists for Systemd,
which is a full replacement for <filename>init</filename> with which is a full replacement for init with
parallel starting of services, reduced shell overhead and other parallel starting of services, reduced shell overhead and other
features that are used by many distributions. features that are used by many distributions.
</para> </para>
<para> <para>
If you want to use <filename>sysvinit</filename>, you do If you want to use SysVinit, you do
not have to do anything. not have to do anything.
But, if you want to use <filename>systemd</filename>, you must But, if you want to use Systemd, you must
take some steps as described in the following sections. take some steps as described in the following sections.
</para> </para>
<!--
<note>
It is recommended that you create your own distribution configuration
file to hold these settings instead of using your
<filename>local.conf</filename> file.
For information on creating your own distribution, see the
"<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
section.
</note>
-->
<section id='using-systemd-exclusively'> <section id='using-systemd-exclusively'>
<title>Using systemd Exclusively</title> <title>Using Systemd Exclusively</title>
<para> <para>
Set the following variables in your distribution configuration Set the these variables in your distribution configuration
file as follows: file as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
DISTRO_FEATURES_append = " systemd" DISTRO_FEATURES_append = " systemd"
VIRTUAL-RUNTIME_init_manager = "systemd" VIRTUAL-RUNTIME_init_manager = "systemd"
</literallayout> </literallayout>
You can also prevent the <filename>sysvinit</filename> You can also prevent the SysVinit
distribution feature from distribution feature from
being automatically enabled as follows: being automatically enabled as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit" DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
</literallayout> </literallayout>
Doing so removes any redundant <filename>sysvinit</filename> Doing so removes any redundant SysVinit scripts.
scripts.
</para> </para>
<para> <para>
For information on the backfill variable, see For information on the backfill variable, see
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><filename>DISTRO_FEATURES_BACKFILL_CONSIDERED</filename></ulink> <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><filename>DISTRO_FEATURES_BACKFILL_CONSIDERED</filename></ulink>.
in the Yocto Project Reference Manual.
</para> </para>
</section> </section>
<section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'> <section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'>
<title>Using systemd for the Main Image and Using SysVinit for the Rescue Image</title> <title>Using Systemd for the Main Image and Using SysVinit for the Rescue Image</title>
<para> <para>
Set the following variables in your distribution configuration Set the these variables in your distribution configuration
file as follows: file as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
DISTRO_FEATURES_append = " systemd" DISTRO_FEATURES_append = " systemd"
@ -5369,55 +5356,15 @@
</literallayout> </literallayout>
Doing so causes your main image to use the Doing so causes your main image to use the
<filename>packagegroup-core-boot.bb</filename> recipe and <filename>packagegroup-core-boot.bb</filename> recipe and
<filename>systemd</filename>. Systemd.
The rescue/minimal image cannot use this package group. The rescue/minimal image cannot use this package group.
However, it can install <filename>sysvinit</filename> However, it can install SysVinit
and the appropriate packages will have support for both and the appropriate packages will have support for both
<filename>systemd</filename> and <filename>sysvinit</filename>. Systemd and SysVinit.
</para> </para>
</section> </section>
</section> </section>
<!--
<section id='excluding-recipes-from-the-build'>
<title>Excluding Recipes From the Build</title>
<para>
You might find that there are groups of recipes or append files
that you want to filter out of the build process.
Usually, this is not necessary.
However, on rare occasions where you might want to use a
layer but exclude parts that are causing problems, such
as introducing a different version of a recipe, you can
use
<ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink>
to exclude the recipe.
</para>
<para>
It is possible to filter or mask out <filename>.bb</filename> and
<filename>.bbappend</filename> files.
You can do this by providing an expression with the
<filename>BBMASK</filename> variable.
Here is one example:
<literallayout class='monospaced'>
BBMASK = "/meta-mymachine/recipes-maybe/"
</literallayout>
Here, all <filename>.bb</filename> and
<filename>.bbappend</filename> files in the directory that match
the expression are ignored during the build process.
</para>
<note>
The value you provide is passed to Python's regular expression
compiler.
The expression is compared against the full paths to the files.
For complete syntax information, see Python's documentation at
<ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>.
</note>
</section>
-->
<section id="platdev-appdev-srcrev"> <section id="platdev-appdev-srcrev">
<title>Using an External SCM</title> <title>Using an External SCM</title>