summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-03-07 15:41:51 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-03-16 14:25:01 +0000
commit809b96e9316076909345d0fa7866f5155aeee767 (patch)
tree16dff3a5e07aa005066bd11efccaea746a0752a9 /documentation
parent88e368dca48957314bca2a9a369dcde515953633 (diff)
downloadpoky-809b96e9316076909345d0fa7866f5155aeee767.tar.gz
manuals: inclusive language updates
Changes identified by OE core's scripts/contrib/convert-variable-renames.py script Original variable names are kept in old migration notes, but references to the new ones are provided. (From yocto-docs rev: 1a35380ca80509fee036018a2bbb22ba9b44d47a) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/bsp-guide/bsp.rst10
-rw-r--r--documentation/dev-manual/common-tasks.rst44
-rw-r--r--documentation/migration-guides/migration-2.2.rst4
-rw-r--r--documentation/migration-guides/migration-3.0.rst2
-rw-r--r--documentation/migration-guides/migration-3.4.rst3
-rw-r--r--documentation/overview-manual/concepts.rst8
-rw-r--r--documentation/ref-manual/classes.rst8
-rw-r--r--documentation/ref-manual/variables.rst38
-rw-r--r--documentation/sdk-manual/appendix-customizing.rst20
9 files changed, 69 insertions, 68 deletions
diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst
index ab8ed54807..8ec7f2957e 100644
--- a/documentation/bsp-guide/bsp.rst
+++ b/documentation/bsp-guide/bsp.rst
@@ -1113,7 +1113,7 @@ list describes them in order of preference:
1113#. *Use the LICENSE_FLAGS Variable to Define the Recipes that Have Commercial or 1113#. *Use the LICENSE_FLAGS Variable to Define the Recipes that Have Commercial or
1114 Other Types of Specially-Licensed Packages:* For each of those recipes, you can 1114 Other Types of Specially-Licensed Packages:* For each of those recipes, you can
1115 specify a matching license string in a ``local.conf`` variable named 1115 specify a matching license string in a ``local.conf`` variable named
1116 :term:`LICENSE_FLAGS_WHITELIST`. 1116 :term:`LICENSE_FLAGS_ACCEPTED`.
1117 Specifying the matching license string signifies that you agree to 1117 Specifying the matching license string signifies that you agree to
1118 the license. Thus, the build system can build the corresponding 1118 the license. Thus, the build system can build the corresponding
1119 recipe and include the component in the image. See the 1119 recipe and include the component in the image. See the
@@ -1122,15 +1122,15 @@ list describes them in order of preference:
1122 how to use these variables. 1122 how to use these variables.
1123 1123
1124 If you build as you normally would, without specifying any recipes in 1124 If you build as you normally would, without specifying any recipes in
1125 the :term:`LICENSE_FLAGS_WHITELIST` variable, the build stops and provides 1125 the :term:`LICENSE_FLAGS_ACCEPTED` variable, the build stops and provides
1126 you with the list of recipes that you have tried to include in the image 1126 you with the list of recipes that you have tried to include in the image
1127 that need entries in the :term:`LICENSE_FLAGS_WHITELIST` variable. Once you 1127 that need entries in the :term:`LICENSE_FLAGS_ACCEPTED` variable. Once you
1128 enter the appropriate license flags into it, restart the build to continue 1128 enter the appropriate license flags into it, restart the build to continue
1129 where it left off. During the build, the prompt will not appear again since 1129 where it left off. During the build, the prompt will not appear again since
1130 you have satisfied the requirement. 1130 you have satisfied the requirement.
1131 1131
1132 Once the appropriate license flags are on the white list in the 1132 Once the appropriate license flags are on the white list in the
1133 :term:`LICENSE_FLAGS_WHITELIST` variable, you can build the encumbered 1133 :term:`LICENSE_FLAGS_ACCEPTED` variable, you can build the encumbered
1134 image with no change at all to the normal build process. 1134 image with no change at all to the normal build process.
1135 1135
1136#. *Get a Pre-Built Version of the BSP:* You can get this type of BSP by 1136#. *Get a Pre-Built Version of the BSP:* You can get this type of BSP by
@@ -1143,7 +1143,7 @@ list describes them in order of preference:
1143 click-through license agreements presented by the website. If you 1143 click-through license agreements presented by the website. If you
1144 want to build the image yourself using the recipes contained within 1144 want to build the image yourself using the recipes contained within
1145 the BSP tarball, you will still need to create an appropriate 1145 the BSP tarball, you will still need to create an appropriate
1146 :term:`LICENSE_FLAGS_WHITELIST` to match the encumbered recipes in the 1146 :term:`LICENSE_FLAGS_ACCEPTED` to match the encumbered recipes in the
1147 BSP. 1147 BSP.
1148 1148
1149.. note:: 1149.. note::
diff --git a/documentation/dev-manual/common-tasks.rst b/documentation/dev-manual/common-tasks.rst
index 9a6416bf8e..e71c352549 100644
--- a/documentation/dev-manual/common-tasks.rst
+++ b/documentation/dev-manual/common-tasks.rst
@@ -11037,17 +11037,17 @@ name and version (after variable expansion)::
11037In order for a component restricted by a 11037In order for a component restricted by a
11038:term:`LICENSE_FLAGS` definition to be enabled and included in an image, it 11038:term:`LICENSE_FLAGS` definition to be enabled and included in an image, it
11039needs to have a matching entry in the global 11039needs to have a matching entry in the global
11040:term:`LICENSE_FLAGS_WHITELIST` 11040:term:`LICENSE_FLAGS_ACCEPTED`
11041variable, which is a variable typically defined in your ``local.conf`` 11041variable, which is a variable typically defined in your ``local.conf``
11042file. For example, to enable the 11042file. For example, to enable the
11043``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` package, you 11043``poky/meta/recipes-multimedia/gstreamer/gst-plugins-ugly`` package, you
11044could add either the string "commercial_gst-plugins-ugly" or the more 11044could add either the string "commercial_gst-plugins-ugly" or the more
11045general string "commercial" to :term:`LICENSE_FLAGS_WHITELIST`. See the 11045general string "commercial" to :term:`LICENSE_FLAGS_ACCEPTED`. See the
11046":ref:`dev-manual/common-tasks:license flag matching`" section for a full 11046":ref:`dev-manual/common-tasks:license flag matching`" section for a full
11047explanation of how :term:`LICENSE_FLAGS` matching works. Here is the 11047explanation of how :term:`LICENSE_FLAGS` matching works. Here is the
11048example:: 11048example::
11049 11049
11050 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly" 11050 LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly"
11051 11051
11052Likewise, to additionally enable the package built from the recipe 11052Likewise, to additionally enable the package built from the recipe
11053containing ``LICENSE_FLAGS = "license_${PN}_${PV}"``, and assuming that 11053containing ``LICENSE_FLAGS = "license_${PN}_${PV}"``, and assuming that
@@ -11055,7 +11055,7 @@ the actual recipe name was ``emgd_1.10.bb``, the following string would
11055enable that package as well as the original ``gst-plugins-ugly`` 11055enable that package as well as the original ``gst-plugins-ugly``
11056package:: 11056package::
11057 11057
11058 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly license_emgd_1.10" 11058 LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly license_emgd_1.10"
11059 11059
11060As a convenience, you do not need to specify the 11060As a convenience, you do not need to specify the
11061complete license string for every package. You can use 11061complete license string for every package. You can use
@@ -11068,7 +11068,7 @@ previously mentioned as well as any other packages that have licenses
11068starting with "commercial" or "license". 11068starting with "commercial" or "license".
11069:: 11069::
11070 11070
11071 LICENSE_FLAGS_WHITELIST = "commercial license" 11071 LICENSE_FLAGS_ACCEPTED = "commercial license"
11072 11072
11073License Flag Matching 11073License Flag Matching
11074~~~~~~~~~~~~~~~~~~~~~ 11074~~~~~~~~~~~~~~~~~~~~~
@@ -11076,7 +11076,7 @@ License Flag Matching
11076License flag matching allows you to control what recipes the 11076License flag matching allows you to control what recipes the
11077OpenEmbedded build system includes in the build. Fundamentally, the 11077OpenEmbedded build system includes in the build. Fundamentally, the
11078build system attempts to match :term:`LICENSE_FLAGS` strings found in 11078build system attempts to match :term:`LICENSE_FLAGS` strings found in
11079recipes against strings found in :term:`LICENSE_FLAGS_WHITELIST`. 11079recipes against strings found in :term:`LICENSE_FLAGS_ACCEPTED`.
11080A match causes the build system to include a recipe in the 11080A match causes the build system to include a recipe in the
11081build, while failure to find a match causes the build system to exclude 11081build, while failure to find a match causes the build system to exclude
11082a recipe. 11082a recipe.
@@ -11085,19 +11085,19 @@ In general, license flag matching is simple. However, understanding some
11085concepts will help you correctly and effectively use matching. 11085concepts will help you correctly and effectively use matching.
11086 11086
11087Before a flag defined by a particular recipe is tested against the 11087Before a flag defined by a particular recipe is tested against the
11088entries of :term:`LICENSE_FLAGS_WHITELIST`, the expanded 11088entries of :term:`LICENSE_FLAGS_ACCEPTED`, the expanded
11089string ``_${PN}`` is appended to the flag. This expansion makes each 11089string ``_${PN}`` is appended to the flag. This expansion makes each
11090:term:`LICENSE_FLAGS` value recipe-specific. After expansion, the 11090:term:`LICENSE_FLAGS` value recipe-specific. After expansion, the
11091string is then matched against the entries. Thus, specifying 11091string is then matched against the entries. Thus, specifying
11092``LICENSE_FLAGS = "commercial"`` in recipe "foo", for example, results 11092``LICENSE_FLAGS = "commercial"`` in recipe "foo", for example, results
11093in the string ``"commercial_foo"``. And, to create a match, that string 11093in the string ``"commercial_foo"``. And, to create a match, that string
11094must appear among the entries of :term:`LICENSE_FLAGS_WHITELIST`. 11094must appear among the entries of :term:`LICENSE_FLAGS_ACCEPTED`.
11095 11095
11096Judicious use of the :term:`LICENSE_FLAGS` strings and the contents of the 11096Judicious use of the :term:`LICENSE_FLAGS` strings and the contents of the
11097:term:`LICENSE_FLAGS_WHITELIST` variable allows you a lot of flexibility for 11097:term:`LICENSE_FLAGS_ACCEPTED` variable allows you a lot of flexibility for
11098including or excluding recipes based on licensing. For example, you can 11098including or excluding recipes based on licensing. For example, you can
11099broaden the matching capabilities by using license flags string subsets 11099broaden the matching capabilities by using license flags string subsets
11100in :term:`LICENSE_FLAGS_WHITELIST`. 11100in :term:`LICENSE_FLAGS_ACCEPTED`.
11101 11101
11102.. note:: 11102.. note::
11103 11103
@@ -11106,7 +11106,7 @@ in :term:`LICENSE_FLAGS_WHITELIST`.
11106 ``usethispart_1.3``, ``usethispart_1.4``, and so forth). 11106 ``usethispart_1.3``, ``usethispart_1.4``, and so forth).
11107 11107
11108For example, simply specifying the string "commercial" in the 11108For example, simply specifying the string "commercial" in the
11109:term:`LICENSE_FLAGS_WHITELIST` variable matches any expanded 11109:term:`LICENSE_FLAGS_ACCEPTED` variable matches any expanded
11110:term:`LICENSE_FLAGS` definition that starts with the string 11110:term:`LICENSE_FLAGS` definition that starts with the string
11111"commercial" such as "commercial_foo" and "commercial_bar", which 11111"commercial" such as "commercial_foo" and "commercial_bar", which
11112are the strings the build system automatically generates for 11112are the strings the build system automatically generates for
@@ -11124,24 +11124,24 @@ This scheme works even if the :term:`LICENSE_FLAGS` string already has
11124``_${PN}`` appended. For example, the build system turns the license 11124``_${PN}`` appended. For example, the build system turns the license
11125flag "commercial_1.2_foo" into "commercial_1.2_foo_foo" and would match 11125flag "commercial_1.2_foo" into "commercial_1.2_foo_foo" and would match
11126both the general "commercial" and the specific "commercial_1.2_foo" 11126both the general "commercial" and the specific "commercial_1.2_foo"
11127strings found in the :term:`LICENSE_FLAGS_WHITELIST` variable, as expected. 11127strings found in the :term:`LICENSE_FLAGS_ACCEPTED` variable, as expected.
11128 11128
11129Here are some other scenarios: 11129Here are some other scenarios:
11130 11130
11131- You can specify a versioned string in the recipe such as 11131- You can specify a versioned string in the recipe such as
11132 "commercial_foo_1.2" in a "foo" recipe. The build system expands this 11132 "commercial_foo_1.2" in a "foo" recipe. The build system expands this
11133 string to "commercial_foo_1.2_foo". Combine this license flag with a 11133 string to "commercial_foo_1.2_foo". Combine this license flag with a
11134 :term:`LICENSE_FLAGS_WHITELIST` variable that has the string 11134 :term:`LICENSE_FLAGS_ACCEPTED` variable that has the string
11135 "commercial" and you match the flag along with any other flag that 11135 "commercial" and you match the flag along with any other flag that
11136 starts with the string "commercial". 11136 starts with the string "commercial".
11137 11137
11138- Under the same circumstances, you can add "commercial_foo" in the 11138- Under the same circumstances, you can add "commercial_foo" in the
11139 :term:`LICENSE_FLAGS_WHITELIST` variable and the build system not only 11139 :term:`LICENSE_FLAGS_ACCEPTED` variable and the build system not only
11140 matches "commercial_foo_1.2" but also matches any license flag with 11140 matches "commercial_foo_1.2" but also matches any license flag with
11141 the string "commercial_foo", regardless of the version. 11141 the string "commercial_foo", regardless of the version.
11142 11142
11143- You can be very specific and use both the package and version parts 11143- You can be very specific and use both the package and version parts
11144 in the :term:`LICENSE_FLAGS_WHITELIST` list (e.g. 11144 in the :term:`LICENSE_FLAGS_ACCEPTED` list (e.g.
11145 "commercial_foo_1.2") to specifically match a versioned recipe. 11145 "commercial_foo_1.2") to specifically match a versioned recipe.
11146 11146
11147Other Variables Related to Commercial Licenses 11147Other Variables Related to Commercial Licenses
@@ -11163,20 +11163,20 @@ file::
11163 gst-plugins-ugly-mpegaudioparse" 11163 gst-plugins-ugly-mpegaudioparse"
11164 COMMERCIAL_VIDEO_PLUGINS = "gst-plugins-ugly-mpeg2dec \ 11164 COMMERCIAL_VIDEO_PLUGINS = "gst-plugins-ugly-mpeg2dec \
11165 gst-plugins-ugly-mpegstream gst-plugins-bad-mpegvideoparse" 11165 gst-plugins-ugly-mpegstream gst-plugins-bad-mpegvideoparse"
11166 LICENSE_FLAGS_WHITELIST = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp" 11166 LICENSE_FLAGS_ACCEPTED = "commercial_gst-plugins-ugly commercial_gst-plugins-bad commercial_qmmp"
11167 11167
11168 11168
11169Of course, you could also create a matching list for those 11169Of course, you could also create a matching list for those
11170components using the more general "commercial" in the 11170components using the more general "commercial" in the
11171:term:`LICENSE_FLAGS_WHITELIST` variable, but that would also enable all 11171:term:`LICENSE_FLAGS_ACCEPTED` variable, but that would also enable all
11172the other packages with :term:`LICENSE_FLAGS` 11172the other packages with :term:`LICENSE_FLAGS`
11173containing "commercial", which you may or may not want:: 11173containing "commercial", which you may or may not want::
11174 11174
11175 LICENSE_FLAGS_WHITELIST = "commercial" 11175 LICENSE_FLAGS_ACCEPTED = "commercial"
11176 11176
11177Specifying audio and video plugins as part of the 11177Specifying audio and video plugins as part of the
11178``COMMERCIAL_AUDIO_PLUGINS`` and ``COMMERCIAL_VIDEO_PLUGINS`` statements 11178``COMMERCIAL_AUDIO_PLUGINS`` and ``COMMERCIAL_VIDEO_PLUGINS`` statements
11179(along with the enabling :term:`LICENSE_FLAGS_WHITELIST`) includes the 11179(along with the enabling :term:`LICENSE_FLAGS_ACCEPTED`) includes the
11180plugins or components into built images, thus adding support for media 11180plugins or components into built images, thus adding support for media
11181formats or components. 11181formats or components.
11182 11182
@@ -11540,7 +11540,7 @@ The NIST database knows which versions are vulnerable and which ones
11540are not. 11540are not.
11541 11541
11542Last but not least, you can choose to ignore vulnerabilities through 11542Last but not least, you can choose to ignore vulnerabilities through
11543the :term:`CVE_CHECK_PN_WHITELIST` and :term:`CVE_CHECK_WHITELIST` 11543the :term:`CVE_CHECK_SKIP_RECIPE` and :term:`CVE_CHECK_IGNORE`
11544variables. 11544variables.
11545 11545
11546Implementation details 11546Implementation details
@@ -11559,9 +11559,9 @@ Then, the code looks up all the CVE IDs in the NIST database for all the
11559products defined in :term:`CVE_PRODUCT`. Then, for each found CVE: 11559products defined in :term:`CVE_PRODUCT`. Then, for each found CVE:
11560 11560
11561 - If the package name (:term:`PN`) is part of 11561 - If the package name (:term:`PN`) is part of
11562 :term:`CVE_CHECK_PN_WHITELIST`, it is considered as patched. 11562 :term:`CVE_CHECK_SKIP_RECIPE`, it is considered as patched.
11563 11563
11564 - If the CVE ID is part of :term:`CVE_CHECK_WHITELIST`, it is 11564 - If the CVE ID is part of :term:`CVE_CHECK_IGNORE`, it is
11565 considered as patched too. 11565 considered as patched too.
11566 11566
11567 - If the CVE ID is part of the patched CVE for the recipe, it is 11567 - If the CVE ID is part of the patched CVE for the recipe, it is
diff --git a/documentation/migration-guides/migration-2.2.rst b/documentation/migration-guides/migration-2.2.rst
index 3e35b2b8aa..10aa2d0684 100644
--- a/documentation/migration-guides/migration-2.2.rst
+++ b/documentation/migration-guides/migration-2.2.rst
@@ -26,8 +26,8 @@ Staging Directories in Sysroot Has Been Simplified
26 26
27The way directories are staged in sysroot has been simplified and 27The way directories are staged in sysroot has been simplified and
28introduces the new :term:`SYSROOT_DIRS`, 28introduces the new :term:`SYSROOT_DIRS`,
29:term:`SYSROOT_DIRS_NATIVE`, and 29:term:`SYSROOT_DIRS_NATIVE`, and ``SYSROOT_DIRS_BLACKLIST``
30:term:`SYSROOT_DIRS_BLACKLIST`. See the 30(replaced by :term:`SYSROOT_DIRS_IGNORE` in version 3.5). See the
31:oe_lists:`v2 patch series on the OE-Core Mailing List 31:oe_lists:`v2 patch series on the OE-Core Mailing List
32</pipermail/openembedded-core/2016-May/121365.html>` 32</pipermail/openembedded-core/2016-May/121365.html>`
33for additional information. 33for additional information.
diff --git a/documentation/migration-guides/migration-3.0.rst b/documentation/migration-guides/migration-3.0.rst
index 610298bda6..50d6758e71 100644
--- a/documentation/migration-guides/migration-3.0.rst
+++ b/documentation/migration-guides/migration-3.0.rst
@@ -148,7 +148,7 @@ XML feeds that ``cve-check-tool`` was using, supports CVSSv3 scoring,
148and makes other improvements. 148and makes other improvements.
149 149
150Additionally, the ``CVE_CHECK_CVE_WHITELIST`` variable has been replaced 150Additionally, the ``CVE_CHECK_CVE_WHITELIST`` variable has been replaced
151by ``CVE_CHECK_WHITELIST``. 151by ``CVE_CHECK_WHITELIST`` (replaced by :term:`CVE_CHECK_IGNORE` in version 3.5).
152 152
153.. _migration-3.0-bitbake-changes: 153.. _migration-3.0-bitbake-changes:
154 154
diff --git a/documentation/migration-guides/migration-3.4.rst b/documentation/migration-guides/migration-3.4.rst
index 60c057b07c..139b2bf9c0 100644
--- a/documentation/migration-guides/migration-3.4.rst
+++ b/documentation/migration-guides/migration-3.4.rst
@@ -255,7 +255,8 @@ Miscellaneous
255 255
256- The previously deprecated ``COMPRESS_CMD`` and 256- The previously deprecated ``COMPRESS_CMD`` and
257 ``CVE_CHECK_CVE_WHITELIST`` variables have been removed. Use 257 ``CVE_CHECK_CVE_WHITELIST`` variables have been removed. Use
258 ``CONVERSION_CMD`` and :term:`CVE_CHECK_WHITELIST` respectively 258 ``CONVERSION_CMD`` and ``CVE_CHECK_WHITELIST`` (replaced by
259 :term:`CVE_CHECK_IGNORE` in version 3.5) respectively
259 instead. 260 instead.
260 261
261- The obsolete ``oe_machinstall`` function previously provided in the 262- The obsolete ``oe_machinstall`` function previously provided in the
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index ae35687ee5..065d9586c6 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -1372,15 +1372,15 @@ associated with an extensible SDK:
1372 Specifies whether or not the toolchain is included when building the 1372 Specifies whether or not the toolchain is included when building the
1373 extensible SDK. 1373 extensible SDK.
1374 1374
1375- :term:`SDK_LOCAL_CONF_WHITELIST`: 1375- :term:`ESDK_LOCALCONF_ALLOW`:
1376 A list of variables allowed through from the build system 1376 A list of variables allowed through from the build system
1377 configuration into the extensible SDK configuration. 1377 configuration into the extensible SDK configuration.
1378 1378
1379- :term:`SDK_LOCAL_CONF_BLACKLIST`: 1379- :term:`ESDK_LOCALCONF_REMOVE`:
1380 A list of variables not allowed through from the build system 1380 A list of variables not allowed through from the build system
1381 configuration into the extensible SDK configuration. 1381 configuration into the extensible SDK configuration.
1382 1382
1383- :term:`SDK_INHERIT_BLACKLIST`: 1383- :term:`ESDK_CLASS_INHERIT_DISABLE`:
1384 A list of classes to remove from the 1384 A list of classes to remove from the
1385 :term:`INHERIT` value globally 1385 :term:`INHERIT` value globally
1386 within the extensible SDK configuration. 1386 within the extensible SDK configuration.
@@ -1722,7 +1722,7 @@ it construct the basehash. The following statement effectively results
1722in a list of global variable dependency excludes (i.e. variables never 1722in a list of global variable dependency excludes (i.e. variables never
1723included in any checksum):: 1723included in any checksum)::
1724 1724
1725 BB_HASHBASE_WHITELIST ?= "TMPDIR FILE PATH PWD BB_TASKHASH BBPATH DL_DIR \\ 1725 BB_BASEHASH_IGNORE_VARS ?= "TMPDIR FILE PATH PWD BB_TASKHASH BBPATH DL_DIR \\
1726 SSTATE_DIR THISDIR FILESEXTRAPATHS FILE_DIRNAME HOME LOGNAME SHELL TERM \\ 1726 SSTATE_DIR THISDIR FILESEXTRAPATHS FILE_DIRNAME HOME LOGNAME SHELL TERM \\
1727 USER FILESPATH STAGING_DIR_HOST STAGING_DIR_TARGET COREBASE PRSERV_HOST \\ 1727 USER FILESPATH STAGING_DIR_HOST STAGING_DIR_TARGET COREBASE PRSERV_HOST \\
1728 PRSERV_DUMPDIR PRSERV_DUMPFILE PRSERV_LOCKDOWN PARALLEL_MAKE \\ 1728 PRSERV_DUMPDIR PRSERV_DUMPFILE PRSERV_LOCKDOWN PARALLEL_MAKE \\
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index e1e61c9c9f..e26e4343a1 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -828,13 +828,13 @@ provided by the recipe ``icecc-create-env-native.bb``.
828If you do not want the Icecream distributed compile support to apply to 828If you do not want the Icecream distributed compile support to apply to
829specific recipes or classes, you can ask them to be ignored by Icecream 829specific recipes or classes, you can ask them to be ignored by Icecream
830by listing the recipes and classes using the 830by listing the recipes and classes using the
831:term:`ICECC_USER_PACKAGE_BL` and 831:term:`ICECC_RECIPE_DISABLE` and
832:term:`ICECC_USER_CLASS_BL` variables, 832:term:`ICECC_CLASS_DISABLE` variables,
833respectively, in your ``local.conf`` file. Doing so causes the 833respectively, in your ``local.conf`` file. Doing so causes the
834OpenEmbedded build system to handle these compilations locally. 834OpenEmbedded build system to handle these compilations locally.
835 835
836Additionally, you can list recipes using the 836Additionally, you can list recipes using the
837:term:`ICECC_USER_PACKAGE_WL` variable in 837:term:`ICECC_RECIPE_ENABLE` variable in
838your ``local.conf`` file to force ``icecc`` to be enabled for recipes 838your ``local.conf`` file to force ``icecc`` to be enabled for recipes
839using an empty :term:`PARALLEL_MAKE` variable. 839using an empty :term:`PARALLEL_MAKE` variable.
840 840
@@ -2497,7 +2497,7 @@ stages:
2497 subset of files is controlled by the 2497 subset of files is controlled by the
2498 :term:`SYSROOT_DIRS`, 2498 :term:`SYSROOT_DIRS`,
2499 :term:`SYSROOT_DIRS_NATIVE`, and 2499 :term:`SYSROOT_DIRS_NATIVE`, and
2500 :term:`SYSROOT_DIRS_BLACKLIST` 2500 :term:`SYSROOT_DIRS_IGNORE`
2501 variables. 2501 variables.
2502 2502
2503 .. note:: 2503 .. note::
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index ee77ee27af..81a6a0b240 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -1472,16 +1472,16 @@ system and gives an overview of their function and contents.
1472 variable only in certain contexts (e.g. when building for kernel 1472 variable only in certain contexts (e.g. when building for kernel
1473 and kernel module recipes). 1473 and kernel module recipes).
1474 1474
1475 :term:`CVE_CHECK_PN_WHITELIST` 1475 :term:`CVE_CHECK_SKIP_RECIPE`
1476 The list of package names (:term:`PN`) for which 1476 The list of package names (:term:`PN`) for which
1477 CVEs (Common Vulnerabilities and Exposures) are ignored. 1477 CVEs (Common Vulnerabilities and Exposures) are ignored.
1478 1478
1479 :term:`CVE_CHECK_WHITELIST` 1479 :term:`CVE_CHECK_IGNORE`
1480 The list of CVE IDs which are ignored. Here is 1480 The list of CVE IDs which are ignored. Here is
1481 an example from the :oe_layerindex:`Python3 recipe</layerindex/recipe/23823>`:: 1481 an example from the :oe_layerindex:`Python3 recipe</layerindex/recipe/23823>`::
1482 1482
1483 # This is windows only issue. 1483 # This is windows only issue.
1484 CVE_CHECK_WHITELIST += "CVE-2020-15523" 1484 CVE_CHECK_IGNORE += "CVE-2020-15523"
1485 1485
1486 :term:`CVE_PRODUCT` 1486 :term:`CVE_PRODUCT`
1487 In a recipe, defines the name used to match the recipe name 1487 In a recipe, defines the name used to match the recipe name
@@ -2879,7 +2879,7 @@ system and gives an overview of their function and contents.
2879 this variable, the :ref:`icecc <ref-classes-icecc>` class attempts 2879 this variable, the :ref:`icecc <ref-classes-icecc>` class attempts
2880 to define it by locating ``icecc`` using ``which``. 2880 to define it by locating ``icecc`` using ``which``.
2881 2881
2882 :term:`ICECC_USER_CLASS_BL` 2882 :term:`ICECC_CLASS_DISABLE`
2883 Identifies user classes that you do not want the Icecream distributed 2883 Identifies user classes that you do not want the Icecream distributed
2884 compile support to consider. This variable is used by the 2884 compile support to consider. This variable is used by the
2885 :ref:`icecc <ref-classes-icecc>` class. You set this variable in 2885 :ref:`icecc <ref-classes-icecc>` class. You set this variable in
@@ -2889,7 +2889,7 @@ system and gives an overview of their function and contents.
2889 those classes will not benefit from distributed compilation across 2889 those classes will not benefit from distributed compilation across
2890 remote hosts. Instead they will be built locally. 2890 remote hosts. Instead they will be built locally.
2891 2891
2892 :term:`ICECC_USER_PACKAGE_BL` 2892 :term:`ICECC_RECIPE_DISABLE`
2893 Identifies user recipes that you do not want the Icecream distributed 2893 Identifies user recipes that you do not want the Icecream distributed
2894 compile support to consider. This variable is used by the 2894 compile support to consider. This variable is used by the
2895 :ref:`icecc <ref-classes-icecc>` class. You set this variable in 2895 :ref:`icecc <ref-classes-icecc>` class. You set this variable in
@@ -2899,7 +2899,7 @@ system and gives an overview of their function and contents.
2899 from distributed compilation across remote hosts. Instead they will 2899 from distributed compilation across remote hosts. Instead they will
2900 be built locally. 2900 be built locally.
2901 2901
2902 :term:`ICECC_USER_PACKAGE_WL` 2902 :term:`ICECC_RECIPE_ENABLE`
2903 Identifies user recipes that use an empty 2903 Identifies user recipes that use an empty
2904 :term:`PARALLEL_MAKE` variable that you want to 2904 :term:`PARALLEL_MAKE` variable that you want to
2905 force remote distributed compilation on using the Icecream 2905 force remote distributed compilation on using the Icecream
@@ -4375,7 +4375,7 @@ system and gives an overview of their function and contents.
4375 4375
4376 :term:`LICENSE_FLAGS` 4376 :term:`LICENSE_FLAGS`
4377 Specifies additional flags for a recipe you must allow through 4377 Specifies additional flags for a recipe you must allow through
4378 :term:`LICENSE_FLAGS_WHITELIST` in 4378 :term:`LICENSE_FLAGS_ACCEPTED` in
4379 order for the recipe to be built. When providing multiple flags, 4379 order for the recipe to be built. When providing multiple flags,
4380 separate them with spaces. 4380 separate them with spaces.
4381 4381
@@ -4386,7 +4386,7 @@ system and gives an overview of their function and contents.
4386 ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`" 4386 ":ref:`dev-manual/common-tasks:enabling commercially licensed recipes`"
4387 section in the Yocto Project Development Tasks Manual. 4387 section in the Yocto Project Development Tasks Manual.
4388 4388
4389 :term:`LICENSE_FLAGS_WHITELIST` 4389 :term:`LICENSE_FLAGS_ACCEPTED`
4390 Lists license flags that when specified in 4390 Lists license flags that when specified in
4391 :term:`LICENSE_FLAGS` within a recipe should not 4391 :term:`LICENSE_FLAGS` within a recipe should not
4392 prevent that recipe from being built. For more information, see the 4392 prevent that recipe from being built. For more information, see the
@@ -6548,13 +6548,13 @@ system and gives an overview of their function and contents.
6548 :term:`SDK_EXT_TYPE` is set to "minimal", and defaults to "1" if 6548 :term:`SDK_EXT_TYPE` is set to "minimal", and defaults to "1" if
6549 :term:`SDK_EXT_TYPE` is set to "full". 6549 :term:`SDK_EXT_TYPE` is set to "full".
6550 6550
6551 :term:`SDK_INHERIT_BLACKLIST` 6551 :term:`ESDK_CLASS_INHERIT_DISABLE`
6552 A list of classes to remove from the :term:`INHERIT` 6552 A list of classes to remove from the :term:`INHERIT`
6553 value globally within the extensible SDK configuration. The 6553 value globally within the extensible SDK configuration. The
6554 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the 6554 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class sets the
6555 default value:: 6555 default value::
6556 6556
6557 SDK_INHERIT_BLACKLIST ?= "buildhistory icecc" 6557 ESDK_CLASS_INHERIT_DISABLE ?= "buildhistory icecc"
6558 6558
6559 Some classes are not generally applicable within the extensible SDK 6559 Some classes are not generally applicable within the extensible SDK
6560 context. You can use this variable to disable those classes. 6560 context. You can use this variable to disable those classes.
@@ -6565,14 +6565,14 @@ system and gives an overview of their function and contents.
6565 section in the Yocto Project Application Development and the 6565 section in the Yocto Project Application Development and the
6566 Extensible Software Development Kit (eSDK) manual. 6566 Extensible Software Development Kit (eSDK) manual.
6567 6567
6568 :term:`SDK_LOCAL_CONF_BLACKLIST` 6568 :term:`ESDK_LOCALCONF_REMOVE`
6569 A list of variables not allowed through from the OpenEmbedded build 6569 A list of variables not allowed through from the OpenEmbedded build
6570 system configuration into the extensible SDK configuration. Usually, 6570 system configuration into the extensible SDK configuration. Usually,
6571 these are variables that are specific to the machine on which the 6571 these are variables that are specific to the machine on which the
6572 build system is running and thus would be potentially problematic 6572 build system is running and thus would be potentially problematic
6573 within the extensible SDK. 6573 within the extensible SDK.
6574 6574
6575 By default, :term:`SDK_LOCAL_CONF_BLACKLIST` is set in the 6575 By default, :term:`ESDK_LOCALCONF_REMOVE` is set in the
6576 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class and 6576 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class and
6577 excludes the following variables: 6577 excludes the following variables:
6578 6578
@@ -6591,14 +6591,14 @@ system and gives an overview of their function and contents.
6591 section in the Yocto Project Application Development and the 6591 section in the Yocto Project Application Development and the
6592 Extensible Software Development Kit (eSDK) manual. 6592 Extensible Software Development Kit (eSDK) manual.
6593 6593
6594 :term:`SDK_LOCAL_CONF_WHITELIST` 6594 :term:`ESDK_LOCALCONF_ALLOW`
6595 A list of variables allowed through from the OpenEmbedded build 6595 A list of variables allowed through from the OpenEmbedded build
6596 system configuration into the extensible SDK configuration. By 6596 system configuration into the extensible SDK configuration. By
6597 default, the list of variables is empty and is set in the 6597 default, the list of variables is empty and is set in the
6598 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class. 6598 :ref:`populate-sdk-ext <ref-classes-populate-sdk-*>` class.
6599 6599
6600 This list overrides the variables specified using the 6600 This list overrides the variables specified using the
6601 :term:`SDK_LOCAL_CONF_BLACKLIST` variable as well as 6601 :term:`ESDK_LOCALCONF_REMOVE` variable as well as
6602 other variables automatically added due to the "/" character 6602 other variables automatically added due to the "/" character
6603 being found at the start of the 6603 being found at the start of the
6604 value, which is usually indicative of being a path and thus might not 6604 value, which is usually indicative of being a path and thus might not
@@ -7506,14 +7506,14 @@ system and gives an overview of their function and contents.
7506 /sysroot-only \ 7506 /sysroot-only \
7507 " 7507 "
7508 7508
7509 :term:`SYSROOT_DIRS_BLACKLIST` 7509 :term:`SYSROOT_DIRS_IGNORE`
7510 Directories that are not staged into the sysroot by the 7510 Directories that are not staged into the sysroot by the
7511 :ref:`ref-tasks-populate_sysroot` task. You 7511 :ref:`ref-tasks-populate_sysroot` task. You
7512 can use this variable to exclude certain subdirectories of 7512 can use this variable to exclude certain subdirectories of
7513 directories listed in :term:`SYSROOT_DIRS` from 7513 directories listed in :term:`SYSROOT_DIRS` from
7514 staging. By default, the following directories are not staged:: 7514 staging. By default, the following directories are not staged::
7515 7515
7516 SYSROOT_DIRS_BLACKLIST = " \ 7516 SYSROOT_DIRS_IGNORE = " \
7517 ${mandir} \ 7517 ${mandir} \
7518 ${docdir} \ 7518 ${docdir} \
7519 ${infodir} \ 7519 ${infodir} \
@@ -8426,7 +8426,7 @@ system and gives an overview of their function and contents.
8426 passes and uses "all" for the target during the U-Boot building 8426 passes and uses "all" for the target during the U-Boot building
8427 process. 8427 process.
8428 8428
8429 :term:`UNKNOWN_CONFIGURE_WHITELIST` 8429 :term:`UNKNOWN_CONFIGURE_OPT_IGNORE`
8430 Specifies a list of options that, if reported by the configure script 8430 Specifies a list of options that, if reported by the configure script
8431 as being invalid, should not generate a warning during the 8431 as being invalid, should not generate a warning during the
8432 :ref:`ref-tasks-configure` task. Normally, invalid 8432 :ref:`ref-tasks-configure` task. Normally, invalid
@@ -8436,10 +8436,10 @@ system and gives an overview of their function and contents.
8436 However, there are common options that are passed to all 8436 However, there are common options that are passed to all
8437 configure scripts at a class level, but might not be valid for some 8437 configure scripts at a class level, but might not be valid for some
8438 configure scripts. Therefore warnings about these options are useless. 8438 configure scripts. Therefore warnings about these options are useless.
8439 For these cases, the options are added to :term:`UNKNOWN_CONFIGURE_WHITELIST`. 8439 For these cases, the options are added to :term:`UNKNOWN_CONFIGURE_OPT_IGNORE`.
8440 8440
8441 The configure arguments check that uses 8441 The configure arguments check that uses
8442 :term:`UNKNOWN_CONFIGURE_WHITELIST` is part of the 8442 :term:`UNKNOWN_CONFIGURE_OPT_IGNORE` is part of the
8443 :ref:`insane <ref-classes-insane>` class and is only enabled if the 8443 :ref:`insane <ref-classes-insane>` class and is only enabled if the
8444 recipe inherits the :ref:`autotools <ref-classes-autotools>` class. 8444 recipe inherits the :ref:`autotools <ref-classes-autotools>` class.
8445 8445
diff --git a/documentation/sdk-manual/appendix-customizing.rst b/documentation/sdk-manual/appendix-customizing.rst
index f8e56477f3..9a76cc59d6 100644
--- a/documentation/sdk-manual/appendix-customizing.rst
+++ b/documentation/sdk-manual/appendix-customizing.rst
@@ -21,7 +21,7 @@ build system applies them against ``local.conf`` and ``auto.conf``:
21 specific to the :term:`Build Host`. 21 specific to the :term:`Build Host`.
22 22
23- Variables listed in 23- Variables listed in
24 :term:`SDK_LOCAL_CONF_BLACKLIST` 24 :term:`ESDK_LOCALCONF_REMOVE`
25 are excluded. These variables are not allowed through from the 25 are excluded. These variables are not allowed through from the
26 OpenEmbedded build system configuration into the extensible SDK 26 OpenEmbedded build system configuration into the extensible SDK
27 configuration. Typically, these variables are specific to the machine 27 configuration. Typically, these variables are specific to the machine
@@ -29,19 +29,19 @@ build system applies them against ``local.conf`` and ``auto.conf``:
29 of the extensible SDK configuration. 29 of the extensible SDK configuration.
30 30
31 For a list of the variables excluded by default, see the 31 For a list of the variables excluded by default, see the
32 :term:`SDK_LOCAL_CONF_BLACKLIST` 32 :term:`ESDK_LOCALCONF_REMOVE`
33 in the glossary of the Yocto Project Reference Manual. 33 in the glossary of the Yocto Project Reference Manual.
34 34
35- Variables listed in 35- Variables listed in
36 :term:`SDK_LOCAL_CONF_WHITELIST` 36 :term:`ESDK_LOCALCONF_ALLOW`
37 are included. Including a variable in the value of 37 are included. Including a variable in the value of
38 :term:`SDK_LOCAL_CONF_WHITELIST` overrides either of the previous two 38 :term:`ESDK_LOCALCONF_ALLOW` overrides either of the previous two
39 filters. The default value is blank. 39 filters. The default value is blank.
40 40
41- Classes inherited globally with 41- Classes inherited globally with
42 :term:`INHERIT` that are listed in 42 :term:`INHERIT` that are listed in
43 :term:`SDK_INHERIT_BLACKLIST` 43 :term:`ESDK_CLASS_INHERIT_DISABLE`
44 are disabled. Using :term:`SDK_INHERIT_BLACKLIST` to disable these 44 are disabled. Using :term:`ESDK_CLASS_INHERIT_DISABLE` to disable these
45 classes is the typical method to disable classes that are problematic 45 classes is the typical method to disable classes that are problematic
46 or unnecessary in the SDK context. The default value disables the 46 or unnecessary in the SDK context. The default value disables the
47 :ref:`buildhistory <ref-classes-buildhistory>` 47 :ref:`buildhistory <ref-classes-buildhistory>`
@@ -63,13 +63,13 @@ adjustments:
63- If your SDK configuration inherits additional classes using the 63- If your SDK configuration inherits additional classes using the
64 :term:`INHERIT` variable and you 64 :term:`INHERIT` variable and you
65 do not need or want those classes enabled in the SDK, you can 65 do not need or want those classes enabled in the SDK, you can
66 disable them by adding them to the :term:`SDK_INHERIT_BLACKLIST` 66 disable them by adding them to the :term:`ESDK_CLASS_INHERIT_DISABLE`
67 variable as described in the previous section. 67 variable as described in the previous section.
68 68
69 .. note:: 69 .. note::
70 70
71 The default value of 71 The default value of
72 SDK_INHERIT_BLACKLIST 72 ESDK_CLASS_INHERIT_DISABLE
73 is set using the "?=" operator. Consequently, you will need to 73 is set using the "?=" operator. Consequently, you will need to
74 either define the entire list by using the "=" operator, or you 74 either define the entire list by using the "=" operator, or you
75 will need to append a value using either ":append" or the "+=" 75 will need to append a value using either ":append" or the "+="
@@ -92,7 +92,7 @@ adjustments:
92 92
93 - Disable the tasks if they are added by a class and you do not need 93 - Disable the tasks if they are added by a class and you do not need
94 the functionality the class provides in the extensible SDK. To 94 the functionality the class provides in the extensible SDK. To
95 disable the tasks, add the class to the :term:`SDK_INHERIT_BLACKLIST` 95 disable the tasks, add the class to the :term:`ESDK_CLASS_INHERIT_DISABLE`
96 variable as described in the previous section. 96 variable as described in the previous section.
97 97
98- Generally, you want to have a shared state mirror set up so users of 98- Generally, you want to have a shared state mirror set up so users of
@@ -277,7 +277,7 @@ source, you need to do a number of things:
277 configuration file. You can then pass the variable to the SDK by 277 configuration file. You can then pass the variable to the SDK by
278 adding the following:: 278 adding the following::
279 279
280 SDK_LOCAL_CONF_WHITELIST = "SSTATE_MIRRORS" 280 ESDK_LOCALCONF_ALLOW = "SSTATE_MIRRORS"
281 281
282 - Alternatively, if you just want to set the :term:`SSTATE_MIRRORS` 282 - Alternatively, if you just want to set the :term:`SSTATE_MIRRORS`
283 variable's value for the SDK alone, create a 283 variable's value for the SDK alone, create a