summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/dev-manual-common-tasks.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-04-16 08:53:07 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-04-17 22:34:16 +0100
commitbf64daa2ab88f40bcc9aace2098cd49cbce850d1 (patch)
treea8225629eb98476891f559a0225bd1baa9acd8c5 /documentation/dev-manual/dev-manual-common-tasks.xml
parent1fbc3e9c811295ef16cb07a7c609e60f4afe726a (diff)
downloadpoky-bf64daa2ab88f40bcc9aace2098cd49cbce850d1.tar.gz
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>
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml76
1 files changed, 37 insertions, 39 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 4e37b1bea1..7f2bbc336e 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2384,27 +2384,34 @@
2384 A common example usage of include files would be to 2384 A common example usage of include files would be to
2385 separate out the selection of desired version and revisions 2385 separate out the selection of desired version and revisions
2386 for individual recipes. 2386 for individual recipes.
2387</para>
2388 <para>Your configuration file needs to set the following
2389 required variables:
2390 <literallayout class='monospaced'>
2391 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_NAME'><filename>DISTRO_NAME</filename></ulink> [required]
2392 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_VERSION'><filename>DISTRO_VERSION</filename></ulink> [required]
2393 </literallayout>
2394 These following variables are optional and you typically
2395 set them from the distribution configuration file:
2396 <literallayout class='monospaced'>
2397 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></ulink> [optional]
2398 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RDEPENDS'><filename>DISTRO_EXTRA_RDEPENDS</filename></ulink> [optional]
2399 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RRECOMMENDS'><filename>DISTRO_EXTRA_RRECOMMENDS</filename></ulink> [optional]
2400 <ulink url='&YOCTO_DOCS_REF_URL;#var-TCLIBC'><filename>TCLIBC</filename></ulink> [optional]
2401 </literallayout>
2387 <tip> 2402 <tip>
2388 If you want to base your distribution configuration file 2403 If you want to base your distribution configuration file
2389 on the very basic configuration from OE-Core, you 2404 on the very basic configuration from OE-Core, you
2390 can "require" 2405 can use
2391 <filename>conf/distro/defaultsetup.conf</filename>. 2406 <filename>conf/distro/defaultsetup.conf</filename> as
2407 a reference and just include variables that differ
2408 as compared to <filename>defaultsetup.conf</filename>.
2392 Alternatively, you can create a distribution 2409 Alternatively, you can create a distribution
2393 configuration file from scratch using the 2410 configuration file from scratch using the
2394 <filename>defaultsetup.conf</filename> file 2411 <filename>defaultsetup.conf</filename> file
2395 or configuration files from other distributions 2412 or configuration files from other distributions
2396 such as Poky or Angstrom as references. 2413 such as Poky or Angstrom as references.
2397 </tip></para> 2414 </tip></para></listitem>
2398 <para>Your configuration file needs to set the following
2399 variables:
2400 <literallayout class='monospaced'>
2401 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_NAME'><filename>DISTRO_NAME</filename></ulink> [required]
2402 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_VERSION'><filename>DISTRO_VERSION</filename></ulink> [required]
2403 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES'><filename>DISTRO_FEATURES</filename></ulink> [required if creating from scratch]
2404 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RDEPENDS'><filename>DISTRO_EXTRA_RDEPENDS</filename></ulink> [optional]
2405 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_EXTRA_RRECOMMENDS'><filename>DISTRO_EXTRA_RRECOMMENDS</filename></ulink> [optional]
2406 <ulink url='&YOCTO_DOCS_REF_URL;#var-TCLIBC'><filename>TCLIBC</filename></ulink> [required if creating from scratch]
2407 </literallayout></para></listitem>
2408 <listitem><para><emphasis>Provide Miscellaneous Variables:</emphasis> 2415 <listitem><para><emphasis>Provide Miscellaneous Variables:</emphasis>
2409 Be sure to define any other variable for which you want to 2416 Be sure to define any other variable for which you want to
2410 create a default or enforce as part of the distribution 2417 create a default or enforce as part of the distribution
@@ -3724,36 +3731,27 @@
3724 </para> 3731 </para>
3725 3732
3726 <note> 3733 <note>
3727 <para><emphasis>NOTES TO SELF:</emphasis> 3734 It is recommended that you create your own distribution configuration
3728 <filename>systemd</filename> is a full replacement of for init with 3735 file to hold these settings instead of using your
3729 parallel starting of services, reduced shell overhead and other 3736 <filename>local.conf</filename> file.
3730 features, used by many distributions.</para> 3737 For information on creating your own distribution, see the
3731 <para>I think you set the <filename>VIRTUAL-RUNTIME</filename> 3738 "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
3732 in a recipe. 3739 section.
3733 I found a recipe called
3734 <filename>packagegroup-core-boot.bb</filename>, which is an
3735 <filename>OE-Core</filename> recipe, that has a bunch of them.
3736 The comment refers to the group as "VIRTUAL-RUNTIME providers".
3737 The list includes <filename>VIRTUAL-RUNTIME_dev_manager</filename>,
3738 <filename>VIRTUAL-RUNTIME_init_manager</filename>,
3739 <filename>VIRTUAL-RUNTIME_login_manager</filename>,
3740 <filename>VIRTUAL-RUNTIME_initscripts</filename>, and
3741 <filename>VIRTUAL-RUNTIME_keymaps</filename>.</para>
3742 </note> 3740 </note>
3743 3741
3744 <section id='using-systemd-exclusively'> 3742 <section id='using-systemd-exclusively'>
3745 <title>Using systemd Exclusively</title> 3743 <title>Using systemd Exclusively</title>
3746 3744
3747 <para> 3745 <para>
3748 Set the following variables in your 3746 Set the following variables in your distribution configuration
3749 <filename>local.conf</filename> file as follows: 3747 file as follows:
3750 <literallayout class='monospaced'> 3748 <literallayout class='monospaced'>
3751 DISTRO_FEATURES_append = " systemd" 3749 DISTRO_FEATURES_append = " systemd"
3752 VIRTUAL-RUNTIME_init_manager = "systemd" 3750 VIRTUAL-RUNTIME_init_manager = "systemd"
3753 </literallayout> 3751 </literallayout>
3754 You can save some disk space by adding 3752 You can also prevent the <filename>sysvinit</filename>
3755 <filename>sysvinit</filename> to the distribution features 3753 distribution feature from
3756 considered for backfill as follows: 3754 being automatically enabled as follows:
3757 <literallayout class='monospaced'> 3755 <literallayout class='monospaced'>
3758 DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit" 3756 DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
3759 </literallayout> 3757 </literallayout>
@@ -3762,12 +3760,12 @@
3762 </para> 3760 </para>
3763 </section> 3761 </section>
3764 3762
3765 <section id='use-systemd-for-the-main-image-and-use-sysvinit-for-the-rescue-image'> 3763 <section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'>
3766 <title>Use systemd for the Main Image and Use SysVinit for the Rescue Image</title> 3764 <title>Using systemd for the Main Image and Using SysVinit for the Rescue Image</title>
3767 3765
3768 <para> 3766 <para>
3769 Set the following variables in your 3767 Set the following variables in your distribution configuration
3770 <filename>local.conf</filename> file as follows: 3768 file as follows:
3771 <literallayout class='monospaced'> 3769 <literallayout class='monospaced'>
3772 DISTRO_FEATURES_append = " systemd" 3770 DISTRO_FEATURES_append = " systemd"
3773 VIRTUAL-RUNTIME_init_manager = "systemd" 3771 VIRTUAL-RUNTIME_init_manager = "systemd"
@@ -3775,9 +3773,9 @@
3775 Doing so causes your main image to use the 3773 Doing so causes your main image to use the
3776 <filename>packagegroup-core-boot.bb</filename> recipe and 3774 <filename>packagegroup-core-boot.bb</filename> recipe and
3777 <filename>systemd</filename>. 3775 <filename>systemd</filename>.
3778 The rescue/minimal image cannot use this group. 3776 The rescue/minimal image cannot use this package group.
3779 However, it can install <filename>sysvinit</filename> 3777 However, it can install <filename>sysvinit</filename>
3780 and the appropriate packages with have both 3778 and the appropriate packages will have support for both
3781 <filename>systemd</filename> and <filename>sysvinit</filename>. 3779 <filename>systemd</filename> and <filename>sysvinit</filename>.
3782 </para> 3780 </para>
3783 </section> 3781 </section>