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 A common example usage of include files would be to
separate out the selection of desired version and revisions separate out the selection of desired version and revisions
for individual recipes. 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> <tip>
If you want to base your distribution configuration file If you want to base your distribution configuration file
on the very basic configuration from OE-Core, you on the very basic configuration from OE-Core, you
can "require" can use
<filename>conf/distro/defaultsetup.conf</filename>. <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 Alternatively, you can create a distribution
configuration file from scratch using the configuration file from scratch using the
<filename>defaultsetup.conf</filename> file <filename>defaultsetup.conf</filename> file
or configuration files from other distributions or configuration files from other distributions
such as Poky or Angstrom as references. such as Poky or Angstrom as references.
</tip></para> </tip></para></listitem>
<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>
<listitem><para><emphasis>Provide Miscellaneous Variables:</emphasis> <listitem><para><emphasis>Provide Miscellaneous Variables:</emphasis>
Be sure to define any other variable for which you want to Be sure to define any other variable for which you want to
create a default or enforce as part of the distribution create a default or enforce as part of the distribution
@ -3724,36 +3731,27 @@
</para> </para>
<note> <note>
<para><emphasis>NOTES TO SELF:</emphasis> It is recommended that you create your own distribution configuration
<filename>systemd</filename> is a full replacement of for init with file to hold these settings instead of using your
parallel starting of services, reduced shell overhead and other <filename>local.conf</filename> file.
features, used by many distributions.</para> For information on creating your own distribution, see the
<para>I think you set the <filename>VIRTUAL-RUNTIME</filename> "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
in a recipe. section.
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>
</note> </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 Set the following variables in your distribution configuration
<filename>local.conf</filename> 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 save some disk space by adding You can also prevent the <filename>sysvinit</filename>
<filename>sysvinit</filename> to the distribution features distribution feature from
considered for backfill 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>
@ -3762,12 +3760,12 @@
</para> </para>
</section> </section>
<section id='use-systemd-for-the-main-image-and-use-sysvinit-for-the-rescue-image'> <section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'>
<title>Use systemd for the Main Image and Use 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 Set the following variables in your distribution configuration
<filename>local.conf</filename> 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"
@ -3775,9 +3773,9 @@
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>. <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> 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>. <filename>systemd</filename> and <filename>sysvinit</filename>.
</para> </para>
</section> </section>