summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2016-10-19 07:54:57 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-10-25 17:55:37 +0100
commit3769f7ba06dcf48ecba250483d895256b4c52d16 (patch)
tree0f6d58322342554fe3dd3df4d4f7e57dd9943aaf /documentation
parent952a47b42cb3696db2896ac53b5246802bba0f59 (diff)
downloadpoky-3769f7ba06dcf48ecba250483d895256b4c52d16.tar.gz
ref-manual: Updated 2.2 migration for runqemu porting to python
Indicated that the configuration file is not mandatory. Also, documented the supported qemu* machines should you run the script without a configuration file. (From yocto-docs rev: aeb2c28d7476f67302a1b51da51fb57027e9d02c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/migration.xml47
1 files changed, 40 insertions, 7 deletions
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 @@
3493 3493
3494 <para> 3494 <para>
3495 The new <filename>runqemu</filename> is a Python script. 3495 The new <filename>runqemu</filename> is a Python script.
3496 The script requires a configuration file in the following 3496 Machine knowledge is no longer hardcoded into
3497 form in order to boot the BSP: 3497 <filename>runqemu</filename>.
3498 You can choose to use the <filename>qemuboot</filename>
3499 configuration file to define the BSP's own arguments and to make
3500 it bootable with <filename>runqemu</filename>.
3501 If you use a configuration file, use the following form:
3498 <literallayout class='monospaced'> 3502 <literallayout class='monospaced'>
3499 <replaceable>image-name</replaceable>-<replaceable>machine</replaceable>.qemuboot.conf 3503 <replaceable>image-name</replaceable>-<replaceable>machine</replaceable>.qemuboot.conf
3500 </literallayout> 3504 </literallayout>
3501 Machine knowledge is no longer hardcoded into 3505 The configuration file enables fine-grained tuning of options
3502 <filename>runqemu</filename>. 3506 passed to QEMU without the <filename>runqemu</filename> script
3503 You can use the <filename>qemuboot</filename> configuration file 3507 hard-coding any knowledge about different machines.
3504 to define the BSP's own arguments and to make it bootable 3508 Using a configuration file is particularly convenient when trying
3505 with <filename>runqemu</filename>. 3509 to use QEMU with machines other than the
3510 <filename>qemu*</filename> machines in OE-Core.
3506 <note> 3511 <note>
3507 Previous usage patterns are continued to be supported. 3512 Previous usage patterns are continued to be supported.
3508 </note> 3513 </note>
@@ -3515,6 +3520,34 @@
3515 <filename>qemuboot.conf</filename>. 3520 <filename>qemuboot.conf</filename>.
3516 </para> 3521 </para>
3517 3522
3523
3524 <para>
3525 If you want to use <filename>runqemu</filename> without a
3526 configuration file, use the following command form:
3527 <literallayout class='monospaced'>
3528 $ runqemu <replaceable>machine</replaceable> <replaceable>rootfs</replaceable> <replaceable>kernel</replaceable> [<replaceable>options</replaceable>]
3529 </literallayout>
3530 Supported <replaceable>machines</replaceable> are as follows:
3531 <literallayout class='monospaced'>
3532 qemuarm
3533 qemuarm64
3534 qemux86
3535 qemux86-64
3536 qemuppc
3537 qemumips
3538 qemumips64
3539 qemumipsel
3540 qemumips64el
3541 </literallayout>
3542 Consider the following example, which uses the
3543 <filename>qemux86-64</filename> machine,
3544 provides a root filesystem, provides an image, and uses
3545 the <filename>nographic</filename> option:
3546 <literallayout class='monospaced'>
3547$ runqemu qemux86-64 tmp/deploy/images/qemux86-64/core-image-minimal-qemux86-64.ext4 tmp/deploy/images/qemux86-64/bzImage nographic
3548 </literallayout>
3549 </para>
3550
3518 <para> 3551 <para>
3519 Following is a list of variables that can be set in configuration 3552 Following is a list of variables that can be set in configuration
3520 files such as <filename>bsp.conf</filename> to enable the BSP 3553 files such as <filename>bsp.conf</filename> to enable the BSP