From: Gerd Hoffmann <kraxel@redhat.com>
Date: Tue, 4 Oct 2022 13:01:39 +0000 (+0200)
Subject: systemd-boot man page: add section for virtual machines
X-Git-Tag: v253-rc1~516^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F24855%2Fhead;p=thirdparty%2Fsystemd.git

systemd-boot man page: add section for virtual machines
---

diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml
index 0eee532f90a..57b66803fad 100644
--- a/man/systemd-boot.xml
+++ b/man/systemd-boot.xml
@@ -525,6 +525,23 @@
     <filename>/etc/kernel/tries</filename> when a boot loader entry is first created.</para>
   </refsect1>
 
+  <refsect1>
+    <title>Using systemd-boot in virtual machines.</title>
+
+    <para>When using qemu with OVMF (UEFI Firmware for virtual machines) the <option>-kernel</option> switch
+    works not only for linux kernels, but for any EFI binary, including sd-boot and unified linux
+    kernels.  Example command line for loading sd-boot on x64:</para>
+
+    <para>
+      <command>qemu-system-x86_64 <replaceable>[ ... ]</replaceable>
+      -kernel /usr/lib/systemd/boot/efi/systemd-bootx64.efi</command>
+    </para>
+
+    <para>systemd-boot will detect that it was started directly instead of being loaded from ESP and will
+    search for the ESP in that case, taking into account boot order information from the hypervisor (if
+    available).</para>
+  </refsect1>
+
   <refsect1>
     <title>See Also</title>
     <para>