sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Edits to systemd section. 

Changes from Paul Eggleton after a review.

(From yocto-docs rev: 16daab4d3898906dc681d9dad391bd1bc9dce4fe)

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 2013-04-16 08:53:07 -07:00 committed by Richard Purdie
parent 1fbc3e9c81
commit bf64daa2ab
1 changed files with 37 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -2384,27 +2384,34 @@
A common example usage of include files would be to
separate out the selection of desired version and revisions
for individual recipes.
</para>
<para>Your configuration file needs to set the following
required variables:
<literallayout class='monospaced'>
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_NAME'><filename>DISTRO_NAME</filename></ulink> [required]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_VERSION'><filename>DISTRO_VERSION</filename></ulink> [required]
</literallayout>
These following variables are optional and you typically
set them from the distribution configuration file:
<literallayout class='monospaced'>
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></ulink> [optional]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RDEPENDS'><filename>DISTRO_EXTRA_RDEPENDS</filename></ulink> [optional]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RRECOMMENDS'><filename>DISTRO_EXTRA_RRECOMMENDS</filename></ulink> [optional]
<ulink url='&YOCTO_DOCS_REF_URL;#var-TCLIBC'><filename>TCLIBC</filename></ulink> [optional]
</literallayout>
<tip>
If you want to base your distribution configuration file
on the very basic configuration from OE-Core, you
can "require"
<filename>conf/distro/defaultsetup.conf</filename>.
can use
<filename>conf/distro/defaultsetup.conf</filename> as
a reference and just include variables that differ
as compared to <filename>defaultsetup.conf</filename>.
Alternatively, you can create a distribution
configuration file from scratch using the
<filename>defaultsetup.conf</filename> file
or configuration files from other distributions
such as Poky or Angstrom as references.
</tip></para>
<para>Your configuration file needs to set the following
variables:
<literallayout class='monospaced'>
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_NAME'><filename>DISTRO_NAME</filename></ulink> [required]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_VERSION'><filename>DISTRO_VERSION</filename></ulink> [required]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></ulink> [required if creating from scratch]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RDEPENDS'><filename>DISTRO_EXTRA_RDEPENDS</filename></ulink> [optional]
<ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RRECOMMENDS'><filename>DISTRO_EXTRA_RRECOMMENDS</filename></ulink> [optional]
<ulink url='&YOCTO_DOCS_REF_URL;#var-TCLIBC'><filename>TCLIBC</filename></ulink> [required if creating from scratch]
</literallayout></para></listitem>
</tip></para></listitem>
<listitem><para><emphasis>Provide Miscellaneous Variables:</emphasis>
Be sure to define any other variable for which you want to
create a default or enforce as part of the distribution
@ -3724,36 +3731,27 @@
</para>
<note>
<para><emphasis>NOTES TO SELF:</emphasis>
<filename>systemd</filename> is a full replacement of for init with
parallel starting of services, reduced shell overhead and other
features, used by many distributions.</para>
<para>I think you set the <filename>VIRTUAL-RUNTIME</filename>
in a recipe.
I found a recipe called
<filename>packagegroup-core-boot.bb</filename>, which is an
<filename>OE-Core</filename> recipe, that has a bunch of them.
The comment refers to the group as "VIRTUAL-RUNTIME providers".
The list includes <filename>VIRTUAL-RUNTIME_dev_manager</filename>,
<filename>VIRTUAL-RUNTIME_init_manager</filename>,
<filename>VIRTUAL-RUNTIME_login_manager</filename>,
<filename>VIRTUAL-RUNTIME_initscripts</filename>, and
<filename>VIRTUAL-RUNTIME_keymaps</filename>.</para>
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'>
<title>Using systemd Exclusively</title>
<para>
Set the following variables in your
<filename>local.conf</filename> file as follows:
Set the following variables in your distribution configuration
file as follows:
<literallayout class='monospaced'>
DISTRO_FEATURES_append = " systemd"
VIRTUAL-RUNTIME_init_manager = "systemd"
</literallayout>
You can save some disk space by adding
<filename>sysvinit</filename> to the distribution features
considered for backfill as follows:
You can also prevent the <filename>sysvinit</filename>
distribution feature from
being automatically enabled as follows:
<literallayout class='monospaced'>
DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
</literallayout>
@ -3762,12 +3760,12 @@
</para>
</section>
<section id='use-systemd-for-the-main-image-and-use-sysvinit-for-the-rescue-image'>
<title>Use systemd for the Main Image and Use SysVinit for the Rescue Image</title>
<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>
<para>
Set the following variables in your
<filename>local.conf</filename> file as follows:
Set the following variables in your distribution configuration
file as follows:
<literallayout class='monospaced'>
DISTRO_FEATURES_append = " systemd"
VIRTUAL-RUNTIME_init_manager = "systemd"
@ -3775,9 +3773,9 @@
Doing so causes your main image to use the
<filename>packagegroup-core-boot.bb</filename> recipe and
<filename>systemd</filename>.
The rescue/minimal image cannot use this group.
The rescue/minimal image cannot use this package group.
However, it can install <filename>sysvinit</filename>
and the appropriate packages with have both
and the appropriate packages will have support for both
<filename>systemd</filename> and <filename>sysvinit</filename>.
</para>
</section>