]>
code.delx.au - refind/blob - install.sh
3 # Linux/MacOS X script to install rEFInd
7 # ./install.sh [options]
10 # "--esp" to install to the ESP rather than to the system's root
11 # filesystem. This is the default on 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 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.7.9 -- Fixed bug that caused errors if dmraid utility not installed
39 # 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
40 # to locate and mount ESP on Linux, if it's not mounted
41 # 0.7.6 -- Added --ownhfs {device-filename} option
42 # 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
43 # 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
44 # 0.7.0 -- Added support for the new Btrfs driver
45 # 0.6.12 -- Added support for PreLoader as well as for shim
46 # 0.6.11 -- Improvements in script's ability to handle directories with spaces
48 # 0.6.9 -- Install gptsync on Macs
49 # 0.6.8 -- Bug fix: ESP scan now uses "uniq".
50 # 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
51 # copying shim.efi and MokManager.efi over themselves.
52 # 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
53 # 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
54 # directories & for installing to EFI/BOOT in BIOS mode
55 # 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
56 # 0.6.1 -- Added --root option; minor bug fixes
57 # 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
58 # changed default driver installation behavior in Linux to install
59 # the driver needed to read /boot (if available)
60 # 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
61 # 0.5.1.1 -- Fixed bug that caused script failure under OS X
62 # 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
64 # 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
65 # 0.4.5 -- Fixed check for rEFItBlesser in OS X
66 # 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
67 # 0.4.1 -- Added check for rEFItBlesser in OS X
68 # 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
69 # 0.3.2.1 -- Check for presence of source files; aborts if not present
70 # 0.3.2 -- Initial version
72 # Note: install.sh version numbers match those of the rEFInd package
73 # with which they first appeared.
77 LocalKeysBase
="refind_local"
81 TargetX64
="refind_x64.efi"
82 TargetIA32
="refind_ia32.efi"
88 # Functions used by both OS X and Linux....
93 if [[ $OSName == "Linux" ]] ; then
94 # Install the driver required to read /boot, if it's available
99 while [[ $# -gt 0 ]]; do
101 --esp |
--ESP) InstallToEspOnMac
=1
105 TargetDir
=/System
/Library
/CoreServices
108 --usedefault) TargetDir
=/EFI
/BOOT
110 TargetX64
="bootx64.efi"
111 TargetIA32
="bootia32.efi"
117 --localkeys) LocalKeys
=1
119 --shim |
--preloader) ShimSource
="$2"
120 ShimType
=`basename $ShimSource`
123 --drivers |
--alldrivers) InstallDrivers
="all"
125 --nodrivers) InstallDrivers
="none"
129 * ) echo "Usage: $0 [--esp | --usedefault {device-file} | --root {directory} |"
130 echo " --ownhfs {device-file} ]"
131 echo " [--nodrivers | --alldrivers] [--shim {shim-filename}]"
132 echo " [--localkeys] [--yes]"
138 if [[ $InstallToEspOnMac == 1 && "$TargetDir" == '/EFI/BOOT' ]] ; then
139 echo "You may use --esp OR --usedefault, but not both! Aborting!"
142 if [[ "$RootDir" != '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
143 echo "You may use --usedefault OR --root, but not both! Aborting!"
146 if [[ "$RootDir" != '/' && $InstallToEspOnMac == 1 ]] ; then
147 echo "You may use --root OR --esp, but not both! Aborting!"
150 if [[ "$TargetDir" != '/System/Library/CoreServices' && "$OwnHfs" == '1' ]] ; then
151 echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
155 RLConfFile
="$RootDir/boot/refind_linux.conf"
156 EtcKeysDir
="$RootDir/etc/refind.d/keys"
159 # Get a yes/no response from the user and place it in the YesNo variable.
160 # If the AlwaysYes variable is set to 1, skip the user input and set "Y"
161 # in the YesNo variable.
163 if [[ $AlwaysYes == 1 ]] ; then
171 # Abort if the rEFInd files can't be found.
172 # Also sets $ConfFile to point to the configuration file,
173 # $IconsDir to point to the icons directory, and
174 # $ShimSource to the source of the shim.efi file (if necessary).
176 # Note: This check is satisfied if EITHER the 32- or the 64-bit version
177 # is found, even on the wrong platform. This is because the platform
178 # hasn't yet been determined. This could obviously be improved, but it
179 # would mean restructuring lots more code....
180 if [[ ! -f "$RefindDir/refind_ia32.efi" && ! -f "$RefindDir/refind_x64.efi" ]] ; then
181 echo "The rEFInd binary file is missing! Aborting installation!"
185 if [[ -f "$RefindDir/refind.conf-sample" ]] ; then
186 ConfFile
="$RefindDir/refind.conf-sample"
187 elif [[ -f "$ThisDir/refind.conf-sample" ]] ; then
188 ConfFile
="$ThisDir/refind.conf-sample"
190 echo "The sample configuration file is missing! Aborting installation!"
194 if [[ -d "$RefindDir/icons" ]] ; then
195 IconsDir
="$RefindDir/icons"
196 elif [[ -d "$ThisDir/icons" ]] ; then
197 IconsDir
="$ThisDir/icons"
199 echo "The icons directory is missing! Aborting installation!"
203 if [[ "$ShimSource" != "none" ]] ; then
204 if [[ -f "$ShimSource" ]] ; then
205 if [[ $ShimType == "shimx64.efi" ||
$ShimType == "shim.efi" ]] ; then
206 TargetX64
="grubx64.efi"
207 MokManagerSource
=`dirname "$ShimSource"`/MokManager.efi
208 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
209 TargetX64
="loader.efi"
210 MokManagerSource
=`dirname "$ShimSource"`/HashTool.efi
212 echo "Unknown shim/PreBootloader filename: $ShimType!"
213 echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
217 echo "The specified shim/PreBootloader file, $ShimSource, doesn't exist!"
218 echo "Aborting installation!"
224 # Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
225 # available) to target.
227 cp -fb "$ShimSource" "$InstallDir/$TargetDir/$TargetShim"
228 if [[ $?
!= 0 ]] ; then
231 if [[ -f "$MokManagerSource" ]] ; then
232 cp -fb "$MokManagerSource" "$InstallDir/$TargetDir/"
234 if [[ $?
!= 0 ]] ; then
239 # Copy the public keys to the installation medium
241 if [[ $LocalKeys == 1 ]] ; then
242 mkdir
-p "$InstallDir/$TargetDir/keys/"
243 cp "$EtcKeysDir/$LocalKeysBase.cer" "$InstallDir/$TargetDir/keys/"
244 cp "$EtcKeysDir/$LocalKeysBase.crt" "$InstallDir/$TargetDir/keys/"
248 # Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
249 # honoring the $InstallDrivers condition. Must be passed a suitable
250 # architecture code (ia32 or x64).
254 Blkid
=`which blkid 2> /dev/null`
255 if [[ $InstallDrivers == "all" ]] ; then
256 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
257 cp "$ThisDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
258 cp "$RefindDir"/drivers_
$1/*_
$1.efi
"$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
259 elif [[ "$InstallDrivers" == "boot" && -x "$Blkid" ]] ; then
260 BootPart
=`df /boot | grep dev | cut -f 1 -d " "`
261 BootFS
=`$Blkid -o export $BootPart 2> /dev/null | grep TYPE= | cut -f 2 -d =`
264 ext2 | ext3
) DriverType
="ext2"
265 # Could use ext4, but that can create unwanted entries from symbolic
266 # links in / to /boot/vmlinuz if a separate /boot partition is used.
268 ext4
) DriverType
="ext4"
270 reiserfs
) DriverType
="reiserfs"
272 btrfs
) DriverType
="btrfs"
274 hfsplus
) DriverType
="hfs"
278 if [[ -n $BootFS ]] ; then
279 echo "Installing driver for $BootFS (${DriverType}_$1.efi)"
280 mkdir
-p "$InstallDir/$TargetDir/drivers_$1"
281 cp "$ThisDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1/" 2> /dev
/null
282 cp "$RefindDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1"/ 2> /dev
/null
287 # Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
288 # directory on the ESP. Must be passed a suitable architecture code (ia32
291 mkdir
-p $InstallDir/EFI
/tools
292 if [[ $OSName == 'Darwin' ]] ; then
293 cp -f "$RefindDir/tools_$1/gptsync_$1.efi" "$InstallDir/EFI/tools/"
294 if [[ -f "$InstallDir/EFI/tools/gptsync.efi" ]] ; then
295 mv "$InstallDir/EFI/tools/gptsync.efi" "$InstallDir/EFI/tools/gptsync.efi-disabled"
296 echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
301 # Copy the rEFInd files to the ESP or OS X root partition.
302 # Sets Problems=1 if any critical commands fail.
304 mkdir
-p "$InstallDir/$TargetDir"
305 if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
306 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" 2> /dev
/null
307 if [[ $?
!= 0 ]] ; then
308 echo "Note: IA32 (x86) binary not installed!"
310 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" 2> /dev
/null
311 if [[ $?
!= 0 ]] ; then
314 if [[ "$ShimSource" != "none" ]] ; then
315 TargetShim
="bootx64.efi"
318 if [[ $InstallDrivers == "all" ]] ; then
319 cp -r "$RefindDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
320 cp -r "$ThisDir"/drivers_
* "$InstallDir/$TargetDir/" 2> /dev
/null
321 elif [[ $Upgrade == 1 ]] ; then
322 if [[ $Platform == 'EFI64' ]] ; then
332 elif [[ $Platform == 'EFI64' ||
$TargetDir == "/EFI/Microsoft/Boot" ]] ; then
333 cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64"
334 if [[ $?
!= 0 ]] ; then
339 Refind
="refind_x64.efi"
341 if [[ "$ShimSource" != "none" ]] ; then
342 if [[ "$TargetShim" == "default" ]] ; then
343 TargetShim
=`basename "$ShimSource"`
347 if [[ $LocalKeys == 0 ]] ; then
348 echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir"
349 mkdir
-p "$EtcKeysDir"
350 cp "$ThisDir/keys/refind.cer" "$EtcKeysDir" 2> /dev
/null
351 cp "$ThisDir/keys/refind.crt" "$EtcKeysDir" 2> /dev
/null
354 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
355 SetupMacHfs
$TargetX64
357 elif [[ $Platform == 'EFI32' ]] ; then
358 cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32"
359 if [[ $?
!= 0 ]] ; then
364 Refind
="refind_ia32.efi"
365 if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
366 SetupMacHfs
$TargetIA32
369 echo "Unknown platform! Aborting!"
372 echo "Copied rEFInd binary files"
374 if [[ -d "$InstallDir/$TargetDir/icons" ]] ; then
375 rm -rf "$InstallDir/$TargetDir/icons-backup" &> /dev
/null
376 mv -f "$InstallDir/$TargetDir/icons" "$InstallDir/$TargetDir/icons-backup"
377 echo "Notice: Backed up existing icons directory as icons-backup."
379 cp -r "$IconsDir" "$InstallDir/$TargetDir"
380 if [[ $?
!= 0 ]] ; then
383 mkdir
-p "$InstallDir/$TargetDir/keys"
384 cp -rf "$ThisDir"/keys
/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
385 cp -rf "$EtcKeysDir"/*.
[cd]er
"$InstallDir/$TargetDir/keys/" 2> /dev
/null
386 if [[ -f "$InstallDir/$TargetDir/refind.conf" ]] ; then
387 echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
388 echo "to avoid overwriting your customizations."
390 cp -f "$ConfFile" "$InstallDir/$TargetDir"
391 if [[ $?
!= 0 ]] ; then
395 echo "Copying sample configuration file as refind.conf; edit this file to configure"
398 cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf"
399 if [[ $?
!= 0 ]] ; then
403 if [[ $DeleteRefindDir == 1 ]] ; then
404 echo "Deleting the temporary directory $RefindDir"
407 } # CopyRefindFiles()
409 # Mount the partition the user specified with the --usedefault or --ownhfs option
410 MountDefaultTarget
() {
411 InstallDir
=/tmp
/refind_install
412 mkdir
-p "$InstallDir"
414 if [[ $OSName == 'Darwin' ]] ; then
415 if [[ $OwnHfs == '1' ]] ; then
416 Temp
=`diskutil info "$TargetPart" | grep "Mount Point"`
417 InstallDir
=`echo $Temp | cut -f 3-30 -d ' '`
418 if [[ $InstallDir == '' ]] ; then
419 InstallDir
=/tmp
/refind_install
420 mount
-t hfs
"$TargetPart" "$InstallDir"
425 mount
-t msdos
"$TargetPart" "$InstallDir"
427 elif [[ $OSName == 'Linux' ]] ; then
428 mount
-t vfat
"$TargetPart" "$InstallDir"
430 if [[ $?
!= 0 ]] ; then
431 echo "Couldn't mount $TargetPart ! Aborting!"
435 echo "UnmountEsp = $UnmountEsp"
436 } # MountDefaultTarget()
439 # A series of OS X support functions....
442 # Mount the ESP at /Volumes/ESP or determine its current mount
444 # Sets InstallDir to the ESP mount point
445 # Sets UnmountEsp if we mounted it
447 # Identify the ESP. Note: This returns the FIRST ESP found;
448 # if the system has multiple disks, this could be wrong!
449 Temp
=$
(mount |
sed -n -E "/^(\/dev\/disk[0-9]+s[0-9]+) on \/ \(.*$/s//\1/p")
451 Temp
=$
(diskutil list
$Temp |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
454 if [ -z $Temp ]; then
455 echo "Warning: root device doesn't have an EFI partition"
458 echo "Warning: root device could not be found"
460 if [ -z $Temp ]; then
461 Temp
=$
(diskutil list |
sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
465 if [ -z $Temp ]; then
466 echo "Could not find an EFI partition. Aborting!"
470 Esp
=/dev
/`echo $Temp`
471 # If the ESP is mounted, use its current mount point....
472 Temp
=`df -P | grep "$Esp"`
473 InstallDir
=`echo $Temp | cut -f 6 -d ' '`
474 if [[ "$InstallDir" == '' ]] ; then
475 mkdir
/Volumes
/ESP
&> /dev
/null
476 mount
-t msdos
"$Esp" /Volumes
/ESP
477 if [[ $?
!= 0 ]] ; then
478 echo "Unable to mount ESP! Aborting!\n"
482 InstallDir
="/Volumes/ESP"
486 # Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
487 # (http://mjg59.dreamwidth.org/7468.html)
488 # Must be passed the original rEFInd binary filename (without a path).
490 if [[ -s "$InstallDir/mach_kernel" ]] ; then
491 echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
494 cp -n "$InstallDir/$TargetDir/boot.efi" "$InstallDir/$TargetDir/boot.efi-backup" &> /dev
/null
495 ln -f "$InstallDir/$TargetDir/$1" "$InstallDir/$TargetDir/boot.efi"
496 touch "$InstallDir/mach_kernel"
497 rm "$InstallDir/$TargetDir/SystemVersion.plist" &> /dev
/null
498 cat - << ENDOFHERE >> "$InstallDir/$TargetDir/SystemVersion.plist"
499 <xml version="1.0" encoding="UTF-8"?>
500 <plist version="1.0">
502 <key>ProductBuildVersion</key>
504 <key>ProductName</key>
505 <string>rEFInd</string>
506 <key>ProductVersion</key>
507 <string>0.7.6</string>
513 # Control the OS X installation.
514 # Sets Problems=1 if problems found during the installation.
516 echo "Installing rEFInd on OS X...."
517 if [[ "$TargetDir" == "/EFI/BOOT" ||
"$OwnHfs" == '1' ]] ; then
519 elif [[ "$InstallToEspOnMac" == "1" ]] ; then
522 InstallDir
="$RootDir/"
524 echo "Installing rEFInd to the partition mounted at $InstallDir"
525 Platform
=`ioreg -l -p IODeviceTree | grep firmware-abi | cut -d "\"" -f 4`
527 if [[ $InstallToEspOnMac == "1" ]] ; then
528 bless
--mount "$InstallDir" --setBoot --file "$InstallDir/$TargetDir/$Refind"
529 elif [[ "$TargetDir" != "/EFI/BOOT" ]] ; then
530 bless
--setBoot --folder "$InstallDir/$TargetDir" --file "$InstallDir/$TargetDir/$Refind"
532 if [[ $?
!= 0 ]] ; then
535 if [[ -f /Library
/StartupItems
/rEFItBlesser ||
-d /Library
/StartupItems
/rEFItBlesser
]] ; then
537 echo "/Library/StartupItems/rEFItBlesser found!"
538 echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
539 echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
541 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
542 echo "Deleting /Library/StartupItems/rEFItBlesser..."
543 rm -r /Library
/StartupItems
/rEFItBlesser
545 echo "Not deleting rEFItBlesser."
549 echo "WARNING: If you have an Advanced Format disk, *DO NOT* attempt to check the"
550 echo "bless status with 'bless --info', since this is known to cause disk corruption"
551 echo "on some systems!!"
557 # Now a series of Linux support functions....
560 # Check for evidence that we're running in Secure Boot mode. If so, and if
561 # appropriate options haven't been set, warn the user and offer to abort.
562 # If we're NOT in Secure Boot mode but the user HAS specified the --shim
563 # or --localkeys option, warn the user and offer to abort.
565 # FIXME: Although I checked the presence (and lack thereof) of the
566 # /sys/firmware/efi/vars/SecureBoot* files on my Secure Boot test system
567 # before releasing this script, I've since found that they are at least
568 # sometimes present when Secure Boot is absent. This means that the first
569 # test can produce false alarms. A better test is highly desirable.
571 VarFile
=`ls -d /sys/firmware/efi/vars/SecureBoot* 2> /dev/null`
572 if [[ -n "$VarFile" && "$TargetDir" != '/EFI/BOOT' && "$ShimSource" == "none" ]] ; then
574 echo "CAUTION: Your computer appears to support Secure Boot, but you haven't"
575 echo "specified a valid shim.efi file source. If you've disabled Secure Boot and"
576 echo "intend to leave it disabled, this is fine; but if Secure Boot is active, the"
577 echo "resulting installation won't boot. You can read more about this topic at"
578 echo "http://www.rodsbooks.com/refind/secureboot.html."
580 echo -n "Do you want to proceed with installation (Y/N)? "
582 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
583 echo "OK; continuing with the installation..."
589 if [[ "$ShimSource" != "none" && ! -n "$VarFile" ]] ; then
591 echo "You've specified installing using a shim.efi file, but your computer does not"
592 echo "appear to be running in Secure Boot mode. Although installing in this way"
593 echo "should work, it's unnecessarily complex. You may continue, but unless you"
594 echo "plan to enable Secure Boot, you should consider stopping and omitting the"
595 echo "--shim option. You can read more about this topic at"
596 echo "http://www.rodsbooks.com/refind/secureboot.html."
598 echo -n "Do you want to proceed with installation (Y/N)? "
600 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
601 echo "OK; continuing with the installation..."
607 if [[ $LocalKeys != 0 && ! -n "$VarFile" ]] ; then
609 echo "You've specified re-signing your rEFInd binaries with locally-generated keys,"
610 echo "but your computer does not appear to be running in Secure Boot mode. The"
611 echo "keys you generate will be useless unless you enable Secure Boot. You may"
612 echo "proceed with this installation, but before you do so, you may want to read"
613 echo "more about it at http://www.rodsbooks.com/refind/secureboot.html."
615 echo -n "Do you want to proceed with installation (Y/N)? "
617 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
618 echo "OK; continuing with the installation..."
624 } # CheckSecureBoot()
626 # Check for the presence of locally-generated keys from a previous installation in
627 # $EtcKeysDir (/etc/refind.d/keys). If they're not present, generate them using
630 PrivateKey
="$EtcKeysDir/$LocalKeysBase.key"
631 CertKey
="$EtcKeysDir/$LocalKeysBase.crt"
632 DerKey
="$EtcKeysDir/$LocalKeysBase.cer"
633 OpenSSL
=`which openssl 2> /dev/null`
635 # Do the work only if one or more of the necessary keys is missing
636 # TODO: Technically, we don't need the DerKey; but if it's missing and openssl
637 # is also missing, this will fail. This could be improved.
638 if [[ ! -f "$PrivateKey" ||
! -f "$CertKey" ||
! -f "$DerKey" ]] ; then
639 echo "Generating a fresh set of local keys...."
640 mkdir
-p "$EtcKeysDir"
641 chmod 0700 "$EtcKeysDir"
642 if [[ ! -x "$OpenSSL" ]] ; then
643 echo "Can't find openssl, which is required to create your private signing keys!"
647 if [[ -f "$PrivateKey" ]] ; then
648 echo "Backing up existing $PrivateKey"
649 cp -f "$PrivateKey" "$PrivateKey.backup" 2> /dev
/null
651 if [[ -f "$CertKey" ]] ; then
652 echo "Backing up existing $CertKey"
653 cp -f "$CertKey" "$CertKey.backup" 2> /dev
/null
655 if [[ -f "$DerKey" ]] ; then
656 echo "Backing up existing $DerKey"
657 cp -f "$DerKey" "$DerKey.backup" 2> /dev
/null
659 "$OpenSSL" req
-new -x509 -newkey rsa
:2048 -keyout "$PrivateKey" -out "$CertKey" \
660 -nodes -days 3650 -subj "/CN=Locally-generated rEFInd key/"
661 "$OpenSSL" x509
-in "$CertKey" -out "$DerKey" -outform DER
662 chmod 0600 "$PrivateKey"
664 echo "Using existing local keys...."
668 # Sign a single binary. Requires parameters:
670 # $2 = destination file
671 # Also assumes that the SBSign, PESign, UseSBSign, UsePESign, and various key variables are set
673 # Aborts script on error
675 $SBSign --key "$PrivateKey" --cert "$CertKey" --output "$2" "$1"
676 if [[ $?
!= 0 ]] ; then
677 echo "Problem signing the binary $1! Aborting!"
682 # Re-sign the x86-64 binaries with a locally-generated key, First look for appropriate
683 # key files in $EtcKeysDir. If they're present, use them to re-sign the binaries. If
684 # not, try to generate new keys and store them in $EtcKeysDir.
686 SBSign
=`which sbsign 2> /dev/null`
687 echo "Found sbsign at $SBSign"
688 TempDir
="/tmp/refind_local"
689 if [[ ! -x "$SBSign" ]] ; then
690 echo "Can't find sbsign, which is required to sign rEFInd with your own keys!"
695 mkdir
-p "$TempDir/drivers_x64"
696 cp "$RefindDir/refind.conf-sample $TempDir" 2> /dev
/null
697 cp "$ThisDir/refind.conf-sample $TempDir" 2> /dev
/null
698 cp "$RefindDir/refind_ia32.efi $TempDir" 2> /dev
/null
699 cp -a "$RefindDir/drivers_ia32 $TempDir" 2> /dev
/null
700 cp -a "$ThisDir/drivers_ia32 $TempDir" 2> /dev
/null
701 SignOneBinary
"$RefindDir/refind_x64.efi" "$TempDir/refind_x64.efi"
703 IFS
=$
(echo -en "\n\b")
704 for Driver
in `ls "$RefindDir"/drivers_x64/*.efi "$ThisDir"/drivers_x64/*.efi 2> /dev/null` ; do
705 TempName
=`basename "$Driver"`
706 SignOneBinary
"$Driver" "$TempDir/drivers_x64/$TempName"
713 # Locate and mount an ESP, if possible, based on parted output.
714 # Should be called only if /boot/efi is NOT an acceptable ESP.
715 # Sets InstallDir to the mounted ESP's path ($RootDir/boot/efi)
716 # and EspFilesystem the filesystem (always "vfat")
718 echo "The ESP doesn't seem to be mounted! Trying to find it...."
725 for Drive
in `ls /dev/[sh]d?` ; do
727 Dmraid
=`which dmraid 2> /dev/null`
728 if [ -x "$Dmraid" ] ; then
729 DmStatus
=`dmraid -r | grep $Drive`
730 if [ -n "$DmStatus" ] ; then
731 echo "$Drive seems to be part of a RAID array; skipping!"
735 TableType
=`parted $Drive print -m -s 2>/dev/null | awk -F: '$1 == "'$Drive'" { print $6 }'`
736 if [[ $TableType == 'gpt' && $SkipIt == 0 ]] ; then # read only GPT disks that aren't part of dmraid array
737 PartNum
=`LANG=C parted $Drive print -m -s 2>/dev/null | awk -F: '$7 ~ "(^boot| boot)" { print $1 }' | head -n 1`
738 if [ "$PartNum" -eq "$PartNum" ] 2> /dev
/null
; then
739 InstallDir
="$RootDir/boot/efi"
741 mount
$Drive$PartNum $InstallDir
742 EspFilesystem
=`grep "$Drive$PartNum.*/boot/efi" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
743 if [[ $EspFilesystem != 'vfat' ]] ; then
746 echo "Mounting ESP at $InstallDir"
749 fi # $PartNum -eq $PartNum
754 # Identifies the ESP's location (/boot or /boot/efi, or these locations under
755 # the directory specified by --root); aborts if the ESP isn't mounted at
757 # Sets InstallDir to the ESP mount point.
759 mount
/boot
&> /dev
/null
760 mount
/boot
/efi
&> /dev
/null
761 EspLine
=`df "$RootDir/boot/efi" 2> /dev/null | grep boot/efi`
762 if [[ ! -n "$EspLine" ]] ; then
763 EspLine
=`df "$RootDir"/boot | grep boot`
765 InstallDir
=`echo $EspLine | cut -d " " -f 6`
767 if [[ -n "$InstallDir" ]] ; then
768 EspFilesystem
=`grep "$InstallDir" /etc/mtab | uniq | grep -v autofs | cut -d " " -f 3`
770 if [[ $EspFilesystem != 'vfat' ]] ; then
773 if [[ $EspFilesystem != 'vfat' ]] ; then
774 echo "$RootDir/$InstallDir doesn't seem to be on a VFAT filesystem. The ESP must be"
775 echo "mounted at $RootDir/boot or $RootDir/boot/efi and it must be VFAT! Aborting!"
778 echo "ESP was found at $InstallDir using $EspFilesystem"
781 # Uses efibootmgr to add an entry for rEFInd to the EFI's NVRAM.
782 # If this fails, sets Problems=1
786 Efibootmgr
=`which efibootmgr 2> /dev/null`
787 if [[ "$Efibootmgr" ]] ; then
788 InstallDisk
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 1-8`
789 PartNum
=`grep "$InstallDir" /etc/mtab | cut -d " " -f 1 | cut -c 9-10`
790 EntryFilename
="$TargetDir/$Refind"
791 EfiEntryFilename
=`echo ${EntryFilename//\//\\\}`
792 EfiEntryFilename2
=`echo ${EfiEntryFilename} | sed s/\\\\\\\\/\\\\\\\\\\\\\\\\/g`
793 ExistingEntry
=`"$Efibootmgr" -v | grep -i "$EfiEntryFilename2"`
795 if [[ "$ExistingEntry" ]] ; then
796 ExistingEntryBootNum
=`echo "$ExistingEntry" | cut -c 5-8`
797 FirstBoot
=`"$Efibootmgr" | grep BootOrder | cut -c 12-15`
798 if [[ "$ExistingEntryBootNum" != "$FirstBoot" ]] ; then
799 echo "An existing rEFInd boot entry exists, but isn't set as the default boot"
800 echo "manager. The boot order is being adjusted to make rEFInd the default boot"
801 echo "manager. If this is NOT what you want, you should use efibootmgr to"
802 echo "manually adjust your EFI's boot order."
803 "$Efibootmgr" -b $ExistingEntryBootNum -B &> /dev
/null
810 if [[ $InstallIt == "1" ]] ; then
811 echo "Installing it!"
812 "$Efibootmgr" -c -l "$EfiEntryFilename" -L "rEFInd Boot Manager" -d $InstallDisk -p $PartNum &> /dev
/null
813 if [[ $?
!= 0 ]] ; then
819 else # efibootmgr not found
824 if [[ $EfibootmgrProblems ]] ; then
826 echo "ALERT: There were problems running the efibootmgr program! You may need to"
827 echo "rename the $Refind binary to the default name (EFI/boot/bootx64.efi"
828 echo "on x86-64 systems or EFI/boot/bootia32.efi on x86 systems) to have it run!"
831 echo "rEFInd has been set as the default boot manager."
835 # Create a minimal/sample refind_linux.conf file in /boot.
836 GenerateRefindLinuxConf
() {
837 if [[ -f "$RLConfFile" ]] ; then
838 echo "Existing $RLConfFile found; not overwriting."
840 echo "Creating $RLConfFile; edit it to adjust kernel options."
841 if [[ -f "$RootDir/etc/default/grub" ]] ; then
842 # We want the default options used by the distribution, stored here....
843 source "$RootDir/etc/default/grub"
844 echo "Setting default boot options based on $RootDir/etc/default/grub"
846 RootFS
=`df "$RootDir" | grep dev | cut -f 1 -d " "`
847 StartOfDevname
=`echo "$RootFS" | cut -b 1-7`
848 if [[ "$StartOfDevname" == "/dev/sd" ||
"$StartOfDevName" == "/dev/hd" ]] ; then
849 # Identify root filesystem by UUID rather than by device node, if possible
850 Uuid
=`blkid -o export -s UUID "$RootFS" 2> /dev/null | grep UUID=`
851 if [[ -n $Uuid ]] ; then
855 DefaultOptions
="$GRUB_CMDLINE_LINUX $GRUB_CMDLINE_LINUX_DEFAULT"
856 echo "\"Boot with standard options\" \"ro root=$RootFS $DefaultOptions \"" > $RLConfFile
857 echo "\"Boot to single-user mode\" \"ro root=$RootFS $DefaultOptions single\"" >> $RLConfFile
858 echo "\"Boot with minimal options\" \"ro root=$RootFS\"" >> $RLConfFile
862 # Set varaibles for installation in EFI/BOOT directory
864 TargetDir
="/EFI/BOOT"
865 if [[ $ShimSource == "none" ]] ; then
866 TargetX64
="bootx64.efi"
867 TargetIA32
="bootia32.efi"
869 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
870 TargetX64
="grubx64.efi"
871 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
872 TargetX64
="loader.efi"
874 echo "Unknown shim/PreBootloader type: $ShimType"
878 TargetIA32
="bootia32.efi"
879 TargetShim
="bootx64.efi"
881 } # SetFilenamesForBoot()
883 # Set variables for installation in EFI/Microsoft/Boot directory
885 TargetDir
="/EFI/Microsoft/Boot"
886 if [[ $ShimSource == "none" ]] ; then
887 TargetX64
="bootmgfw.efi"
889 if [[ $ShimType == "shim.efi" ||
$ShimType == "shimx64.efi" ]] ; then
890 TargetX64
="grubx64.efi"
891 elif [[ $ShimType == "preloader.efi" ||
$ShimType == "PreLoader.efi" ]] ; then
892 TargetX64
="loader.efi"
894 echo "Unknown shim/PreBootloader type: $ShimType"
898 TargetShim
="bootmgfw.efi"
902 # TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
903 # - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
904 # install to that directory under the suitable name; but DO NOT do this if
905 # refind.conf is also in /EFI/refind.
906 # - If booted in BIOS mode and the ESP lacks any other EFI files, install to
908 # - If booted in BIOS mode and there's no refind.conf file and there is a
909 # /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
910 # install under that name, "hijacking" the Windows boot loader filename
911 DetermineTargetDir
() {
914 if [[ -f $InstallDir/EFI
/BOOT
/refind.conf
]] ; then
918 if [[ -f $InstallDir/EFI
/Microsoft
/Boot
/refind.conf
]] ; then
922 if [[ -f $InstallDir/EFI
/refind
/refind.conf
]] ; then
923 TargetDir
="/EFI/refind"
926 if [[ $Upgrade == 1 ]] ; then
927 echo "Found rEFInd installation in $InstallDir$TargetDir; upgrading it."
930 if [[ ! -d /sys
/firmware
/efi
&& $Upgrade == 0 ]] ; then # BIOS-mode
931 FoundEfiFiles
=`find "$InstallDir/EFI/BOOT" -name "*.efi" 2> /dev/null`
932 FoundConfFiles
=`find "$InstallDir" -name "refind\.conf" 2> /dev/null`
933 if [[ ! -n "$FoundConfFiles" && -f "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
934 mv -n "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" "$InstallDir/EFI/Microsoft" &> /dev
/null
936 echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
937 echo "files so as to install to $InstallDir$TargetDir."
938 elif [[ ! -n "$FoundEfiFiles" ]] ; then # In BIOS mode and no default loader; install as default loader
940 echo "Running in BIOS mode with no existing default boot loader; installing to"
941 echo $InstallDir$TargetDir
943 echo "Running in BIOS mode with an existing default boot loader; backing it up and"
944 echo "installing rEFInd in its place."
945 if [[ -d "$InstallDir/EFI/BOOT-rEFIndBackup" ]] ; then
947 echo "Caution: An existing backup of a default boot loader exists! If the current"
948 echo "default boot loader and the backup are different boot loaders, the current"
949 echo "one will become inaccessible."
951 echo -n "Do you want to proceed with installation (Y/N)? "
953 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
954 echo "OK; continuing with the installation..."
959 mv -n "$InstallDir/EFI/BOOT" "$InstallDir/EFI/BOOT-rEFIndBackup"
963 } # DetermineTargetDir()
965 # Controls rEFInd installation under Linux.
966 # Sets Problems=1 if something goes wrong.
968 if [[ "$TargetDir" == "/System/Library/CoreServices" ]] ; then
969 echo "You may not use the --ownhfs option under Linux! Aborting!"
972 echo "Installing rEFInd on Linux...."
973 modprobe efivars
&> /dev
/null
974 if [[ $TargetDir == "/EFI/BOOT" ]] ; then
981 if [[ $CpuType == 'x86_64' ]] ; then
983 elif [[ ($CpuType == 'i386' ||
$CpuType == 'i486' ||
$CpuType == 'i586' ||
$CpuType == 'i686') ]] ; then
985 # If we're in EFI mode, do some sanity checks, and alert the user or even
986 # abort. Not in BIOS mode, though, since that could be used on an emergency
987 # disc to try to recover a troubled Linux installation.
988 if [[ -d /sys
/firmware
/efi
]] ; then
989 if [[ "$ShimSource" != "none" && "$TargetDir" != "/BOOT/EFI" ]] ; then
991 echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
992 echo "use the --shim option to install on such systems. Aborting!"
997 echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
998 echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
999 echo "on a 64-bit computer, you should manually install the 64-bit version of"
1000 echo "rEFInd. If you're installing on a Mac, you should do so from OS X. If"
1001 echo "you're positive you want to continue with this installation, answer 'Y'"
1002 echo "to the following question..."
1004 echo -n "Are you sure you want to continue (Y/N)? "
1006 if [[ $YesNo == "Y" ||
$YesNo == "y" ]] ; then
1007 echo "OK; continuing with the installation..."
1013 echo "Unknown CPU type '$CpuType'; aborting!"
1017 if [[ $LocalKeys == 1 ]] ; then
1023 if [[ "$TargetDir" != "/EFI/BOOT" && "$TargetDir" != "/EFI/Microsoft/Boot" ]] ; then
1025 GenerateRefindLinuxConf
1027 } # InstallOnLinux()
1030 # The main part of the script. Sets a few environment variables,
1031 # performs a few startup checks, and then calls functions to
1032 # install under OS X or Linux, depending on the detected platform.
1037 ThisDir
="$( cd -P "$
( dirname "${BASH_SOURCE[0]}" )" && pwd )"
1038 RefindDir
="$ThisDir/refind"
1039 ThisScript
="$ThisDir/`basename $0`"
1040 if [[ `whoami` != "root" ]] ; then
1041 echo "Not running as root; attempting to elevate privileges via sudo...."
1042 sudo
"$ThisScript" "$@"
1043 if [[ $?
!= 0 ]] ; then
1044 echo "This script must be run as root (or using sudo). Exiting!"
1051 if [[ $OSName == 'Darwin' ]] ; then
1052 if [[ "$ShimSource" != "none" ]] ; then
1053 echo "The --shim option is not supported on OS X! Exiting!"
1056 if [[ "$LocalKeys" != 0 ]] ; then
1057 echo "The --localkeys option is not supported on OS X! Exiting!"
1061 elif [[ $OSName == 'Linux' ]] ; then
1064 echo "Running on unknown OS; aborting!"
1067 if [[ $Problems ]] ; then
1070 echo "Installation has completed, but problems were detected. Review the output for"
1071 echo "error messages and take corrective measures as necessary. You may need to"
1072 echo "re-run this script or install manually before rEFInd will work."
1076 echo "Installation has completed successfully."
1080 if [[ $UnmountEsp == '1' ]] ; then
1081 echo "Unmounting install dir"
1085 if [[ "$InstallDir" == /tmp
/refind_install
]] ; then