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>