poky/documentation/dev-manual
Antonin Godard 7651767849 dev-manual: document how to provide confs from layer.conf
Add a section on providing global level configuration from the
layer.conf file. Since this file is parsed at an earlier stage in the
parsing process, it's not possible to combine bb.utils.contains and
{DISTRO,MACHINE}_FEATURES to conditionally set some configurations.

This patch documents:

- First that this file can be used for providing such configuration.
- Then demonstrate how to conditionally provide them, using a technique
  that is currently used in meta-virtualization
  (https://git.yoctoproject.org/meta-virtualization/tree/conf/layer.conf#n50).

Fixes [YOCTO #12688].

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: e49111c280927c922ab40547c02c11772787b731)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit 31e5bd3e82e11f77da2abd96eb8c17a7c8194b7c)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
2024-11-15 06:05:33 -08:00
..
figures dev-manual: Added new section for creating NPM packages 2019-06-18 11:29:23 +01:00
bmaptool.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
build-quality.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
building.rst dev-manual: improve descriptions of 'bitbake -S printdiff' 2024-04-05 07:24:00 -07:00
custom-distribution.rst dev-manual: update custom distribution section 2024-05-15 09:44:16 -07:00
custom-template-configuration-directory.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
customizing-images.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
debugging.rst dev-manual: improve descriptions of 'bitbake -S printdiff' 2024-04-05 07:24:00 -07:00
development-shell.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
device-manager.rst manuals: document VIRTUAL-RUNTIME variables 2024-03-25 04:11:26 -10:00
disk-space.rst dev-manual: disk-space: improve wording for obsolete sstate cache files 2023-09-23 05:26:16 -10:00
efficiently-fetching-sources.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
error-reporting-tool.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
external-scm.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
external-toolchain.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
gobject-introspection.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
index.rst dev-manual: add security team processes 2023-11-03 04:26:13 -10:00
init-manager.rst manuals: fix trailing spaces 2024-04-19 04:50:39 -07:00
intro.rst dev-manual: various pedantic nitpickery 2021-09-04 08:46:35 +01:00
layers.rst dev-manual: document how to provide confs from layer.conf 2024-11-15 06:05:33 -08:00
libraries.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
licenses.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
new-machine.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
new-recipe.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
packages.rst dev-manual: packages: fix capitalization 2024-03-25 04:11:26 -10:00
prebuilt-libraries.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
python-development-shell.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
qemu.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
quilt.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
read-only-rootfs.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
runtime-testing.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
sbom.rst dev-manual: Rephrase spdx creation 2024-03-01 05:19:54 -10:00
securing-images.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
security-subjects.rst dev-manual: add security team processes 2023-11-03 04:26:13 -10:00
speeding-up-build.rst manuals: suppress excess use of "following" word 2024-03-01 05:19:54 -10:00
start.rst manuals: fix trailing spaces 2024-04-19 04:50:39 -07:00
temporary-source-code.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
upgrading-recipes.rst manuals: update class references 2023-11-28 05:00:32 -10:00
vulnerabilities.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
wayland.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00
wic.rst manuals: remove tab characters 2024-04-19 04:50:40 -07:00
x32-psabi.rst dev-manual: split common-tasks.rst 2023-09-23 05:26:16 -10:00