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 # "--yes" to assume a "yes" response to all prompts
27 # The "esp" option is valid only on Mac OS X; it causes
28 # installation to the EFI System Partition (ESP) rather than
29 # to the current OS X boot partition. Under Linux, this script
30 # installs to the ESP by default.
32 # This program is copyright (c) 2012-2015 by Roderick W. Smith
33 # It is released under the terms of the GNU GPL, version 3,
34 # a copy of which should be included in the file COPYING.txt.
38 # 0.8.7 -- Better detection of Secure Boot mode & fixed errors when copying
39 # Shim & MokManager files over themselves; fixed bug that caused
40 # inappropriate installation to EFI/BOOT/bootx64.efi
41 # 0.8.6 -- Fixed bugs that caused misidentification of ESP on disks with
42 # partition numbers over 10 on OS X and misidentification of mount
43 # point if already-mounted ESP had space in path.
44 # 0.8.5 -- Refinement/cleanup of new OS X ESP-as-default policy
45 # 0.8.4 -- OS X default changed to install to ESP under /EFI/BOOT
46 # 0.7.9 -- Fixed bug that caused errors if dmraid utility not installed
47 # 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
48 # to locate and mount ESP on Linux, if it's not mounted
49 # 0.7.6 -- Added --ownhfs {device-filename} option
50 # 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
51 # 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
52 # 0.7.0 -- Added support for the new Btrfs driver
53 # 0.6.12 -- Added support for PreLoader as well as for shim
54 # 0.6.11 -- Improvements in script's ability to handle directories with spaces
56 # 0.6.9 -- Install gptsync on Macs
57 # 0.6.8 -- Bug fix: ESP scan now uses "uniq".
58 # 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
59 # copying shim.efi and MokManager.efi over themselves.
60 # 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
61 # 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
62 # directories & for installing to EFI/BOOT in BIOS mode
63 # 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
64 # 0.6.1 -- Added --root option; minor bug fixes
65 # 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
66 # changed default driver installation behavior in Linux to install
67 # the driver needed to read /boot (if available)
68 # 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
69 # 0.5.1.1 -- Fixed bug that caused script failure under OS X
70 # 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
72 # 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
73 # 0.4.5 -- Fixed check for rEFItBlesser in OS X
74 # 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
75 # 0.4.1 -- Added check for rEFItBlesser in OS X
76 # 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
77 # 0.3.2.1 -- Check for presence of source files; aborts if not present
78 # 0.3.2 -- Initial version
80 # Note: install.sh version numbers match those of the rEFInd package
81 # with which they first appeared.
85 LocalKeysBase
="refind_local"
89 TargetX64
="refind_x64.efi"
90 TargetIA32
="refind_ia32.efi"
96 # Functions used by both OS X and Linux....
101 # Install the driver required to read Linux /boot, if it's available
102 # Note: Under OS X, this will be installed only if a Linux partition
103 # is detected, in which case the ext4fs driver will be installed.
104 InstallDrivers
="boot"
105 while [[ $# -gt 0 ]]; do
107 --notesp) InstallToEspOnMac
=0
112 TargetDir
=/System
/Library
/CoreServices
115 --usedefault) TargetDir
=/EFI
/BOOT
117 TargetX64
="bootx64.efi"
118 TargetIA32
="bootia32.efi"
125 --localkeys) LocalKeys
=1
127 --shim |
--preloader) ShimSource
="$2"
128 ShimType
=`basename $ShimSource`
131 --drivers |
--alldrivers) InstallDrivers
="all"
133 --nodrivers) InstallDrivers
="none"
137 * ) echo "Usage: $0 [--notesp | --usedefault {device-file} | --root {dir} |"
138 echo " --ownhfs {device-file} ]"
139 echo " [--nodrivers | --alldrivers] [--shim {shim-filename}]"
140 echo " [--localkeys] [--yes]"
145 if [[ "$InstallToEspOnMac" == 0 && "$RootDir" == '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
146 echo "You may use --notesp OR --usedefault, but not both! Aborting!"
149 if [[ "$RootDir" != '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
150 echo "You may use --root OR --usedefault, but not both! Aborting!"
153 if [[ "$TargetDir" != '/System/Library/CoreServices' && "$OwnHfs" == '1' ]] ; then
154 echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
157 RLConfFile
="$RootDir/boot/refind_linux.conf"
158 EtcKeysDir
="$RootDir/etc/refind.d/keys"
161 # Get a yes/no response from the user and place it in the YesNo variable.
162 # If the AlwaysYes variable is set to 1, skip the user input and set "Y"
163 # in the YesNo variable.
165 if [[ $AlwaysYes == 1 ]] ; then
173 # Abort if the rEFInd files can't be found.
174 # Also sets $ConfFile to point to the configuration file,
175 # $IconsDir to point to the icons directory, and
176 # $ShimSource to the source of the shim.efi file (if necessary).
178 # Note: This check is satisfied if EITHER the 32- or the 64-bit version
179 # is found, even on the wrong platform. This is because the platform
180 # hasn't yet been determined. This could obviously be improved, but it
181 # would mean restructuring lots more code....
182 if [[ ! -f "$RefindDir/refind_ia32.efi" && ! -f "$RefindDir/refind_x64.efi" ]] ; then
183 echo "The rEFInd binary file is missing! Aborting installation!"
187 if [[ -f "$RefindDir/refind.conf-sample" ]] ; then
188 ConfFile
="$RefindDir/refind.conf-sample"
189 elif [[ -f "$ThisDir/refind.conf-sample" ]] ; then
190 ConfFile
="$ThisDir/refind.conf-sample"
192 echo "The sample configuration file is missing! Aborting installation!"
196 if [[ -d "$RefindDir/icons" ]] ; then
197 IconsDir
="$RefindDir/icons"
198 elif [[ -d "$ThisDir/icons" ]] ; then
199 IconsDir
="$ThisDir/icons"
201 echo "The icons directory is missing! Aborting installation!"
205 echo "ShimSource is $ShimSource"
206 if [[ "$ShimSource" != "none" ]] ; then
207 if [[ -f "$ShimSource" ]] ; then
208 if [[ $ShimType == "shimx64.efi" ||
$ShimType == "shim.efi" ]] ; then
209 TargetX64
="grubx64.efi"
210 MokManagerSource
=`dirname "$ShimSource"`/MokManager.efi
211 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
212 TargetX64
="loader.efi"
213 MokManagerSource
=`dirname "$ShimSource"`/HashTool.efi
215 echo "Unknown shim/PreBootloader filename: $ShimType!"
216 echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
220 echo "The specified shim/PreBootloader file, $ShimSource, doesn't exist!"
221 echo "Aborting installation!"
227 # Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
228 # available) to target.
230 local inode1
=`ls -i "$ShimSource" 2> /dev/null | cut -f 1 -d " "`
231 local inode2
=`ls -i "$InstallDir/$TargetDir/$TargetShim" 2> /dev/null | cut -f 1 -d " "`
232 if [[ $inode1 != $inode2 ]] ; then
233 cp -fb "$ShimSource" "$InstallDir/$TargetDir/$TargetShim"
234 if [[ $?
!= 0 ]] ; then
238 inode1
=`ls -i "$MokManagerSource" 2> /dev/null | cut -f 1 -d " "`
239 local TargetMMName
=`basename $MokManagerSource`
240 inode2
=`ls -i "$InstallDir/$TargetDir/$TargetMMName" 2> /dev/null | cut -f 1 -d " "`
241 if [[ $inode1 != $inode2 ]] ; then
242 if [[ -f "$MokManagerSource" ]] ; then
243 cp -fb "$MokManagerSource" "$InstallDir/$TargetDir/"
245 if [[ $?
!= 0 ]] ; then
251 # Copy the public keys to the installation medium
253 if [[ $LocalKeys == 1 ]] ; then
254 mkdir
-p "$InstallDir/$TargetDir/keys/"
255 cp "$EtcKeysDir/$LocalKeysBase.cer" "$InstallDir/$TargetDir/keys/"
256 cp "$EtcKeysDir/$LocalKeysBase.crt" "$InstallDir/$TargetDir/keys/"
260 # Set varaibles for installation in EFI/BOOT directory
262 TargetDir
="/EFI/BOOT"
263 if [[ $ShimSource == "none" ]] ; then
264 TargetX64
="bootx64.efi"
265 TargetIA32
="bootia32.efi"
267 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
268 TargetX64
="grubx64.efi"
269 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
270 TargetX64
="loader.efi"
272 echo "Unknown shim/PreBootloader type: $ShimType"
276 TargetIA32
="bootia32.efi"
277 TargetShim
="bootx64.efi"
281 # Set variables for installation in EFI/Microsoft/Boot directory
283 TargetDir
="/EFI/Microsoft/Boot"
284 if [[ $ShimSource == "none" ]] ; then
285 TargetX64
="bootmgfw.efi"
287 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
288 TargetX64
="grubx64.efi"
289 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
290 TargetX64
="loader.efi"
292 echo "Unknown shim/PreBootloader type: $ShimType"
296 TargetShim
="bootmgfw.efi"
298 } # SetVarsForMsBoot()
300 # TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
301 # - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
302 # install to that directory under the suitable name; but DO NOT do this if
303 # refind.conf is also in /EFI/refind.
304 # - If booted in BIOS mode and the ESP lacks any other EFI files, install to
306 # - If booted in BIOS mode and there's no refind.conf file and there is a
307 # /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
308 # install under that name, "hijacking" the Windows boot loader filename
309 DetermineTargetDir
() {
312 if [[ -f $InstallDir/EFI
/BOOT
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
316 if [[ -f $InstallDir/EFI
/Microsoft
/Boot
/refind.conf
&& ! -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
320 if [[ -f $InstallDir/EFI
/refind
/refind.conf
&& foofoo
]] ; then
321 TargetDir
="/EFI/refind"
322 if [[ $ShimSource == "none" ]] ; then
323 TargetX64
="refind_x64.efi"
324 TargetIA32
="refind_ia32.efi"
328 if [[ $Upgrade == 1 ]] ; then
329 echo "Found rEFInd installation in $InstallDir$TargetDir; upgrading it."
332 if [[ ! -d /sys
/firmware
/efi
&& ! $OSName == 'Darwin' && $Upgrade == 0 ]] ; then # BIOS-mode
333 FoundEfiFiles
=`find "$InstallDir/EFI/BOOT" -name "*.efi" 2> /dev/null`
334 FoundConfFiles
=`find "$InstallDir" -name "refind\.conf" 2> /dev/null`
335 if [[ ! -n "$FoundConfFiles" && -f "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
336 mv -n "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" "$InstallDir/EFI/Microsoft" &> /dev
/null
338 echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
339 echo "files so as to install to $InstallDir$TargetDir."
340 elif [[ ! -n "$FoundEfiFiles" ]] ; then # In BIOS mode and no default loader; install as default loader
342 echo "Running in BIOS mode with no existing default boot loader; installing to"
343 echo $InstallDir$TargetDir
345 echo "Running in BIOS mode with an existing default boot loader; backing it up and"
346 echo "installing rEFInd in its place."
347 if [[ -d "$InstallDir/EFI/BOOT-rEFIndBackup" ]] ; then
349 echo "Caution: An existing backup of a default boot loader exists! If the current"
350 echo "default boot loader and the backup are different boot loaders, the current"
351 echo "one will become inaccessible."
353 echo -n "Do you want to proceed with installation (Y/N)? "
355 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
356 echo "OK; continuing with the installation..."
361 mv -n "$InstallDir/EFI/BOOT" "$InstallDir/EFI/BOOT-rEFIndBackup"
365 } # DetermineTargetDir()
367 # Determine (or guess) the filesystem used on the Linux /boot filesystem.
368 # Store the result in the BootFS global variable.
372 Blkid
=`which blkid 2> /dev/null`
374 if [[ $OSName == 'Linux' && -x "$Blkid" ]] ; then
375 BootPart
=`df /boot | grep dev | cut -f 1 -d " "`
376 BootFS
=`$Blkid -o export $BootPart 2> /dev/null | grep TYPE= | cut -f 2 -d =`
378 if [[ $OSName == 'Darwin' ]] ; then
379 # 0FC63DAF-8483-4772-8E79-3D69D8477DE4 = Linux filesystem
380 # BC13C2FF-59E6-4262-A352-B275FD6F7172 = Freedesktop $boot partition
381 # 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 = Freedesktop Linux /home
382 # E6D6D379-F507-44C2-A23C-238F2A3DF928 = Linux LVM
383 # A19D880F-05FC-4D3B-A006-743F0F84911E = Linux RAID
384 # 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F = Linux swap
385 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')
387 if [[ -n $Temp ]] ; then
388 echo "Found suspected Linux partition(s); installing ext4fs driver."
394 # Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
395 # honoring the $InstallDrivers condition. Must be passed a suitable
396 # architecture code (ia32 or x64).
398 if [[ $InstallDrivers == "all" ]] ; then
399 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
400 cp "$ThisDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
401 cp "$RefindDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
402 elif [[ "$InstallDrivers" == "boot" ]] ; then
406 ext2 | ext3
) DriverType
="ext2"
407 # Could use ext4, but that can create unwanted entries from symbolic
408 # links in / to /boot/vmlinuz if a separate /boot partition is used.
410 ext4
) DriverType
="ext4"
412 reiserfs
) DriverType
="reiserfs"
414 btrfs
) DriverType
="btrfs"
416 hfsplus
) DriverType
="hfs"
418 ntfs
) DriverType
="ntfs"
422 if [[ -n $BootFS ]] ; then
423 echo "Installing driver for $BootFS (${DriverType}_$1.efi)"
424 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
425 cp "$ThisDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
426 cp "$RefindDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1"/ 2> /dev
/null
431 # Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
432 # directory on the ESP. Must be passed a suitable architecture code (ia32
435 mkdir
-p "$InstallDir/EFI/tools"
436 if [[ $OSName == 'Darwin' ]] ; then
437 cp -f "$RefindDir/tools_$1/gptsync_$1.efi" "$InstallDir/EFI/tools/"
438 if [[ -f "$InstallDir/EFI/tools/gptsync.efi" ]] ; then
439 mv "$InstallDir/EFI/tools/gptsync.efi" "$InstallDir/EFI/tools/gptsync.efi-disabled"
440 echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
445 # Copy the rEFInd files to the ESP or OS X root partition.
446 # Sets Problems=1 if any critical commands fail.
448 mkdir
-p "$InstallDir/$TargetDir"
449 if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
450 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" 2> /dev
/null
451 if [[ $?
!= 0 ]] ; then
452 echo "Note: IA32 (x86) binary not installed!"
454 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" 2> /dev
/null
455 if [[ $?
!= 0 ]] ; then
458 if [[ "$ShimSource" != "none" ]] ; then
459 TargetShim
="bootx64.efi"
462 if [[ $InstallDrivers == "all" ]] ; then
463 cp -r "$RefindDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
464 cp -r "$ThisDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
465 elif [[ $Upgrade == 1 ||
$InstallToEspOnMac == 1 ]] ; then
466 if [[ $Platform == 'EFI64' ]] ; then
475 if [[ $Platform == 'EFI64' ]] ; then
477 elif [[ $Platform == 'EFI32' ]] ; then
478 Refind
='bootia32.efi'
481 elif [[ $Platform == 'EFI64' ||
$TargetDir == "/EFI/Microsoft/Boot" ]] ; then
482 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64"
483 if [[ $?
!= 0 ]] ; then
488 Refind
="refind_x64.efi"
490 if [[ "$ShimSource" != "none" ]] ; then
491 if [[ "$TargetShim" == "default" ]] ; then
492 TargetShim
=`basename "$ShimSource"`
496 if [[ $LocalKeys == 0 ]] ; then
497 echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir"
498 mkdir
-p "$EtcKeysDir"
499 cp "$ThisDir/keys/refind.cer" "$EtcKeysDir" 2> /dev
/null
500 cp "$ThisDir/keys/refind.crt" "$EtcKeysDir" 2> /dev
/null
503 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
504 SetupMacHfs
$TargetX64
506 elif [[ $Platform == 'EFI32' ]] ; then
507 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32"
508 if [[ $?
!= 0 ]] ; then
513 Refind
="refind_ia32.efi"
514 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
515 SetupMacHfs
$TargetIA32
518 echo "Unknown platform! Aborting!"
521 echo "Copied rEFInd binary files"
523 if [[ -d "$InstallDir/$TargetDir/icons" ]] ; then
524 rm -rf "$InstallDir/$TargetDir/icons-backup" &> /dev
/null
525 mv -f "$InstallDir/$TargetDir/icons" "$InstallDir/$TargetDir/icons-backup"
526 echo "Notice: Backed up existing icons directory as icons-backup."
528 cp -r "$IconsDir" "$InstallDir/$TargetDir"
529 if [[ $?
!= 0 ]] ; then
532 mkdir
-p "$InstallDir/$TargetDir/keys"
533 cp -rf "$ThisDir"/keys
/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
534 cp -rf "$EtcKeysDir"/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
535 if [[ -f "$InstallDir/$TargetDir/refind.conf" ]] ; then
536 echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
537 echo "to avoid overwriting your customizations."
539 cp -f "$ConfFile" "$InstallDir/$TargetDir"
540 if [[ $?
!= 0 ]] ; then
544 echo "Copying sample configuration file as refind.conf; edit this file to configure"
547 cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf"
548 if [[ $?
!= 0 ]] ; then
552 if [[ $DeleteRefindDir == 1 ]] ; then
553 echo "Deleting the temporary directory $RefindDir"
556 } # CopyRefindFiles()
558 # Mount the partition the user specified with the --usedefault or --ownhfs option
559 MountDefaultTarget
() {
560 InstallDir
=/tmp
/refind_install
561 mkdir
-p "$InstallDir"
563 if [[ $OSName == 'Darwin' ]] ; then
564 if [[ $OwnHfs == '1' ]] ; then
565 Temp
=`diskutil info "$TargetPart" | grep "Mount Point"`
566 InstallDir
=`echo $Temp | cut -f 3-30 -d ' '`
567 if [[ $InstallDir == '' ]] ; then
568 InstallDir
=/tmp
/refind_install
569 mount
-t hfs
"$TargetPart" "$InstallDir"
574 mount
-t msdos
"$TargetPart" "$InstallDir"
576 elif [[ $OSName == 'Linux' ]] ; then
577 mount
-t vfat
"$TargetPart" "$InstallDir"
579 if [[ $?
!= 0 ]] ; then
580 echo "Couldn't mount $TargetPart ! Aborting!"
584 } # MountDefaultTarget()
587 # A series of OS X support functions....
590 # Mount the ESP at /Volumes/ESP or determine its current mount
592 # Sets InstallDir to the ESP mount point
593 # Sets UnmountEsp if we mounted it
595 # Identify the ESP. Note: This returns the FIRST ESP found;
596 # if the system has multiple disks, this could be wrong!
597 Temp
=$
(mount |
sed -n -E "/^(\/dev\/disk[0-9]+s[0-9]+) on \/ \(.*$/s//\1/p")
599 Temp
=$
(diskutil list |
grep " EFI " |
grep -o 'disk.*' |
head -n 1)
600 if [ -z $Temp ]; then
601 echo "Warning: root device doesn't have an EFI partition"
604 echo "Warning: root device could not be found"
606 if [ -z $Temp ]; then
607 Temp
=$
(diskutil list |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
611 if [ -z $Temp ]; then
612 echo "Could not find an EFI partition. Aborting!"
616 Esp
=/dev
/`echo $Temp`
617 # If the ESP is mounted, use its current mount point....
618 Temp
=`df -P | grep "$Esp "`
619 InstallDir
=`echo $Temp | cut -f 6- -d ' '`
620 if [[ "$InstallDir" == '' ]] ; then
621 mkdir
/Volumes
/ESP
&> /dev
/null
622 mount
-t msdos
"$Esp" /Volumes
/ESP
623 # Some systems have HFS+ "ESPs." They shouldn't, but they do. If this is
624 # detected, mount it as such and set appropriate options.
625 if [[ $?
!= 0 ]] ; then
626 mount
-t hfs
"$Esp" /Volumes
/Esp
629 if [[ $?
!= 0 ]] ; then
630 echo "Unable to mount ESP! Aborting!\n"
635 InstallDir
="/Volumes/ESP"
639 # Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
640 # (http://mjg59.dreamwidth.org/7468.html)
641 # Must be passed the original rEFInd binary filename (without a path).
643 if [[ -s "$InstallDir/mach_kernel" ]] ; then
644 echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
647 cp -n "$InstallDir/$TargetDir/boot.efi" "$InstallDir/$TargetDir/boot.efi-backup" &> /dev
/null
648 ln -f "$InstallDir/$TargetDir/$1" "$InstallDir/$TargetDir/boot.efi"
649 touch "$InstallDir/mach_kernel"
650 rm "$InstallDir/$TargetDir/SystemVersion.plist" &> /dev
/null
651 cat - << ENDOFHERE >> "$InstallDir/$TargetDir/SystemVersion.plist"
652 <xml version="1.0" encoding="UTF-8"?>
653 <plist version="1.0">
655 <key>ProductBuildVersion</key>
657 <key>ProductName</key>
658 <string>rEFInd</string>
659 <key>ProductVersion</key>
660 <string>0.9.1</string>
666 # Control the OS X installation.
667 # Sets Problems=1 if problems found during the installation.
669 echo "Installing rEFInd on OS X...."
670 if [[ "$InstallToEspOnMac" == "1" ]] ; then
672 elif [[ "$TargetDir" == "/EFI/BOOT" ||
"$OwnHfs" == '1' ]] ; then
675 InstallDir
="$RootDir/"
677 echo "Installing rEFInd to the partition mounted at $InstallDir"
679 Platform
=`ioreg -l -p IODeviceTree | grep firmware-abi | cut -d "\"" -f 4`
681 if [[ $InstallToEspOnMac == "1" ]] ; then
682 bless
--mount "$InstallDir" --setBoot --file "$InstallDir/$TargetDir/$Refind" --shortform
683 elif [[ "$TargetDir" != "/EFI/BOOT" ]] ; then
684 bless
--setBoot --folder "$InstallDir/$TargetDir" --file "$InstallDir/$TargetDir/$Refind"
686 if [[ $?
!= 0 ]] ; then
689 if [[ -f /Library
/StartupItems
/rEFItBlesser ||
-d /Library
/StartupItems
/rEFItBlesser
]] ; then
691 echo "/Library/StartupItems/rEFItBlesser found!"
692 echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
693 echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
695 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
696 echo "Deleting /Library/StartupItems/rEFItBlesser..."
697 rm -r /Library
/StartupItems
/rEFItBlesser
699 echo "Not deleting rEFItBlesser."
703 echo "WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the"
704 echo "bless status with 'bless --info', since this is known to cause disk corruption"
705 echo "on some systems!!"
711 # Now a series of Linux support functions....
714 # Check for evidence that we're running in Secure Boot mode. If so, and if
715 # appropriate options haven't been set, warn the user and offer to abort.
716 # If we're NOT in Secure Boot mode but the user HAS specified the --shim
717 # or --localkeys option, warn the user and offer to abort.
720 if [[ -f /sys
/firmware
/efi
/vars
/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c
/data
]] ; then
721 IsSecureBoot
=`od -An -t u1 /sys/firmware/efi/vars/SecureBoot-8be4df61-93ca-11d2-aa0d-00e098032b8c/data | tr -d '[[:space:]]'`
725 if [[ $IsSecureBoot == "1" && "$TargetDir" != '/EFI/BOOT' && "$ShimSource" == "none" ]] ; then
727 echo "CAUTION: Your computer appears to be booted with Secure Boot, but you haven't"
728 echo "specified a valid shim.efi file source. Chances are you should re-run with"
729 echo "the --shim option. You can read more about this topic at"
730 echo "http://www.rodsbooks.com/refind/secureboot.html."
732 echo -n "Do you want to proceed with installation (Y/N)? "
734 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
735 echo "OK; continuing with the installation..."
741 if [[ "$ShimSource" != "none" && ! $IsSecureBoot == "1" ]] ; then
743 echo "You've specified installing using a shim.efi file, but your computer does not"
744 echo "appear to be running in Secure Boot mode. Although installing in this way"
745 echo "should work, it's unnecessarily complex. You may continue, but unless you"
746 echo "plan to enable Secure Boot, you should consider stopping and omitting the"
747 echo "--shim option. You can read more about this topic at"
748 echo "http://www.rodsbooks.com/refind/secureboot.html."
750 echo -n "Do you want to proceed with installation (Y/N)? "
752 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
753 echo "OK; continuing with the installation..."
759 if [[ $LocalKeys != 0 && ! $IsSecureBoot == "1" ]] ; then
761 echo "You've specified re-signing your rEFInd binaries with locally-generated keys,"
762 echo "but your computer does not appear to be running in Secure Boot mode. The"
763 echo "keys you generate will be useless unless you enable Secure Boot. You may"
764 echo "proceed with this installation, but before you do so, you may want to read"
765 echo "more about it at http://www.rodsbooks.com/refind/secureboot.html."
767 echo -n "Do you want to proceed with installation (Y/N)? "
769 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
770 echo "OK; continuing with the installation..."
776 } # CheckSecureBoot()
778 # Check for the presence of locally-generated keys from a previous installation in
779 # $EtcKeysDir (/etc/refind.d/keys). If they're not present, generate them using
782 PrivateKey
="$EtcKeysDir/$LocalKeysBase.key"
783 CertKey
="$EtcKeysDir/$LocalKeysBase.crt"
784 DerKey
="$EtcKeysDir/$LocalKeysBase.cer"
785 OpenSSL
=`which openssl 2> /dev/null`
787 # Do the work only if one or more of the necessary keys is missing
788 # TODO: Technically, we don't need the DerKey; but if it's missing and openssl
789 # is also missing, this will fail. This could be improved.
790 if [[ ! -f "$PrivateKey" ||
! -f "$CertKey" ||
! -f "$DerKey" ]] ; then
791 echo "Generating a fresh set of local keys...."
792 mkdir
-p "$EtcKeysDir"
793 chmod 0700 "$EtcKeysDir"
794 if [[ ! -x "$OpenSSL" ]] ; then
795 echo "Can't find openssl, which is required to create your private signing keys!"
799 if [[ -f "$PrivateKey" ]] ; then
800 echo "Backing up existing $PrivateKey"
801 cp -f "$PrivateKey" "$PrivateKey.backup" 2> /dev
/null
803 if [[ -f "$CertKey" ]] ; then
804 echo "Backing up existing $CertKey"
805 cp -f "$CertKey" "$CertKey.backup" 2> /dev
/null
807 if [[ -f "$DerKey" ]] ; then
808 echo "Backing up existing $DerKey"
809 cp -f "$DerKey" "$DerKey.backup" 2> /dev
/null
811 "$OpenSSL" req
-new -x509 -newkey rsa
:2048 -keyout "$PrivateKey" -out "$CertKey" \
812 -nodes -days 3650 -subj "/CN=Locally-generated rEFInd key/"
813 "$OpenSSL" x509
-in "$CertKey" -out "$DerKey" -outform DER
814 chmod 0600 "$PrivateKey"
816 echo "Using existing local keys...."
820 # Sign a single binary. Requires parameters:
822 # $2 = destination file
823 # Also assumes that the SBSign, PESign, UseSBSign, UsePESign, and various key variables are set
825 # Aborts script on error
827 $SBSign --key "$PrivateKey" --cert "$CertKey" --output "$2" "$1"
828 if [[ $?
!= 0 ]] ; then
829 echo "Problem signing the binary $1! Aborting!"
834 # Re-sign the x86-64 binaries with a locally-generated key, First look for appropriate
835 # key files in $EtcKeysDir. If they're present, use them to re-sign the binaries. If
836 # not, try to generate new keys and store them in $EtcKeysDir.
838 SBSign
=`which sbsign 2> /dev/null`
839 echo "Found sbsign at $SBSign"
840 TempDir
="/tmp/refind_local"
841 if [[ ! -x "$SBSign" ]] ; then
842 echo "Can't find sbsign, which is required to sign rEFInd with your own keys!"
847 mkdir
-p "$TempDir/drivers_x64"
848 cp "$RefindDir/refind.conf-sample $TempDir" 2> /dev
/null
849 cp "$ThisDir/refind.conf-sample $TempDir" 2> /dev
/null
850 cp "$RefindDir/refind_ia32.efi $TempDir" 2> /dev
/null
851 cp -a "$RefindDir/drivers_ia32 $TempDir" 2> /dev
/null
852 cp -a "$ThisDir/drivers_ia32 $TempDir" 2> /dev
/null
853 SignOneBinary
"$RefindDir/refind_x64.efi" "$TempDir/refind_x64.efi"
855 IFS
=$
(echo -en "\n\b")
856 for Driver
in `ls "$RefindDir"/drivers_x64/*.efi "$ThisDir"/drivers_x64/*.efi 2> /dev/null` ; do
857 TempName
=`basename "$Driver"`
858 SignOneBinary
"$Driver" "$TempDir/drivers_x64/$TempName"
865 # Locate and mount an ESP, if possible, based on parted output.
866 # Should be called only if /boot/efi is NOT an acceptable ESP.
867 # Sets InstallDir to the mounted ESP's path ($RootDir/boot/efi)
868 # and EspFilesystem the filesystem (always "vfat")
870 echo "The ESP doesn't seem to be mounted! Trying to find it...."
877 for Drive
in `ls /dev/[sh]d?` ; do
879 Dmraid
=`which dmraid 2> /dev/null`
880 if [ -x "$Dmraid" ] ; then
881 DmStatus
=`dmraid -r | grep $Drive`
882 if [ -n "$DmStatus" ] ; then
883 echo "$Drive seems to be part of a RAID array; skipping!"
887 TableType
=`parted $Drive print -m -s 2>/dev/null | awk -F: '$1 == "'$Drive'" { print $6 }'`
888 if [[ $TableType == 'gpt' && $SkipIt == 0 ]] ; then # read only GPT disks that aren't part of dmraid array
889 PartNum
=`LANG=C parted $Drive print -m -s 2>/dev/null | awk -F: '$7 ~ "(^boot| boot)" { print $1 }' | head -n 1`
890 if [ "$PartNum" -eq "$PartNum" ] 2> /dev
/null
; then
891 InstallDir
="$RootDir/boot/efi"
893 mount
$Drive$PartNum $InstallDir
894 EspFilesystem
=`grep "$Drive$PartNum.*/boot/efi" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
895 if [[ $EspFilesystem != 'vfat' ]] ; then
898 echo "Mounting ESP at $InstallDir"
901 fi # $PartNum -eq $PartNum
906 # Identifies the ESP's location (/boot or /boot/efi, or these locations under
907 # the directory specified by --root); aborts if the ESP isn't mounted at
909 # Sets InstallDir to the ESP mount point.
911 mount
/boot
&> /dev
/null
912 mount
/boot
/efi
&> /dev
/null
913 EspLine
=`df "$RootDir/boot/efi" 2> /dev/null | grep boot/efi`
914 if [[ ! -n "$EspLine" ]] ; then
915 EspLine
=`df "$RootDir"/boot | grep boot`
917 InstallDir
=`echo $EspLine | cut -d " " -f 6`
919 if [[ -n "$InstallDir" ]] ; then
920 EspFilesystem
=`grep -w "$InstallDir" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
922 if [[ $EspFilesystem != 'vfat' ]] ; then
925 if [[ $EspFilesystem != 'vfat' ]] ; then
926 echo "$RootDir/$InstallDir doesn't seem to be on a VFAT filesystem. The ESP must be"
927 echo "mounted at $RootDir/boot or $RootDir/boot/efi and it must be VFAT! Aborting!"
930 echo "ESP was found at $InstallDir using $EspFilesystem"
933 # Uses efibootmgr to add an entry for rEFInd to the EFI's NVRAM.
934 # If this fails, sets Problems=1
938 Efibootmgr
=`which efibootmgr 2> /dev/null`
939 if [[ "$Efibootmgr" ]] ; then
940 InstallDisk
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 1-8`
941 PartNum
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 9-10`
942 EntryFilename
="$TargetDir/$Refind"
943 EfiEntryFilename
=`echo ${EntryFilename//\//\\\}`
944 EfiEntryFilename2
=`echo ${EfiEntryFilename} | sed s/\\\\\\\\/\\\\\\\\\\\\\\\\/g`
945 ExistingEntry
=`"$Efibootmgr" -v | grep -i "$EfiEntryFilename2"`
947 if [[ "$ExistingEntry" ]] ; then
948 ExistingEntryBootNum
=`echo "$ExistingEntry" | cut -c 5-8`
949 FirstBoot
=`"$Efibootmgr" | grep BootOrder | cut -c 12-15`
950 if [[ "$ExistingEntryBootNum" != "$FirstBoot" ]] ; then
951 echo "An existing rEFInd boot entry exists, but isn't set as the default boot"
952 echo "manager. The boot order is being adjusted to make rEFInd the default boot"
953 echo "manager. If this is NOT what you want, you should use efibootmgr to"
954 echo "manually adjust your EFI's boot order."
955 "$Efibootmgr" -b $ExistingEntryBootNum -B &> /dev
/null
962 if [[ $InstallIt == "1" ]] ; then
963 echo "Installing it!"
964 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum &> /dev
/null
965 if [[ $?
!= 0 ]] ; then
971 else # efibootmgr not found
976 if [[ $EfibootmgrProblems ]] ; then
978 echo "ALERT: There were problems running the efibootmgr program! You may need to"
979 echo "rename the $Refind binary to the default name (EFI/boot/bootx64.efi"
980 echo "on x86-64 systems or EFI/boot/bootia32.efi on x86 systems) to have it run!"
983 echo "rEFInd has been set as the default boot manager."
987 # Create a minimal/sample refind_linux.conf file in /boot.
988 GenerateRefindLinuxConf
() {
989 if [[ -f "$RLConfFile" ]] ; then
990 echo "Existing $RLConfFile found; not overwriting."
992 echo "Creating $RLConfFile; edit it to adjust kernel options."
993 if [[ -f "$RootDir/etc/default/grub" ]] ; then
994 # We want the default options used by the distribution, stored here....
995 source "$RootDir/etc/default/grub"
996 echo "Setting default boot options based on $RootDir/etc/default/grub"
998 RootFS
=`df "$RootDir" | grep dev | cut -f 1 -d " "`
999 StartOfDevname
=`echo "$RootFS" | cut -b 1-7`
1000 if [[ "$StartOfDevname" == "/dev/sd" ||
"$StartOfDevName" == "/dev/hd" ]] ; then
1001 # Identify root filesystem by UUID rather than by device node, if possible
1002 Uuid
=`blkid -o export -s UUID "$RootFS" 2> /dev/null | grep UUID=`
1003 if [[ -n $Uuid ]] ; then
1007 DefaultOptions
="$GRUB_CMDLINE_LINUX $GRUB_CMDLINE_LINUX_DEFAULT"
1008 echo "\"Boot with standard options\" \"ro root=$RootFS $DefaultOptions \"" > $RLConfFile
1009 echo "\"Boot to single-user mode\" \"ro root=$RootFS $DefaultOptions single\"" >> $RLConfFile
1010 echo "\"Boot with minimal options\" \"ro root=$RootFS\"" >> $RLConfFile
1014 # Controls rEFInd installation under Linux.
1015 # Sets Problems=1 if something goes wrong.
1017 if [[ "$TargetDir" == "/System/Library/CoreServices" ]] ; then
1018 echo "You may not use the --ownhfs option under Linux! Aborting!"
1021 echo "Installing rEFInd on Linux...."
1022 modprobe efivars
&> /dev
/null
1023 if [[ $TargetDir == "/EFI/BOOT" ]] ; then
1030 if [[ $CpuType == 'x86_64' ]] ; then
1032 elif [[ ($CpuType == 'i386' ||
$CpuType == 'i486' ||
$CpuType == 'i586' ||
$CpuType == 'i686') ]] ; then
1034 # If we're in EFI mode, do some sanity checks, and alert the user or even
1035 # abort. Not in BIOS mode, though, since that could be used on an emergency
1036 # disc to try to recover a troubled Linux installation.
1037 if [[ -d /sys
/firmware
/efi
]] ; then
1038 if [[ "$ShimSource" != "none" && "$TargetDir" != "/BOOT/EFI" ]] ; then
1040 echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
1041 echo "use the --shim option to install on such systems. Aborting!"
1046 echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
1047 echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
1048 echo "on a 64-bit computer, you should manually install the 64-bit version of"
1049 echo "rEFInd. If you're installing on a Mac, you should do so from OS X. If"
1050 echo "you're positive you want to continue with this installation, answer 'Y'"
1051 echo "to the following question..."
1053 echo -n "Are you sure you want to continue (Y/N)? "
1055 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
1056 echo "OK; continuing with the installation..."
1062 echo "Unknown CPU type '$CpuType'; aborting!"
1066 if [[ $LocalKeys == 1 ]] ; then
1072 if [[ "$TargetDir" != "/EFI/BOOT" && "$TargetDir" != "/EFI/Microsoft/Boot" ]] ; then
1074 GenerateRefindLinuxConf
1076 } # InstallOnLinux()
1079 # The main part of the script. Sets a few environment variables,
1080 # performs a few startup checks, and then calls functions to
1081 # install under OS X or Linux, depending on the detected platform.
1085 ThisDir
="$( cd -P "$
( dirname "${BASH_SOURCE[0]}" )" && pwd )"
1086 RefindDir
="$ThisDir/refind"
1087 ThisScript
="$ThisDir/`basename $0`"
1088 if [[ `whoami` != "root" ]] ; then
1089 echo "Not running as root; attempting to elevate privileges via sudo...."
1090 sudo
"$ThisScript" "$@"
1091 if [[ $?
!= 0 ]] ; then
1092 echo "This script must be run as root (or using sudo). Exiting!"
1099 if [[ $OSName == 'Darwin' ]] ; then
1100 if [[ "$ShimSource" != "none" ]] ; then
1101 echo "The --shim option is not supported on OS X! Exiting!"
1104 if [[ "$LocalKeys" != 0 ]] ; then
1105 echo "The --localkeys option is not supported on OS X! Exiting!"
1109 elif [[ $OSName == 'Linux' ]] ; then
1112 echo "Running on unknown OS; aborting!"
1113 if [[ "$InstallToEspOnMac" == 0 ]] ; then
1114 echo "The --notesp option is not supported on Linux! Exiting!"
1119 if [[ $Problems ]] ; then
1122 echo "Installation has completed, but problems were detected. Review the output for"
1123 echo "error messages and take corrective measures as necessary. You may need to"
1124 echo "re-run this script or install manually before rEFInd will work."
1128 echo "Installation has completed successfully."
1132 if [[ $UnmountEsp == '1' ]] ; then
1133 echo "Unmounting install dir"
1137 if [[ "$InstallDir" == /tmp
/refind_install
]] ; then