systemd-boot man page: add section for virtual machines

diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml
index 0eee532f90af00114537add52de23ec9cf119cca..57b66803fadf37ed1409fb86b155cdbfdf356779 100644 (file)
--- 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>