diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index bd70ca7910..64f6da876b 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -3493,16 +3493,21 @@
The new runqemu is a Python script.
- The script requires a configuration file in the following
- form in order to boot the BSP:
+ Machine knowledge is no longer hardcoded into
+ runqemu.
+ You can choose to use the qemuboot
+ configuration file to define the BSP's own arguments and to make
+ it bootable with runqemu.
+ If you use a configuration file, use the following form:
image-name-machine.qemuboot.conf
- Machine knowledge is no longer hardcoded into
- runqemu.
- You can use the qemuboot configuration file
- to define the BSP's own arguments and to make it bootable
- with runqemu.
+ The configuration file enables fine-grained tuning of options
+ passed to QEMU without the runqemu script
+ hard-coding any knowledge about different machines.
+ Using a configuration file is particularly convenient when trying
+ to use QEMU with machines other than the
+ qemu* machines in OE-Core.
Previous usage patterns are continued to be supported.
@@ -3515,6 +3520,34 @@
qemuboot.conf.
+
+
+ If you want to use runqemu without a
+ configuration file, use the following command form:
+
+ $ runqemu machine rootfs kernel [options]
+
+ Supported machines are as follows:
+
+ qemuarm
+ qemuarm64
+ qemux86
+ qemux86-64
+ qemuppc
+ qemumips
+ qemumips64
+ qemumipsel
+ qemumips64el
+
+ Consider the following example, which uses the
+ qemux86-64 machine,
+ provides a root filesystem, provides an image, and uses
+ the nographic option:
+
+$ runqemu qemux86-64 tmp/deploy/images/qemux86-64/core-image-minimal-qemux86-64.ext4 tmp/deploy/images/qemux86-64/bzImage nographic
+
+
+
Following is a list of variables that can be set in configuration
files such as bsp.conf to enable the BSP