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

[Dimitris Tassopoulos]

I've forgot to format...

>From 89711eb7143bd832fb150442b9ca63fdf80d53fb Mon Sep 17 00:00:00 2001
From: Dimitris Tassopoulos <dimtass at 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>
-- 

On Mon, Nov 5, 2018 at 11:22 PM Dimitris Tassopoulos <dimtass at gmail.com>
wrote:

> 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,
> 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.
>
> index 4e7b5de4e..365b5c577 100644
> @@ -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>
>
>
> Regards,
> Dimitris
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.yoctoproject.org/pipermail/yocto/attachments/20181105/4813a42e/attachment-0001.html>