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