Skip to content

Commit 9c91afa

Browse files
gardarahesford
authored andcommitted
Make default efi path distro agnostic
1 parent 333b6d8 commit 9c91afa

File tree

4 files changed

+13
-13
lines changed

4 files changed

+13
-13
lines changed

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ vmlinuz-5.3.18_1
141141
vmlinuz-5.4.6_1
142142
```
143143

144-
Typically, EFI system partitions (ESP) are mounted at `/boot/efi`, as is shown above. An ESP may contain a number of sub-directories, including an `EFI` directory that often contains multiple independent EFI executables. In this example layout, `/boot/efi/EFI/void` may hold ZFSBootMenu kernels and initramfs images. After setting the `ImageDir` property of the `Components` section of `/etc/zfsbootmenu/config.yaml` to `/boot/efi/EFI/void`, running `generate-zbm` will cause ZFSBootMenu kernel and initramfs pairs to be installed in the desired location:
144+
Typically, EFI system partitions (ESP) are mounted at `/boot/efi`, as is shown above. An ESP may contain a number of sub-directories, including an `EFI` directory that often contains multiple independent EFI executables. In this example layout, `/boot/efi/EFI/zbm` may hold ZFSBootMenu kernels and initramfs images. After setting the `ImageDir` property of the `Components` section of `/etc/zfsbootmenu/config.yaml` to `/boot/efi/EFI/zbm`, running `generate-zbm` will cause ZFSBootMenu kernel and initramfs pairs to be installed in the desired location:
145145

146146
```
147147
# lsblk -f /dev/sda
@@ -150,7 +150,7 @@ sdg
150150
├─sda1 vfat AFC2-35EE 7.9G 1% /boot/efi
151151
└─sda2 swap 412401b6-4aec-4452-a6bd-6fc20fbdc2a5 [SWAP]
152152
153-
# ls /boot/efi/EFI/void/
153+
# ls /boot/efi/EFI/zbm/
154154
initramfs-1.12.0_1.img
155155
initramfs-1.12.0_2.img
156156
vmlinuz-1.12.0_1
@@ -166,8 +166,8 @@ efibootmgr --disk /dev/sda \
166166
--part 1 \
167167
--create \
168168
--label "ZFSBootMenu" \
169-
--loader '\EFI\void\vmlinuz-1.12.0_2' \
170-
--unicode 'zbm.prefer=zroot ro initrd=\EFI\void\initramfs-1.12.0_2.img quiet' \
169+
--loader '\EFI\zbm\vmlinuz-1.12.0_2' \
170+
--unicode 'zbm.prefer=zroot ro initrd=\EFI\zbm\initramfs-1.12.0_2.img quiet' \
171171
--verbose
172172
```
173173

@@ -177,7 +177,7 @@ Each time ZFSBootMenu is updated, a new EFI entry will need to be manually added
177177

178178
## rEFInd
179179

180-
`rEFInd` is considerably easier to install and manage. Refer to your distribution's packages for installation. Once rEFInd has been installed, you can create `refind_linux.conf` in the directory holding the ZFSBootMenu files (`/boot/efi/EFI/void` in our example):
180+
`rEFInd` is considerably easier to install and manage. Refer to your distribution's packages for installation. Once rEFInd has been installed, you can create `refind_linux.conf` in the directory holding the ZFSBootMenu files (`/boot/efi/EFI/zbm` in our example):
181181

182182
```
183183
"Boot default" "zbm.prefer=zroot ro quiet loglevel=0 zbm.skip"

docs/man/generate-zbm.5

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -235,22 +235,22 @@ Behaves similarly to \fIComponents.Versions\fR, but acts on files matching the \
235235
The path to the \s-1EFI\s0 stub loader used to boot the unified bundle. If not set, a default of \fI/usr/lib/gummiboot/linuxx64.efi.stub\fR is assumed.
236236
.SH "EXAMPLE"
237237
.IX Header "EXAMPLE"
238-
The following example will write separate, unversioned ZFSBootMenu kernel and initramfs images to \fI/boot/efi/EFI/void\fR, keeping a backup for each file that would be overwritten when creating the new images. In addition, a versioned \s-1UEFI\s0 bundle will be stored in the same directory, where two prior revisions of the current version and the highest revision of each of the two most recent prior versions will be retained.
238+
The following example will write separate, unversioned ZFSBootMenu kernel and initramfs images to \fI/boot/efi/EFI/zbm\fR, keeping a backup for each file that would be overwritten when creating the new images. In addition, a versioned \s-1UEFI\s0 bundle will be stored in the same directory, where two prior revisions of the current version and the highest revision of each of the two most recent prior versions will be retained.
239239
.Sp
240240
.Vb 10
241241
\& Global:
242242
\& ManageImages: true
243243
\& BootMountPoint: /boot/efi
244244
\& DracutConfDir: /etc/zfsbootmenu/dracut.conf.d
245245
\& Components:
246-
\& ImageDir: /boot/efi/EFI/void
246+
\& ImageDir: /boot/efi/EFI/zbm
247247
\& Versions: false
248248
\& Enabled: true
249249
\& syslinux:
250250
\& Config: /boot/syslinux/syslinux.cfg
251251
\& Enabled: false
252252
\& EFI:
253-
\& ImageDir: /boot/efi/EFI/void
253+
\& ImageDir: /boot/efi/EFI/zbm
254254
\& Versions: 2
255255
\& Enabled: true
256256
\& Kernel:

docs/pod/generate-zbm.5.pod

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ The path to the EFI stub loader used to boot the unified bundle. If not set, a d
144144

145145
=head1 EXAMPLE
146146

147-
The following example will write separate, unversioned ZFSBootMenu kernel and initramfs images to I</boot/efi/EFI/void>, keeping a backup for each file that would be overwritten when creating the new images. In addition, a versioned UEFI bundle will be stored in the same directory, where two prior revisions of the current version and the highest revision of each of the two most recent prior versions will be retained.
147+
The following example will write separate, unversioned ZFSBootMenu kernel and initramfs images to I</boot/efi/EFI/zbm>, keeping a backup for each file that would be overwritten when creating the new images. In addition, a versioned UEFI bundle will be stored in the same directory, where two prior revisions of the current version and the highest revision of each of the two most recent prior versions will be retained.
148148

149149
=over 4
150150

@@ -153,14 +153,14 @@ The following example will write separate, unversioned ZFSBootMenu kernel and in
153153
BootMountPoint: /boot/efi
154154
DracutConfDir: /etc/zfsbootmenu/dracut.conf.d
155155
Components:
156-
ImageDir: /boot/efi/EFI/void
156+
ImageDir: /boot/efi/EFI/zbm
157157
Versions: false
158158
Enabled: true
159159
syslinux:
160160
Config: /boot/syslinux/syslinux.cfg
161161
Enabled: false
162162
EFI:
163-
ImageDir: /boot/efi/EFI/void
163+
ImageDir: /boot/efi/EFI/zbm
164164
Versions: 2
165165
Enabled: true
166166
Kernel:

etc/zfsbootmenu/config.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ Global:
77
InitCPIO: false
88
InitCPIOConfig: /etc/zfsbootmenu/mkinitcpio.conf
99
Components:
10-
ImageDir: /boot/efi/EFI/void
10+
ImageDir: /boot/efi/EFI/zbm
1111
Versions: 3
1212
Enabled: true
1313
syslinux:
1414
Config: /boot/syslinux/syslinux.cfg
1515
Enabled: false
1616
EFI:
17-
ImageDir: /boot/efi/EFI/void
17+
ImageDir: /boot/efi/EFI/zbm
1818
Versions: false
1919
Enabled: false
2020
Kernel:

0 commit comments

Comments
 (0)