[PATCH 3/4] test: document pytest --env and --fs options

Ahmad Fatoum a.fatoum at barebox.org
Tue Jul 8 12:35:59 PDT 2025


These two options are really useful to avoid needless typing in QEMU by
making files and environment variables available to barebox from outside.

Document them outside of the pytest --help text as well.

Signed-off-by: Ahmad Fatoum <a.fatoum at barebox.org>
---
 Documentation/boards/emulated.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Documentation/boards/emulated.rst b/Documentation/boards/emulated.rst
index 44e78eef7fe1..602def560120 100644
--- a/Documentation/boards/emulated.rst
+++ b/Documentation/boards/emulated.rst
@@ -59,6 +59,18 @@ more easily::
   # Run tests and pass a block device (here /dev/virtioblk0)
   pytest --lg-env test/arm/virt at multi_v8_defconfig.yaml --blk=rootfs.ext4
 
+For testing, the QEMU fw_cfg and virtfs support is particularly useful::
+
+  # inject boot.sh file in working directory into barebox environment
+  # at /env/boot/fit and set /env/nv/boot.default to fit
+  pytest --lg-env test/arm/virt at multi_v8_defconfig.yaml \
+     --env nv/boot.default=fit --env boot/fit=@boot.sh
+
+  # make available the host's local working directory in barebox as
+  # /mnt/9p/host
+  pytest --lg-env test/arm/virt at multi_v8_defconfig.yaml \
+     --fs host=.
+
 For a complete listing of possible options run ``pytest --help``.
 
 MAKEALL
-- 
2.39.5




More information about the barebox mailing list