summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-09-23 19:41:05 +0200
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-10-07 10:54:26 +0100
commit3784c57c042a5b44dc507df1abf660014252aa9c (patch)
treef4a0d866fcf5678163ea7d340bfc77ba626fcfaf /documentation
parentc4e05c52237edc7314dba2de84abd1413b6751c7 (diff)
downloadpoky-3784c57c042a5b44dc507df1abf660014252aa9c.tar.gz
manuals: add reference to the "do_kernel_configcheck" task
(From yocto-docs rev: 8356996e66c4a45f9f15b30950c6c61a0d50c2c9) 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/kernel-dev/common.rst10
-rw-r--r--documentation/ref-manual/tasks.rst2
2 files changed, 6 insertions, 6 deletions
diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst
index fb8d7cd029..f370350264 100644
--- a/documentation/kernel-dev/common.rst
+++ b/documentation/kernel-dev/common.rst
@@ -1316,7 +1316,7 @@ In order to run this task, you must have an existing ``.config`` file.
1316See the ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" section for 1316See the ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" section for
1317information on how to create a configuration file. 1317information on how to create a configuration file.
1318 1318
1319Following is sample output from the ``do_kernel_configcheck`` task: 1319Following is sample output from the :ref:`ref-tasks-kernel_configcheck` task:
1320 1320
1321.. code-block:: none 1321.. code-block:: none
1322 1322
@@ -1396,7 +1396,7 @@ possible by reading the output of the kernel configuration fragment
1396audit, noting any issues, making changes to correct the issues, and then 1396audit, noting any issues, making changes to correct the issues, and then
1397repeating. 1397repeating.
1398 1398
1399As part of the kernel build process, the ``do_kernel_configcheck`` task 1399As part of the kernel build process, the :ref:`ref-tasks-kernel_configcheck` task
1400runs. This task validates the kernel configuration by checking the final 1400runs. This task validates the kernel configuration by checking the final
1401``.config`` file against the input files. During the check, the task 1401``.config`` file against the input files. During the check, the task
1402produces warning messages for the following issues: 1402produces warning messages for the following issues:
@@ -1430,13 +1430,13 @@ To streamline the configuration, do the following:
1430 successfully. Use this configuration file as your baseline. 1430 successfully. Use this configuration file as your baseline.
1431 1431
14322. *Run Configure and Check Tasks:* Separately run the 14322. *Run Configure and Check Tasks:* Separately run the
1433 ``do_kernel_configme`` and ``do_kernel_configcheck`` tasks:: 1433 ``do_kernel_configme`` and :ref:`ref-tasks-kernel_configcheck` tasks::
1434 1434
1435 $ bitbake linux-yocto -c kernel_configme -f 1435 $ bitbake linux-yocto -c kernel_configme -f
1436 $ bitbake linux-yocto -c kernel_configcheck -f 1436 $ bitbake linux-yocto -c kernel_configcheck -f
1437 1437
14383. *Process the Results:* Take the resulting list of files from the 14383. *Process the Results:* Take the resulting list of files from the
1439 ``do_kernel_configcheck`` task warnings and do the following: 1439 :ref:`ref-tasks-kernel_configcheck` task warnings and do the following:
1440 1440
1441 - Drop values that are redefined in the fragment but do not change 1441 - Drop values that are redefined in the fragment but do not change
1442 the final ``.config`` file. 1442 the final ``.config`` file.
@@ -1450,7 +1450,7 @@ To streamline the configuration, do the following:
1450 1450
14514. *Re-Run Configure and Check Tasks:* After you have worked through the 14514. *Re-Run Configure and Check Tasks:* After you have worked through the
1452 output of the kernel configuration audit, you can re-run the 1452 output of the kernel configuration audit, you can re-run the
1453 ``do_kernel_configme`` and ``do_kernel_configcheck`` tasks to see the 1453 ``do_kernel_configme`` and :ref:`ref-tasks-kernel_configcheck` tasks to see the
1454 results of your changes. If you have more issues, you can deal with 1454 results of your changes. If you have more issues, you can deal with
1455 them as described in the previous step. 1455 them as described in the previous step.
1456 1456
diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst
index 7d03d9f3a1..806442eae3 100644
--- a/documentation/ref-manual/tasks.rst
+++ b/documentation/ref-manual/tasks.rst
@@ -666,7 +666,7 @@ kernel with the correct branches checked out.
666 666
667Validates the configuration produced by the 667Validates the configuration produced by the
668:ref:`ref-tasks-kernel_menuconfig` task. The 668:ref:`ref-tasks-kernel_menuconfig` task. The
669``do_kernel_configcheck`` task produces warnings when a requested 669:ref:`ref-tasks-kernel_configcheck` task produces warnings when a requested
670configuration does not appear in the final ``.config`` file or when you 670configuration does not appear in the final ``.config`` file or when you
671override a policy configuration in a hardware configuration fragment. 671override a policy configuration in a hardware configuration fragment.
672You can run this task explicitly and view the output by using the 672You can run this task explicitly and view the output by using the