1
0
mirror of https://git.yoctoproject.org/poky synced 2026-07-16 03:47:03 +00:00

ref-manual: add "KERNEL_IMAGE_STRIP_EXTRA_SECTIONS" to variables

Add this variable to the variables glossary, and add links to it and
back to the do_strip() task for completeness.

(From yocto-docs rev: cc4b7ffb3b2558ae796decbd216302e253addf02)

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit f43fc622d2fd6bc832a2993841b2020f86c6475c)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Paul Barker <paul@pbarker.dev>
This commit is contained in:
Robert P. J. Day
2026-07-10 05:17:35 -04:00
committed by Paul Barker
parent 9ba4cbc08e
commit be05e58dcf
2 changed files with 16 additions and 1 deletions
+9 -1
View File
@@ -784,11 +784,19 @@ any that exceed that value, but fail only if none of them fit.
``do_strip``
------------
If ``KERNEL_IMAGE_STRIP_EXTRA_SECTIONS`` is defined, this task strips
If :term:`KERNEL_IMAGE_STRIP_EXTRA_SECTIONS` is defined, this task strips
the sections named in that variable from ``vmlinux``. This stripping is
typically used to remove nonessential sections such as ``.comment``
sections from a size-sensitive configuration.
Common sections to strip:
- ``.comment``: Holds compiler version strings and information
- ``.note.*``: Extra notes often left by the compiler
- ``.debug``: Debugging information
.. _ref-tasks-validate_branches:
``do_validate_branches``
+7
View File
@@ -5131,6 +5131,13 @@ system and gives an overview of their function and contents.
See :term:`KERNEL_ARTIFACT_NAME` for additional information.
:term:`KERNEL_IMAGE_STRIP_EXTRA_SECTIONS`
If this variable is set, it should contain the sections to be
stripped from the ``vmlinux`` image by the kernel-related
:ref:`ref-tasks-strip` task. As a simple example::
KERNEL_IMAGE_STRIP_EXTRA_SECTIONS = ".comment .note.* .debug"
:term:`KERNEL_IMAGETYPE`
The type of kernel to build for a device, usually set by the machine
configuration files and defaults to "zImage". This variable is used