ref-manual/variables.rst: document WIC_CREATE_EXTRA_ARGS

Fixes [YOCTO #15509]

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
(From yocto-docs rev: 8e893cc8cabba4b4f21556561d1ca9656ca1ff9f)

Signed-off-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit f1cdecb6da91dbfac59359c83038cb4a4c36ad0a)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Trevor Woerner 2025-05-13 12:58:38 -04:00 committed by Steve Sakoman
parent 40232dc020
commit 38e33dedee

View File

@ -9579,6 +9579,20 @@ system and gives an overview of their function and contents.
can control with this variable, see the can control with this variable, see the
":ref:`ref-classes-insane`" section. ":ref:`ref-classes-insane`" section.
:term:`WIC_CREATE_EXTRA_ARGS`
If the :term:`IMAGE_FSTYPES` variable contains "wic", the build
will generate a
:ref:`Wic image <dev-manual/wic:creating partitioned images using wic>`
automatically when BitBake builds an image recipe. As part of
this process BitBake will invoke the "`wic create`" command. The
:term:`WIC_CREATE_EXTRA_ARGS` variable is placed at the end of this
command which allows the user to supply additional arguments.
One such useful purpose for this mechanism is to add the ``-D`` (or
``--debug``) argument to the "`wic create`" command. This increases the
amount of debugging information written out to the Wic log during the
Wic creation process.
:term:`WKS_FILE` :term:`WKS_FILE`
Specifies the location of the Wic kickstart file that is used by the Specifies the location of the Wic kickstart file that is used by the
OpenEmbedded build system to create a partitioned image OpenEmbedded build system to create a partitioned image