summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml85
1 files changed, 16 insertions, 69 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index d7bfdad4ab..9e269c1cdb 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -5304,64 +5304,51 @@
5304 <title>Selecting an Initialization Manager</title> 5304 <title>Selecting an Initialization Manager</title>
5305 5305
5306 <para> 5306 <para>
5307 By default, the Yocto Project uses 5307 By default, the Yocto Project uses SysVinit as the initialization
5308 <filename>SysVinit</filename> as the initialization manager. 5308 manager.
5309 However, support also exists for <filename>systemd</filename>, 5309 However, support also exists for Systemd,
5310 which is a full replacement for <filename>init</filename> with 5310 which is a full replacement for init with
5311 parallel starting of services, reduced shell overhead and other 5311 parallel starting of services, reduced shell overhead and other
5312 features that are used by many distributions. 5312 features that are used by many distributions.
5313 </para> 5313 </para>
5314 5314
5315 <para> 5315 <para>
5316 If you want to use <filename>sysvinit</filename>, you do 5316 If you want to use SysVinit, you do
5317 not have to do anything. 5317 not have to do anything.
5318 But, if you want to use <filename>systemd</filename>, you must 5318 But, if you want to use Systemd, you must
5319 take some steps as described in the following sections. 5319 take some steps as described in the following sections.
5320 </para> 5320 </para>
5321 5321
5322<!--
5323 <note>
5324 It is recommended that you create your own distribution configuration
5325 file to hold these settings instead of using your
5326 <filename>local.conf</filename> file.
5327 For information on creating your own distribution, see the
5328 "<link linkend='creating-your-own-distribution'>Creating Your Own Distribution</link>"
5329 section.
5330 </note>
5331-->
5332
5333 <section id='using-systemd-exclusively'> 5322 <section id='using-systemd-exclusively'>
5334 <title>Using systemd Exclusively</title> 5323 <title>Using Systemd Exclusively</title>
5335 5324
5336 <para> 5325 <para>
5337 Set the following variables in your distribution configuration 5326 Set the these variables in your distribution configuration
5338 file as follows: 5327 file as follows:
5339 <literallayout class='monospaced'> 5328 <literallayout class='monospaced'>
5340 DISTRO_FEATURES_append = " systemd" 5329 DISTRO_FEATURES_append = " systemd"
5341 VIRTUAL-RUNTIME_init_manager = "systemd" 5330 VIRTUAL-RUNTIME_init_manager = "systemd"
5342 </literallayout> 5331 </literallayout>
5343 You can also prevent the <filename>sysvinit</filename> 5332 You can also prevent the SysVinit
5344 distribution feature from 5333 distribution feature from
5345 being automatically enabled as follows: 5334 being automatically enabled as follows:
5346 <literallayout class='monospaced'> 5335 <literallayout class='monospaced'>
5347 DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit" 5336 DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
5348 </literallayout> 5337 </literallayout>
5349 Doing so removes any redundant <filename>sysvinit</filename> 5338 Doing so removes any redundant SysVinit scripts.
5350 scripts.
5351 </para> 5339 </para>
5352 5340
5353 <para> 5341 <para>
5354 For information on the backfill variable, see 5342 For information on the backfill variable, see
5355 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><filename>DISTRO_FEATURES_BACKFILL_CONSIDERED</filename></ulink> 5343 <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO_FEATURES_BACKFILL_CONSIDERED'><filename>DISTRO_FEATURES_BACKFILL_CONSIDERED</filename></ulink>.
5356 in the Yocto Project Reference Manual.
5357 </para> 5344 </para>
5358 </section> 5345 </section>
5359 5346
5360 <section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'> 5347 <section id='using-systemd-for-the-main-image-and-using-sysvinit-for-the-rescue-image'>
5361 <title>Using systemd for the Main Image and Using SysVinit for the Rescue Image</title> 5348 <title>Using Systemd for the Main Image and Using SysVinit for the Rescue Image</title>
5362 5349
5363 <para> 5350 <para>
5364 Set the following variables in your distribution configuration 5351 Set the these variables in your distribution configuration
5365 file as follows: 5352 file as follows:
5366 <literallayout class='monospaced'> 5353 <literallayout class='monospaced'>
5367 DISTRO_FEATURES_append = " systemd" 5354 DISTRO_FEATURES_append = " systemd"
@@ -5369,55 +5356,15 @@
5369 </literallayout> 5356 </literallayout>
5370 Doing so causes your main image to use the 5357 Doing so causes your main image to use the
5371 <filename>packagegroup-core-boot.bb</filename> recipe and 5358 <filename>packagegroup-core-boot.bb</filename> recipe and
5372 <filename>systemd</filename>. 5359 Systemd.
5373 The rescue/minimal image cannot use this package group. 5360 The rescue/minimal image cannot use this package group.
5374 However, it can install <filename>sysvinit</filename> 5361 However, it can install SysVinit
5375 and the appropriate packages will have support for both 5362 and the appropriate packages will have support for both
5376 <filename>systemd</filename> and <filename>sysvinit</filename>. 5363 Systemd and SysVinit.
5377 </para> 5364 </para>
5378 </section> 5365 </section>
5379 </section> 5366 </section>
5380 5367
5381<!--
5382 <section id='excluding-recipes-from-the-build'>
5383 <title>Excluding Recipes From the Build</title>
5384
5385 <para>
5386 You might find that there are groups of recipes or append files
5387 that you want to filter out of the build process.
5388 Usually, this is not necessary.
5389 However, on rare occasions where you might want to use a
5390 layer but exclude parts that are causing problems, such
5391 as introducing a different version of a recipe, you can
5392 use
5393 <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink>
5394 to exclude the recipe.
5395 </para>
5396
5397 <para>
5398 It is possible to filter or mask out <filename>.bb</filename> and
5399 <filename>.bbappend</filename> files.
5400 You can do this by providing an expression with the
5401 <filename>BBMASK</filename> variable.
5402 Here is one example:
5403 <literallayout class='monospaced'>
5404 BBMASK = "/meta-mymachine/recipes-maybe/"
5405 </literallayout>
5406 Here, all <filename>.bb</filename> and
5407 <filename>.bbappend</filename> files in the directory that match
5408 the expression are ignored during the build process.
5409 </para>
5410
5411 <note>
5412 The value you provide is passed to Python's regular expression
5413 compiler.
5414 The expression is compared against the full paths to the files.
5415 For complete syntax information, see Python's documentation at
5416 <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>.
5417 </note>
5418 </section>
5419-->
5420
5421 <section id="platdev-appdev-srcrev"> 5368 <section id="platdev-appdev-srcrev">
5422 <title>Using an External SCM</title> 5369 <title>Using an External SCM</title>
5423 5370