[yocto] [yocto-docs][PATCH] Added info for ovfm

Dimitris Tassopoulos

2018-11-05 22:24:28 UTC

I've forgot to format...

From 89711eb7143bd832fb150442b9ca63fdf80d53fb Mon Sep 17 00:00:00 2001
From: Dimitris Tassopoulos <***@gmail.com>
Date: Mon, 5 Nov 2018 23:18:25 +0100
Subject: [PATCH] Added description of the ovmf option in runqemu

The current documentation doesn't have any info for the ovmf option.
In case you build a QEMU image with the grub-efi bootloader, then the
qemu image needs the ovmf firmware to boot. Therefore, when using the
runqemu script you need to pass the ovmf option. I believe this is
needed as without this info there's no hint how to boot a UEFI image.

I've added a sample example with the other existing ones and the option
in the dev-manual-qemu.xml. I've also linked the grub-efi to the class,
so it's linked in the mega-manual. I've build the documentation:

$ make DOC=mega-manual

and tested the edit and that the link works.
---
documentation/dev-manual/dev-manual-qemu.xml | 7 +++++++
1 file changed, 7 insertions(+)

diff --git a/documentation/dev-manual/dev-manual-qemu.xml
b/documentation/dev-manual/dev-manual-qemu.xml
index 4e7b5de4e..365b5c577 100644
--- a/documentation/dev-manual/dev-manual-qemu.xml
+++ b/documentation/dev-manual/dev-manual-qemu.xml
@@ -508,6 +508,7 @@
runqemu tmp/deploy/images/qemux86/<qemuboot.conf>
runqemu qemux86-64 core-image-sato ext4
runqemu qemux86-64 wic-image-minimal wic
+ runqemu qemux86-64 core-image-minimal wic ovmf
runqemu path/to/bzImage-qemux86.bin path/to/nfsrootdir/ serial
runqemu qemux86
iso/hddimg/wic.vmdk/wic.qcow2/wic.vdi/ramfs/cpio.gz...
runqemu qemux86 qemuparams="-m 256"
@@ -678,6 +679,12 @@ qemux86" or "qemux86-64".
<filename>publicvnc</filename>:
Enables a VNC server open to all hosts.
</para></listitem>
+ <listitem><para>
+ <filename>ovmf</filename>:
+ Enables support for UEFI within QEMU. This option can
be used with the
+ <link
linkend='ref-classes-grub-efi'><filename>grub-efi</filename></link>
+ class.
+ </para></listitem>
</itemizedlist>
</para>
</section>
--

Post by Dimitris Tassopoulos
Hi all, since I don't have permission to push, I'm sending the patch by
email.
This is the commit message and patch
Added description of the ovmf option in runqemu
The current documentation doesn't have any info for the ovmf option.
In case you build a QEMU image with the grub-efi bootloader, then the
qemu image needs the ovmf firmware to boot. Therefore, when using the
runqemu script you need to pass the ovmf option. I believe this is
needed as without this info there's no hint how to boot a UEFI image.
I've added a sample example with the other existing ones and the option
in the dev-manual-qemu.xml. I've also linked the grub-efi to the class,
$ make DOC=mega-manual
and tested the edit and that the link works.
index 4e7b5de4e..365b5c577 100644
@@ -508,6 +508,7 @@
runqemu qemux86-64 core-image-sato ext4
runqemu qemux86-64 wic-image-minimal wic
+ runqemu qemux86-64 core-image-minimal wic ovmf
runqemu path/to/bzImage-qemux86.bin path/to/nfsrootdir/ serial
runqemu qemux86
iso/hddimg/wic.vmdk/wic.qcow2/wic.vdi/ramfs/cpio.gz...
runqemu qemux86 qemuparams="-m 256"
@@ -678,6 +679,12 @@ qemux86" or "qemux86-64".
Enables a VNC server open to all hosts.
</para></listitem>
+ <listitem><para>
+ Enables support for UEFI within QEMU. This option can
be used with the
+ <link
linkend='ref-classes-grub-efi'><filename>grub-efi</filename></link>
+ class.
+ </para></listitem>
</itemizedlist>
</para>
</section>
Regards,
Dimitris