3 # Linux/MacOS X script to install rEFInd
7 # ./install.sh [options]
10 # "--notesp" to install to the OS X root filesystem rather than to the ESP.
11 # This option may not be used under Linux.
12 # "--usedefault {devicefile}" to install as default
13 # (/EFI/BOOT/BOOTX64.EFI and similar) to the specified device
14 # (/dev/sdd1 or whatever) without registering with the NVRAM.
15 # "--ownhfs {devicefile}" to install to an HFS+ volume that's NOT currently
16 # an OS X boot volume.
17 # "--root {dir}" to specify installation using the specified directory
18 # as the system's root
19 # "--alldrivers" to install all drivers along with regular files
20 # "--nodrivers" to suppress driver installation (default in Linux is
21 # driver used on /boot; --nodrivers is OS X default)
22 # "--shim {shimfile}" to install a shim.efi file for Secure Boot
23 # "--preloader" is synonymous with "--shim"
24 # "--localkeys" to re-sign x86-64 binaries with a locally-generated key
25 # "--keepname" to keep refind_x64.efi name as such even when using shim
26 # "--yes" to assume a "yes" response to all prompts
28 # The "esp" option is valid only on Mac OS X; it causes
29 # installation to the EFI System Partition (ESP) rather than
30 # to the current OS X boot partition. Under Linux, this script
31 # installs to the ESP by default.
33 # This program is copyright (c) 2012-2015 by Roderick W. Smith
34 # It is released under the terms of the GNU GPL, version 3,
35 # a copy of which should be included in the file COPYING.txt.
39 # 0.9.3 -- Enable running under OS X's recovery system.
40 # 0.9.2 -- Added --keepname option.
41 # 0.8.7 -- Better detection of Secure Boot mode & fixed errors when copying
42 # Shim & MokManager files over themselves; fixed bug that caused
43 # inappropriate installation to EFI/BOOT/bootx64.efi
44 # 0.8.6 -- Fixed bugs that caused misidentification of ESP on disks with
45 # partition numbers over 10 on OS X and misidentification of mount
46 # point if already-mounted ESP had space in path.
47 # 0.8.5 -- Refinement/cleanup of new OS X ESP-as-default policy
48 # 0.8.4 -- OS X default changed to install to ESP under /EFI/BOOT
49 # 0.7.9 -- Fixed bug that caused errors if dmraid utility not installed
50 # 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
51 # to locate and mount ESP on Linux, if it's not mounted
52 # 0.7.6 -- Added --ownhfs {device-filename} option
53 # 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
54 # 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
55 # 0.7.0 -- Added support for the new Btrfs driver
56 # 0.6.12 -- Added support for PreLoader as well as for shim
57 # 0.6.11 -- Improvements in script's ability to handle directories with spaces
59 # 0.6.9 -- Install gptsync on Macs
60 # 0.6.8 -- Bug fix: ESP scan now uses "uniq".
61 # 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
62 # copying shim.efi and MokManager.efi over themselves.
63 # 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
64 # 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
65 # directories & for installing to EFI/BOOT in BIOS mode
66 # 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
67 # 0.6.1 -- Added --root option; minor bug fixes
68 # 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
69 # changed default driver installation behavior in Linux to install
70 # the driver needed to read /boot (if available)
71 # 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
72 # 0.5.1.1 -- Fixed bug that caused script failure under OS X
73 # 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
75 # 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
76 # 0.4.5 -- Fixed check for rEFItBlesser in OS X
77 # 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
78 # 0.4.1 -- Added check for rEFItBlesser in OS X
79 # 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
80 # 0.3.2.1 -- Check for presence of source files; aborts if not present
81 # 0.3.2 -- Initial version
83 # Note: install.sh version numbers match those of the rEFInd package
84 # with which they first appeared.
88 LocalKeysBase
="refind_local"
93 TargetX64
="refind_x64.efi"
94 TargetIA32
="refind_ia32.efi"
100 # Functions used by both OS X and Linux....
105 # Install the driver required to read Linux /boot, if it's available
106 # Note: Under OS X, this will be installed only if a Linux partition
107 # is detected, in which case the ext4fs driver will be installed.
108 InstallDrivers
="boot"
109 while [[ $# -gt 0 ]]; do
111 --notesp) InstallToEspOnMac
=0
116 TargetDir
=/System
/Library
/CoreServices
119 --usedefault) TargetDir
=/EFI
/BOOT
121 TargetX64
="bootx64.efi"
122 TargetIA32
="bootia32.efi"
129 --localkeys) LocalKeys
=1
131 --shim |
--preloader) ShimSource
="$2"
132 ShimType
=`basename $ShimSource`
135 --keepname) KeepName
=1
137 --drivers |
--alldrivers) InstallDrivers
="all"
139 --nodrivers) InstallDrivers
="none"
143 * ) echo "Usage: $0 [--notesp | --usedefault {device-file} | --root {dir} |"
144 echo " --ownhfs {device-file} ] [--keepname]"
145 echo " [--nodrivers | --alldrivers]"
146 echo " [--localkeys] [--keepname] [--yes]"
151 if [[ "$InstallToEspOnMac" == 0 && "$RootDir" == '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
152 echo "You may use --notesp OR --usedefault, but not both! Aborting!"
155 if [[ "$RootDir" != '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
156 echo "You may use --root OR --usedefault, but not both! Aborting!"
159 if [[ "$TargetDir" != '/System/Library/CoreServices' && "$OwnHfs" == '1' ]] ; then
160 echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
163 if [[ "$KeepName" == 1 && "$ShimSource" == "none" ]] ; then
164 echo "The --keepname option is meaningful only in conjunction with --shim"
165 echo "or --preloader! Aborting!"
168 if [[ "$KeepName" == 1 && "$OSTYPE" != "linux-gnu" ]] ; then
169 echo "The --keepname option is valid only under Linux! Aborting!"
172 if [[ "$KeepName" == 1 && "$TargetDir" != "/EFI/BOOT" ]] ; then
173 echo "The --keepname option is incompatible with --usedefault! Aborting!"
176 RLConfFile
="$RootDir/boot/refind_linux.conf"
177 EtcKeysDir
="$RootDir/etc/refind.d/keys"
180 # Get a yes/no response from the user and place it in the YesNo variable.
181 # If the AlwaysYes variable is set to 1, skip the user input and set "Y"
182 # in the YesNo variable.
184 if [[ $AlwaysYes == 1 ]] ; then
192 # Abort if the rEFInd files can't be found.
193 # Also sets $ConfFile to point to the configuration file,
194 # $IconsDir to point to the icons directory, and
195 # $ShimSource to the source of the shim.efi file (if necessary).
197 # Note: This check is satisfied if EITHER the 32- or the 64-bit version
198 # is found, even on the wrong platform. This is because the platform
199 # hasn't yet been determined. This could obviously be improved, but it
200 # would mean restructuring lots more code....
201 if [[ ! -f "$RefindDir/refind_ia32.efi" && ! -f "$RefindDir/refind_x64.efi" ]] ; then
202 echo "The rEFInd binary file is missing! Aborting installation!"
206 if [[ -f "$RefindDir/refind.conf-sample" ]] ; then
207 ConfFile
="$RefindDir/refind.conf-sample"
208 elif [[ -f "$ThisDir/refind.conf-sample" ]] ; then
209 ConfFile
="$ThisDir/refind.conf-sample"
211 echo "The sample configuration file is missing! Aborting installation!"
215 if [[ -d "$RefindDir/icons" ]] ; then
216 IconsDir
="$RefindDir/icons"
217 elif [[ -d "$ThisDir/icons" ]] ; then
218 IconsDir
="$ThisDir/icons"
220 echo "The icons directory is missing! Aborting installation!"
224 echo "ShimSource is $ShimSource"
225 if [[ "$ShimSource" != "none" ]] ; then
226 if [[ -f "$ShimSource" ]] ; then
227 if [[ $ShimType == "shimx64.efi" ||
$ShimType == "shim.efi" ]] ; then
228 TargetX64
="grubx64.efi"
229 MokManagerSource
=`dirname "$ShimSource"`/MokManager.efi
230 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
231 TargetX64
="loader.efi"
232 MokManagerSource
=`dirname "$ShimSource"`/HashTool.efi
234 echo "Unknown shim/PreBootloader filename: $ShimType!"
235 echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
239 echo "The specified shim/PreBootloader file, $ShimSource, doesn't exist!"
240 echo "Aborting installation!"
246 # Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
247 # available) to target.
249 local inode1
=`ls -i "$ShimSource" 2> /dev/null | cut -f 1 -d " "`
250 local inode2
=`ls -i "$InstallDir/$TargetDir/$TargetShim" 2> /dev/null | cut -f 1 -d " "`
251 if [[ $inode1 != $inode2 ]] ; then
252 cp -fb "$ShimSource" "$InstallDir/$TargetDir/$TargetShim"
253 if [[ $?
!= 0 ]] ; then
257 inode1
=`ls -i "$MokManagerSource" 2> /dev/null | cut -f 1 -d " "`
258 local TargetMMName
=`basename $MokManagerSource`
259 inode2
=`ls -i "$InstallDir/$TargetDir/$TargetMMName" 2> /dev/null | cut -f 1 -d " "`
260 if [[ $inode1 != $inode2 ]] ; then
261 if [[ -f "$MokManagerSource" ]] ; then
262 cp -fb "$MokManagerSource" "$InstallDir/$TargetDir/"
264 if [[ $?
!= 0 ]] ; then
270 # Copy the public keys to the installation medium
272 if [[ $LocalKeys == 1 ]] ; then
273 mkdir
-p "$InstallDir/$TargetDir/keys/"
274 cp "$EtcKeysDir/$LocalKeysBase.cer" "$InstallDir/$TargetDir/keys/"
275 cp "$EtcKeysDir/$LocalKeysBase.crt" "$InstallDir/$TargetDir/keys/"
279 # Set varaibles for installation in EFI/BOOT directory
281 TargetDir
="/EFI/BOOT"
282 if [[ $ShimSource == "none" ]] ; then
283 TargetX64
="bootx64.efi"
284 TargetIA32
="bootia32.efi"
286 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
287 TargetX64
="grubx64.efi"
288 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
289 TargetX64
="loader.efi"
291 echo "Unknown shim/PreBootloader type: $ShimType"
295 TargetIA32
="bootia32.efi"
296 TargetShim
="bootx64.efi"
298 if [[ $KeepName == 1 ]] ; then
299 echo "Installation is to /EFI/BOOT, which is incompatible with --keepname! Aborting!"
304 # Set variables for installation in EFI/Microsoft/Boot directory
306 TargetDir
="/EFI/Microsoft/Boot"
307 if [[ $ShimSource == "none" ]] ; then
308 TargetX64
="bootmgfw.efi"
309 TargetIA32
="bootmgfw.efi"
311 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
312 TargetX64
="grubx64.efi"
313 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
314 TargetX64
="loader.efi"
316 echo "Unknown shim/PreBootloader type: $ShimType"
320 TargetShim
="bootmgfw.efi"
322 if [[ $KeepName == 1 ]] ; then
323 echo "Installation is to /EFI/Microsoft/Boot, which is incompatible with --keepname!"
327 } # SetVarsForMsBoot()
329 # TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
330 # - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
331 # install to that directory under the suitable name; but DO NOT do this if
332 # refind.conf is also in /EFI/refind.
333 # - If booted in BIOS mode and the ESP lacks any other EFI files, install to
335 # - If booted in BIOS mode and there's no refind.conf file and there is a
336 # /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
337 # install under that name, "hijacking" the Windows boot loader filename
338 DetermineTargetDir
() {
341 if [[ -f $InstallDir/EFI
/BOOT
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
345 if [[ -f $InstallDir/EFI
/Microsoft
/Boot
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
349 if [[ -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
350 TargetDir
="/EFI/refind"
351 if [[ $ShimSource == "none" ||
$KeepName == 1 ]] ; then
352 TargetX64
="refind_x64.efi"
353 TargetIA32
="refind_ia32.efi"
357 if [[ $Upgrade == 1 ]] ; then
358 echo "Found rEFInd installation in $InstallDir$TargetDir; upgrading it."
361 if [[ ! -d /sys
/firmware
/efi
&& ! $OSTYPE == darwin
* && $Upgrade == 0 ]] ; then # BIOS-mode
362 FoundEfiFiles
=`find "$InstallDir/EFI/BOOT" -name "*.efi" 2> /dev/null`
363 FoundConfFiles
=`find "$InstallDir" -name "refind\.conf" 2> /dev/null`
364 if [[ ! -n "$FoundConfFiles" && -f "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
365 mv -n "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" "$InstallDir/EFI/Microsoft" &> /dev
/null
367 echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
368 echo "files so as to install to $InstallDir$TargetDir."
369 elif [[ ! -n "$FoundEfiFiles" ]] ; then # In BIOS mode and no default loader; install as default loader
371 echo "Running in BIOS mode with no existing default boot loader; installing to"
372 echo $InstallDir$TargetDir
374 echo "Running in BIOS mode with an existing default boot loader; backing it up and"
375 echo "installing rEFInd in its place."
376 if [[ -d "$InstallDir/EFI/BOOT-rEFIndBackup" ]] ; then
378 echo "Caution: An existing backup of a default boot loader exists! If the current"
379 echo "default boot loader and the backup are different boot loaders, the current"
380 echo "one will become inaccessible."
382 echo -n "Do you want to proceed with installation (Y/N)? "
384 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
385 echo "OK; continuing with the installation..."
390 mv -n "$InstallDir/EFI/BOOT" "$InstallDir/EFI/BOOT-rEFIndBackup"
394 } # DetermineTargetDir()
396 # Determine (or guess) the filesystem used on the Linux /boot filesystem.
397 # Store the result in the BootFS global variable.
404 if command -v blkid
2>/dev
/null
; then
405 BootPart
=`df /boot | grep dev | cut -f 1 -d " "`
406 BootFS
=`blkid -o export $BootPart 2> /dev/null | grep TYPE= | cut -f 2 -d =`
410 # 0FC63DAF-8483-4772-8E79-3D69D8477DE4 = Linux filesystem
411 # BC13C2FF-59E6-4262-A352-B275FD6F7172 = Freedesktop $boot partition
412 # 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 = Freedesktop Linux /home
413 # E6D6D379-F507-44C2-A23C-238F2A3DF928 = Linux LVM
414 # A19D880F-05FC-4D3B-A006-743F0F84911E = Linux RAID
415 # 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F = Linux swap
416 Temp
=$
(diskutil list |
grep -i '0FC63DAF-8483-4772-8E79-3D69D8477DE4\|BC13C2FF-59E6-4262-A352-B275FD6F7172\|933AC7E1-2EB4-4F13-B844-0E14E2AEF915\|E6D6D379-F507-44C2-A23C-238F2A3DF928\|A19D880F-05FC-4D3B-A006-743F0F84911E\|0657FD6D-A4AB-43C4-84E5-0933C84B4F4F\|Linux')
418 if [[ -n $Temp ]] ; then
419 echo "Found suspected Linux partition(s); installing ext4fs driver."
426 # Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
427 # honoring the $InstallDrivers condition. Must be passed a suitable
428 # architecture code (ia32 or x64).
430 if [[ $InstallDrivers == "all" ]] ; then
431 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
432 cp "$ThisDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
433 cp "$RefindDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
434 elif [[ "$InstallDrivers" == "boot" ]] ; then
438 ext2 | ext3
) DriverType
="ext2"
439 # Could use ext4, but that can create unwanted entries from symbolic
440 # links in / to /boot/vmlinuz if a separate /boot partition is used.
442 ext4
) DriverType
="ext4"
444 reiserfs
) DriverType
="reiserfs"
446 btrfs
) DriverType
="btrfs"
448 hfsplus
) DriverType
="hfs"
450 ntfs
) DriverType
="ntfs"
454 if [[ -n $BootFS ]] ; then
455 echo "Installing driver for $BootFS (${DriverType}_$1.efi)"
456 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
457 cp "$ThisDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
458 cp "$RefindDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1"/ 2> /dev
/null
463 # Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
464 # directory on the ESP. Must be passed a suitable architecture code (ia32
467 mkdir
-p "$InstallDir/EFI/tools"
468 if [[ $OSTYPE == darwin
* ]] ; then
469 cp -f "$RefindDir/tools_$1/gptsync_$1.efi" "$InstallDir/EFI/tools/"
470 if [[ -f "$InstallDir/EFI/tools/gptsync.efi" ]] ; then
471 mv "$InstallDir/EFI/tools/gptsync.efi" "$InstallDir/EFI/tools/gptsync.efi-disabled"
472 echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
477 # Copy the rEFInd files to the ESP or OS X root partition.
478 # Sets Problems=1 if any critical commands fail.
480 mkdir
-p "$InstallDir/$TargetDir"
481 if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
482 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" 2> /dev
/null
483 if [[ $?
!= 0 ]] ; then
484 echo "Note: IA32 (x86) binary not installed!"
486 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" 2> /dev
/null
487 if [[ $?
!= 0 ]] ; then
490 if [[ "$ShimSource" != "none" ]] ; then
491 TargetShim
="bootx64.efi"
494 if [[ $InstallDrivers == "all" ]] ; then
495 cp -r "$RefindDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
496 cp -r "$ThisDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
497 elif [[ $Upgrade == 1 ||
$InstallToEspOnMac == 1 ]] ; then
498 if [[ $Platform == 'EFI64' ]] ; then
507 if [[ $Platform == 'EFI64' ]] ; then
509 elif [[ $Platform == 'EFI32' ]] ; then
510 Refind
='bootia32.efi'
513 elif [[ $Platform == 'EFI64' ||
$TargetDir == "/EFI/Microsoft/Boot" ]] ; then
514 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64"
515 if [[ $?
!= 0 ]] ; then
520 Refind
="refind_x64.efi"
522 if [[ "$ShimSource" != "none" ]] ; then
523 if [[ "$TargetShim" == "default" ]] ; then
524 TargetShim
=`basename "$ShimSource"`
528 if [[ $LocalKeys == 0 ]] ; then
529 echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir"
530 mkdir
-p "$EtcKeysDir"
531 cp "$ThisDir/keys/refind.cer" "$EtcKeysDir" 2> /dev
/null
532 cp "$ThisDir/keys/refind.crt" "$EtcKeysDir" 2> /dev
/null
535 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
536 SetupMacHfs
$TargetX64
538 elif [[ $Platform == 'EFI32' ]] ; then
539 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32"
540 if [[ $?
!= 0 ]] ; then
545 Refind
="refind_ia32.efi"
546 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
547 SetupMacHfs
$TargetIA32
550 echo "Unknown platform! Aborting!"
553 echo "Copied rEFInd binary files"
555 if [[ -d "$InstallDir/$TargetDir/icons" ]] ; then
556 rm -rf "$InstallDir/$TargetDir/icons-backup" &> /dev
/null
557 mv -f "$InstallDir/$TargetDir/icons" "$InstallDir/$TargetDir/icons-backup"
558 echo "Notice: Backed up existing icons directory as icons-backup."
560 cp -r "$IconsDir" "$InstallDir/$TargetDir"
561 if [[ $?
!= 0 ]] ; then
564 mkdir
-p "$InstallDir/$TargetDir/keys"
565 cp -rf "$ThisDir"/keys
/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
566 cp -rf "$EtcKeysDir"/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
567 if [[ -f "$InstallDir/$TargetDir/refind.conf" ]] ; then
568 echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
569 echo "to avoid overwriting your customizations."
571 cp -f "$ConfFile" "$InstallDir/$TargetDir"
572 if [[ $?
!= 0 ]] ; then
576 echo "Copying sample configuration file as refind.conf; edit this file to configure"
579 cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf"
580 if [[ $?
!= 0 ]] ; then
584 if [[ $DeleteRefindDir == 1 ]] ; then
585 echo "Deleting the temporary directory $RefindDir"
588 } # CopyRefindFiles()
590 # Mount the partition the user specified with the --usedefault or --ownhfs option
591 MountDefaultTarget
() {
592 InstallDir
=/tmp
/refind_install
593 mkdir
-p "$InstallDir"
595 if [[ $OSTYPE == darwin
* ]] ; then
596 if [[ $OwnHfs == '1' ]] ; then
597 Temp
=`diskutil info "$TargetPart" | grep "Mount Point"`
598 InstallDir
=`echo $Temp | cut -f 3-30 -d ' '`
599 if [[ $InstallDir == '' ]] ; then
600 InstallDir
=/tmp
/refind_install
601 mount
-t hfs
"$TargetPart" "$InstallDir"
606 mount
-t msdos
"$TargetPart" "$InstallDir"
608 elif [[ $OSTYPE == linux-gnu
]] ; then
609 mount
-t vfat
"$TargetPart" "$InstallDir"
611 if [[ $?
!= 0 ]] ; then
612 echo "Couldn't mount $TargetPart ! Aborting!"
616 } # MountDefaultTarget()
619 # A series of OS X support functions....
622 # Mount the ESP at /Volumes/ESP or determine its current mount
624 # Sets InstallDir to the ESP mount point
625 # Sets UnmountEsp if we mounted it
627 # Identify the ESP. Note: This returns the FIRST ESP found;
628 # if the system has multiple disks, this could be wrong!
629 Temp
=$
(mount |
sed -n -E "/^(\/dev\/disk[0-9]+s[0-9]+) on \/ \(.*$/s//\1/p")
631 Temp
=$
(diskutil list |
grep " EFI " |
grep -o 'disk.*' |
head -n 1)
632 if [ -z $Temp ]; then
633 echo "Warning: root device doesn't have an EFI partition"
636 echo "Warning: root device could not be found"
638 if [ -z $Temp ]; then
639 Temp
=$
(diskutil list |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
643 if [ -z $Temp ]; then
644 echo "Could not find an EFI partition. Aborting!"
648 Esp
=/dev
/`echo $Temp`
649 # If the ESP is mounted, use its current mount point....
650 Temp
=`df -P | grep "$Esp "`
651 InstallDir
=`echo $Temp | cut -f 6- -d ' '`
652 if [[ "$InstallDir" == '' ]] ; then
653 mkdir
/Volumes
/ESP
&> /dev
/null
654 mount
-t msdos
"$Esp" /Volumes
/ESP
655 # Some systems have HFS+ "ESPs." They shouldn't, but they do. If this is
656 # detected, mount it as such and set appropriate options.
657 if [[ $?
!= 0 ]] ; then
658 mount
-t hfs
"$Esp" /Volumes
/Esp
661 if [[ $?
!= 0 ]] ; then
662 echo "Unable to mount ESP! Aborting!\n"
667 InstallDir
="/Volumes/ESP"
671 # Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
672 # (http://mjg59.dreamwidth.org/7468.html)
673 # Must be passed the original rEFInd binary filename (without a path).
675 if [[ -s "$InstallDir/mach_kernel" ]] ; then
676 echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
679 cp -n "$InstallDir/$TargetDir/boot.efi" "$InstallDir/$TargetDir/boot.efi-backup" &> /dev
/null
680 ln -f "$InstallDir/$TargetDir/$1" "$InstallDir/$TargetDir/boot.efi"
681 touch "$InstallDir/mach_kernel"
682 rm "$InstallDir/$TargetDir/SystemVersion.plist" &> /dev
/null
683 cat - << ENDOFHERE >> "$InstallDir/$TargetDir/SystemVersion.plist"
684 <xml version="1.0" encoding="UTF-8"?>
685 <plist version="1.0">
687 <key>ProductBuildVersion</key>
689 <key>ProductName</key>
690 <string>rEFInd</string>
691 <key>ProductVersion</key>
692 <string>0.9.2</string>
698 # Control the OS X installation.
699 # Sets Problems=1 if problems found during the installation.
701 echo "Installing rEFInd on OS X...."
702 if [[ "$InstallToEspOnMac" == "1" ]] ; then
704 elif [[ "$TargetDir" == "/EFI/BOOT" ||
"$OwnHfs" == '1' ]] ; then
707 InstallDir
="$RootDir/"
709 echo "Installing rEFInd to the partition mounted at $InstallDir"
711 Platform
=`ioreg -l -p IODeviceTree | grep firmware-abi | cut -d "\"" -f 4`
713 if [[ $InstallToEspOnMac == "1" ]] ; then
714 bless
--mount "$InstallDir" --setBoot --file "$InstallDir/$TargetDir/$Refind" --shortform
715 elif [[ "$TargetDir" != "/EFI/BOOT" ]] ; then
716 bless
--setBoot --folder "$InstallDir/$TargetDir" --file "$InstallDir/$TargetDir/$Refind"
718 if [[ $?
!= 0 ]] ; then
721 if [[ -f /Library
/StartupItems
/rEFItBlesser ||
-d /Library
/StartupItems
/rEFItBlesser
]] ; then
723 echo "/Library/StartupItems/rEFItBlesser found!"
724 echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
725 echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
727 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
728 echo "Deleting /Library/StartupItems/rEFItBlesser..."
729 rm -r /Library
/StartupItems
/rEFItBlesser
731 echo "Not deleting rEFItBlesser."
735 echo "WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the"
736 echo "bless status with 'bless --info', since this is known to cause disk corruption"
737 echo "on some systems!!"
743 # Now a series of Linux support functions....
746 # Check for evidence that we're running in Secure Boot mode. If so, and if
747 # appropriate options haven't been set, warn the user and offer to abort.
748 # If we're NOT in Secure Boot mode but the user HAS specified the --shim
749 # or --localkeys option, warn the user and offer to abort.
752 if [[ -f /sys
/firmware
/efi
/vars
/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c
/data
]] ; then
753 IsSecureBoot
=`od -An -t u1 /sys/firmware/efi/vars/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c/data | tr -d '[[:space:]]'`
757 if [[ $IsSecureBoot == "1" && "$TargetDir" != '/EFI/BOOT' && "$ShimSource" == "none" ]] ; then
759 echo "CAUTION: Your computer appears to be booted with Secure Boot, but you haven't"
760 echo "specified a valid shim.efi file source. Chances are you should re-run with"
761 echo "the --shim option. You can read more about this topic at"
762 echo "http://www.rodsbooks.com/refind/secureboot.html."
764 echo -n "Do you want to proceed with installation (Y/N)? "
766 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
767 echo "OK; continuing with the installation..."
773 if [[ "$ShimSource" != "none" && ! $IsSecureBoot == "1" ]] ; then
775 echo "You've specified installing using a shim.efi file, but your computer does not"
776 echo "appear to be running in Secure Boot mode. Although installing in this way"
777 echo "should work, it's unnecessarily complex. You may continue, but unless you"
778 echo "plan to enable Secure Boot, you should consider stopping and omitting the"
779 echo "--shim option. You can read more about this topic at"
780 echo "http://www.rodsbooks.com/refind/secureboot.html."
782 echo -n "Do you want to proceed with installation (Y/N)? "
784 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
785 echo "OK; continuing with the installation..."
791 if [[ $LocalKeys != 0 && ! $IsSecureBoot == "1" ]] ; then
793 echo "You've specified re-signing your rEFInd binaries with locally-generated keys,"
794 echo "but your computer does not appear to be running in Secure Boot mode. The"
795 echo "keys you generate will be useless unless you enable Secure Boot. You may"
796 echo "proceed with this installation, but before you do so, you may want to read"
797 echo "more about it at http://www.rodsbooks.com/refind/secureboot.html."
799 echo -n "Do you want to proceed with installation (Y/N)? "
801 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
802 echo "OK; continuing with the installation..."
808 } # CheckSecureBoot()
810 # Check for the presence of locally-generated keys from a previous installation in
811 # $EtcKeysDir (/etc/refind.d/keys). If they're not present, generate them using
814 PrivateKey
="$EtcKeysDir/$LocalKeysBase.key"
815 CertKey
="$EtcKeysDir/$LocalKeysBase.crt"
816 DerKey
="$EtcKeysDir/$LocalKeysBase.cer"
817 OpenSSL
=`which openssl 2> /dev/null`
819 # Do the work only if one or more of the necessary keys is missing
820 # TODO: Technically, we don't need the DerKey; but if it's missing and openssl
821 # is also missing, this will fail. This could be improved.
822 if [[ ! -f "$PrivateKey" ||
! -f "$CertKey" ||
! -f "$DerKey" ]] ; then
823 echo "Generating a fresh set of local keys...."
824 mkdir
-p "$EtcKeysDir"
825 chmod 0700 "$EtcKeysDir"
826 if [[ ! -x "$OpenSSL" ]] ; then
827 echo "Can't find openssl, which is required to create your private signing keys!"
831 if [[ -f "$PrivateKey" ]] ; then
832 echo "Backing up existing $PrivateKey"
833 cp -f "$PrivateKey" "$PrivateKey.backup" 2> /dev
/null
835 if [[ -f "$CertKey" ]] ; then
836 echo "Backing up existing $CertKey"
837 cp -f "$CertKey" "$CertKey.backup" 2> /dev
/null
839 if [[ -f "$DerKey" ]] ; then
840 echo "Backing up existing $DerKey"
841 cp -f "$DerKey" "$DerKey.backup" 2> /dev
/null
843 "$OpenSSL" req
-new -x509 -newkey rsa
:2048 -keyout "$PrivateKey" -out "$CertKey" \
844 -nodes -days 3650 -subj "/CN=Locally-generated rEFInd key/"
845 "$OpenSSL" x509
-in "$CertKey" -out "$DerKey" -outform DER
846 chmod 0600 "$PrivateKey"
848 echo "Using existing local keys...."
852 # Sign a single binary. Requires parameters:
854 # $2 = destination file
855 # Also assumes that the SBSign, PESign, UseSBSign, UsePESign, and various key variables are set
857 # Aborts script on error
859 $SBSign --key "$PrivateKey" --cert "$CertKey" --output "$2" "$1"
860 if [[ $?
!= 0 ]] ; then
861 echo "Problem signing the binary $1! Aborting!"
866 # Re-sign the x86-64 binaries with a locally-generated key, First look for appropriate
867 # key files in $EtcKeysDir. If they're present, use them to re-sign the binaries. If
868 # not, try to generate new keys and store them in $EtcKeysDir.
870 SBSign
=`which sbsign 2> /dev/null`
871 echo "Found sbsign at $SBSign"
872 TempDir
="/tmp/refind_local"
873 if [[ ! -x "$SBSign" ]] ; then
874 echo "Can't find sbsign, which is required to sign rEFInd with your own keys!"
879 mkdir
-p "$TempDir/drivers_x64"
880 cp "$RefindDir/refind.conf-sample $TempDir" 2> /dev
/null
881 cp "$ThisDir/refind.conf-sample $TempDir" 2> /dev
/null
882 cp "$RefindDir/refind_ia32.efi $TempDir" 2> /dev
/null
883 cp -a "$RefindDir/drivers_ia32 $TempDir" 2> /dev
/null
884 cp -a "$ThisDir/drivers_ia32 $TempDir" 2> /dev
/null
885 SignOneBinary
"$RefindDir/refind_x64.efi" "$TempDir/refind_x64.efi"
887 IFS
=$
(echo -en "\n\b")
888 for Driver
in `ls "$RefindDir"/drivers_x64/*.efi "$ThisDir"/drivers_x64/*.efi 2> /dev/null` ; do
889 TempName
=`basename "$Driver"`
890 SignOneBinary
"$Driver" "$TempDir/drivers_x64/$TempName"
897 # Locate and mount an ESP, if possible, based on parted output.
898 # Should be called only if /boot/efi is NOT an acceptable ESP.
899 # Sets InstallDir to the mounted ESP's path ($RootDir/boot/efi)
900 # and EspFilesystem the filesystem (always "vfat")
902 echo "The ESP doesn't seem to be mounted! Trying to find it...."
909 for Drive
in `ls /dev/[sh]d?` ; do
911 Dmraid
=`which dmraid 2> /dev/null`
912 if [ -x "$Dmraid" ] ; then
913 DmStatus
=`dmraid -r | grep $Drive`
914 if [ -n "$DmStatus" ] ; then
915 echo "$Drive seems to be part of a RAID array; skipping!"
919 TableType
=`parted $Drive print -m -s 2>/dev/null | awk -F: '$1 == "'$Drive'" { print $6 }'`
920 if [[ $TableType == 'gpt' && $SkipIt == 0 ]] ; then # read only GPT disks that aren't part of dmraid array
921 PartNum
=`LANG=C parted $Drive print -m -s 2>/dev/null | awk -F: '$7 ~ "(^boot| boot)" { print $1 }' | head -n 1`
922 if [ "$PartNum" -eq "$PartNum" ] 2> /dev
/null
; then
923 InstallDir
="$RootDir/boot/efi"
925 mount
$Drive$PartNum $InstallDir
926 EspFilesystem
=`grep "$Drive$PartNum.*/boot/efi" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
927 if [[ $EspFilesystem != 'vfat' ]] ; then
930 echo "Mounting ESP at $InstallDir"
933 fi # $PartNum -eq $PartNum
938 # Identifies the ESP's location (/boot or /boot/efi, or these locations under
939 # the directory specified by --root); aborts if the ESP isn't mounted at
941 # Sets InstallDir to the ESP mount point.
943 mount
/boot
&> /dev
/null
944 mount
/boot
/efi
&> /dev
/null
945 EspLine
=`df "$RootDir/boot/efi" 2> /dev/null | grep boot/efi`
946 if [[ ! -n "$EspLine" ]] ; then
947 EspLine
=`df "$RootDir"/boot | grep boot`
949 InstallDir
=`echo $EspLine | cut -d " " -f 6`
951 if [[ -n "$InstallDir" ]] ; then
952 EspFilesystem
=`grep -w "$InstallDir" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
954 if [[ $EspFilesystem != 'vfat' ]] ; then
957 if [[ $EspFilesystem != 'vfat' ]] ; then
958 echo "$RootDir/$InstallDir doesn't seem to be on a VFAT filesystem. The ESP must be"
959 echo "mounted at $RootDir/boot or $RootDir/boot/efi and it must be VFAT! Aborting!"
962 echo "ESP was found at $InstallDir using $EspFilesystem"
965 # Uses efibootmgr to add an entry for rEFInd to the EFI's NVRAM.
966 # If this fails, sets Problems=1
969 Efibootmgr
=`which efibootmgr 2> /dev/null`
970 if [[ "$Efibootmgr" ]] ; then
971 InstallDisk
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 1-8`
972 PartNum
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 9-10`
973 EntryFilename
="$TargetDir/$Refind"
974 EfiEntryFilename
=`echo ${EntryFilename//\//\\\}`
975 EfiEntryFilename2
=`echo ${EfiEntryFilename} | sed s/\\\\\\\\/\\\\\\\\\\\\\\\\/g`
976 ExistingEntry
=`"$Efibootmgr" -v | grep -i "$EfiEntryFilename2"`
978 if [[ "$ExistingEntry" ]] ; then
979 ExistingEntryBootNum
=`echo "$ExistingEntry" | cut -c 5-8`
980 FirstBoot
=`"$Efibootmgr" | grep BootOrder | cut -c 12-15`
981 if [[ "$ExistingEntryBootNum" != "$FirstBoot" ]] ; then
982 echo "An existing rEFInd boot entry exists, but isn't set as the default boot"
983 echo "manager. The boot order is being adjusted to make rEFInd the default boot"
984 echo "manager. If this is NOT what you want, you should use efibootmgr to"
985 echo "manually adjust your EFI's boot order."
987 "$Efibootmgr" -b $ExistingEntryBootNum -B &> /dev
/null
990 echo "Installing it!"
991 if [[ "$KeepName" == 0 ]] ; then
992 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum &> /dev
/null
994 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum \
995 -u "$TargetShim $TargetX64" &> /dev
/null
997 if [[ $?
!= 0 ]] ; then
1002 else # efibootmgr not found
1003 EfibootmgrProblems
=1
1007 if [[ $EfibootmgrProblems ]] ; then
1009 echo "ALERT: There were problems running the efibootmgr program! You may need to"
1010 echo "rename the $Refind binary to the default name (EFI/boot/bootx64.efi"
1011 echo "on x86-64 systems or EFI/boot/bootia32.efi on x86 systems) to have it run!"
1014 echo "rEFInd has been set as the default boot manager."
1018 # Create a minimal/sample refind_linux.conf file in /boot.
1019 GenerateRefindLinuxConf
() {
1020 if [[ -f "$RLConfFile" ]] ; then
1021 echo "Existing $RLConfFile found; not overwriting."
1023 echo "Creating $RLConfFile; edit it to adjust kernel options."
1024 if [[ -f "$RootDir/etc/default/grub" ]] ; then
1025 # We want the default options used by the distribution, stored here....
1026 source "$RootDir/etc/default/grub"
1027 echo "Setting default boot options based on $RootDir/etc/default/grub"
1029 RootFS
=`df "$RootDir" | grep dev | cut -f 1 -d " "`
1030 StartOfDevname
=`echo "$RootFS" | cut -b 1-7`
1031 if [[ "$StartOfDevname" == "/dev/sd" ||
"$StartOfDevName" == "/dev/hd" ]] ; then
1032 # Identify root filesystem by UUID rather than by device node, if possible
1033 Uuid
=`blkid -o export -s UUID "$RootFS" 2> /dev/null | grep UUID=`
1034 if [[ -n $Uuid ]] ; then
1038 DefaultOptions
="$GRUB_CMDLINE_LINUX $GRUB_CMDLINE_LINUX_DEFAULT"
1039 echo "\"Boot with standard options\" \"ro root=$RootFS $DefaultOptions \"" > $RLConfFile
1040 echo "\"Boot to single-user mode\" \"ro root=$RootFS $DefaultOptions single\"" >> $RLConfFile
1041 echo "\"Boot with minimal options\" \"ro root=$RootFS\"" >> $RLConfFile
1045 # Controls rEFInd installation under Linux.
1046 # Sets Problems=1 if something goes wrong.
1048 if [[ "$TargetDir" == "/System/Library/CoreServices" ]] ; then
1049 echo "You may not use the --ownhfs option under Linux! Aborting!"
1052 echo "Installing rEFInd on Linux...."
1053 modprobe efivars
&> /dev
/null
1054 if [[ $TargetDir == "/EFI/BOOT" ]] ; then
1061 if [[ $CpuType == 'x86_64' ]] ; then
1063 elif [[ ($CpuType == 'i386' ||
$CpuType == 'i486' ||
$CpuType == 'i586' ||
$CpuType == 'i686') ]] ; then
1065 # If we're in EFI mode, do some sanity checks, and alert the user or even
1066 # abort. Not in BIOS mode, though, since that could be used on an emergency
1067 # disc to try to recover a troubled Linux installation.
1068 if [[ -d /sys
/firmware
/efi
]] ; then
1069 if [[ "$ShimSource" != "none" && "$TargetDir" != "/BOOT/EFI" ]] ; then
1071 echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
1072 echo "use the --shim option to install on such systems. Aborting!"
1077 echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
1078 echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
1079 echo "on a 64-bit computer, you should manually install the 64-bit version of"
1080 echo "rEFInd. If you're installing on a Mac, you should do so from OS X. If"
1081 echo "you're positive you want to continue with this installation, answer 'Y'"
1082 echo "to the following question..."
1084 echo -n "Are you sure you want to continue (Y/N)? "
1086 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
1087 echo "OK; continuing with the installation..."
1093 echo "Unknown CPU type '$CpuType'; aborting!"
1097 if [[ $LocalKeys == 1 ]] ; then
1103 if [[ "$TargetDir" != "/EFI/BOOT" && "$TargetDir" != "/EFI/Microsoft/Boot" ]] ; then
1105 GenerateRefindLinuxConf
1107 } # InstallOnLinux()
1110 # The main part of the script. Sets a few environment variables,
1111 # performs a few startup checks, and then calls functions to
1112 # install under OS X or Linux, depending on the detected platform.
1115 ThisDir
="$( cd -P "${BASH_SOURCE%/*}" && pwd )"
1116 RefindDir
="$ThisDir/refind"
1117 if [[ $UID != 0 ]] ; then
1118 echo "Not running as root; attempting to elevate privileges via sudo...."
1119 sudo
"$BASH_SOURCE" "$@"
1120 if [[ $?
!= 0 ]] ; then
1121 echo "This script must be run as root (or using sudo). Exiting!"
1130 if [[ "$ShimSource" != "none" ]] ; then
1131 echo "The --shim option is not supported on OS X! Exiting!"
1134 if [[ "$LocalKeys" != 0 ]] ; then
1135 echo "The --localkeys option is not supported on OS X! Exiting!"
1144 echo "Running on unknown OS; aborting!"
1145 if [[ "$InstallToEspOnMac" == 0 ]] ; then
1146 echo "The --notesp option is not supported on Linux! Exiting!"
1151 if [[ $Problems ]] ; then
1154 echo "Installation has completed, but problems were detected. Review the output for"
1155 echo "error messages and take corrective measures as necessary. You may need to"
1156 echo "re-run this script or install manually before rEFInd will work."
1160 echo "Installation has completed successfully."
1164 if [[ $UnmountEsp == '1' ]] ; then
1165 echo "Unmounting install dir"
1169 if [[ "$InstallDir" == /tmp
/refind_install
]] ; then