ref-manual/variables.rst: document the QB_DEFAULT_BIOS variable

The QB_DEFAULT_BIOS allows setting the -bios parameter of QEMU, which
can be used to emulate U-Boot, for example.

(From yocto-docs rev: dc9a5aa19ca2a0b5ad866f0329b8a030542ca0c6)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit f2eef5268aa94b31e986e4eef4ce1fe0094b70c4)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Paul Barker <paul@pbarker.dev>
This commit is contained in:
Antonin Godard
2026-08-13 12:33:22 +01:00
committed by Paul Barker
parent 3cd1dbb582
commit 1ba3cd7c88
+19
View File
@@ -7380,6 +7380,25 @@ system and gives an overview of their function and contents.
replaces the ``@CLIENT@`` and ``@GATEWAY@`` place holders by the IP and
the gateway address of the QEMU guest.
:term:`QB_DEFAULT_BIOS`
The :term:`QB_DEFAULT_BIOS` variable can be used to provide a default
value for the path of a file located in :term:`DEPLOY_DIR_IMAGE` and
used by ``runqemu`` to specify the `-bios <https://www.qemu.org/docs/master/system/invocation.html#hxtool-8>`__
option of QEMU. For example, this variable can be set as follows to
emulate U-Boot for the :oecore_path:`qemuarm64 <meta/conf/machine/qemuarm64.conf>`
machine::
QB_DEFAULT_BIOS = "u-boot.bin"
The above example makes the assumption the U-Boot recipe was built
and that the ``u-boot.bin`` is deployed in the :term:`DEPLOY_DIR_IMAGE`
directory.
.. note::
When using ``runqemu``, the ``BIOS`` environment variable takes
precedence over this variable.
:term:`QB_DEFAULT_FSTYPE`
The :term:`QB_DEFAULT_FSTYPE` variable controls the default filesystem