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.2 -- Added --keepname option.
40 # 0.8.7 -- Better detection of Secure Boot mode & fixed errors when copying
41 # Shim & MokManager files over themselves; fixed bug that caused
42 # inappropriate installation to EFI/BOOT/bootx64.efi
43 # 0.8.6 -- Fixed bugs that caused misidentification of ESP on disks with
44 # partition numbers over 10 on OS X and misidentification of mount
45 # point if already-mounted ESP had space in path.
46 # 0.8.5 -- Refinement/cleanup of new OS X ESP-as-default policy
47 # 0.8.4 -- OS X default changed to install to ESP under /EFI/BOOT
48 # 0.7.9 -- Fixed bug that caused errors if dmraid utility not installed
49 # 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
50 # to locate and mount ESP on Linux, if it's not mounted
51 # 0.7.6 -- Added --ownhfs {device-filename} option
52 # 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
53 # 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
54 # 0.7.0 -- Added support for the new Btrfs driver
55 # 0.6.12 -- Added support for PreLoader as well as for shim
56 # 0.6.11 -- Improvements in script's ability to handle directories with spaces
58 # 0.6.9 -- Install gptsync on Macs
59 # 0.6.8 -- Bug fix: ESP scan now uses "uniq".
60 # 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
61 # copying shim.efi and MokManager.efi over themselves.
62 # 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
63 # 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
64 # directories & for installing to EFI/BOOT in BIOS mode
65 # 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
66 # 0.6.1 -- Added --root option; minor bug fixes
67 # 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
68 # changed default driver installation behavior in Linux to install
69 # the driver needed to read /boot (if available)
70 # 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
71 # 0.5.1.1 -- Fixed bug that caused script failure under OS X
72 # 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
74 # 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
75 # 0.4.5 -- Fixed check for rEFItBlesser in OS X
76 # 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
77 # 0.4.1 -- Added check for rEFItBlesser in OS X
78 # 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
79 # 0.3.2.1 -- Check for presence of source files; aborts if not present
80 # 0.3.2 -- Initial version
82 # Note: install.sh version numbers match those of the rEFInd package
83 # with which they first appeared.
87 LocalKeysBase
="refind_local"
92 TargetX64
="refind_x64.efi"
93 TargetIA32
="refind_ia32.efi"
99 # Functions used by both OS X and Linux....
104 # Install the driver required to read Linux /boot, if it's available
105 # Note: Under OS X, this will be installed only if a Linux partition
106 # is detected, in which case the ext4fs driver will be installed.
107 InstallDrivers
="boot"
108 while [[ $# -gt 0 ]]; do
110 --notesp) InstallToEspOnMac
=0
115 TargetDir
=/System
/Library
/CoreServices
118 --usedefault) TargetDir
=/EFI
/BOOT
120 TargetX64
="bootx64.efi"
121 TargetIA32
="bootia32.efi"
128 --localkeys) LocalKeys
=1
130 --shim |
--preloader) ShimSource
="$2"
131 ShimType
=`basename $ShimSource`
134 --keepname) KeepName
=1
136 --drivers |
--alldrivers) InstallDrivers
="all"
138 --nodrivers) InstallDrivers
="none"
142 * ) echo "Usage: $0 [--notesp | --usedefault {device-file} | --root {dir} |"
143 echo " --ownhfs {device-file} ] [--keepname]"
144 echo " [--nodrivers | --alldrivers]"
145 echo " [--localkeys] [--keepname] [--yes]"
150 if [[ "$InstallToEspOnMac" == 0 && "$RootDir" == '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
151 echo "You may use --notesp OR --usedefault, but not both! Aborting!"
154 if [[ "$RootDir" != '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
155 echo "You may use --root OR --usedefault, but not both! Aborting!"
158 if [[ "$TargetDir" != '/System/Library/CoreServices' && "$OwnHfs" == '1' ]] ; then
159 echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
162 if [[ "$KeepName" == 1 && "$ShimSource" == "none" ]] ; then
163 echo "The --keepname option is meaningful only in conjunction with --shim"
164 echo "or --preloader! Aborting!"
167 if [[ "$KeepName" == 1 && "$OSTYPE" != "linux-gnu" ]] ; then
168 echo "The --keepname option is valid only under Linux! Aborting!"
171 if [[ "$KeepName" == 1 && "$TargetDir" != "/EFI/BOOT" ]] ; then
172 echo "The --keepname option is incompatible with --usedefault! Aborting!"
175 RLConfFile
="$RootDir/boot/refind_linux.conf"
176 EtcKeysDir
="$RootDir/etc/refind.d/keys"
179 # Get a yes/no response from the user and place it in the YesNo variable.
180 # If the AlwaysYes variable is set to 1, skip the user input and set "Y"
181 # in the YesNo variable.
183 if [[ $AlwaysYes == 1 ]] ; then
191 # Abort if the rEFInd files can't be found.
192 # Also sets $ConfFile to point to the configuration file,
193 # $IconsDir to point to the icons directory, and
194 # $ShimSource to the source of the shim.efi file (if necessary).
196 # Note: This check is satisfied if EITHER the 32- or the 64-bit version
197 # is found, even on the wrong platform. This is because the platform
198 # hasn't yet been determined. This could obviously be improved, but it
199 # would mean restructuring lots more code....
200 if [[ ! -f "$RefindDir/refind_ia32.efi" && ! -f "$RefindDir/refind_x64.efi" ]] ; then
201 echo "The rEFInd binary file is missing! Aborting installation!"
205 if [[ -f "$RefindDir/refind.conf-sample" ]] ; then
206 ConfFile
="$RefindDir/refind.conf-sample"
207 elif [[ -f "$ThisDir/refind.conf-sample" ]] ; then
208 ConfFile
="$ThisDir/refind.conf-sample"
210 echo "The sample configuration file is missing! Aborting installation!"
214 if [[ -d "$RefindDir/icons" ]] ; then
215 IconsDir
="$RefindDir/icons"
216 elif [[ -d "$ThisDir/icons" ]] ; then
217 IconsDir
="$ThisDir/icons"
219 echo "The icons directory is missing! Aborting installation!"
223 echo "ShimSource is $ShimSource"
224 if [[ "$ShimSource" != "none" ]] ; then
225 if [[ -f "$ShimSource" ]] ; then
226 if [[ $ShimType == "shimx64.efi" ||
$ShimType == "shim.efi" ]] ; then
227 TargetX64
="grubx64.efi"
228 MokManagerSource
=`dirname "$ShimSource"`/MokManager.efi
229 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
230 TargetX64
="loader.efi"
231 MokManagerSource
=`dirname "$ShimSource"`/HashTool.efi
233 echo "Unknown shim/PreBootloader filename: $ShimType!"
234 echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
238 echo "The specified shim/PreBootloader file, $ShimSource, doesn't exist!"
239 echo "Aborting installation!"
245 # Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
246 # available) to target.
248 local inode1
=`ls -i "$ShimSource" 2> /dev/null | cut -f 1 -d " "`
249 local inode2
=`ls -i "$InstallDir/$TargetDir/$TargetShim" 2> /dev/null | cut -f 1 -d " "`
250 if [[ $inode1 != $inode2 ]] ; then
251 cp -fb "$ShimSource" "$InstallDir/$TargetDir/$TargetShim"
252 if [[ $?
!= 0 ]] ; then
256 inode1
=`ls -i "$MokManagerSource" 2> /dev/null | cut -f 1 -d " "`
257 local TargetMMName
=`basename $MokManagerSource`
258 inode2
=`ls -i "$InstallDir/$TargetDir/$TargetMMName" 2> /dev/null | cut -f 1 -d " "`
259 if [[ $inode1 != $inode2 ]] ; then
260 if [[ -f "$MokManagerSource" ]] ; then
261 cp -fb "$MokManagerSource" "$InstallDir/$TargetDir/"
263 if [[ $?
!= 0 ]] ; then
269 # Copy the public keys to the installation medium
271 if [[ $LocalKeys == 1 ]] ; then
272 mkdir
-p "$InstallDir/$TargetDir/keys/"
273 cp "$EtcKeysDir/$LocalKeysBase.cer" "$InstallDir/$TargetDir/keys/"
274 cp "$EtcKeysDir/$LocalKeysBase.crt" "$InstallDir/$TargetDir/keys/"
278 # Set varaibles for installation in EFI/BOOT directory
280 TargetDir
="/EFI/BOOT"
281 if [[ $ShimSource == "none" ]] ; then
282 TargetX64
="bootx64.efi"
283 TargetIA32
="bootia32.efi"
285 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
286 TargetX64
="grubx64.efi"
287 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
288 TargetX64
="loader.efi"
290 echo "Unknown shim/PreBootloader type: $ShimType"
294 TargetIA32
="bootia32.efi"
295 TargetShim
="bootx64.efi"
297 if [[ $KeepName == 1 ]] ; then
298 echo "Installation is to /EFI/BOOT, which is incompatible with --keepname! Aborting!"
303 # Set variables for installation in EFI/Microsoft/Boot directory
305 TargetDir
="/EFI/Microsoft/Boot"
306 if [[ $ShimSource == "none" ]] ; then
307 TargetX64
="bootmgfw.efi"
308 TargetIA32
="bootmgfw.efi"
310 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
311 TargetX64
="grubx64.efi"
312 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
313 TargetX64
="loader.efi"
315 echo "Unknown shim/PreBootloader type: $ShimType"
319 TargetShim
="bootmgfw.efi"
321 if [[ $KeepName == 1 ]] ; then
322 echo "Installation is to /EFI/Microsoft/Boot, which is incompatible with --keepname!"
326 } # SetVarsForMsBoot()
328 # TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
329 # - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
330 # install to that directory under the suitable name; but DO NOT do this if
331 # refind.conf is also in /EFI/refind.
332 # - If booted in BIOS mode and the ESP lacks any other EFI files, install to
334 # - If booted in BIOS mode and there's no refind.conf file and there is a
335 # /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
336 # install under that name, "hijacking" the Windows boot loader filename
337 DetermineTargetDir
() {
340 if [[ -f $InstallDir/EFI
/BOOT
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
344 if [[ -f $InstallDir/EFI
/Microsoft
/Boot
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
348 if [[ -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
349 TargetDir
="/EFI/refind"
350 if [[ $ShimSource == "none" ||
$KeepName == 1 ]] ; then
351 TargetX64
="refind_x64.efi"
352 TargetIA32
="refind_ia32.efi"
356 if [[ $Upgrade == 1 ]] ; then
357 echo "Found rEFInd installation in $InstallDir$TargetDir; upgrading it."
360 if [[ ! -d /sys
/firmware
/efi
&& ! $OSTYPE == darwin
* && $Upgrade == 0 ]] ; then # BIOS-mode
361 FoundEfiFiles
=`find "$InstallDir/EFI/BOOT" -name "*.efi" 2> /dev/null`
362 FoundConfFiles
=`find "$InstallDir" -name "refind\.conf" 2> /dev/null`
363 if [[ ! -n "$FoundConfFiles" && -f "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
364 mv -n "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" "$InstallDir/EFI/Microsoft" &> /dev
/null
366 echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
367 echo "files so as to install to $InstallDir$TargetDir."
368 elif [[ ! -n "$FoundEfiFiles" ]] ; then # In BIOS mode and no default loader; install as default loader
370 echo "Running in BIOS mode with no existing default boot loader; installing to"
371 echo $InstallDir$TargetDir
373 echo "Running in BIOS mode with an existing default boot loader; backing it up and"
374 echo "installing rEFInd in its place."
375 if [[ -d "$InstallDir/EFI/BOOT-rEFIndBackup" ]] ; then
377 echo "Caution: An existing backup of a default boot loader exists! If the current"
378 echo "default boot loader and the backup are different boot loaders, the current"
379 echo "one will become inaccessible."
381 echo -n "Do you want to proceed with installation (Y/N)? "
383 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
384 echo "OK; continuing with the installation..."
389 mv -n "$InstallDir/EFI/BOOT" "$InstallDir/EFI/BOOT-rEFIndBackup"
393 } # DetermineTargetDir()
395 # Determine (or guess) the filesystem used on the Linux /boot filesystem.
396 # Store the result in the BootFS global variable.
403 if command -v blkid
2>/dev
/null
; then
404 BootPart
=`df /boot | grep dev | cut -f 1 -d " "`
405 BootFS
=`blkid -o export $BootPart 2> /dev/null | grep TYPE= | cut -f 2 -d =`
409 # 0FC63DAF-8483-4772-8E79-3D69D8477DE4 = Linux filesystem
410 # BC13C2FF-59E6-4262-A352-B275FD6F7172 = Freedesktop $boot partition
411 # 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 = Freedesktop Linux /home
412 # E6D6D379-F507-44C2-A23C-238F2A3DF928 = Linux LVM
413 # A19D880F-05FC-4D3B-A006-743F0F84911E = Linux RAID
414 # 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F = Linux swap
415 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')
417 if [[ -n $Temp ]] ; then
418 echo "Found suspected Linux partition(s); installing ext4fs driver."
425 # Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
426 # honoring the $InstallDrivers condition. Must be passed a suitable
427 # architecture code (ia32 or x64).
429 if [[ $InstallDrivers == "all" ]] ; then
430 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
431 cp "$ThisDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
432 cp "$RefindDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
433 elif [[ "$InstallDrivers" == "boot" ]] ; then
437 ext2 | ext3
) DriverType
="ext2"
438 # Could use ext4, but that can create unwanted entries from symbolic
439 # links in / to /boot/vmlinuz if a separate /boot partition is used.
441 ext4
) DriverType
="ext4"
443 reiserfs
) DriverType
="reiserfs"
445 btrfs
) DriverType
="btrfs"
447 hfsplus
) DriverType
="hfs"
449 ntfs
) DriverType
="ntfs"
453 if [[ -n $BootFS ]] ; then
454 echo "Installing driver for $BootFS (${DriverType}_$1.efi)"
455 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
456 cp "$ThisDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
457 cp "$RefindDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1"/ 2> /dev
/null
462 # Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
463 # directory on the ESP. Must be passed a suitable architecture code (ia32
466 mkdir
-p "$InstallDir/EFI/tools"
467 if [[ $OSTYPE == darwin
* ]] ; then
468 cp -f "$RefindDir/tools_$1/gptsync_$1.efi" "$InstallDir/EFI/tools/"
469 if [[ -f "$InstallDir/EFI/tools/gptsync.efi" ]] ; then
470 mv "$InstallDir/EFI/tools/gptsync.efi" "$InstallDir/EFI/tools/gptsync.efi-disabled"
471 echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
476 # Copy the rEFInd files to the ESP or OS X root partition.
477 # Sets Problems=1 if any critical commands fail.
479 mkdir
-p "$InstallDir/$TargetDir"
480 if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
481 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" 2> /dev
/null
482 if [[ $?
!= 0 ]] ; then
483 echo "Note: IA32 (x86) binary not installed!"
485 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" 2> /dev
/null
486 if [[ $?
!= 0 ]] ; then
489 if [[ "$ShimSource" != "none" ]] ; then
490 TargetShim
="bootx64.efi"
493 if [[ $InstallDrivers == "all" ]] ; then
494 cp -r "$RefindDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
495 cp -r "$ThisDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
496 elif [[ $Upgrade == 1 ||
$InstallToEspOnMac == 1 ]] ; then
497 if [[ $Platform == 'EFI64' ]] ; then
506 if [[ $Platform == 'EFI64' ]] ; then
508 elif [[ $Platform == 'EFI32' ]] ; then
509 Refind
='bootia32.efi'
512 elif [[ $Platform == 'EFI64' ||
$TargetDir == "/EFI/Microsoft/Boot" ]] ; then
513 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64"
514 if [[ $?
!= 0 ]] ; then
519 Refind
="refind_x64.efi"
521 if [[ "$ShimSource" != "none" ]] ; then
522 if [[ "$TargetShim" == "default" ]] ; then
523 TargetShim
=`basename "$ShimSource"`
527 if [[ $LocalKeys == 0 ]] ; then
528 echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir"
529 mkdir
-p "$EtcKeysDir"
530 cp "$ThisDir/keys/refind.cer" "$EtcKeysDir" 2> /dev
/null
531 cp "$ThisDir/keys/refind.crt" "$EtcKeysDir" 2> /dev
/null
534 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
535 SetupMacHfs
$TargetX64
537 elif [[ $Platform == 'EFI32' ]] ; then
538 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32"
539 if [[ $?
!= 0 ]] ; then
544 Refind
="refind_ia32.efi"
545 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
546 SetupMacHfs
$TargetIA32
549 echo "Unknown platform! Aborting!"
552 echo "Copied rEFInd binary files"
554 if [[ -d "$InstallDir/$TargetDir/icons" ]] ; then
555 rm -rf "$InstallDir/$TargetDir/icons-backup" &> /dev
/null
556 mv -f "$InstallDir/$TargetDir/icons" "$InstallDir/$TargetDir/icons-backup"
557 echo "Notice: Backed up existing icons directory as icons-backup."
559 cp -r "$IconsDir" "$InstallDir/$TargetDir"
560 if [[ $?
!= 0 ]] ; then
563 mkdir
-p "$InstallDir/$TargetDir/keys"
564 cp -rf "$ThisDir"/keys
/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
565 cp -rf "$EtcKeysDir"/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
566 if [[ -f "$InstallDir/$TargetDir/refind.conf" ]] ; then
567 echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
568 echo "to avoid overwriting your customizations."
570 cp -f "$ConfFile" "$InstallDir/$TargetDir"
571 if [[ $?
!= 0 ]] ; then
575 echo "Copying sample configuration file as refind.conf; edit this file to configure"
578 cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf"
579 if [[ $?
!= 0 ]] ; then
583 if [[ $DeleteRefindDir == 1 ]] ; then
584 echo "Deleting the temporary directory $RefindDir"
587 } # CopyRefindFiles()
589 # Mount the partition the user specified with the --usedefault or --ownhfs option
590 MountDefaultTarget
() {
591 InstallDir
=/tmp
/refind_install
592 mkdir
-p "$InstallDir"
594 if [[ $OSTYPE == darwin
* ]] ; then
595 if [[ $OwnHfs == '1' ]] ; then
596 Temp
=`diskutil info "$TargetPart" | grep "Mount Point"`
597 InstallDir
=`echo $Temp | cut -f 3-30 -d ' '`
598 if [[ $InstallDir == '' ]] ; then
599 InstallDir
=/tmp
/refind_install
600 mount
-t hfs
"$TargetPart" "$InstallDir"
605 mount
-t msdos
"$TargetPart" "$InstallDir"
607 elif [[ $OSTYPE == linux-gnu
]] ; then
608 mount
-t vfat
"$TargetPart" "$InstallDir"
610 if [[ $?
!= 0 ]] ; then
611 echo "Couldn't mount $TargetPart ! Aborting!"
615 } # MountDefaultTarget()
618 # A series of OS X support functions....
621 # Mount the ESP at /Volumes/ESP or determine its current mount
623 # Sets InstallDir to the ESP mount point
624 # Sets UnmountEsp if we mounted it
626 # Identify the ESP. Note: This returns the FIRST ESP found;
627 # if the system has multiple disks, this could be wrong!
628 Temp
=$
(mount |
sed -n -E "/^(\/dev\/disk[0-9]+s[0-9]+) on \/ \(.*$/s//\1/p")
630 Temp
=$
(diskutil list |
grep " EFI " |
grep -o 'disk.*' |
head -n 1)
631 if [ -z $Temp ]; then
632 echo "Warning: root device doesn't have an EFI partition"
635 echo "Warning: root device could not be found"
637 if [ -z $Temp ]; then
638 Temp
=$
(diskutil list |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
642 if [ -z $Temp ]; then
643 echo "Could not find an EFI partition. Aborting!"
647 Esp
=/dev
/`echo $Temp`
648 # If the ESP is mounted, use its current mount point....
649 Temp
=`df -P | grep "$Esp "`
650 InstallDir
=`echo $Temp | cut -f 6- -d ' '`
651 if [[ "$InstallDir" == '' ]] ; then
652 mkdir
/Volumes
/ESP
&> /dev
/null
653 mount
-t msdos
"$Esp" /Volumes
/ESP
654 # Some systems have HFS+ "ESPs." They shouldn't, but they do. If this is
655 # detected, mount it as such and set appropriate options.
656 if [[ $?
!= 0 ]] ; then
657 mount
-t hfs
"$Esp" /Volumes
/Esp
660 if [[ $?
!= 0 ]] ; then
661 echo "Unable to mount ESP! Aborting!\n"
666 InstallDir
="/Volumes/ESP"
670 # Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
671 # (http://mjg59.dreamwidth.org/7468.html)
672 # Must be passed the original rEFInd binary filename (without a path).
674 if [[ -s "$InstallDir/mach_kernel" ]] ; then
675 echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
678 cp -n "$InstallDir/$TargetDir/boot.efi" "$InstallDir/$TargetDir/boot.efi-backup" &> /dev
/null
679 ln -f "$InstallDir/$TargetDir/$1" "$InstallDir/$TargetDir/boot.efi"
680 touch "$InstallDir/mach_kernel"
681 rm "$InstallDir/$TargetDir/SystemVersion.plist" &> /dev
/null
682 cat - << ENDOFHERE >> "$InstallDir/$TargetDir/SystemVersion.plist"
683 <xml version="1.0" encoding="UTF-8"?>
684 <plist version="1.0">
686 <key>ProductBuildVersion</key>
688 <key>ProductName</key>
689 <string>rEFInd</string>
690 <key>ProductVersion</key>
691 <string>0.9.2</string>
697 # Control the OS X installation.
698 # Sets Problems=1 if problems found during the installation.
700 echo "Installing rEFInd on OS X...."
701 if [[ "$InstallToEspOnMac" == "1" ]] ; then
703 elif [[ "$TargetDir" == "/EFI/BOOT" ||
"$OwnHfs" == '1' ]] ; then
706 InstallDir
="$RootDir/"
708 echo "Installing rEFInd to the partition mounted at $InstallDir"
710 Platform
=`ioreg -l -p IODeviceTree | grep firmware-abi | cut -d "\"" -f 4`
712 if [[ $InstallToEspOnMac == "1" ]] ; then
713 bless
--mount "$InstallDir" --setBoot --file "$InstallDir/$TargetDir/$Refind" --shortform
714 elif [[ "$TargetDir" != "/EFI/BOOT" ]] ; then
715 bless
--setBoot --folder "$InstallDir/$TargetDir" --file "$InstallDir/$TargetDir/$Refind"
717 if [[ $?
!= 0 ]] ; then
720 if [[ -f /Library
/StartupItems
/rEFItBlesser ||
-d /Library
/StartupItems
/rEFItBlesser
]] ; then
722 echo "/Library/StartupItems/rEFItBlesser found!"
723 echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
724 echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
726 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
727 echo "Deleting /Library/StartupItems/rEFItBlesser..."
728 rm -r /Library
/StartupItems
/rEFItBlesser
730 echo "Not deleting rEFItBlesser."
734 echo "WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the"
735 echo "bless status with 'bless --info', since this is known to cause disk corruption"
736 echo "on some systems!!"
742 # Now a series of Linux support functions....
745 # Check for evidence that we're running in Secure Boot mode. If so, and if
746 # appropriate options haven't been set, warn the user and offer to abort.
747 # If we're NOT in Secure Boot mode but the user HAS specified the --shim
748 # or --localkeys option, warn the user and offer to abort.
751 if [[ -f /sys
/firmware
/efi
/vars
/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c
/data
]] ; then
752 IsSecureBoot
=`od -An -t u1 /sys/firmware/efi/vars/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c/data | tr -d '[[:space:]]'`
756 if [[ $IsSecureBoot == "1" && "$TargetDir" != '/EFI/BOOT' && "$ShimSource" == "none" ]] ; then
758 echo "CAUTION: Your computer appears to be booted with Secure Boot, but you haven't"
759 echo "specified a valid shim.efi file source. Chances are you should re-run with"
760 echo "the --shim option. You can read more about this topic at"
761 echo "http://www.rodsbooks.com/refind/secureboot.html."
763 echo -n "Do you want to proceed with installation (Y/N)? "
765 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
766 echo "OK; continuing with the installation..."
772 if [[ "$ShimSource" != "none" && ! $IsSecureBoot == "1" ]] ; then
774 echo "You've specified installing using a shim.efi file, but your computer does not"
775 echo "appear to be running in Secure Boot mode. Although installing in this way"
776 echo "should work, it's unnecessarily complex. You may continue, but unless you"
777 echo "plan to enable Secure Boot, you should consider stopping and omitting the"
778 echo "--shim option. You can read more about this topic at"
779 echo "http://www.rodsbooks.com/refind/secureboot.html."
781 echo -n "Do you want to proceed with installation (Y/N)? "
783 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
784 echo "OK; continuing with the installation..."
790 if [[ $LocalKeys != 0 && ! $IsSecureBoot == "1" ]] ; then
792 echo "You've specified re-signing your rEFInd binaries with locally-generated keys,"
793 echo "but your computer does not appear to be running in Secure Boot mode. The"
794 echo "keys you generate will be useless unless you enable Secure Boot. You may"
795 echo "proceed with this installation, but before you do so, you may want to read"
796 echo "more about it at http://www.rodsbooks.com/refind/secureboot.html."
798 echo -n "Do you want to proceed with installation (Y/N)? "
800 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
801 echo "OK; continuing with the installation..."
807 } # CheckSecureBoot()
809 # Check for the presence of locally-generated keys from a previous installation in
810 # $EtcKeysDir (/etc/refind.d/keys). If they're not present, generate them using
813 PrivateKey
="$EtcKeysDir/$LocalKeysBase.key"
814 CertKey
="$EtcKeysDir/$LocalKeysBase.crt"
815 DerKey
="$EtcKeysDir/$LocalKeysBase.cer"
816 OpenSSL
=`which openssl 2> /dev/null`
818 # Do the work only if one or more of the necessary keys is missing
819 # TODO: Technically, we don't need the DerKey; but if it's missing and openssl
820 # is also missing, this will fail. This could be improved.
821 if [[ ! -f "$PrivateKey" ||
! -f "$CertKey" ||
! -f "$DerKey" ]] ; then
822 echo "Generating a fresh set of local keys...."
823 mkdir
-p "$EtcKeysDir"
824 chmod 0700 "$EtcKeysDir"
825 if [[ ! -x "$OpenSSL" ]] ; then
826 echo "Can't find openssl, which is required to create your private signing keys!"
830 if [[ -f "$PrivateKey" ]] ; then
831 echo "Backing up existing $PrivateKey"
832 cp -f "$PrivateKey" "$PrivateKey.backup" 2> /dev
/null
834 if [[ -f "$CertKey" ]] ; then
835 echo "Backing up existing $CertKey"
836 cp -f "$CertKey" "$CertKey.backup" 2> /dev
/null
838 if [[ -f "$DerKey" ]] ; then
839 echo "Backing up existing $DerKey"
840 cp -f "$DerKey" "$DerKey.backup" 2> /dev
/null
842 "$OpenSSL" req
-new -x509 -newkey rsa
:2048 -keyout "$PrivateKey" -out "$CertKey" \
843 -nodes -days 3650 -subj "/CN=Locally-generated rEFInd key/"
844 "$OpenSSL" x509
-in "$CertKey" -out "$DerKey" -outform DER
845 chmod 0600 "$PrivateKey"
847 echo "Using existing local keys...."
851 # Sign a single binary. Requires parameters:
853 # $2 = destination file
854 # Also assumes that the SBSign, PESign, UseSBSign, UsePESign, and various key variables are set
856 # Aborts script on error
858 $SBSign --key "$PrivateKey" --cert "$CertKey" --output "$2" "$1"
859 if [[ $?
!= 0 ]] ; then
860 echo "Problem signing the binary $1! Aborting!"
865 # Re-sign the x86-64 binaries with a locally-generated key, First look for appropriate
866 # key files in $EtcKeysDir. If they're present, use them to re-sign the binaries. If
867 # not, try to generate new keys and store them in $EtcKeysDir.
869 SBSign
=`which sbsign 2> /dev/null`
870 echo "Found sbsign at $SBSign"
871 TempDir
="/tmp/refind_local"
872 if [[ ! -x "$SBSign" ]] ; then
873 echo "Can't find sbsign, which is required to sign rEFInd with your own keys!"
878 mkdir
-p "$TempDir/drivers_x64"
879 cp "$RefindDir/refind.conf-sample $TempDir" 2> /dev
/null
880 cp "$ThisDir/refind.conf-sample $TempDir" 2> /dev
/null
881 cp "$RefindDir/refind_ia32.efi $TempDir" 2> /dev
/null
882 cp -a "$RefindDir/drivers_ia32 $TempDir" 2> /dev
/null
883 cp -a "$ThisDir/drivers_ia32 $TempDir" 2> /dev
/null
884 SignOneBinary
"$RefindDir/refind_x64.efi" "$TempDir/refind_x64.efi"
886 IFS
=$
(echo -en "\n\b")
887 for Driver
in `ls "$RefindDir"/drivers_x64/*.efi "$ThisDir"/drivers_x64/*.efi 2> /dev/null` ; do
888 TempName
=`basename "$Driver"`
889 SignOneBinary
"$Driver" "$TempDir/drivers_x64/$TempName"
896 # Locate and mount an ESP, if possible, based on parted output.
897 # Should be called only if /boot/efi is NOT an acceptable ESP.
898 # Sets InstallDir to the mounted ESP's path ($RootDir/boot/efi)
899 # and EspFilesystem the filesystem (always "vfat")
901 echo "The ESP doesn't seem to be mounted! Trying to find it...."
908 for Drive
in `ls /dev/[sh]d?` ; do
910 Dmraid
=`which dmraid 2> /dev/null`
911 if [ -x "$Dmraid" ] ; then
912 DmStatus
=`dmraid -r | grep $Drive`
913 if [ -n "$DmStatus" ] ; then
914 echo "$Drive seems to be part of a RAID array; skipping!"
918 TableType
=`parted $Drive print -m -s 2>/dev/null | awk -F: '$1 == "'$Drive'" { print $6 }'`
919 if [[ $TableType == 'gpt' && $SkipIt == 0 ]] ; then # read only GPT disks that aren't part of dmraid array
920 PartNum
=`LANG=C parted $Drive print -m -s 2>/dev/null | awk -F: '$7 ~ "(^boot| boot)" { print $1 }' | head -n 1`
921 if [ "$PartNum" -eq "$PartNum" ] 2> /dev
/null
; then
922 InstallDir
="$RootDir/boot/efi"
924 mount
$Drive$PartNum $InstallDir
925 EspFilesystem
=`grep "$Drive$PartNum.*/boot/efi" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
926 if [[ $EspFilesystem != 'vfat' ]] ; then
929 echo "Mounting ESP at $InstallDir"
932 fi # $PartNum -eq $PartNum
937 # Identifies the ESP's location (/boot or /boot/efi, or these locations under
938 # the directory specified by --root); aborts if the ESP isn't mounted at
940 # Sets InstallDir to the ESP mount point.
942 mount
/boot
&> /dev
/null
943 mount
/boot
/efi
&> /dev
/null
944 EspLine
=`df "$RootDir/boot/efi" 2> /dev/null | grep boot/efi`
945 if [[ ! -n "$EspLine" ]] ; then
946 EspLine
=`df "$RootDir"/boot | grep boot`
948 InstallDir
=`echo $EspLine | cut -d " " -f 6`
950 if [[ -n "$InstallDir" ]] ; then
951 EspFilesystem
=`grep -w "$InstallDir" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
953 if [[ $EspFilesystem != 'vfat' ]] ; then
956 if [[ $EspFilesystem != 'vfat' ]] ; then
957 echo "$RootDir/$InstallDir doesn't seem to be on a VFAT filesystem. The ESP must be"
958 echo "mounted at $RootDir/boot or $RootDir/boot/efi and it must be VFAT! Aborting!"
961 echo "ESP was found at $InstallDir using $EspFilesystem"
964 # Uses efibootmgr to add an entry for rEFInd to the EFI's NVRAM.
965 # If this fails, sets Problems=1
968 Efibootmgr
=`which efibootmgr 2> /dev/null`
969 if [[ "$Efibootmgr" ]] ; then
970 InstallDisk
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 1-8`
971 PartNum
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 9-10`
972 EntryFilename
="$TargetDir/$Refind"
973 EfiEntryFilename
=`echo ${EntryFilename//\//\\\}`
974 EfiEntryFilename2
=`echo ${EfiEntryFilename} | sed s/\\\\\\\\/\\\\\\\\\\\\\\\\/g`
975 ExistingEntry
=`"$Efibootmgr" -v | grep -i "$EfiEntryFilename2"`
977 if [[ "$ExistingEntry" ]] ; then
978 ExistingEntryBootNum
=`echo "$ExistingEntry" | cut -c 5-8`
979 FirstBoot
=`"$Efibootmgr" | grep BootOrder | cut -c 12-15`
980 if [[ "$ExistingEntryBootNum" != "$FirstBoot" ]] ; then
981 echo "An existing rEFInd boot entry exists, but isn't set as the default boot"
982 echo "manager. The boot order is being adjusted to make rEFInd the default boot"
983 echo "manager. If this is NOT what you want, you should use efibootmgr to"
984 echo "manually adjust your EFI's boot order."
986 "$Efibootmgr" -b $ExistingEntryBootNum -B &> /dev
/null
989 echo "Installing it!"
990 if [[ "$KeepName" == 0 ]] ; then
991 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum &> /dev
/null
993 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum \
994 -u "$TargetShim $TargetX64" &> /dev
/null
996 if [[ $?
!= 0 ]] ; then
1001 else # efibootmgr not found
1002 EfibootmgrProblems
=1
1006 if [[ $EfibootmgrProblems ]] ; then
1008 echo "ALERT: There were problems running the efibootmgr program! You may need to"
1009 echo "rename the $Refind binary to the default name (EFI/boot/bootx64.efi"
1010 echo "on x86-64 systems or EFI/boot/bootia32.efi on x86 systems) to have it run!"
1013 echo "rEFInd has been set as the default boot manager."
1017 # Create a minimal/sample refind_linux.conf file in /boot.
1018 GenerateRefindLinuxConf
() {
1019 if [[ -f "$RLConfFile" ]] ; then
1020 echo "Existing $RLConfFile found; not overwriting."
1022 echo "Creating $RLConfFile; edit it to adjust kernel options."
1023 if [[ -f "$RootDir/etc/default/grub" ]] ; then
1024 # We want the default options used by the distribution, stored here....
1025 source "$RootDir/etc/default/grub"
1026 echo "Setting default boot options based on $RootDir/etc/default/grub"
1028 RootFS
=`df "$RootDir" | grep dev | cut -f 1 -d " "`
1029 StartOfDevname
=`echo "$RootFS" | cut -b 1-7`
1030 if [[ "$StartOfDevname" == "/dev/sd" ||
"$StartOfDevName" == "/dev/hd" ]] ; then
1031 # Identify root filesystem by UUID rather than by device node, if possible
1032 Uuid
=`blkid -o export -s UUID "$RootFS" 2> /dev/null | grep UUID=`
1033 if [[ -n $Uuid ]] ; then
1037 DefaultOptions
="$GRUB_CMDLINE_LINUX $GRUB_CMDLINE_LINUX_DEFAULT"
1038 echo "\"Boot with standard options\" \"ro root=$RootFS $DefaultOptions \"" > $RLConfFile
1039 echo "\"Boot to single-user mode\" \"ro root=$RootFS $DefaultOptions single\"" >> $RLConfFile
1040 echo "\"Boot with minimal options\" \"ro root=$RootFS\"" >> $RLConfFile
1044 # Controls rEFInd installation under Linux.
1045 # Sets Problems=1 if something goes wrong.
1047 if [[ "$TargetDir" == "/System/Library/CoreServices" ]] ; then
1048 echo "You may not use the --ownhfs option under Linux! Aborting!"
1051 echo "Installing rEFInd on Linux...."
1052 modprobe efivars
&> /dev
/null
1053 if [[ $TargetDir == "/EFI/BOOT" ]] ; then
1060 if [[ $CpuType == 'x86_64' ]] ; then
1062 elif [[ ($CpuType == 'i386' ||
$CpuType == 'i486' ||
$CpuType == 'i586' ||
$CpuType == 'i686') ]] ; then
1064 # If we're in EFI mode, do some sanity checks, and alert the user or even
1065 # abort. Not in BIOS mode, though, since that could be used on an emergency
1066 # disc to try to recover a troubled Linux installation.
1067 if [[ -d /sys
/firmware
/efi
]] ; then
1068 if [[ "$ShimSource" != "none" && "$TargetDir" != "/BOOT/EFI" ]] ; then
1070 echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
1071 echo "use the --shim option to install on such systems. Aborting!"
1076 echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
1077 echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
1078 echo "on a 64-bit computer, you should manually install the 64-bit version of"
1079 echo "rEFInd. If you're installing on a Mac, you should do so from OS X. If"
1080 echo "you're positive you want to continue with this installation, answer 'Y'"
1081 echo "to the following question..."
1083 echo -n "Are you sure you want to continue (Y/N)? "
1085 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
1086 echo "OK; continuing with the installation..."
1092 echo "Unknown CPU type '$CpuType'; aborting!"
1096 if [[ $LocalKeys == 1 ]] ; then
1102 if [[ "$TargetDir" != "/EFI/BOOT" && "$TargetDir" != "/EFI/Microsoft/Boot" ]] ; then
1104 GenerateRefindLinuxConf
1106 } # InstallOnLinux()
1109 # The main part of the script. Sets a few environment variables,
1110 # performs a few startup checks, and then calls functions to
1111 # install under OS X or Linux, depending on the detected platform.
1114 ThisDir
="$( cd -P "${BASH_SOURCE%/*}" && pwd )"
1115 RefindDir
="$ThisDir/refind"
1116 if [[ $UID != 0 ]] ; then
1117 echo "Not running as root; attempting to elevate privileges via sudo...."
1118 sudo
"$BASH_SOURCE" "$@"
1119 if [[ $?
!= 0 ]] ; then
1120 echo "This script must be run as root (or using sudo). Exiting!"
1129 if [[ "$ShimSource" != "none" ]] ; then
1130 echo "The --shim option is not supported on OS X! Exiting!"
1133 if [[ "$LocalKeys" != 0 ]] ; then
1134 echo "The --localkeys option is not supported on OS X! Exiting!"
1143 echo "Running on unknown OS; aborting!"
1144 if [[ "$InstallToEspOnMac" == 0 ]] ; then
1145 echo "The --notesp option is not supported on Linux! Exiting!"
1150 if [[ $Problems ]] ; then
1153 echo "Installation has completed, but problems were detected. Review the output for"
1154 echo "error messages and take corrective measures as necessary. You may need to"
1155 echo "re-run this script or install manually before rEFInd will work."
1159 echo "Installation has completed successfully."
1163 if [[ $UnmountEsp == '1' ]] ; then
1164 echo "Unmounting install dir"
1168 if [[ "$InstallDir" == /tmp
/refind_install
]] ; then