systemd/0151-systemd-boot-man-page-...

41 lines
1.5 KiB
Diff

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>