From 6b7474f7ca29076d28df81a49feec6311fa18202 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Tue, 30 Jun 2026 10:13:17 +0200 Subject: [PATCH] ref-manual/variables.rst: document the IMAGE_*_DEBUGFS variables Added by commit 41316293e442 ("lib/oe/image.py: Add image generation for companion debug filesystem") in OE-Core. (From yocto-docs rev: 51c53ef1e8b4ec4afbb84252e59dd5501f405064) Signed-off-by: Antonin Godard (cherry picked from commit 75a69c94f5ba556fbe182c96a9bab2c561a0358e) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 088071c452..6352b86698 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -3988,6 +3988,21 @@ system and gives an overview of their function and contents. or ``:prepend``. You must use the ``+=`` operator to add one or more options to the :term:`IMAGE_FSTYPES` variable. + :term:`IMAGE_FSTYPES_DEBUGFS` + The :term:`IMAGE_FSTYPES_DEBUGFS` holds a list of filesystem image types + to generate when the :term:`IMAGE_GEN_DEBUGFS` variable is set to "1". The + content of this variable is the same as what is supported by the + :term:`IMAGE_FSTYPES` variable. + + :term:`IMAGE_GEN_DEBUGFS` + When set to "1" in an :ref:`ref-classes-image` recipe, the + :term:`OpenEmbedded Build System` will generate a companion image that + contains the debug symbols and source code for the packages installed on + the image. The :term:`OpenEmbedded Build System` does this by adding all + the available ``-dbg`` and ``-src`` packages available in the package + feed, which are automatically generated during + :ref:`overview-manual/concepts:Package Splitting`. + :term:`IMAGE_INSTALL` Used by recipes to specify the packages to install into an image through the :ref:`ref-classes-image` class. Use the