diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-03-19 06:44:38 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-03-25 12:29:43 +0000 |
commit | d8b69fb4de28d917839abfbad6287b45febf4fdd (patch) | |
tree | 3f592e9d9310de1a8be9306ac5dd0bc1e8d5120c /documentation | |
parent | 80e7223d8963ac27cedb3dcf4f61ef215957e536 (diff) | |
download | poky-d8b69fb4de28d917839abfbad6287b45febf4fdd.tar.gz |
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>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 85 |
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 | ||