]>
code.delx.au - refind/blob - install.sh
93b4cdea8241fef03e7010075eb0253bf7e042ad
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-2014 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.5 -- Refinement/cleanup of new OS X ESP-as-default policy
39 # 0.8.4 -- OS X default changed to install to ESP under /EFI/BOOT
40 # 0.7.9 -- Fixed bug that caused errors if dmraid utility not installed
41 # 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
42 # to locate and mount ESP on Linux, if it's not mounted
43 # 0.7.6 -- Added --ownhfs {device-filename} option
44 # 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
45 # 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
46 # 0.7.0 -- Added support for the new Btrfs driver
47 # 0.6.12 -- Added support for PreLoader as well as for shim
48 # 0.6.11 -- Improvements in script's ability to handle directories with spaces
50 # 0.6.9 -- Install gptsync on Macs
51 # 0.6.8 -- Bug fix: ESP scan now uses "uniq".
52 # 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
53 # copying shim.efi and MokManager.efi over themselves.
54 # 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
55 # 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
56 # directories & for installing to EFI/BOOT in BIOS mode
57 # 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
58 # 0.6.1 -- Added --root option; minor bug fixes
59 # 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
60 # changed default driver installation behavior in Linux to install
61 # the driver needed to read /boot (if available)
62 # 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
63 # 0.5.1.1 -- Fixed bug that caused script failure under OS X
64 # 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
66 # 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
67 # 0.4.5 -- Fixed check for rEFItBlesser in OS X
68 # 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
69 # 0.4.1 -- Added check for rEFItBlesser in OS X
70 # 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
71 # 0.3.2.1 -- Check for presence of source files; aborts if not present
72 # 0.3.2 -- Initial version
74 # Note: install.sh version numbers match those of the rEFInd package
75 # with which they first appeared.
79 LocalKeysBase
= "refind_local"
83 TargetX64
= "refind_x64.efi"
84 TargetIA32
= "refind_ia32.efi"
90 # Functions used by both OS X and Linux....
95 # Install the driver required to read Linux /boot, if it's available
96 # Note: Under OS X, this will be installed only if a Linux partition
97 # is detected, in which case the ext4fs driver will be installed.
99 while [[ $# -gt 0 ]]; do
101 --notesp ) InstallToEspOnMac
= 0
106 TargetDir
=/ System
/ Library
/ CoreServices
109 --usedefault ) TargetDir
=/ EFI
/ BOOT
111 TargetX64
= "bootx64.efi"
112 TargetIA32
= "bootia32.efi"
119 --localkeys ) LocalKeys
= 1
121 --shim |
--preloader ) ShimSource
= " $2 "
122 ShimType
= `basename $ShimSource `
125 --drivers |
--alldrivers ) InstallDrivers
= "all"
127 --nodrivers ) InstallDrivers
= "none"
131 * ) echo "Usage: $0 [--notesp | --usedefault {device-file} | --root {dir} |"
132 echo " --ownhfs {device-file} ]"
133 echo " [--nodrivers | --alldrivers] [--shim {shim-filename}]"
134 echo " [--localkeys] [--yes]"
139 if [[ " $InstallToEspOnMac " == 0 && " $RootDir " == '/' && " $TargetDir " == '/EFI/BOOT' ]] ; then
140 echo "You may use --notesp OR --usedefault, but not both! Aborting!"
143 if [[ " $RootDir " != '/' && " $TargetDir " == '/EFI/BOOT' ]] ; then
144 echo "You may use --root OR --usedefault, but not both! Aborting!"
147 if [[ " $TargetDir " != '/System/Library/CoreServices' && " $OwnHfs " == '1' ]] ; then
148 echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
151 RLConfFile
= " $RootDir /boot/refind_linux.conf"
152 EtcKeysDir
= " $RootDir /etc/refind.d/keys"
155 # Get a yes/no response from the user and place it in the YesNo variable.
156 # If the AlwaysYes variable is set to 1, skip the user input and set "Y"
157 # in the YesNo variable.
159 if [[ $AlwaysYes == 1 ]] ; then
167 # Abort if the rEFInd files can't be found.
168 # Also sets $ConfFile to point to the configuration file,
169 # $IconsDir to point to the icons directory, and
170 # $ShimSource to the source of the shim.efi file (if necessary).
172 # Note: This check is satisfied if EITHER the 32- or the 64-bit version
173 # is found, even on the wrong platform. This is because the platform
174 # hasn't yet been determined. This could obviously be improved, but it
175 # would mean restructuring lots more code....
176 if [[ ! -f " $RefindDir /refind_ia32.efi" && ! -f " $RefindDir /refind_x64.efi" ]] ; then
177 echo "The rEFInd binary file is missing! Aborting installation!"
181 if [[ -f " $RefindDir /refind.conf-sample" ]] ; then
182 ConfFile
= " $RefindDir /refind.conf-sample"
183 elif [[ -f " $ThisDir /refind.conf-sample" ]] ; then
184 ConfFile
= " $ThisDir /refind.conf-sample"
186 echo "The sample configuration file is missing! Aborting installation!"
190 if [[ -d " $RefindDir /icons" ]] ; then
191 IconsDir
= " $RefindDir /icons"
192 elif [[ -d " $ThisDir /icons" ]] ; then
193 IconsDir
= " $ThisDir /icons"
195 echo "The icons directory is missing! Aborting installation!"
199 if [[ " $ShimSource " != "none" ]] ; then
200 if [[ -f " $ShimSource " ]] ; then
201 if [[ $ShimType == "shimx64.efi" ||
$ShimType == "shim.efi" ]] ; then
202 TargetX64
= "grubx64.efi"
203 MokManagerSource
= `dirname " $ShimSource "` / MokManager.efi
204 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
205 TargetX64
= "loader.efi"
206 MokManagerSource
= `dirname " $ShimSource "` / HashTool.efi
208 echo "Unknown shim/PreBootloader filename: $ShimType !"
209 echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
213 echo "The specified shim/PreBootloader file, $ShimSource , doesn't exist!"
214 echo "Aborting installation!"
220 # Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
221 # available) to target.
223 cp -fb " $ShimSource " " $InstallDir / $TargetDir / $TargetShim "
224 if [[ $?
!= 0 ]] ; then
227 if [[ -f " $MokManagerSource " ]] ; then
228 cp -fb " $MokManagerSource " " $InstallDir / $TargetDir /"
230 if [[ $?
!= 0 ]] ; then
235 # Copy the public keys to the installation medium
237 if [[ $LocalKeys == 1 ]] ; then
238 mkdir
-p " $InstallDir / $TargetDir /keys/"
239 cp " $EtcKeysDir / $LocalKeysBase .cer" " $InstallDir / $TargetDir /keys/"
240 cp " $EtcKeysDir / $LocalKeysBase .crt" " $InstallDir / $TargetDir /keys/"
244 # Set varaibles for installation in EFI/BOOT directory
246 TargetDir
= "/EFI/BOOT"
247 if [[ $ShimSource == "none" ]] ; then
248 TargetX64
= "bootx64.efi"
249 TargetIA32
= "bootia32.efi"
251 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
252 TargetX64
= "grubx64.efi"
253 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
254 TargetX64
= "loader.efi"
256 echo "Unknown shim/PreBootloader type: $ShimType "
260 TargetIA32
= "bootia32.efi"
261 TargetShim
= "bootx64.efi"
265 # Set variables for installation in EFI/Microsoft/Boot directory
267 TargetDir
= "/EFI/Microsoft/Boot"
268 if [[ $ShimSource == "none" ]] ; then
269 TargetX64
= "bootmgfw.efi"
271 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
272 TargetX64
= "grubx64.efi"
273 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
274 TargetX64
= "loader.efi"
276 echo "Unknown shim/PreBootloader type: $ShimType "
280 TargetShim
= "bootmgfw.efi"
282 } # SetVarsForMsBoot()
284 # TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
285 # - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
286 # install to that directory under the suitable name; but DO NOT do this if
287 # refind.conf is also in /EFI/refind.
288 # - If booted in BIOS mode and the ESP lacks any other EFI files, install to
290 # - If booted in BIOS mode and there's no refind.conf file and there is a
291 # /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
292 # install under that name, "hijacking" the Windows boot loader filename
293 DetermineTargetDir
() {
296 if [[ -f $InstallDir / EFI
/ BOOT
/ refind.conf
]] ; then
300 if [[ -f $InstallDir / EFI
/ Microsoft
/ Boot
/ refind.conf
]] ; then
304 if [[ -f $InstallDir / EFI
/ refind
/ refind.conf
]] ; then
305 TargetDir
= "/EFI/refind"
306 if [[ " $OSName " == 'Darwin' ]] ; then
307 TargetX64
= "refind_x64.efi"
308 TargetIA32
= "refind_ia32.efi"
312 if [[ $Upgrade == 1 ]] ; then
313 echo "Found rEFInd installation in $InstallDir $TargetDir ; upgrading it."
316 if [[ ! -d / sys
/ firmware
/ efi
&& ! $OSName == 'Darwin' && $Upgrade == 0 ]] ; then # BIOS-mode
317 FoundEfiFiles
= `find " $InstallDir /EFI/BOOT" -name "*.efi" 2> /dev/null`
318 FoundConfFiles
= `find " $InstallDir " -name "refind\.conf" 2> /dev/null`
319 if [[ ! -n " $FoundConfFiles " && -f " $InstallDir /EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
320 mv -n " $InstallDir /EFI/Microsoft/Boot/bootmgfw.efi" " $InstallDir /EFI/Microsoft" &> / dev
/ null
322 echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
323 echo "files so as to install to $InstallDir $TargetDir ."
324 elif [[ ! -n " $FoundEfiFiles " ]] ; then # In BIOS mode and no default loader; install as default loader
326 echo "Running in BIOS mode with no existing default boot loader; installing to"
327 echo $InstallDir$TargetDir
329 echo "Running in BIOS mode with an existing default boot loader; backing it up and"
330 echo "installing rEFInd in its place."
331 if [[ -d " $InstallDir /EFI/BOOT-rEFIndBackup" ]] ; then
333 echo "Caution: An existing backup of a default boot loader exists! If the current"
334 echo "default boot loader and the backup are different boot loaders, the current"
335 echo "one will become inaccessible."
337 echo -n "Do you want to proceed with installation (Y/N)? "
339 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
340 echo "OK; continuing with the installation..."
345 mv -n " $InstallDir /EFI/BOOT" " $InstallDir /EFI/BOOT-rEFIndBackup"
349 } # DetermineTargetDir()
351 # Determine (or guess) the filesystem used on the Linux /boot filesystem.
352 # Store the result in the BootFS global variable.
356 Blkid
= `which blkid 2> /dev/null`
358 if [[ $OSName == 'Linux' && -x " $Blkid " ]] ; then
359 BootPart
= `df /boot | grep dev | cut -f 1 -d " "`
360 BootFS
= ` $Blkid -o export $BootPart 2> /dev/null | grep TYPE= | cut -f 2 -d =`
362 if [[ $OSName == 'Darwin' ]] ; then
363 # 0FC63DAF-8483-4772-8E79-3D69D8477DE4 = Linux filesystem
364 # BC13C2FF-59E6-4262-A352-B275FD6F7172 = Freedesktop $boot partition
365 # 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 = Freedesktop Linux /home
366 # E6D6D379-F507-44C2-A23C-238F2A3DF928 = Linux LVM
367 # A19D880F-05FC-4D3B-A006-743F0F84911E = Linux RAID
368 # 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F = Linux swap
369 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' )
371 if [[ -n $Temp ]] ; then
372 echo "Found suspected Linux partition(s); installing ext4fs driver."
378 # Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
379 # honoring the $InstallDrivers condition. Must be passed a suitable
380 # architecture code (ia32 or x64).
382 if [[ $InstallDrivers == "all" ]] ; then
383 mkdir
-p " $InstallDir / $TargetDir /drivers_ $1 "
384 cp " $ThisDir " / drivers_
$1 /* _
$1 .efi
" $InstallDir / $TargetDir /drivers_ $1 /" 2 > / dev
/ null
385 cp " $RefindDir " / drivers_
$1 /* _
$1 .efi
" $InstallDir / $TargetDir /drivers_ $1 /" 2 > / dev
/ null
386 elif [[ " $InstallDrivers " == "boot" ]] ; then
390 ext2 | ext3
) DriverType
= "ext2"
391 # Could use ext4, but that can create unwanted entries from symbolic
392 # links in / to /boot/vmlinuz if a separate /boot partition is used.
394 ext4
) DriverType
= "ext4"
396 reiserfs
) DriverType
= "reiserfs"
398 btrfs
) DriverType
= "btrfs"
400 hfsplus
) DriverType
= "hfs"
404 if [[ -n $BootFS ]] ; then
405 echo "Installing driver for $BootFS ( ${DriverType} _ $1 .efi)"
406 mkdir
-p " $InstallDir / $TargetDir /drivers_ $1 "
407 cp " $ThisDir /drivers_ $1 / ${DriverType} _ $1 .efi" " $InstallDir / $TargetDir /drivers_ $1 /" 2 > / dev
/ null
408 cp " $RefindDir /drivers_ $1 / ${DriverType} _ $1 .efi" " $InstallDir / $TargetDir /drivers_ $1 " / 2 > / dev
/ null
413 # Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
414 # directory on the ESP. Must be passed a suitable architecture code (ia32
417 mkdir
-p " $InstallDir /EFI/tools"
418 if [[ $OSName == 'Darwin' ]] ; then
419 cp -f " $RefindDir /tools_ $1 /gptsync_ $1 .efi" " $InstallDir /EFI/tools/"
420 if [[ -f " $InstallDir /EFI/tools/gptsync.efi" ]] ; then
421 mv " $InstallDir /EFI/tools/gptsync.efi" " $InstallDir /EFI/tools/gptsync.efi-disabled"
422 echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
427 # Copy the rEFInd files to the ESP or OS X root partition.
428 # Sets Problems=1 if any critical commands fail.
430 mkdir
-p " $InstallDir / $TargetDir "
431 if [[ " $TargetDir " == '/EFI/BOOT' ]] ; then
432 cp " $RefindDir /refind_ia32.efi" " $InstallDir / $TargetDir / $TargetIA32 " 2 > / dev
/ null
433 if [[ $?
!= 0 ]] ; then
434 echo "Note: IA32 (x86) binary not installed!"
436 cp " $RefindDir /refind_x64.efi" " $InstallDir / $TargetDir / $TargetX64 " 2 > / dev
/ null
437 if [[ $?
!= 0 ]] ; then
440 if [[ " $ShimSource " != "none" ]] ; then
441 TargetShim
= "bootx64.efi"
444 if [[ $InstallDrivers == "all" ]] ; then
445 cp -r " $RefindDir " / drivers_
* " $InstallDir / $TargetDir /" 2 > / dev
/ null
446 cp -r " $ThisDir " / drivers_
* " $InstallDir / $TargetDir /" 2 > / dev
/ null
447 elif [[ $Upgrade == 1 ||
$InstallToEspOnMac == 1 ]] ; then
448 if [[ $Platform == 'EFI64' ]] ; then
457 if [[ $Platform == 'EFI64' ]] ; then
459 elif [[ $Platform == 'EFI32' ]] ; then
460 Refind
= 'bootia32.efi'
463 elif [[ $Platform == 'EFI64' ||
$TargetDir == "/EFI/Microsoft/Boot" ]] ; then
464 cp " $RefindDir /refind_x64.efi" " $InstallDir / $TargetDir / $TargetX64 "
465 if [[ $?
!= 0 ]] ; then
470 Refind
= "refind_x64.efi"
472 if [[ " $ShimSource " != "none" ]] ; then
473 if [[ " $TargetShim " == "default" ]] ; then
474 TargetShim
= `basename " $ShimSource "`
478 if [[ $LocalKeys == 0 ]] ; then
479 echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir "
480 mkdir
-p " $EtcKeysDir "
481 cp " $ThisDir /keys/refind.cer" " $EtcKeysDir " 2 > / dev
/ null
482 cp " $ThisDir /keys/refind.crt" " $EtcKeysDir " 2 > / dev
/ null
485 if [[ " $TargetDir " == '/System/Library/CoreServices' ]] ; then
486 SetupMacHfs
$TargetX64
488 elif [[ $Platform == 'EFI32' ]] ; then
489 cp " $RefindDir /refind_ia32.efi" " $InstallDir / $TargetDir / $TargetIA32 "
490 if [[ $?
!= 0 ]] ; then
495 Refind
= "refind_ia32.efi"
496 if [[ " $TargetDir " == '/System/Library/CoreServices' ]] ; then
497 SetupMacHfs
$TargetIA32
500 echo "Unknown platform! Aborting!"
503 echo "Copied rEFInd binary files"
505 if [[ -d " $InstallDir / $TargetDir /icons" ]] ; then
506 rm -rf " $InstallDir / $TargetDir /icons-backup" &> / dev
/ null
507 mv -f " $InstallDir / $TargetDir /icons" " $InstallDir / $TargetDir /icons-backup"
508 echo "Notice: Backed up existing icons directory as icons-backup."
510 cp -r " $IconsDir " " $InstallDir / $TargetDir "
511 if [[ $?
!= 0 ]] ; then
514 mkdir
-p " $InstallDir / $TargetDir /keys"
515 cp -rf " $ThisDir " / keys
/* .
[ cd ] er
" $InstallDir / $TargetDir /keys/" 2 > / dev
/ null
516 cp -rf " $EtcKeysDir " /* .
[ cd ] er
" $InstallDir / $TargetDir /keys/" 2 > / dev
/ null
517 if [[ -f " $InstallDir / $TargetDir /refind.conf" ]] ; then
518 echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
519 echo "to avoid overwriting your customizations."
521 cp -f " $ConfFile " " $InstallDir / $TargetDir "
522 if [[ $?
!= 0 ]] ; then
526 echo "Copying sample configuration file as refind.conf; edit this file to configure"
529 cp -f " $ConfFile " " $InstallDir / $TargetDir /refind.conf"
530 if [[ $?
!= 0 ]] ; then
534 if [[ $DeleteRefindDir == 1 ]] ; then
535 echo "Deleting the temporary directory $RefindDir "
538 } # CopyRefindFiles()
540 # Mount the partition the user specified with the --usedefault or --ownhfs option
541 MountDefaultTarget
() {
542 InstallDir
=/ tmp
/ refind_install
543 mkdir
-p " $InstallDir "
545 if [[ $OSName == 'Darwin' ]] ; then
546 if [[ $OwnHfs == '1' ]] ; then
547 Temp
= `diskutil info " $TargetPart " | grep "Mount Point"`
548 InstallDir
= `echo $Temp | cut -f 3-30 -d ' '`
549 if [[ $InstallDir == '' ]] ; then
550 InstallDir
=/ tmp
/ refind_install
551 mount
-t hfs
" $TargetPart " " $InstallDir "
556 mount
-t msdos
" $TargetPart " " $InstallDir "
558 elif [[ $OSName == 'Linux' ]] ; then
559 mount
-t vfat
" $TargetPart " " $InstallDir "
561 if [[ $?
!= 0 ]] ; then
562 echo "Couldn't mount $TargetPart ! Aborting!"
566 } # MountDefaultTarget()
569 # A series of OS X support functions....
572 # Mount the ESP at /Volumes/ESP or determine its current mount
574 # Sets InstallDir to the ESP mount point
575 # Sets UnmountEsp if we mounted it
577 # Identify the ESP. Note: This returns the FIRST ESP found;
578 # if the system has multiple disks, this could be wrong!
579 Temp
= $
( mount |
sed -n -E "/^(\/dev\/disk[0-9]+s[0-9]+) on \/ \(.*$/s//\1/p" )
581 Temp
= $
( diskutil list |
grep " EFI " |
grep -o 'disk.*' |
head -n 1 )
582 if [ -z $Temp ]; then
583 echo "Warning: root device doesn't have an EFI partition"
586 echo "Warning: root device could not be found"
588 if [ -z $Temp ]; then
589 Temp
= $
( diskutil list |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
593 if [ -z $Temp ]; then
594 echo "Could not find an EFI partition. Aborting!"
598 Esp
=/ dev
/ `echo $Temp `
599 # If the ESP is mounted, use its current mount point....
600 Temp
= `df -P | grep " $Esp "`
601 InstallDir
= `echo $Temp | cut -f 6 -d ' '`
602 if [[ " $InstallDir " == '' ]] ; then
603 mkdir
/ Volumes
/ ESP
&> / dev
/ null
604 mount
-t msdos
" $Esp " / Volumes
/ ESP
605 # Some systems have HFS+ "ESPs." They shouldn't, but they do. If this is
606 # detected, mount it as such and set appropriate options.
607 if [[ $?
!= 0 ]] ; then
608 mount
-t hfs
" $Esp " / Volumes
/ Esp
611 if [[ $?
!= 0 ]] ; then
612 echo "Unable to mount ESP! Aborting! \n "
617 InstallDir
= "/Volumes/ESP"
621 # Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
622 # (http://mjg59.dreamwidth.org/7468.html)
623 # Must be passed the original rEFInd binary filename (without a path).
625 if [[ -s " $InstallDir /mach_kernel" ]] ; then
626 echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
629 cp -n " $InstallDir / $TargetDir /boot.efi" " $InstallDir / $TargetDir /boot.efi-backup" &> / dev
/ null
630 ln -f " $InstallDir / $TargetDir / $1 " " $InstallDir / $TargetDir /boot.efi"
631 touch " $InstallDir /mach_kernel"
632 rm " $InstallDir / $TargetDir /SystemVersion.plist" &> / dev
/ null
633 cat - << ENDOFHERE >> " $InstallDir / $TargetDir /SystemVersion.plist"
634 <xml version="1.0" encoding="UTF-8"?>
635 <plist version="1.0">
637 <key>ProductBuildVersion</key>
639 <key>ProductName</key>
640 <string>rEFInd</string>
641 <key>ProductVersion</key>
642 <string>0.7.6</string>
648 # Control the OS X installation.
649 # Sets Problems=1 if problems found during the installation.
651 echo "Installing rEFInd on OS X...."
652 if [[ " $InstallToEspOnMac " == "1" ]] ; then
654 elif [[ " $TargetDir " == "/EFI/BOOT" ||
" $OwnHfs " == '1' ]] ; then
657 InstallDir
= " $RootDir /"
659 echo "Installing rEFInd to the partition mounted at $InstallDir "
661 Platform
= `ioreg -l -p IODeviceTree | grep firmware-abi | cut -d " \" " -f 4`
663 if [[ $InstallToEspOnMac == "1" ]] ; then
664 bless
--mount " $InstallDir " --setBoot --file " $InstallDir / $TargetDir / $Refind "
665 elif [[ " $TargetDir " != "/EFI/BOOT" ]] ; then
666 bless
--setBoot --folder " $InstallDir / $TargetDir " --file " $InstallDir / $TargetDir / $Refind "
668 if [[ $?
!= 0 ]] ; then
671 if [[ -f / Library
/ StartupItems
/ rEFItBlesser ||
-d / Library
/ StartupItems
/ rEFItBlesser
]] ; then
673 echo "/Library/StartupItems/rEFItBlesser found!"
674 echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
675 echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
677 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
678 echo "Deleting /Library/StartupItems/rEFItBlesser..."
679 rm -r / Library
/ StartupItems
/ rEFItBlesser
681 echo "Not deleting rEFItBlesser."
685 echo "WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the"
686 echo "bless status with 'bless --info', since this is known to cause disk corruption"
687 echo "on some systems!!"
693 # Now a series of Linux support functions....
696 # Check for evidence that we're running in Secure Boot mode. If so, and if
697 # appropriate options haven't been set, warn the user and offer to abort.
698 # If we're NOT in Secure Boot mode but the user HAS specified the --shim
699 # or --localkeys option, warn the user and offer to abort.
701 # FIXME: Although I checked the presence (and lack thereof) of the
702 # /sys/firmware/efi/vars/SecureBoot* files on my Secure Boot test system
703 # before releasing this script, I've since found that they are at least
704 # sometimes present when Secure Boot is absent. This means that the first
705 # test can produce false alarms. A better test is highly desirable.
707 VarFile
= `ls -d /sys/firmware/efi/vars/SecureBoot* 2> /dev/null`
708 if [[ -n " $VarFile " && " $TargetDir " != '/EFI/BOOT' && " $ShimSource " == "none" ]] ; then
710 echo "CAUTION: Your computer appears to support Secure Boot, but you haven't"
711 echo "specified a valid shim.efi file source. If you've disabled Secure Boot and"
712 echo "intend to leave it disabled, this is fine; but if Secure Boot is active, the"
713 echo "resulting installation won't boot. You can read more about this topic at"
714 echo "http://www.rodsbooks.com/refind/secureboot.html."
716 echo -n "Do you want to proceed with installation (Y/N)? "
718 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
719 echo "OK; continuing with the installation..."
725 if [[ " $ShimSource " != "none" && ! -n " $VarFile " ]] ; then
727 echo "You've specified installing using a shim.efi file, but your computer does not"
728 echo "appear to be running in Secure Boot mode. Although installing in this way"
729 echo "should work, it's unnecessarily complex. You may continue, but unless you"
730 echo "plan to enable Secure Boot, you should consider stopping and omitting the"
731 echo "--shim option. You can read more about this topic at"
732 echo "http://www.rodsbooks.com/refind/secureboot.html."
734 echo -n "Do you want to proceed with installation (Y/N)? "
736 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
737 echo "OK; continuing with the installation..."
743 if [[ $LocalKeys != 0 && ! -n " $VarFile " ]] ; then
745 echo "You've specified re-signing your rEFInd binaries with locally-generated keys,"
746 echo "but your computer does not appear to be running in Secure Boot mode. The"
747 echo "keys you generate will be useless unless you enable Secure Boot. You may"
748 echo "proceed with this installation, but before you do so, you may want to read"
749 echo "more about it at http://www.rodsbooks.com/refind/secureboot.html."
751 echo -n "Do you want to proceed with installation (Y/N)? "
753 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
754 echo "OK; continuing with the installation..."
760 } # CheckSecureBoot()
762 # Check for the presence of locally-generated keys from a previous installation in
763 # $EtcKeysDir (/etc/refind.d/keys). If they're not present, generate them using
766 PrivateKey
= " $EtcKeysDir / $LocalKeysBase .key"
767 CertKey
= " $EtcKeysDir / $LocalKeysBase .crt"
768 DerKey
= " $EtcKeysDir / $LocalKeysBase .cer"
769 OpenSSL
= `which openssl 2> /dev/null`
771 # Do the work only if one or more of the necessary keys is missing
772 # TODO: Technically, we don't need the DerKey; but if it's missing and openssl
773 # is also missing, this will fail. This could be improved.
774 if [[ ! -f " $PrivateKey " ||
! -f " $CertKey " ||
! -f " $DerKey " ]] ; then
775 echo "Generating a fresh set of local keys...."
776 mkdir
-p " $EtcKeysDir "
777 chmod 0700 " $EtcKeysDir "
778 if [[ ! -x " $OpenSSL " ]] ; then
779 echo "Can't find openssl, which is required to create your private signing keys!"
783 if [[ -f " $PrivateKey " ]] ; then
784 echo "Backing up existing $PrivateKey "
785 cp -f " $PrivateKey " " $PrivateKey .backup" 2 > / dev
/ null
787 if [[ -f " $CertKey " ]] ; then
788 echo "Backing up existing $CertKey "
789 cp -f " $CertKey " " $CertKey .backup" 2 > / dev
/ null
791 if [[ -f " $DerKey " ]] ; then
792 echo "Backing up existing $DerKey "
793 cp -f " $DerKey " " $DerKey .backup" 2 > / dev
/ null
795 " $OpenSSL " req
-new -x509 -newkey rsa
: 2048 -keyout " $PrivateKey " -out " $CertKey " \
796 -nodes -days 3650 -subj "/CN=Locally-generated rEFInd key/"
797 " $OpenSSL " x509
-in " $CertKey " -out " $DerKey " -outform DER
798 chmod 0600 " $PrivateKey "
800 echo "Using existing local keys...."
804 # Sign a single binary. Requires parameters:
806 # $2 = destination file
807 # Also assumes that the SBSign, PESign, UseSBSign, UsePESign, and various key variables are set
809 # Aborts script on error
811 $SBSign --key " $PrivateKey " --cert " $CertKey " --output " $2 " " $1 "
812 if [[ $?
!= 0 ]] ; then
813 echo "Problem signing the binary $1 ! Aborting!"
818 # Re-sign the x86-64 binaries with a locally-generated key, First look for appropriate
819 # key files in $EtcKeysDir. If they're present, use them to re-sign the binaries. If
820 # not, try to generate new keys and store them in $EtcKeysDir.
822 SBSign
= `which sbsign 2> /dev/null`
823 echo "Found sbsign at $SBSign "
824 TempDir
= "/tmp/refind_local"
825 if [[ ! -x " $SBSign " ]] ; then
826 echo "Can't find sbsign, which is required to sign rEFInd with your own keys!"
831 mkdir
-p " $TempDir /drivers_x64"
832 cp " $RefindDir /refind.conf-sample $TempDir " 2 > / dev
/ null
833 cp " $ThisDir /refind.conf-sample $TempDir " 2 > / dev
/ null
834 cp " $RefindDir /refind_ia32.efi $TempDir " 2 > / dev
/ null
835 cp -a " $RefindDir /drivers_ia32 $TempDir " 2 > / dev
/ null
836 cp -a " $ThisDir /drivers_ia32 $TempDir " 2 > / dev
/ null
837 SignOneBinary
" $RefindDir /refind_x64.efi" " $TempDir /refind_x64.efi"
839 IFS
= $
( echo -en " \n\b " )
840 for Driver
in `ls " $RefindDir "/drivers_x64/*.efi " $ThisDir "/drivers_x64/*.efi 2> /dev/null` ; do
841 TempName
= `basename " $Driver "`
842 SignOneBinary
" $Driver " " $TempDir /drivers_x64/ $TempName "
849 # Locate and mount an ESP, if possible, based on parted output.
850 # Should be called only if /boot/efi is NOT an acceptable ESP.
851 # Sets InstallDir to the mounted ESP's path ($RootDir/boot/efi)
852 # and EspFilesystem the filesystem (always "vfat")
854 echo "The ESP doesn't seem to be mounted! Trying to find it...."
861 for Drive
in `ls /dev/[sh]d?` ; do
863 Dmraid
= `which dmraid 2> /dev/null`
864 if [ -x " $Dmraid " ] ; then
865 DmStatus
= `dmraid -r | grep $Drive `
866 if [ -n " $DmStatus " ] ; then
867 echo " $Drive seems to be part of a RAID array; skipping!"
871 TableType
= `parted $Drive print -m -s 2>/dev/null | awk -F: ' $1 == "' $Drive '" { print $6 }'`
872 if [[ $TableType == 'gpt' && $SkipIt == 0 ]] ; then # read only GPT disks that aren't part of dmraid array
873 PartNum
= `LANG=C parted $Drive print -m -s 2>/dev/null | awk -F: ' $7 ~ "(^boot| boot)" { print $1 }' | head -n 1`
874 if [ " $PartNum " -eq " $PartNum " ] 2 > / dev
/ null
; then
875 InstallDir
= " $RootDir /boot/efi"
877 mount
$Drive$PartNum $InstallDir
878 EspFilesystem
= `grep " $Drive $PartNum .*/boot/efi" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
879 if [[ $EspFilesystem != 'vfat' ]] ; then
882 echo "Mounting ESP at $InstallDir "
885 fi # $PartNum -eq $PartNum
890 # Identifies the ESP's location (/boot or /boot/efi, or these locations under
891 # the directory specified by --root); aborts if the ESP isn't mounted at
893 # Sets InstallDir to the ESP mount point.
895 mount
/ boot
&> / dev
/ null
896 mount
/ boot
/ efi
&> / dev
/ null
897 EspLine
= `df " $RootDir /boot/efi" 2> /dev/null | grep boot/efi`
898 if [[ ! -n " $EspLine " ]] ; then
899 EspLine
= `df " $RootDir "/boot | grep boot`
901 InstallDir
= `echo $EspLine | cut -d " " -f 6`
903 if [[ -n " $InstallDir " ]] ; then
904 EspFilesystem
= `grep -w " $InstallDir " /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
906 if [[ $EspFilesystem != 'vfat' ]] ; then
909 if [[ $EspFilesystem != 'vfat' ]] ; then
910 echo " $RootDir / $InstallDir doesn't seem to be on a VFAT filesystem. The ESP must be"
911 echo "mounted at $RootDir /boot or $RootDir /boot/efi and it must be VFAT! Aborting!"
914 echo "ESP was found at $InstallDir using $EspFilesystem "
917 # Uses efibootmgr to add an entry for rEFInd to the EFI's NVRAM.
918 # If this fails, sets Problems=1
922 Efibootmgr
= `which efibootmgr 2> /dev/null`
923 if [[ " $Efibootmgr " ]] ; then
924 InstallDisk
= `grep " $InstallDir " /etc/mtab | cut -d " " -f 1 | cut -c 1-8`
925 PartNum
= `grep " $InstallDir " /etc/mtab | cut -d " " -f 1 | cut -c 9-10`
926 EntryFilename
= " $TargetDir / $Refind "
927 EfiEntryFilename
= `echo ${EntryFilename//\//\\\} `
928 EfiEntryFilename2
= `echo ${EfiEntryFilename} | sed s/ \\\\\\\\ / \\\\\\\\\\\\\\\\ /g`
929 ExistingEntry
= `" $Efibootmgr " -v | grep -i " $EfiEntryFilename2 "`
931 if [[ " $ExistingEntry " ]] ; then
932 ExistingEntryBootNum
= `echo " $ExistingEntry " | cut -c 5-8`
933 FirstBoot
= `" $Efibootmgr " | grep BootOrder | cut -c 12-15`
934 if [[ " $ExistingEntryBootNum " != " $FirstBoot " ]] ; then
935 echo "An existing rEFInd boot entry exists, but isn't set as the default boot"
936 echo "manager. The boot order is being adjusted to make rEFInd the default boot"
937 echo "manager. If this is NOT what you want, you should use efibootmgr to"
938 echo "manually adjust your EFI's boot order."
939 " $Efibootmgr " -b $ExistingEntryBootNum -B &> / dev
/ null
946 if [[ $InstallIt == "1" ]] ; then
947 echo "Installing it!"
948 " $Efibootmgr " -c -l " $EfiEntryFilename " -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum &> / dev
/ null
949 if [[ $?
!= 0 ]] ; then
955 else # efibootmgr not found
960 if [[ $EfibootmgrProblems ]] ; then
962 echo "ALERT: There were problems running the efibootmgr program! You may need to"
963 echo "rename the $Refind binary to the default name (EFI/boot/bootx64.efi"
964 echo "on x86-64 systems or EFI/boot/bootia32.efi on x86 systems) to have it run!"
967 echo "rEFInd has been set as the default boot manager."
971 # Create a minimal/sample refind_linux.conf file in /boot.
972 GenerateRefindLinuxConf
() {
973 if [[ -f " $RLConfFile " ]] ; then
974 echo "Existing $RLConfFile found; not overwriting."
976 echo "Creating $RLConfFile ; edit it to adjust kernel options."
977 if [[ -f " $RootDir /etc/default/grub" ]] ; then
978 # We want the default options used by the distribution, stored here....
979 source " $RootDir /etc/default/grub"
980 echo "Setting default boot options based on $RootDir /etc/default/grub"
982 RootFS
= `df " $RootDir " | grep dev | cut -f 1 -d " "`
983 StartOfDevname
= `echo " $RootFS " | cut -b 1-7`
984 if [[ " $StartOfDevname " == "/dev/sd" ||
" $StartOfDevName " == "/dev/hd" ]] ; then
985 # Identify root filesystem by UUID rather than by device node, if possible
986 Uuid
= `blkid -o export -s UUID " $RootFS " 2> /dev/null | grep UUID=`
987 if [[ -n $Uuid ]] ; then
991 DefaultOptions
= " $GRUB_CMDLINE_LINUX $GRUB_CMDLINE_LINUX_DEFAULT "
992 echo " \" Boot with standard options \" \" ro root= $RootFS $DefaultOptions \" " > $RLConfFile
993 echo " \" Boot to single-user mode \" \" ro root= $RootFS $DefaultOptions single \" " >> $RLConfFile
994 echo " \" Boot with minimal options \" \" ro root= $RootFS \" " >> $RLConfFile
998 # Controls rEFInd installation under Linux.
999 # Sets Problems=1 if something goes wrong.
1001 if [[ " $TargetDir " == "/System/Library/CoreServices" ]] ; then
1002 echo "You may not use the --ownhfs option under Linux! Aborting!"
1005 echo "Installing rEFInd on Linux...."
1006 modprobe efivars
&> / dev
/ null
1007 if [[ $TargetDir == "/EFI/BOOT" ]] ; then
1014 if [[ $CpuType == 'x86_64' ]] ; then
1016 elif [[ ( $CpuType == 'i386' ||
$CpuType == 'i486' ||
$CpuType == 'i586' ||
$CpuType == 'i686' ) ]] ; then
1018 # If we're in EFI mode, do some sanity checks, and alert the user or even
1019 # abort. Not in BIOS mode, though, since that could be used on an emergency
1020 # disc to try to recover a troubled Linux installation.
1021 if [[ -d / sys
/ firmware
/ efi
]] ; then
1022 if [[ " $ShimSource " != "none" && " $TargetDir " != "/BOOT/EFI" ]] ; then
1024 echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
1025 echo "use the --shim option to install on such systems. Aborting!"
1030 echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
1031 echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
1032 echo "on a 64-bit computer, you should manually install the 64-bit version of"
1033 echo "rEFInd. If you're installing on a Mac, you should do so from OS X. If"
1034 echo "you're positive you want to continue with this installation, answer 'Y'"
1035 echo "to the following question..."
1037 echo -n "Are you sure you want to continue (Y/N)? "
1039 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
1040 echo "OK; continuing with the installation..."
1046 echo "Unknown CPU type ' $CpuType '; aborting!"
1050 if [[ $LocalKeys == 1 ]] ; then
1056 if [[ " $TargetDir " != "/EFI/BOOT" && " $TargetDir " != "/EFI/Microsoft/Boot" ]] ; then
1058 GenerateRefindLinuxConf
1060 } # InstallOnLinux()
1063 # The main part of the script. Sets a few environment variables,
1064 # performs a few startup checks, and then calls functions to
1065 # install under OS X or Linux, depending on the detected platform.
1069 ThisDir
= "$( cd -P " $
( dirname " ${BASH_SOURCE[0]} " ) " && pwd )"
1070 RefindDir
= " $ThisDir /refind"
1071 ThisScript
= " $ThisDir /`basename $0 `"
1072 if [[ `whoami` != "root" ]] ; then
1073 echo "Not running as root; attempting to elevate privileges via sudo...."
1074 sudo
" $ThisScript " "$@"
1075 if [[ $?
!= 0 ]] ; then
1076 echo "This script must be run as root (or using sudo). Exiting!"
1083 if [[ $OSName == 'Darwin' ]] ; then
1084 if [[ " $ShimSource " != "none" ]] ; then
1085 echo "The --shim option is not supported on OS X! Exiting!"
1088 if [[ " $LocalKeys " != 0 ]] ; then
1089 echo "The --localkeys option is not supported on OS X! Exiting!"
1092 if [[ $InstallToEspOnMac == 1 ]] ; then
1094 TargetX64
= "bootx64.efi"
1095 TargetIA32
= "bootia32.efi"
1098 elif [[ $OSName == 'Linux' ]] ; then
1101 echo "Running on unknown OS; aborting!"
1102 if [[ " $InstallToEspOnMac " == 0 ]] ; then
1103 echo "The --notesp option is not supported on Linux! Exiting!"
1108 if [[ $Problems ]] ; then
1111 echo "Installation has completed, but problems were detected. Review the output for"
1112 echo "error messages and take corrective measures as necessary. You may need to"
1113 echo "re-run this script or install manually before rEFInd will work."
1117 echo "Installation has completed successfully."
1121 if [[ $UnmountEsp == '1' ]] ; then
1122 echo "Unmounting install dir"
1126 if [[ " $InstallDir " == / tmp
/ refind_install
]] ; then