- | --shim shim-filename |
- If you pass this option to install.sh, the script will copy the specified shim program file to the target directory, copy the MokManager.efi file from the shim program file's directory to the target directory, copy the 64-bit version of rEFInd as grubx64.efi, and register shim with the firmware. (If you also specify --usedefault, the NVRAM registration is skipped.) The intent is to simplify rEFInd installation on a computer that uses Secure Boot; when so set up, rEFInd will boot in Secure Boot mode, with one caveat: The first time you boot, MokManager will launch, and you must use it to locate and install a public key. This key file will be located in the rEFInd directory's keys subdirectory under the name refind.cer. Note that I'm not providing a shim binary myself, but you can download one from here. In the not-too-distant future, most distributions will provide their own shim programs, so you'll be able to point to them—for instance, in /boot/efi/EFI/fedora/shim.efi. |
+ --shim shim-filename or --preloader preloader-filename |
+ If you pass this option to install.sh, the script will copy the specified shim program file to the target directory, copy the MokManager.efi file from the shim program file's directory to the target directory, copy the 64-bit version of rEFInd as grubx64.efi, and register shim with the firmware. (If you also specify --usedefault, the NVRAM registration is skipped.) When the target file is identified as PreLoader, much the same thing happens, but install.sh copies HashTool.efi instead of MokManager.efi and copies rEFInd as loader.efi rather than as grubx64.efi. The intent is to simplify rEFInd installation on a computer that uses Secure Boot; when so set up, rEFInd will boot in Secure Boot mode, with one caveat: The first time you boot, MokManager/HashTool will launch, and you must use it to locate and install a public key or register rEFInd as a trusted application. The rEFInd public key file will be located in the rEFInd directory's keys subdirectory under the name refind.cer. Note that I'm not providing a shim binary myself, but you can download one from here. Some distributions also provide their own shim programs, so can point to them—for instance, in /boot/efi/EFI/fedora/shim.efi. |
| --localkeys |
@@ -604,9 +604,11 @@ $ ioreg -l -p IODeviceTree | grep firmware-abi
x86 (32-bit) shell 2
+Alternate x86-64 (64-bit) shell 2 for older EFIs
+
-Note that the shell included in rEFInd's CD-R image version is a version 1 shell, so you can't use it for this purpose. You can, however, copy rEFInd's files from the CD-R. You can even launch the version 1 shell included with rEFInd and then use that to launch a version 2 shell. Once you've booted the shell, you can proceed as follows:
+Note that the IA32 shell included in rEFInd's CD-R image version is a version 1 shell, so you can't use it for this purpose. You can, however, copy rEFInd's files from the CD-R. You can even launch the version 1 shell included with rEFInd and then use that to launch a version 2 shell. The x86-64 shell on the CD-R is the alternate shell, which should work on any x86-64 computer. Once you've booted the shell, you can proceed as follows:
@@ -832,7 +834,7 @@ $ ioreg -l -p IODeviceTree | grep firmware-abi
- shell.efi—This
- file, placed in the ESP's efi/tools directory, adds the
+ file, placed in the ESP's EFI/tools directory, adds the
ability to launch a text-mode EFI shell from rEFInd. Note that the
download link is to a 64-bit binary that must be renamed before rEFInd
will recognize it. Additional shell download links appear on the ioreg -l -p IODeviceTree | grep firmware-abi
Linux wiki, and on other sites; try a Web search if the shell you
find doesn't work to your satisfaction.
+- Memtest86—This
+ is a popular tool for performing basic hardware tests, and especially
+ memory tests. rEFInd recognizes this program when it is stored in the
+ EFI/tools, EFI/tools/memtest,
+ EFI/tools/memtest86, EFI/memtest, or
+ EFI/memtest86 directory, with a program filename of
+ memtest86.efi, memtest86_x64.efi,
+ memtest86x64.efi, or bootx64.efi. (Change
+ x64 to ia32 on IA-32 systems.) Be sure to download
+ the EFI version of the program. If you get the USB flash drive version,
+ you should mount the flash drive's ESP (partition 2) and copy the
+ EFI/BOOT directory to your own ESP's
+ EFI/tools/memtest or other Memtest86 directory name, as just
+ specified. rEFInd should then recognize it, provided the
+ showtools line includes the memtest or
+ memtest86 token.
+
- gptsync.efi or gptsync_arch.efi—This program creates a hybrid MBR from
@@ -902,11 +922,13 @@ $ ioreg -l -p IODeviceTree | grep firmware-abi
The biggest drawback to this approach is that you won't be able to edit the rEFInd configuration file or move rEFInd-related binaries from an EFI shell if you install it in this way, since Apple's HFS+ driver for EFI is read-only. (The same is true of rEFInd's HFS+ driver, so it won't help you overcome this limitation.) You may also be limited in making changes to your rEFInd configuration from Linux or other OSes, too, since Linux's HFS+ drivers disable write support by default on volumes with an active journal. You can force write access by using the force option to mount; however, this procedure is noted as being risky in the Linux HFS+ documentation, so I don't recommend doing this on a regular basis. As a compromise, you might try creating a small non-journaled HFS+ volume that's dedicated to holding rEFInd. You could even mount it as the Linux /boot partition, in which case it would also hold the Linux kernel and related files. You'll need to install rEFInd manually if you try this.
+A variant of this solution is suggested in this blog post, which recommends placing rEFInd on an HFS+ volume on the first SATA channel. (In the blogger's case, that channel used to hold an optical drive, but that drive was replaced by a hard disk.)
+
Using the Fallback Filename
-I've received one report that installing rEFInd to the ESP using the fallback filename (EFI/BOOT/bootx64.efi on most systems, or EFI/BOOT/bootia32.efi on very old Macs) can work around the problem.
+I've received a few reports that installing rEFInd to the ESP using the fallback filename (EFI/BOOT/bootx64.efi on most systems, or EFI/BOOT/bootia32.efi on very old Macs) can work around the problem.
Clearing the NVRAM Entries