-
Notifications
You must be signed in to change notification settings - Fork 0
/
refind-install
executable file
·1559 lines (1496 loc) · 61.6 KB
/
refind-install
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
#!/bin/bash
#
# Linux/MacOS X script to install rEFInd
#
# Usage:
#
# ./refind-install [options]
#
# options include:
# "--notesp" to install to the OS X root filesystem rather than to the ESP.
# This option is valid only under OS X.
# "--usedefault {devicefile}" to install as default
# (/EFI/BOOT/BOOTX64.EFI and similar) to the specified device
# (/dev/sdd1 or whatever) without registering with the NVRAM.
# "--ownhfs {devicefile}" to install to an HFS+ volume that's NOT currently
# an OS X boot volume. Valid only in OS X.
# "--root {dir}" to specify installation using the specified directory
# as the system's root
# "--alldrivers" to install all drivers along with regular files
# "--nodrivers" to suppress driver installation (default in Linux is
# driver used on /boot; --nodrivers is OS X default).
# "--shim {shimfile}" to install a shim.efi file for Secure Boot. Valid
# only under Linux.
# "--preloader" is synonymous with "--shim". Valid only under Linux.
# "--encryptkeys" password-protects the Secure Boot private key.
# "--localkeys" to re-sign x86-64 binaries with a locally-generated key.
# Valid only under Linux.
# "--keepname" to keep refind_x64.efi name as such even when using shim.
# Valid only under Linux.
# "--yes" to assume a "yes" response to all prompts
#
# This program is copyright (c) 2012-2024 by Roderick W. Smith
#
# This program is licensed under the terms of the GNU GPL, version 3,
# or (at your option) any later version.
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http:https://www.gnu.org/licenses/>.
# Revision history:
#
# 0.14.1 -- Fix bug that caused --ownhfs option to fail
# 0.14.0.2-- Fix bug that caused failure to detect mounted ESP in Linux (AGAIN)
# 0.14.0 -- Fix bug that caused failure to install filesystem driver in Linux
# 0.13.3.1-- Fix bug that caused failure to detect mounted ESP in Linux
# 0.13.3 -- Remove stray exit from CreateBootCsvFile()
# 0.13.2 -- Add installation of rEFInd Secure Boot key as MOK; if installing
# with Shim, add backup direct boot NVRAM option
# 0.12.0 -- Improve code to find ESPs; should help with NVMe drives. Also
# activate install and bootorder features when using --usedefault
# option.
# 0.11.5 -- Remove excessive slashes (/) from some filenames
# 0.11.4 -- Fixed generation of GUID when automount of ESP in use on Linux
# 0.11.3 -- Added support for ESP mounted at /efi under Linux
# 0.11.1 -- In Linux, be less aggressive about replacing existing NVRAM entries
# 0.11.0 -- Create BOOT.CSV file and option to encrypt SB private key
# 0.10.8 -- Enabled use of shimx64.efi.signed as Shim source file
# 0.10.7 -- Added mm{arch}.efi as equivalent of MokManager.efi
# 0.10.6 -- Improved identification of the root device under macOS.
# 0.10.5 -- More improvement to handling of disks (other than /dev/[sh]d? disks).
# 0.10.4 -- Improved handling of disks (other than /dev/[sh]d? disks).
# 0.10.2 -- Improved Secure Boot detection in Linux, fixed --usedefault in OS X,
# and fixed bug that could cause mountesp to be installed as a FILE
# called /usr/local/bin in OS X.
# 0.10.1 -- Improve extraction of default kernel options from /proc/cmdline.
# Add support for AMD64 (aka AARCH64, aa64) platform. Added
# warning when --alldrivers used without --usedefault.
# 0.10.0 -- Enable running under OS X's recovery system & add warning about
# SIP & brief instructions on how to deal with it if SIP is
# detected to be enabled. Also change way refind_linux.conf default
# options are found; use /proc/cmdline as base.
# 0.9.2 -- Added --keepname option.
# 0.8.7 -- Better detection of Secure Boot mode & fixed errors when copying
# Shim & MokManager files over themselves; fixed bug that caused
# inappropriate installation to EFI/BOOT/bootx64.efi
# 0.8.6 -- Fixed bugs that caused misidentification of ESP on disks with
# partition numbers over 10 on OS X and misidentification of mount
# point if already-mounted ESP had space in path.
# 0.8.5 -- Refinement/cleanup of new OS X ESP-as-default policy
# 0.8.4 -- OS X default changed to install to ESP under /EFI/BOOT
# 0.7.9 -- Fixed bug that caused errors if dmraid utility not installed
# 0.7.7 -- Fixed bug that created mangled refind_linux.conf file; added ability
# to locate and mount ESP on Linux, if it's not mounted
# 0.7.6 -- Added --ownhfs {device-filename} option
# 0.7.5 -- Fixed bug when installing to ESP on recent versions of OS X
# 0.7.2 -- Fixed code that could be confused by use of autofs to mount the ESP
# 0.7.0 -- Added support for the new Btrfs driver
# 0.6.12 -- Added support for PreLoader as well as for shim
# 0.6.11 -- Improvements in script's ability to handle directories with spaces
# in their names
# 0.6.9 -- Install gptsync on Macs
# 0.6.8 -- Bug fix: ESP scan now uses "uniq".
# 0.6.6 -- Bug fix: Upgrade drivers when installed to EFI/BOOT. Also enable
# copying shim.efi and MokManager.efi over themselves.
# 0.6.4 -- Copies ext2 driver rather than ext4 driver for ext2/3fs
# 0.6.3 -- Support for detecting rEFInd in EFI/BOOT and EFI/Microsoft/Boot
# directories & for installing to EFI/BOOT in BIOS mode
# 0.6.2-1 -- Added --yes option & tweaked key-copying for use with RPM install script
# 0.6.1 -- Added --root option; minor bug fixes
# 0.6.0 -- Changed --drivers to --alldrivers and added --nodrivers option;
# changed default driver installation behavior in Linux to install
# the driver needed to read /boot (if available)
# 0.5.1.2 -- Fixed bug that caused failure to generate refind_linux.conf file
# 0.5.1.1 -- Fixed bug that caused script failure under OS X
# 0.5.1 -- Added --shim & --localkeys options & create sample refind_linux.conf
# in /boot
# 0.5.0 -- Added --usedefault & --drivers options & changed "esp" option to "--esp"
# 0.4.5 -- Fixed check for rEFItBlesser in OS X
# 0.4.2 -- Added notice about BIOS-based OSes & made NVRAM changes in Linux smarter
# 0.4.1 -- Added check for rEFItBlesser in OS X
# 0.3.3.1 -- Fixed OS X 10.7 bug; also works as make target
# 0.3.2.1 -- Check for presence of source files; aborts if not present
# 0.3.2 -- Initial version
#
# Note: install.sh version numbers match those of the rEFInd package
# with which they first appeared.
RootDir="/"
TargetDir=/EFI/refind
LocalKeysBase="refind_local"
ShimSource="none"
ShimType="none"
KeepName=0
TargetShim="default"
TargetX64="refind_x64.efi"
TargetIA32="refind_ia32.efi"
LocalKeys=0
EncryptKeys=0
DeleteRefindDir=0
AlwaysYes=0
EspGuid="C12A7328-F81F-11D2-BA4B-00A0C93EC93B"
#
# Functions used by both OS X and Linux....
#
GetParams() {
InstallToEspOnMac=1
# Install the driver required to read Linux /boot, if it's available
# Note: Under OS X, this will be installed only if a Linux partition
# is detected, in which case the ext4fs driver will be installed.
InstallDrivers="boot"
while [[ $# -gt 0 ]]; do
case $1 in
--notesp) InstallToEspOnMac=0
;;
--ownhfs) OwnHfs=1
InstallToEspOnMac=0
TargetPart="$2"
TargetDir=/System/Library/CoreServices
shift
;;
--usedefault) TargetDir=/EFI/BOOT
TargetPart="$2"
TargetX64="bootx64.efi"
TargetIA32="bootia32.efi"
shift
;;
--root) RootDir="$2"
InstallToEspOnMac=0
shift
;;
--localkeys) LocalKeys=1
;;
--encryptkeys) EncryptKeys=1
;;
--shim | --preloader) ShimSource="$2"
ShimType=$(basename "$ShimSource")
shift
;;
--keepname) KeepName=1
;;
--drivers | --alldrivers) InstallDrivers="all"
;;
--nodrivers) InstallDrivers="none"
;;
--yes) AlwaysYes=1
;;
* ) echo "Usage: $0 [--notesp | --usedefault {device-file} | --root {dir} |"
echo " --ownhfs {device-file} ] [--keepname]"
echo " [--nodrivers | --alldrivers] [--shim {shimfile}]"
echo " [--localkeys [--encryptkeys]] [--keepname] [--yes]"
exit 1
esac
shift
done
if [[ "$InstallToEspOnMac" == 0 && "$RootDir" == '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
echo "You may use --notesp OR --usedefault, but not both! Aborting!"
exit 1
fi
if [[ "$RootDir" != '/' && "$TargetDir" == '/EFI/BOOT' ]] ; then
echo "You may use --root OR --usedefault, but not both! Aborting!"
exit 1
fi
if [[ "$TargetDir" != '/System/Library/CoreServices' && "$OwnHfs" == '1' ]] ; then
echo "If you use --ownhfs, you may NOT use --usedefault! Aborting!"
exit 1
fi
if [[ "$KeepName" == 1 && "$ShimSource" == "none" ]] ; then
echo "The --keepname option is meaningful only in conjunction with --shim"
echo "or --preloader! Aborting!"
exit 1
fi
if [[ "$KeepName" == 1 && "$OSTYPE" != "linux" && "$OSTYPE" != "linux-gnu" ]] ; then
echo "The --keepname option is valid only under Linux! Aborting!"
exit 1
fi
if [[ "$KeepName" == 1 && "$TargetDir" == "/EFI/BOOT" ]] ; then
echo "The --keepname option is incompatible with --usedefault! Aborting!"
exit 1
fi
if [[ "$InstallDrivers" == "all" && "$TargetDir" != "/EFI/BOOT" ]] ; then
echo "The --alldrivers option is meant for creating USB flash drives with (near-)"
echo "universal boot support. Using it on a hard disk partition runs the risk of"
echo "creating serious problems, up to and including rendering your computer"
echo -n "unbootable. Are you SURE you want to proceed (Y/N)? "
ReadYesNo
if [[ "$YesNo" != "Y" && "$YesNo" != "y" ]] ; then
echo "Aborting installation!"
exit 0
fi
fi
if [[ "$EncryptKeys" == 1 && "$LocalKeys" == 0 ]] ; then
echo "The --encryptkeys option requires the use of --localkeys! Aborting!"
exit 1
fi
RLConfFile="$RootDir/boot/refind_linux.conf"
EtcKeysDir="$RootDir/etc/refind.d/keys"
} # GetParams()
# Get a yes/no response from the user and place it in the YesNo variable.
# If the AlwaysYes variable is set to 1, skip the user input and set "Y"
# in the YesNo variable.
ReadYesNo() {
if [[ $AlwaysYes == 1 ]] ; then
YesNo="Y"
echo "Y"
else
read -r YesNo
fi
}
# Get a passphrase for decrpyting a private key, and store it in the
# KeyPassphrase variable.
# $1 Set to "--no-confirm" to skip passphrase input confirmation.
ReadKeyPassphrase() {
if [[ $EncryptKeys == 1 ]] && [ -z "$KeyPassphrase" ]; then
while true; do
echo -n "Private key passphrase (no echo): "
read -r -s
KeyPassphrase="$REPLY"
REPLY="shred value"
echo
if [ "$1" == "--no-confirm" ]; then
break
else
echo -n "Confirm passphrase (no echo): "
read -r -s
echo
if [ "$KeyPassphrase" == "$REPLY" ]; then
REPLY="shred value"
break
fi
fi
done
fi
}
# Determine what CPU type and EFI bit depth we're using.
# Sets Platform global variable to lowercase EFI platform code (currently
# "x64", "ia32", or "aa64") -- the same code used in filenames.
DeterminePlatform() {
local CpuType
case "$OSTYPE" in
darwin*)
CpuType=$(ioreg -l -p IODeviceTree | grep firmware-abi | cut -d "\"" -f 4)
case "$CpuType" in
EFI64)
Platform="x64"
;;
EFI32)
Platform="ia32"
;;
*)
echo "Unknown CPU type '$CpuType'; aborting!"
exit 1
;;
esac
;;
linux*)
CpuType=$(uname -m)
case "$CpuType" in
aarch64)
Platform="aa64"
;;
x86_64)
Platform="x64"
;;
i?86)
Platform="ia32"
# If we're in EFI mode, do some sanity checks, and alert the user or even
# abort. Not in BIOS mode, though, since that could be used on an emergency
# disc to try to recover a troubled Linux installation.
if [[ -d /sys/firmware/efi ]] ; then
if [[ "$ShimSource" != "none" && "$TargetDir" != "/BOOT/EFI" ]] ; then
echo ""
echo "CAUTION: shim does not currently supports 32-bit systems, so you should not"
echo "use the --shim option to install on such systems. Aborting!"
echo ""
exit 1
fi
echo
echo "CAUTION: This Linux installation uses a 32-bit kernel. 32-bit EFI-based"
echo "computers are VERY RARE. If you've installed a 32-bit version of Linux"
echo "on a 64-bit computer, you should manually install the 64-bit version of"
echo "rEFInd. If you're positive you want to continue with this installation,"
echo "answer 'Y' to the following question..."
echo
echo -n "Are you sure you want to continue (Y/N)? "
ReadYesNo
if [[ $YesNo == "Y" || $YesNo == "y" ]] ; then
echo "OK; continuing with the installation..."
else
exit 0
fi
fi # In EFI mode
;;
*)
echo "Unknown CPU type '$CpuType'; aborting!"
exit 1
;;
esac # case "$CpuType"....
;;
*)
echo "Unknown OS; aborting!"
exit 1
;;
esac # case "$OSTYPE"....
} # DeterminePlatform()
# Abort if the rEFInd files can't be found.
# Also sets $ConfFile to point to the configuration file,
# $IconsDir to point to the icons directory,
# $ShimSource to the source of the shim.efi file (if necessary),
# $ThisDir to point to the directory in which this script resides,
# and $RefindDir to point to where the rEFInd binaries live
CheckForFiles() {
# Note: $ThisDir points to real (not symlinked) script home on Linux,
# enabling creating a symlink in /usr/sbin (or wherever); but on OS X,
# "readlink" doesn't do the same thing as under Linux, so the script
# must not be a symlink under OS X.
case "$OSTYPE" in
darwin*)
ThisDir="$( cd -P "${BASH_SOURCE%/*}" && pwd )"
;;
linux*)
ThisDir="$(dirname "$(readlink -f "$0")")"
;;
esac
RefindDir="$ThisDir/refind"
if [[ ! -f "$RefindDir/refind_$Platform.efi" ]] ; then
echo "The rEFInd binary file is missing! Aborting installation!"
exit 1
fi
if [[ -f "$RefindDir/refind.conf-sample" ]] ; then
ConfFile="$RefindDir/refind.conf-sample"
elif [[ -f "$ThisDir/refind.conf-sample" ]] ; then
ConfFile="$ThisDir/refind.conf-sample"
else
echo "The sample configuration file is missing! Aborting installation!"
exit 1
fi
if [[ -d "$RefindDir/icons" ]] ; then
IconsDir="$RefindDir/icons"
elif [[ -d "$ThisDir/icons" ]] ; then
IconsDir="$ThisDir/icons"
else
echo "The icons directory is missing! Aborting installation!"
exit 1
fi
echo "ShimSource is $ShimSource"
if [[ "$ShimSource" != "none" ]] ; then
if [[ -f "$ShimSource" ]] ; then
if [[ $ShimType == "shimx64.efi" || $ShimType == "shim.efi" || $ShimType == "shimx64.efi.signed" ]] ; then
TargetX64="grubx64.efi"
TargetAARCH64="grubaa64.efi"
MokManagerSource=$(dirname "$ShimSource")/mm$Platform.efi.signed
if [[ ! -f "$MokManagerSource" ]] ; then
MokManagerSource=$(dirname "$ShimSource")/mm$Platform.efi
fi
if [[ ! -f "$MokManagerSource" ]] ; then
MokManagerSource=$(dirname "$ShimSource")/MokManager.efi
fi
elif [[ $ShimType == "preloader.efi" || $ShimType == "PreLoader.efi" ]] ; then
TargetX64="loader.efi"
MokManagerSource=$(dirname "$ShimSource")/HashTool.efi
else
echo "Unknown shim/PreBootloader filename: $ShimType!"
echo "Known filenames are shimx64.efi, shim.efi, and PreLoader.efi. Aborting!"
exit 1
fi
else
echo "The specified shim/PreBootloader file, $ShimSource, doesn't exist!"
echo "Aborting installation!"
exit 1
fi
fi
} # CheckForFiles()
# Helper for CopyRefindFiles; copies shim files (including MokManager, if it's
# available) to target.
CopyShimFiles() {
local TargetMMName
local inode1
local inode2
inode1=$(ls -i "$ShimSource" 2> /dev/null | cut -f 1 -d " ")
inode2=$(ls -i "$InstallDir/$TargetDir/$TargetShim" 2> /dev/null | cut -f 1 -d " ")
if [[ "$inode1" != "$inode2" ]] ; then
if ! cp -fb "$ShimSource" "$InstallDir/$TargetDir/$TargetShim" ; then
Problems=1
fi
fi
inode1=$(ls -i "$MokManagerSource" 2> /dev/null | cut -f 1 -d " ")
TargetMMName=$(basename "$MokManagerSource")
if [[ $TargetMMName == "mm$Platform.efi.signed" ]] ; then
TargetMMName="mm$Platform.efi"
fi
inode2=$(ls -i "$InstallDir/$TargetDir/$TargetMMName" 2> /dev/null | cut -f 1 -d " ")
if [[ "$inode1" != "$inode2" ]] ; then
if [[ -f "$MokManagerSource" ]] ; then
cp -fb "$MokManagerSource" "$InstallDir/$TargetDir/$TargetMMName"
fi
if [[ $? != 0 ]] ; then
Problems=1
fi
fi
} # CopyShimFiles()
# Copy the public keys to the installation medium
CopyKeys() {
if [[ $LocalKeys == 1 ]] ; then
mkdir -p "$InstallDir/$TargetDir/keys/"
cp "$EtcKeysDir/$LocalKeysBase.cer" "$InstallDir/$TargetDir/keys/"
cp "$EtcKeysDir/$LocalKeysBase.crt" "$InstallDir/$TargetDir/keys/"
fi
} # CopyKeys()
# Set varaibles for installation in EFI/BOOT directory
SetVarsForBoot() {
TargetDir="/EFI/BOOT"
if [[ $ShimSource == "none" ]] ; then
TargetX64="bootx64.efi"
TargetIA32="bootia32.efi"
TargetAARCH64="bootaa64.efi"
else
if [[ $ShimType == "shim.efi" || $ShimType == "shimx64.efi" || $ShimType == "shimx64.efi.signed" || $ShimType = "shimaa64.efi" ]] ; then
TargetX64="grubx64.efi"
TargetAARCH64="grubaa64.efi"
elif [[ $ShimType == "preloader.efi" || $ShimType == "PreLoader.efi" ]] ; then
TargetX64="loader.efi"
else
echo "Unknown shim/PreBootloader type: $ShimType"
echo "Aborting!"
exit 1
fi
TargetIA32="bootia32.efi"
TargetShim="boot$Platform.efi"
fi
if [[ $KeepName == 1 ]] ; then
echo "Installation is to /EFI/BOOT, which is incompatible with --keepname! Aborting!"
exit 1
fi
} # SetVarsForBoot()
# Set variables for installation in EFI/Microsoft/Boot directory
SetVarsForMsBoot() {
TargetDir="/EFI/Microsoft/Boot"
if [[ $ShimSource == "none" ]] ; then
TargetX64="bootmgfw.efi"
TargetIA32="bootmgfw.efi"
TargetAARCH64="bootmgfw.efi"
else
if [[ $ShimType == "shim.efi" || $ShimType == "shimx64.efi" || $ShimType == "shimaa64.efi" ]] ; then
TargetX64="grubx64.efi"
TargetAARCH64="grubaa64.efi"
elif [[ $ShimType == "preloader.efi" || $ShimType == "PreLoader.efi" ]] ; then
TargetX64="loader.efi"
else
echo "Unknown shim/PreBootloader type: $ShimType"
echo "Aborting!"
exit 1
fi
TargetShim="bootmgfw.efi"
fi
if [[ $KeepName == 1 ]] ; then
echo "Installation is to /EFI/Microsoft/Boot, which is incompatible with --keepname!"
echo "Aborting!"
exit 1
fi
} # SetVarsForMsBoot()
# TargetDir defaults to /EFI/refind; however, this function adjusts it as follows:
# - If an existing refind.conf is available in /EFI/BOOT or /EFI/Microsoft/Boot,
# install to that directory under the suitable name; but DO NOT do this if
# refind.conf is also in /EFI/refind.
# - If booted in BIOS mode and the ESP lacks any other EFI files, install to
# /EFI/BOOT
# - If booted in BIOS mode and there's no refind.conf file and there is a
# /EFI/Microsoft/Boot/bootmgfw.efi file, move it down one level and
# install under that name, "hijacking" the Windows boot loader filename
DetermineTargetDir() {
Upgrade=0
if [[ -f $InstallDir/EFI/BOOT/refind.conf && ! -f $InstallDir/EFI/refind/refind.conf ]] ; then
SetVarsForBoot
Upgrade=1
fi
if [[ -f $InstallDir/EFI/Microsoft/Boot/refind.conf && ! -f $InstallDir/EFI/refind/refind.conf ]] ; then
SetVarsForMsBoot
Upgrade=1
fi
if [[ -f $InstallDir/EFI/refind/refind.conf ]] ; then
TargetDir="/EFI/refind"
if [[ $ShimSource == "none" || $KeepName == 1 ]] ; then
TargetX64="refind_x64.efi"
TargetIA32="refind_ia32.efi"
TargetAARCH64="refind_aa64.efi"
fi
Upgrade=1
fi
if [[ $Upgrade == 1 ]] ; then
echo "Found rEFInd installation in $InstallDir$TargetDir; upgrading it."
fi
if [[ ! -d /sys/firmware/efi && ! $OSTYPE == darwin* && $Upgrade == 0 ]] ; then # BIOS-mode
FoundEfiFiles=$(find "$InstallDir/EFI/BOOT" -name "*.efi" 2> /dev/null)
FoundConfFiles=$(find "$InstallDir" -name "refind\.conf" 2> /dev/null)
if [[ -z "$FoundConfFiles" && -f "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" ]] ; then
mv -n "$InstallDir/EFI/Microsoft/Boot/bootmgfw.efi" "$InstallDir/EFI/Microsoft" &> /dev/null
SetVarsForMsBoot
echo "Running in BIOS mode with a suspected Windows installation; moving boot loader"
echo "files so as to install to $InstallDir$TargetDir."
elif [[ -z "$FoundEfiFiles" ]] ; then # In BIOS mode and no default loader; install as default loader
SetVarsForBoot
echo "Running in BIOS mode with no existing default boot loader; installing to"
echo "$InstallDir""$TargetDir"
else
echo "Running in BIOS mode with an existing default boot loader; backing it up and"
echo "installing rEFInd in its place."
if [[ -d "$InstallDir/EFI/BOOT-rEFIndBackup" ]] ; then
echo ""
echo "Caution: An existing backup of a default boot loader exists! If the current"
echo "default boot loader and the backup are different boot loaders, the current"
echo "one will become inaccessible."
echo ""
echo -n "Do you want to proceed with installation (Y/N)? "
ReadYesNo
if [[ $YesNo == "Y" || $YesNo == "y" ]] ; then
echo "OK; continuing with the installation..."
else
exit 0
fi
fi
mv -n "$InstallDir/EFI/BOOT" "$InstallDir/EFI/BOOT-rEFIndBackup"
SetVarsForBoot
fi
fi # BIOS-mode
} # DetermineTargetDir()
# Determine (or guess) the filesystem used on the Linux /boot filesystem.
# Store the result in the BootFS global variable.
SetBootFS() {
BootFS=""
case "$OSTYPE" in
linux*)
if command -v blkid &>/dev/null; then
BootPart=$(df "$RootDir"/boot | grep dev | cut -f 1 -d " ")
BootFS=$(blkid -o export "$BootPart" 2> /dev/null | grep TYPE= | cut -f 2 -d =)
# The above line fails in Ubuntu 22.04, but is OK in 20.10 and 22.10;
# the "-o export" option seems to have temporarily disappeared. In case
# it fails, try another approach (which I think uses newer grep features,
# so don't rely 100% on it, either; but at least it works in Ubuntu
# 22.04)....
if [[ -z "$BootFS" ]] ; then
BootFS=$(blkid "$BootPart" 2> /dev/null | grep -Po 'TYPE=\"\K[^\"]*')
fi
fi
;;
darwin*)
# 0FC63DAF-8483-4772-8E79-3D69D8477DE4 = Linux filesystem
# BC13C2FF-59E6-4262-A352-B275FD6F7172 = Freedesktop $boot partition
# 933AC7E1-2EB4-4F13-B844-0E14E2AEF915 = Freedesktop Linux /home
# E6D6D379-F507-44C2-A23C-238F2A3DF928 = Linux LVM
# A19D880F-05FC-4D3B-A006-743F0F84911E = Linux RAID
# 0657FD6D-A4AB-43C4-84E5-0933C84B4F4F = Linux swap
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')
BootFS=""
if [[ -n $Temp ]] ; then
echo "Found suspected Linux partition(s); installing ext4fs driver."
BootFS="ext4"
fi
;;
esac
} # SetBootFS()
# Copy drivers from $RefindDir/drivers_$1 to $InstallDir/$TargetDir/drivers_$1,
# honoring the $InstallDrivers condition. Must be passed a suitable
# architecture code (ia32 or x64).
CopyDrivers() {
if [[ $InstallDrivers == "all" ]] ; then
mkdir -p "$InstallDir/$TargetDir/drivers_$1"
cp "$ThisDir"/drivers_"$1"/*_"$1".efi "$InstallDir/$TargetDir/drivers_$1/" 2> /dev/null
cp "$RefindDir"/drivers_"$1"/*_"$1".efi "$InstallDir/$TargetDir/drivers_$1/" 2> /dev/null
elif [[ "$InstallDrivers" == "boot" ]] ; then
SetBootFS
DriverType=""
case $BootFS in
ext2 | ext3) DriverType="ext2"
# Could use ext4, but that can create unwanted entries from symbolic
# links in / to /boot/vmlinuz if a separate /boot partition is used.
;;
ext4) DriverType="ext4"
;;
reiserfs) DriverType="reiserfs"
;;
btrfs) DriverType="btrfs"
;;
hfsplus) DriverType="hfs"
;;
ntfs) DriverType="ntfs"
;;
*) BootFS=""
esac
if [[ -n $BootFS ]] ; then
echo "Installing driver for $BootFS (${DriverType}_$1.efi)"
mkdir -p "$InstallDir/$TargetDir/drivers_$1"
cp "$ThisDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1/" 2> /dev/null
cp "$RefindDir/drivers_$1/${DriverType}_$1.efi" "$InstallDir/$TargetDir/drivers_$1"/ 2> /dev/null
fi
fi
} # CopyDrivers()
# Copy tools (currently only gptsync, and that only on Macs) to the EFI/tools
# directory on the ESP. Must be passed a suitable architecture code (ia32
# or x64).
CopyTools() {
mkdir -p "$InstallDir/EFI/tools"
if [[ $OSTYPE == darwin* ]] ; then
cp -f "$RefindDir/tools_$1/gptsync_$1.efi" "$InstallDir/EFI/tools/"
if [[ -f "$InstallDir/EFI/tools/gptsync.efi" ]] ; then
mv "$InstallDir/EFI/tools/gptsync.efi" "$InstallDir/EFI/tools/gptsync.efi-disabled"
echo "Found old gptsync.efi; disabling it by renaming it to gptsync.efi-disabled"
fi
fi
} # CopyTools()
# Copy the rEFInd files to the ESP or OS X root partition.
# Sets Problems=1 if any critical commands fail.
CopyRefindFiles() {
mkdir -p "$InstallDir/$TargetDir"
if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
if ! cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" 2> /dev/null ; then
echo "Note: IA32 (x86) binary not installed!"
fi
if ! cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" 2> /dev/null ; then
Problems=1
fi
cp "$RefindDir/refind_aa64.efi" "$InstallDir/$TargetDir/$TargetAARCH64" 2> /dev/null
if [[ $? != 0 && $Platform == "aa64" ]] ; then
Problems=1
fi
if [[ "$ShimSource" != "none" ]] ; then
TargetShim="bootx64.efi"
CopyShimFiles
fi
if [[ $InstallDrivers == "all" ]] ; then
cp -r "$RefindDir"/drivers_* "$InstallDir/$TargetDir/" 2> /dev/null
cp -r "$ThisDir"/drivers_* "$InstallDir/$TargetDir/" 2> /dev/null
elif [[ $Upgrade == 1 || $InstallToEspOnMac == 1 ]] ; then
CopyDrivers "$Platform"
CopyTools "$Platform"
fi
Refind="boot$Platform.efi"
CopyKeys
elif [[ $Platform == 'x64' || $TargetDir == "/EFI/Microsoft/Boot" ]] ; then
if ! cp "$RefindDir/refind_x64.efi" "$InstallDir/$TargetDir/$TargetX64" ; then
Problems=1
fi
CopyDrivers x64
CopyTools x64
Refind="refind_x64.efi"
CopyKeys
if [[ "$ShimSource" != "none" ]] ; then
if [[ "$TargetShim" == "default" ]] ; then
TargetShim=$(basename "$ShimSource")
fi
CopyShimFiles
Refind="$TargetShim"
if [[ $LocalKeys == 0 ]] ; then
echo "Storing copies of rEFInd Secure Boot public keys in $EtcKeysDir"
mkdir -p "$EtcKeysDir"
cp "$ThisDir/keys/refind.cer" "$EtcKeysDir" 2> /dev/null
cp "$ThisDir/keys/refind.crt" "$EtcKeysDir" 2> /dev/null
fi
fi
if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
SetupMacHfs $TargetX64
fi
elif [[ $Platform == 'ia32' || $Platform == 'aa64' ]] ; then
if [[ $Platform == 'ia32' ]] ; then
if ! cp "$RefindDir/refind_ia32.efi" "$InstallDir/$TargetDir/$TargetIA32" ; then
Problems=1
fi
else
if ! cp "$RefindDir/refind_aa64.efi" "$InstallDir/$TargetDir/$TargetAARCH64" ; then
Problems=1
fi
fi
CopyDrivers $Platform
CopyTools $Platform
Refind="refind_$Platform.efi"
if [[ "$TargetDir" == '/System/Library/CoreServices' ]] ; then
SetupMacHfs $TargetIA32
fi
else
echo "Unknown platform! Aborting!"
exit 1
fi
echo "Copied rEFInd binary files"
echo ""
if [[ -d "$InstallDir/$TargetDir/icons" ]] ; then
rm -rf "$InstallDir/$TargetDir/icons-backup" &> /dev/null
mv -f "$InstallDir/$TargetDir/icons" "$InstallDir/$TargetDir/icons-backup"
echo "Notice: Backed up existing icons directory as icons-backup."
fi
if ! cp -r "$IconsDir" "$InstallDir/$TargetDir" ; then
Problems=1
fi
mkdir -p "$InstallDir/$TargetDir/keys"
cp -rf "$ThisDir"/keys/*.[cd]er "$InstallDir/$TargetDir/keys/" 2> /dev/null
cp -rf "$EtcKeysDir"/*.[cd]er "$InstallDir/$TargetDir/keys/" 2> /dev/null
if [[ -f "$InstallDir/$TargetDir/refind.conf" ]] ; then
echo "Existing refind.conf file found; copying sample file as refind.conf-sample"
echo "to avoid overwriting your customizations."
echo ""
if ! cp -f "$ConfFile" "$InstallDir/$TargetDir" ; then
Problems=1
fi
else
echo "Copying sample configuration file as refind.conf; edit this file to configure"
echo "rEFInd."
echo ""
if ! cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf" ; then
Problems=1
fi
fi
# If installing to the fallback/EFI default filename, make a duplicate copy
# of refind.conf and edit the main copy to include the "install" and "bootorder"
# options, so that the system can be used to install rEFInd if it's on a USB
# flash drive or CD-R....
if [[ "$TargetDir" == '/EFI/BOOT' ]] ; then
cp -f "$ConfFile" "$InstallDir/$TargetDir/refind.conf-sample"
sed -i 's/#showtools shell/showtools install, shell/g' "$InstallDir/$TargetDir/refind.conf"
fi
if [[ $DeleteRefindDir == 1 ]] ; then
echo "Deleting the temporary directory $RefindDir"
rm -r "$RefindDir"
fi
} # CopyRefindFiles()
# Mount the partition the user specified with the --usedefault or --ownhfs option
MountDefaultTarget() {
InstallDir=/tmp/refind_install
mkdir -p "$InstallDir"
UnmountEsp=1
if [[ $OSTYPE == darwin* ]] ; then
if [[ $OwnHfs == '1' ]] ; then
Temp=$(diskutil info "$TargetPart" | grep "Mount Point")
# Note: DO NOT enclose "$Temp" in following lines in quotes; it
# messes up the following "cut" operation!
InstallDir=$(echo $Temp | cut -f 3-30 -d ' ' | sed 's/\/\+/\//g')
if [[ $InstallDir == '' ]] ; then
InstallDir=/tmp/refind_install
mount -t hfs "$TargetPart" "$InstallDir"
else
UnmountEsp=0
fi
else
mount -t msdos "$TargetPart" "$InstallDir"
fi
elif [[ $OSTYPE == linux* ]] ; then
mount -t vfat "$TargetPart" "$InstallDir"
fi
if [[ $? != 0 ]] ; then
echo "Couldn't mount $TargetPart ! Aborting!"
rmdir "$InstallDir"
exit 1
fi
} # MountDefaultTarget()
# Create a BOOT.CSV file in the same directory as rEFInd, to help in recovery
# should the system's boot entry list be lost
CreateBootCsvFile() {
IConv="$(command -v iconv 2> /dev/null)"
if [[ -x "$IConv" ]] ; then
if [[ "$Platform" == "x64" && -d "$InstallDir/$TargetDir" ]] ; then
echo "$TargetX64,rEFInd Boot Manager,,This is the boot entry for rEFInd" | \
$IConv -t UCS-2 > "$InstallDir/$TargetDir/BOOT.CSV"
fi
if [[ "$Platform" == "ia32" && -d "$InstallDir/$TargetDir" ]] ; then
echo "$TargetIA32,rEFInd Boot Manager,,This is the boot entry for rEFInd" | \
$IConv -t UCS-2 > "$InstallDir/$TargetDir/BOOT.CSV"
fi
if [[ "$Platform" == "aarch64" && -d "$InstallDir/$TargetDir" ]] ; then
echo "$TargetAARCH64,rEFInd Boot Manager,,This is the boot entry for rEFInd" | \
$IConv -t UCS-2 > "$InstallDir/$TargetDir/BOOT.CSV"
fi
fi
} # CreateBootCsvFile()
#
# A series of OS X support functions....
#
# Mount the ESP at /Volumes/ESP or determine its current mount
# point.
# Sets InstallDir to the ESP mount point
# Sets UnmountEsp if we mounted it
MountOSXESP() {
# Identify the ESP. Note: This returns the FIRST ESP found;
# if the system has multiple disks, this could be wrong!
Temp=$(mount | sed -n -E "/^(\/dev\/disk.*) on \/ \(.*$/s//\1/p")
if [ "$Temp" ]; then
Temp=$(diskutil list | grep " EFI " | grep -o 'disk.*' | head -n 1)
if [ -z "$Temp" ]; then
echo "Warning: root device doesn't have an EFI System Partition"
fi
else
echo "Warning: root device could not be found"
fi
if [ -z "$Temp" ]; then
Temp=$(diskutil list | sed -n -E '/^ *[0-9]+:[ ]+EFI EFI[ ]+[0-9.]+ [A-Z]+[ ]+(disk[0-9]+s[0-9]+)$/ { s//\1/p
q
}' )
if [ -z "$Temp" ]; then
echo "Could not find an EFI System Partition. Aborting!"
exit 1
fi
fi
Esp=/dev/"$Temp"
# If the ESP is mounted, use its current mount point....
Temp=$(df -P | grep "$Esp ")
InstallDir=$(echo "$Temp" | cut -f 6- -d ' ' | sed 's/\/\+/\//g')
if [[ "$InstallDir" == '' ]] ; then
mkdir /Volumes/ESP &> /dev/null
# Some systems have HFS+ "ESPs." They shouldn't, but they do. If this is
# detected, mount it as such and set appropriate options.
if ! mount -t msdos "$Esp" /Volumes/ESP ; then
OwnHfs=1
InstallToEspOnMac=0
if ! mount -t hfs "$Esp" /Volumes/Esp ; then
printf "Unable to mount ESP! Aborting!\n\n"
exit 1
fi
fi
UnmountEsp=1
InstallDir="/Volumes/ESP"
fi
} # MountOSXESP()
# Set up for booting from Mac HFS+ volume that boots rEFInd in MJG's way
# (http:https://mjg59.dreamwidth.org/7468.html)
# Must be passed the original rEFInd binary filename (without a path).
SetupMacHfs() {
if [[ -s "$InstallDir/mach_kernel" ]] ; then
echo "Attempt to install rEFInd to a partition with a /mach_kernel file! Aborting!"
exit 1
fi
cp -n "$InstallDir/$TargetDir/boot.efi" "$InstallDir/$TargetDir/boot.efi-backup" &> /dev/null
ln -f "$InstallDir/$TargetDir/$1" "$InstallDir/$TargetDir/boot.efi"
touch "$InstallDir/mach_kernel"
rm "$InstallDir/$TargetDir/SystemVersion.plist" &> /dev/null
cat - << ENDOFHERE >> "$InstallDir/$TargetDir/SystemVersion.plist"
<xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>ProductBuildVersion</key>
<string></string>
<key>ProductName</key>
<string>rEFInd</string>
<key>ProductVersion</key>
<string>0.14.2</string>
</dict>
</plist>
ENDOFHERE
} # SetupMacHfs()
CheckForSIP() {
local OKToInstall
local RootName
if [[ -x "/usr/bin/csrutil" && -z "$TargetPart" ]] ; then
OKToInstall=$(/usr/bin/csrutil status | \
grep "Protection status: disabled\|enabled (Apple Internal)\|NVRAM Protections: disabled")
if [[ -z "$OKToInstall" ]] ; then
echo
echo "**** ALERT: SIP ENABLED! ****"
echo
if [[ "$Upgrade" == "1" ]] ; then
echo "You are attempting to upgrade an existing installation, but it appears that"
echo "System Integrity Protection (SIP) is enabled. If rEFInd is working now, then"
echo "this is fine; you can upgrade your existing rEFInd. If rEFInd is not working,"
echo "though, re-installing from this boot will not help. To re-enable rEFInd, you"
echo "must re-install it from a Recovery system or from another OS. To enter the"
echo "Recovery system and re-install rEFInd:"
else
echo "rEFInd cannot be installed because System Integrity Protection (SIP) seems"
echo "to be enabled! You must install rEFInd from your Recovery installation or"
echo "from another OS. To install from the Recovery system:"
fi
echo
echo " 1. Reboot"
echo " 2. Hold down Command+R as the chime sounds"
echo " 3. When the OS has booted, select Utilities->Terminal"
echo " 4. Change to this directory with the 'cd' command; it will probably be under"
if [[ "$(pwd | cut -b 1-8)" == "/Volumes" ]] ; then
echo " $(pwd)"
else
RootName=$(diskutil info -plist / | grep -A 1 VolumeName | grep string | cut -d \> -f 2 | cut -d \< -f 1)
echo " /Volumes/$RootName$(pwd)"
fi
echo " 5. Re-run this script."
echo
if [[ "$Upgrade" != "1" ]] ; then
echo "If you believe SIP is NOT enabled, you may attempt an installation anyhow,"
echo "but it may fail."
echo
fi
echo "For more on this subject, see http:https://www.rodsbooks.com/refind/sip.html"
echo
echo -n "Do you want to attempt installation (Y/N)? "
ReadYesNo
if [[ $YesNo == "N" || $YesNo == "n" ]] ; then
echo "Exiting!"
exit
fi
fi # csrutil status suggests OK to install
fi # csrutil exists
} # CheckForSIP()
# Control the OS X installation.
# Sets Problems=1 if problems found during the installation.
InstallOnOSX() {
echo "Installing rEFInd on macOS...."
if [[ "$InstallToEspOnMac" == "1" && -z "$TargetPart" ]] ; then
MountOSXESP
elif [[ "$TargetDir" == "/EFI/BOOT" || "$OwnHfs" == '1' ]] ; then
MountDefaultTarget
else
InstallDir="$RootDir/"
InstallDir=$(echo "$InstallDir" | sed 's/\/\+/\//g')
fi
echo "Installing rEFInd to the partition mounted at $InstallDir"
DetermineTargetDir
CheckForSIP
CopyRefindFiles
mkdir -p /usr/local/bin &> /dev/null
cp "$ThisDir/mountesp" /usr/local/bin/ &> /dev/null
if [[ $InstallToEspOnMac == "1" && -z "$TargetPart" ]] ; then
bless --mount "$InstallDir" --setBoot --file "$InstallDir/$TargetDir/$Refind" --shortform
elif [[ "$TargetDir" != "/EFI/BOOT" ]] ; then
bless --setBoot --folder "$InstallDir/$TargetDir" --file "$InstallDir/$TargetDir/$Refind"
fi
if [[ $? != 0 ]] ; then
Problems=1
fi
if [[ -f /Library/StartupItems/rEFItBlesser || -d /Library/StartupItems/rEFItBlesser ]] ; then
echo
echo "/Library/StartupItems/rEFItBlesser found!"
echo "This program is part of rEFIt, and will cause rEFInd to fail to work after"
echo -n "its first boot. Do you want to remove rEFItBlesser (Y/N)? "
ReadYesNo
if [[ $YesNo == "Y" || $YesNo == "y" ]] ; then
echo "Deleting /Library/StartupItems/rEFItBlesser..."
rm -r /Library/StartupItems/rEFItBlesser
else
echo "Not deleting rEFItBlesser."
fi
fi
} # InstallOnOSX()
#
# Now a series of Linux support functions....