diff options
author | Michael Opdenacker <michael.opdenacker@bootlin.com> | 2022-09-23 19:41:05 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2022-10-07 10:54:26 +0100 |
commit | 3784c57c042a5b44dc507df1abf660014252aa9c (patch) | |
tree | f4a0d866fcf5678163ea7d340bfc77ba626fcfaf /documentation | |
parent | c4e05c52237edc7314dba2de84abd1413b6751c7 (diff) | |
download | poky-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.rst | 10 | ||||
-rw-r--r-- | documentation/ref-manual/tasks.rst | 2 |
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. | |||
1316 | See the ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" section for | 1316 | See the ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" section for |
1317 | information on how to create a configuration file. | 1317 | information on how to create a configuration file. |
1318 | 1318 | ||
1319 | Following is sample output from the ``do_kernel_configcheck`` task: | 1319 | Following 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 | |||
1396 | audit, noting any issues, making changes to correct the issues, and then | 1396 | audit, noting any issues, making changes to correct the issues, and then |
1397 | repeating. | 1397 | repeating. |
1398 | 1398 | ||
1399 | As part of the kernel build process, the ``do_kernel_configcheck`` task | 1399 | As part of the kernel build process, the :ref:`ref-tasks-kernel_configcheck` task |
1400 | runs. This task validates the kernel configuration by checking the final | 1400 | runs. 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 |
1402 | produces warning messages for the following issues: | 1402 | produces 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 | ||
1432 | 2. *Run Configure and Check Tasks:* Separately run the | 1432 | 2. *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 | ||
1438 | 3. *Process the Results:* Take the resulting list of files from the | 1438 | 3. *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 | ||
1451 | 4. *Re-Run Configure and Check Tasks:* After you have worked through the | 1451 | 4. *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 | ||
667 | Validates the configuration produced by the | 667 | Validates 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 |
670 | configuration does not appear in the final ``.config`` file or when you | 670 | configuration does not appear in the final ``.config`` file or when you |
671 | override a policy configuration in a hardware configuration fragment. | 671 | override a policy configuration in a hardware configuration fragment. |
672 | You can run this task explicitly and view the output by using the | 672 | You can run this task explicitly and view the output by using the |