X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=system-booting.adoc;h=8400a26e6a0fe7b75646717af656788c103248e6;hp=f40a469a64e53cbac53d77a75b68c6d2cc890ebd;hb=87ba80b03f8cc263591b2f3e5344d455b22c4789;hpb=1722c45bca48cb64d22a13c03e0a5398f11d4fc9

diff --git a/system-booting.adoc b/system-booting.adoc
index f40a469..8400a26 100644
--- a/system-booting.adoc
+++ b/system-booting.adoc
@@ -79,14 +79,16 @@ system boots even if the first boot device fails.  The ESPs are kept in sync by
 a kernel postinstall hook script `/etc/kernel/postinst.d/zz-pve-efiboot`. The
 script copies certain kernel versions and the initrd images to `EFI/proxmox/`
 on the root of each ESP and creates the appropriate config files in
-`loader/entries/proxmox-*.conf`.
+`loader/entries/proxmox-*.conf`. The `pve-efiboot-tool` script assists in
+managing both the synced ESPs themselves and their contents.
 
 The following kernel versions are configured by default:
 
 * the currently running kernel
 * the version being newly installed on package updates
-* the two latest kernels
-* the latest version of each kernel series (e.g. 4.15, 5.0).
+* the two latest already installed kernels
+* the latest version of the second-to-last kernel series (e.g. 4.15, 5.0), if applicable
+* any manually selected kernels (see below)
 
 The ESPs are not kept mounted during regular operation, in contrast to `grub`,
 which keeps an ESP mounted on `/boot/efi`. This helps to prevent filesystem
@@ -147,6 +149,8 @@ selected kernels, for example:
 pve-efiboot-tool kernel remove 5.0.15-1-pve
 ----
 
+NOTE: It's required to run `pve-efiboot-tool refresh` to update all EFI System
+Partitions (ESPs) after a manual kernel addition or removal from above.
 
 [[sysboot_systemd_boot_setup]]
 .Setting up a new partition for use as synced ESP
@@ -179,12 +183,18 @@ trigger a refresh of all configured ESPs.
 .Updating the configuration on all ESPs
 
 To copy and configure all bootable kernels and keep all ESPs listed in
-`/etc/kernel/pve-efiboot-uuids` in sync you just need to run `pve-efiboot-tool
-refresh`.
+`/etc/kernel/pve-efiboot-uuids` in sync you just need to run:
+
+----
+ pve-efiboot-tool refresh
+----
 (The equivalent to running `update-grub` on Systems being booted with `grub`).
 
 This is necessary should you make changes to the kernel commandline, or want to
-sync all kernels and initrds after regenerating the latter.
+sync all kernels and initrds.
+
+NOTE: Both `update-initramfs` and `apt` (when necessary) will automatically
+trigger a refresh.
 
 [[sysboot_edit_kernel_cmdline]]
 Editing the kernel commandline
@@ -202,6 +212,6 @@ The kernel commandline needs to be placed in the variable
 
 .Systemd-boot
 
-The kernel commandline needs to be placed as line in `/etc/kernel/cmdline`
-Running `/etc/kernel/postinst.d/zz-pve-efiboot` sets it as `option` line for
-all config files in `loader/entries/proxmox-*.conf`.
+The kernel commandline needs to be placed as one line in `/etc/kernel/cmdline`.
+To apply your changes, run `pve-efiboot-tool·refresh`, which sets it as the
+`option` line for all config files in `loader/entries/proxmox-*.conf`.