From 236e3846e8497f2f7e5c4dfcfc9ff2e922fd02a0 Mon Sep 17 00:00:00 2001

From: Gerd Hoffmann <kraxel@redhat.com>

Date: Tue, 4 Oct 2022 15:01:39 +0200

Subject: [PATCH] systemd-boot man page: add section for virtual machines

(cherry picked from commit 941d418d19397bd20c570729877a5dfa37d762b2)

Related: #2138081

---

 man/systemd-boot.xml | 17 +++++++++++++++++

 1 file changed, 17 insertions(+)

diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml

index 0eee532f90..57b66803fa 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>