]> code.delx.au - refind/blob - NEWS.txt
Add mention of code optimization to NEWS.txt
[refind] / NEWS.txt
1 0.10.5 (??/??/2017):
2 --------------------
3
4 - Minor code optimization.
5
6 - Add new key mappings: Backspace (Delete on Mac keyboards) works the same
7 as Esc, and Tab works the same as F2/Insert/+. This is done for the
8 benefit of new Apple laptops that lack physical Esc and function keys.
9
10 - Fix to refind-install to work better with disks other than /dev/sd? and
11 /dev/hd? devices.
12
13 - Fixes to touch/tablet support to improve reliability.
14
15 0.10.4 (10/9/2016):
16 -------------------
17
18 - Fixed compile problem for drivers with recent versions of GNU-EFI
19 (3.0.4, maybe 3.0.3).
20
21 - Fixed bug that could cause program crash on startup. (In practice, it
22 manifested with GNU-EFI starting with version 3.0.3 or 3.0.4.)
23
24 - An anonymous contributor has provided support for touch screens. This
25 support requires that the "enable_touch" token be used in refind.conf.
26 Note, however, that not all tablet computers have EFIs that provide the
27 necessary support in the firmware.
28
29 - Martin Whitaker contributed 64-bit support to the ext4fs driver, which
30 makes it compatible with ext4fs as written by some recent Linux
31 distributions.
32
33 - Tweaked refind-install to do a better job of detecting disks other
34 than /dev/sd? and /dev/hd? devices.
35
36 0.10.3 (4/24/2016):
37 -------------------
38
39 - Altered RPM & Debian installation scripts so as to NOT call sbsign if
40 Secure Boot is disabled. This is a response to Ubuntu bug #1574372
41 (https://bugs.launchpad.net/ubuntu/+source/sbsigntool/+bug/1574372): In
42 Ubuntu 16.04, the sbsign program is segfaulting randomly, which prevents
43 proper installation of the program. This change at least permits proper
44 installation IF Secure Boot is disabled.
45
46 - Changed description of BIOS/CSM/legacy OS loaders on Macs to include the
47 string "(Legacy)", so as to more easily identify BIOS/CSM/legacy-mode OSes
48 in the rEFInd main menu.
49
50 - Added recognition of the fwupx64.efi file as a firmware update tool.
51 This filename is excluded from the first-row launchers, and is instead
52 presented on the second row, controlled by the "fwupdate" item on the
53 "showtools" option line. It's enabled by default. Note that it's still a
54 bit unclear to me how this tool is supposed to be used. rEFInd launches it
55 with no options, but if it should take options, this will have to be
56 changed in the future.
57
58 - Tightened exclusion of shell binary filenames from boot loader scan.
59 Previously, any filename containing the substring "shell" was excluded
60 from scans. Now it's tighter; only files matching one of the filenames in
61 the constant SHELL_NAMES in main.c are excluded. This change will enable
62 programs with names that include "shell", but that aren't in rEFInd's
63 SHELL_NAMES list, such as "shelly.efi", to be shown in the rEFInd main
64 menu.
65
66 - Fixed bug in NTFS driver that caused it to hang (and thus hang the
67 computer) in some situations, particularly when a file on an NTFS volume
68 had many fragments and when the computer's CSM was activated. (Fix
69 courtesy of "S L.")
70
71 - Modified SIP/CSR rotation code: If the csr-active-config EFI variable is
72 missing AND the firmware is Apple (as identified by the string "Apple"
73 being present in the ST->FirmwareVendor string), rEFInd treats the
74 computer as one on which SIP is available and set to the "enabled" state
75 (0x10). The upshot is that the SIP/CSR tool will appear if the showtools
76 and csr_values options are set appropriately in refind.conf, even if the
77 csr-active-config variable is missing from the NVRAM. The point of this
78 change is that I've received reports of some Macs that run OS X 10.11 but
79 that lack this variable. OS X acts as if SIP were enabled, but rEFInd is
80 then unable to disable SIP. This change gives rEFInd the ability to
81 disable SIP on such systems. The drawback is that the variable might be
82 set on some systems that don't run OS X 10.11. This should be harmless
83 from a technical point of view, but the presence of SIP indicators in
84 rEFInd could be confusing.
85
86 - Added refind-mkdefault script to simplify resetting rEFInd as the default
87 boot program in Linux. The intent is to run this after GRUB, Windows, OS
88 X, or some other tool takes over as the primary boot manager. It can be
89 called from a startup script to handle this task automatically.
90
91 0.10.2 (1/26/2016):
92 -------------------
93
94 - Fixed bug in refind-install that caused mountesp to be installed as a FILE
95 called /usr/local/bin on OS X if the /usr/local/bin directory did not
96 already exist.
97
98 - Fixed bug in mvrefind that caused it to fail to move bootmgfw.efi in
99 some situations, and another that caused it to give the resulting NVRAM
100 entry the default rEFInd name of "rEFInd Boot Manager," rather than the
101 intended "Windows Boot Manager" (to work around bugs in some EFIs).
102
103 - Worked around bug/quirk in some EFIs (in HP ProBook 6470b laptop, at
104 least) that prevented EFI filesystem drivers from working. (Drivers would
105 load but not provide access to filesystems.)
106
107 - Fixed refind-install bug that caused --usedefault option to not work in OS
108 X. (This bug did not affect Linux.)
109
110 - Improved Secure Boot detection in refind-install in Linux.
111
112 - Fixed bug that caused custom volume badges (vol_*.png) to be read only
113 from default location ("icons" subdirectory), effectively eliminating the
114 ability to adjust them.
115
116 - Added centos.crt and centos.cer public key files.
117
118 0.10.1 (12/12/2015):
119 --------------------
120
121 - Change to PPA version: Installing the PPA now queries the user about
122 whether to install to the ESP. Upgrades will remember the initial
123 selection.
124
125 - Modified time-based sorting of loaders in a single directory to push
126 anything starting with "vmlinuz-0-rescue" to the end of the list. Fedora
127 gives its rescue kernels filenames that begin with that string, and if
128 such a kernel happens to be the most recent, treating it normally will
129 cause it to become the default when kernel folding is in use. This is
130 almost certainly undesirable, so this change keeps the rescue kernel at
131 the end of the list instead, which is saner.
132
133 - Significantly reworked the project's Makefiles. This should have no
134 impact on ordinary users, and even most developers should barely notice
135 it; but it should make future extensions to additional platforms or
136 building in different environments easier.
137
138 - Added workaround to gptsync for issue with some Macs' EFIs that caused
139 the program to skip through all prompts, thus accepting the default
140 option. This would normally cause gptsync to do nothing.
141
142 - Added type code 53746F72-6167-11AA-AA11-00306543ECAC (Apple Core Storage,
143 gdisk type AF05) to list of partition types recognized by gptsync.
144
145 - Removed Luxi Sans Mono font, since I discovered it was not open source;
146 and changed the default font from Nimbus Mono to Liberation Mono.
147
148 - Added support for compiling rEFInd for ARM64 (aka AARCH64 or aa64). This
149 works with both GNU-EFI and Tianocore UDK2014.SP1.P1. This support is
150 currently poorly tested. In particular, I used QEMU on an x86-64 computer
151 to create a virtualized ARM64 environment; I've not yet tested on a real
152 computer. I couldn't get QEMU to create a video card, so I used a serial
153 terminal, which means that the graphics features are untested -- I ran
154 rEFInd with "textonly" uncommented in refind.conf. I've tested the ext4fs
155 driver but no other drivers, although they all compile. (So does gptsync,
156 although it's unlikely to be useful on ARM64.) Some rEFInd features are
157 meaningless on ARM64, such as BIOS-mode boot support, anything geared
158 toward Macs (csr_values/csr_rotate, spoof_osx_version, etc.), and
159 enable_and_lock_vmx.
160
161 - Fixed bug that caused rEFInd to fail to scan EFI boot loaders on
162 removable media when rEFInd itself was launched from the fallback
163 filename.
164
165 - Moved detailed descriptions of refind-install from installing.html to
166 a refind-install man page. To keep this information Web-accessible, I've
167 also created HTML versions of the three man pages and linked them into
168 the HTML documentation.
169
170 - Updated LodePNG to latest version (20151024).
171
172 - Fixed bugs in mkrlconf and in refind-install that could cause some kernel
173 options to be excluded from refind_linux.conf. There were two trouble
174 conditions:
175 - Previously, these scripts assumed that the first option in
176 /proc/cmdline was the kernel's filename, but this isn't always the
177 case. (In particular, when gummiboot launches the kernel, this is not
178 true. It might be an incorrect assumption in some other cases, too.)
179 The fix involves checking for likely signs of a kernel filename before
180 discarding this first option.
181 - These scripts cut the "initrd=*" option from /proc/cmdline, but the
182 call to "sed" was overzealous and cut until the end of input. This
183 usually worked, since the initrd= option was usually last on the line;
184 but if it wasn't, any options following initrd= would be lost.
185
186 - Added "kernel*" as a matching pattern for Linux kernels, since this is
187 what Gentoo uses by default.
188
189 - The refind-install script can now be run as a symbolic link in Linux.
190 This enables creating a /usr/sbin/refind-install link in Linux packages,
191 with the binaries stashed wherever the package system likes them. This
192 feature does NOT work in OS X, but there's relatively little need for it
193 there.
194
195 0.10.0 (11/8/2015):
196 -------------------
197
198 - Fixed bug that caused refind-install to not unmount the ESP when it
199 should under OS X.
200
201 - Modified refind-install and mkrlconf scripts to use /proc/cmdline as
202 source for default boot options EXCEPT when refind-install receives the
203 --root option. In that case, refind-install continues to use
204 /etc/default/grub as the source of default options. The idea behind this
205 change is that it's more reliable to get boot options from /proc/cmdline
206 when the targeted system is the one that's booted; but --root would be
207 used from emergency disks or live CDs, in which case the current boot
208 options would be completely wrong, so extracting boot options from GRUB
209 files is the best bet for getting close to the right options.
210
211 - Added "@/boot" to default also_scan_dirs setting. This makes kernels
212 show up on Btrfs volumes under Ubuntu (and perhaps others), at least when
213 the Btrfs driver is loaded.
214
215 - Added new System Integrity Protection (SIP) rotation feature for Macs
216 running OS X 10.11 or later. This feature is disabled by default, except
217 on CD-R and USB flash drive images, on which it's enabled. To enable it,
218 you must make TWO changes to refind.conf: Uncomment the new "csr_values"
219 item and add "csr_rotate" to the "showtools" line (uncommenting it, too,
220 if it's commented out). If desired, you can set more values on
221 "csr_values"; these are comma-delimited one-byte hexadecimal values that
222 define various SIP states. When SIP/CSR rotation is activated, a new
223 shield icon appears among the tools. Selecting it causes the next defined
224 value to be set and a confirmation message to appear for three seconds.
225
226 - Added display of current System Integrity Protection (SIP) mode to
227 "About" display.
228
229 - Added mountesp script for OS X to (you guessed it!) mount the ESP.
230
231 - Renamed support scripts: install.sh to refind-install, mvrefind.sh to
232 mvrefind, and mkrlconf.sh to mkrlconf.
233
234 - New icons! The old ones were getting to be a jumbled mess of styles,
235 particularly for OS tags. I used the AwOken icon set
236 (http://alecive.deviantart.com/art/AwOken-163570862) for the core icons,
237 then expanded from there by creating my own icons and modifying icons for
238 Debian and Elementary OS. I'm also trying to keep better track of
239 copyrights and licenses on icons. Between that and some icons being for
240 OSes that probably see very little use (FreeDOS and eComstation, for
241 instance), a few OS icons have been lost. If you prefer the old icons,
242 you can continue to use them by upgrading rEFInd, renaming icons-backup
243 to something else (say, icons-classic), and then adding an "icons" line
244 in refind.conf to point to the old icons directory.
245
246 - Changed from .zip to .tar.gz as source code archive format. I did this
247 because Linux is the only officially-supported build platform, and
248 tarballs are a more natural fit to a Linux environment. I'm leaving .zip,
249 .deb, and .rpm files as the formats for binary packages.
250
251 - Added detection of System Integrity Protection (SIP; aka "rootless") mode
252 to OS X portion of install.sh script. When detected, and if no existing
253 rEFInd installation is found, the script now prints a warning and brief
254 instructions of how to enter the Recovery mode to install rEFInd and
255 suggests aborting the installation. (The user can override and attempt
256 installation anyhow.) If SIP is detected along with an existing rEFInd
257 installation, the script moderates the warning and explains that an
258 update of a working rEFInd will probably succeed, but that re-installing
259 to fix a broken rEFInd will probably fail.
260
261 - Added new "spoof_osx_version" token, which takes an OS X version number
262 (such as "10.9") as an option. This feature, when enabled, causes rEFInd
263 to tell a Mac's firmware that the specified version of OS X is being
264 launched. This option is usually unnecessary, but it can help properly
265 initialize some hardware -- particularly secondary video devices. OTOH,
266 on some Macs it can cause hardware (notably keyboards and mice) to become
267 unresponsive, so you should not use this option unnecessarily.
268
269 - Worked around an EFI bug that affected my 32-bit Mac Mini: That system
270 seems to have a broken EFI, or possibly a buggy CPU, that causes some
271 (but not all) conversions from floating-point to integer numbers to hang
272 the computer. Such operations were performed only in rEFInd's
273 graphics-resizing code, and so would manifest only when icons or
274 background images were resized. My fix eliminates the use of
275 floating-point operations in the affected function, which eliminates the
276 crashes. There may be some degradation in the quality of resized images,
277 though, particularly on 32-bit systems. (64-bit systems use larger
278 integers, which enable greater precision in my floating-point
279 workaround.)
280
281 - Under OS X, install.sh can now be run from the recovery system. This may
282 help work around OS X 10.11's problems with System Integrity Protection,
283 since it should be possible to reboot into the recovery system to install
284 rEFInd without disabling SIP for the main installation, even for just one
285 boot.
286
287 0.9.2 (9/19/2015):
288 ------------------
289
290 - Added "--keepname" option to install.sh. This option causes install.sh
291 to keep refind_x64.efi named as such rather than rename it as grubx64.efi
292 when using Shim. This option is meaningful only if the --shim option is
293 also used. This option passes the refind_x64.efi filename as an option to
294 Shim, which overrides the default filename of grubx64.efi. A big caveat:
295 Only Shim 0.7 and later supports this feature. (Shim 0.4 also works if a
296 refind_x64.efi is referred to as "\refind_x64.efi" on the command line,
297 but the need for a leading backslash to refer to a file in the same
298 directory as Shim is so confusing and wrong that I cannot in good
299 conscience support it.) I've not seen signed Shim binaries between 0.4
300 and 0.7, so I don't know if any of them might work.
301
302 - Implemented a workaround for a bug in Shim 0.8 that prevented
303 authentication of more than one binary. If any filesystem drivers were
304 installed, the first one would be verified, leaving rEFInd unable to
305 launch anything else unless it was signed by a key in the computer's main
306 Secure Boot db list.
307
308 0.9.1 (9/13/2015):
309 ------------------
310
311 - When rEFInd identifies the root (/) partition via the Freedesktop.org
312 Discoverable Partitions Specification, it now checks two of the
313 partition's attributes, as per the DPS (see
314 http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/):
315 - The partition's read-only attribute determines whether to pass a "rw"
316 or "ro" option to the kernel.
317 - If the partition's do-not-automount flag is set, rEFInd will not pass
318 it as a "root=" option to the kernel. This flag can be used to remove
319 all but one partition from consideration as a root (/) partition if a
320 system has more than one with the correct type code.
321
322 - Improved Freedesktop.org Discoverable Partitions Specification support:
323 Previously, if no refind_linux.conf file was present but an /etc/fstab
324 file was found, rEFInd ignored the Discoverable Partitions Specification
325 filesystem-type codes. This was fine if /etc/fstab contained a valid "/"
326 filesystem specification, but if that was absent, the result was no
327 "root=" specification being present. Under these circumstances
328 (refind_linux.conf absent, /etc/fstab present but lacking a "/" entry),
329 rEFInd now tries to identify a device to specify as "root=" via the
330 Discoverable Partitions Specification.
331
332 - Fixed bug that caused "Found match!" and a prompt to press a key to
333 continue to be printed if any partition used the Freedesktop.org
334 Discoverable Partitions Specification root-partition GUID. (This
335 was leftover debugging/testing code that I somehow missed deleting.)
336
337 - Added icon for Elementary OS.
338
339 - Added /etc/lsb-release to files scanned for clues about the Linux
340 distribution. This file differentiates Mint and Elementary OS from Ubuntu
341 better than does /etc/os-release, and may also help with other
342 closely-related distributions.
343
344 - Improvements to handling of case-insensitive string comparisons. These
345 are buggy on some EFIs, and such bugs affect things like dont_scan_*
346 blacklists, removal of rEFInd's own directory from scanning, matching of
347 keyword names in refind.conf, and even loading of icons. I've replaced
348 many calls to problematic functions with safer calls, which should help a
349 lot. There may still be problems on some systems with some computers,
350 though; as far as I can tell, the bugs are buried deep in some EFI
351 firmware, so I can only replace some of the most direct calls to
352 potentially buggy system calls.
353
354 0.9.0 (7/26/2015):
355 ------------------
356
357 - New icon for Kali Linux, submitted by Francesco D'Eugenio.
358
359 - Minor code changes to ensure that rEFInd compiles with GCC 5.1. (Tested
360 with GNU-EFI on a Fedora 22 system; not yet tested with the TianoCore
361 EDK2.)
362
363 - Added new "fold_linux_kernels" token to refind.conf. This option, when
364 active (the default) "folds" all Linux kernels in a directory into a
365 single entry on the rEFInd menu. The kernel with the most recent time
366 stamp is launched by default. To launch another kernel, you must press F2
367 or Insert; additional kernels appear as options on the first kernel's
368 submenu. To see the pre-0.9.0 behavior, you must set "fold_linux_kernels
369 false" (or one of its synonyms, "off" or "0"). The point of this option
370 is to help de-clutter the rEFInd main menu.
371
372 - Added new Linux root (/) partition auto-discovery feature, based on
373 Freedesktop.org's Discoverable Partitions Spec (DPS)
374 (http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/):
375 If no refind_linux.conf file or /etc/fstab file is found, and if a
376 partition with the correct DPS type code for the system architecture is
377 found, rEFInd adds "ro root=/dev/disk/by-partuuid/{GUID}" to the kernel
378 options. This will not help on LVM setups, and will get it right for only
379 one installation on systems with multiple Linux installations, but it may
380 help some users, if/when the DPS type codes become more common.
381
382 - Fixed bug that caused a rEFInd crash if an empty refind_linux.conf
383 file was encountered.
384
385 - The mkrlconf.sh script now checks the OS on which it's running, which
386 should help avoid confusion or problems by users who mistakenly run it
387 under OS X.
388
389 - rEFInd now skips checking for various BIOS-mode boot sector signatures
390 when running on a UEFI-based PC; these checks are run only on Macs. This
391 may reduce startup time on systems with many partitions.
392
393 - Fixed Debian debinstall script to work correctly on IA32 systems. It had
394 a bug that caused filesystem drivers and gptsync to not be packaged for
395 IA32.
396
397 - Modified Debian postinst file to call install.sh with --localkeys option
398 if sbsign and openssl are available, even when NOT in Secure Boot mode or
399 if shim is not detected. This helps with my Ubuntu PPA when using custom
400 Secure Boot keys, since the PPA is delivered unsigned. (Users will have
401 to have added their own local keys to their firmware's db.) For
402 consistency, I've made the same change to the RPM .spec file.
403
404 0.8.7 (3/1/2015):
405 -----------------
406
407 - Fixed install.sh bug that caused inappropriate installation under the
408 name bootx64.efi (or bootia32.efi) under Linux, with a failure to update
409 the boot entries in NVRAM, has been fixed.
410
411 - Added identification of XFS as filesystem type in volume descriptions.
412
413 - More fixes to filesystem type detection code. Previous version sometimes
414 identified FAT or NTFS (or anything with a boot loader) as a whole-disk
415 device rather than the correct filesystem type.
416
417 - Added protections to the code to reduce the risk of crashes that might
418 occur when dereferencing NULL pointers in various situations.
419
420 - I'm deprecating the use of filesystem numbers (as in "fs0:") because
421 they're unreliable -- filesystem numbers can change between boots and
422 might not be the same as those used in an EFI shell or other program.
423 Sooner or later I'll remove code supporting this feature. In the
424 meantime, if it doesn't work for you, please switch to using filesystem
425 labels, partition labels, or partition GUIDs.
426
427 - Added detection of FreeBSD's BIOS-mode GPT boot loader. Previously,
428 rEFInd could detect FreeBSD's BIOS-mode MBR boot loader, which gave
429 FreeBSD an appropriate icon on Macs; but the BIOS-mode GPT boot loader
430 code is different, so some recent FreeBSD installations showed up with
431 generic grey diamond icons. This change creates FreeBSD icons instead.
432
433 - Added "Secure Boot [active|inactive]" notice to "about" menu for x86
434 (32-bit) systems, since there are now a few 32-bit UEFI systems that
435 support Secure Boot. (AFAIK, these are mostly tablets and convertibles
436 such as the ASUS T100.)
437
438 - Added KeyTool.efi and KeyTool-signed.efi to list of MOK managers. KeyTool
439 is the "super-deluxe" Secure Boot key and hash manager provided as part
440 of the efitools package.
441
442 - Fixed more instances of "invalid parameter" errors on some EFIs.
443
444 - Improved Secure Boot detection in install.sh.
445
446 - install.sh should no longer complain when copying Shim or MokManager over
447 itself.
448
449 0.8.6 (2/8/2015):
450 -----------------
451
452 - Removed special case of ignoring an HFS+ name of "HFS+ volume", since the
453 old rEFInd HFS+ driver that produced this name for all HFS+ volumes has
454 long since been updated to deliver a real name.
455
456 - Addition of new Windows 8 OS icon. On Macs and for BIOS/legacy boots, the
457 new icon is now used for Windows Vista, 7, and 8, while the old one is
458 used for earlier versions of Windows. For EFI-mode boots, the new icon is
459 used universally.
460
461 - If the NTFS driver is loaded, rEFInd now scans NTFS volumes on Macs for
462 the presence of Windows boot files, and removes any NTFS volume that
463 lacks such files from the BIOS/legacy boot list. This should help
464 unclutter the display on Macs that contain NTFS data partitions.
465
466 - Fixed bug that caused misidentification of both whole disks and NTFS
467 volumes as being FAT. (This bug affected the identification of devices
468 and locations in the rEFInd menu, not actual access to devices.)
469
470 - Code refactoring to clear out legacy-boot functions from the
471 ever-expanding refind/main.c file.
472
473 - Added new "badges" option to the "hideui" token in refind.conf. This
474 option hides the device-type badges associated with the OS boot options.
475
476 - Reverted rEFIt commit r472, introduced in rEFInd 0.8.5 to support more
477 BMP images because I've received bug reports that it's causing existing
478 selection images to fail to load.
479
480 - Fixed install.sh bug that caused misidentification of installation
481 directory under OS X if an already-mounted ESP has spaces in its path.
482
483 - Fixed Mac-specific install.sh bug that could cause misidentification of
484 the ESP on disks with partition numbers of 10 or above.
485
486
487 0.8.5 (2/1/2015):
488 -----------------
489
490 - Added NTFS EFI filesystem driver.
491
492 - Minor improvements to filesystem driver framework code.
493
494 - Changes to
495
496 - Fixed bug in Btrfs driver's address reference.
497
498 - Improved install.sh to make it smarter about figuring out where to
499 install on Macs. Specifically, this version now upgrades existing
500 installations, if found (as it always has under Linux), rather than
501 blindly install to EFI/BOOT; it installs to EFI/refind if not existing
502 installation is found; it installs using the --shortform option to bless,
503 which seems to eliminate the 30-second delay problem; and it can handle
504 an HFS+ ESP, which it treats as a separate HFS+ volume (as if the user
505 had used --ownhfs). These changes do not affect behavior under Linux.
506
507 - Added missing check of architecture type for several tools.
508
509 - Applied rEFIt commit r472, which adds support for BMP images with negative
510 height fields, indicating that the image is NOT vertically flipped. This
511 commit and r467 were not incorporated in the original rEFInd because I
512 forked it from a Debian rEFIt package that had been patched to build
513 under GNU-EFI, and was apparently based on a slightly earlier version.
514
515 - Applied rEFIt commit r467, which improves Mac handling of legacy boots
516 from other than the first hard disk.
517
518
519 0.8.4 (12/8/2014):
520 ------------------
521
522 - Tweaked default for dont_scan_volumes: Removed "Recovery HD". This change
523 better suits the needs of OS X 10.10 ("Yosemite") installations, but may
524 result in some stray Recovery HD entries on some Macs.
525
526 - Updated icons for Fedora and Ubuntu and added an icon for Xubuntu.
527
528 - Added new configuration option, "enable_and_lock_vmx", which sets an
529 Intel CPU feature that's required for some types of virtualization to
530 work. Most EFIs enable setting this feature in their own setup utilities,
531 but some (such as most Macs) don't.
532
533 - If rEFInd can't locate an icons directory (either the default or one
534 specified by the icons_dir token), the program switches to text-only
535 mode.
536
537 - If a loader contains the string "grub" and no other clue to the loader's
538 OS association exists, search for os_grub.{png|icns} (which is not
539 provided with rEFInd) or os_linux.{png|icns}. (Previous versions provided
540 a generic loader icon for GRUB.)
541
542 - Fixed bug that caused dont_scan_files to not work with special-case
543 boot loaders (for OS X and Windows) when specifying the complete path to
544 the loader (e.g., EFI/Microsoft/Boot/bootmgfw.efi).
545
546 - Added support for the iPXE network boot tool (see BUILDING.txt for
547 building and basic use instructions).
548
549 0.8.3 (7/6/2014):
550 -----------------
551
552 - Added new feature: Setting "timeout = -1" in refind.conf causes rEFInd to
553 immediately boot the default option UNLESS a keypress is in the buffer
554 when rEFInd launches. In that case, if the keypress corresponds to a
555 shortcut key, the associated boot loader is launched; or if not, the menu
556 is displayed.
557
558 - Added new icons for Clover boot loader and for Mythbuntu Linux
559 distribution.
560
561 - rEFInd now displays the partition's label, when one is available, when
562 offering a BIOS-mode boot option for a partition with no filesystem
563 driver. This works only on Macs doing BIOS-mode booting.
564
565 - Removed GPLv2 code from the FSW core files. This was done because the
566 Btrfs driver is derived from the GRUB Btrfs driver, which is licensed
567 under the GPLv3. Ironically, the GPLv2 and GPLv3 are incompatible
568 licenses, so ensuring that the Btrfs driver doesn't rely on GPLv2 code
569 was legally necessary. In most cases, I reverted to the original rEFIt
570 code, although I kept my own cache code; since I wrote it, I can
571 change its license to a BSD license.
572
573 - Fixed bug that caused rEFInd to unload drivers immediately after loading
574 them. This didn't affect rEFInd's own drivers because they didn't include
575 the unload hooks, but it did affect some other drivers.
576
577 - Changed default scan_all_linux_kernels setting from "false" to "true",
578 and commented the option out in refind.conf-sample. This should not
579 affect most people, since refind.conf-sample had this option commented
580 out, and most rEFInd users either use it that way or don't have Linux
581 kernels installed at all. I've made this change because I want rEFInd to
582 "do the right thing" by default in as many cases as possible. For a while
583 now, rEFInd has been excluding non-bootable files from its menu, and most
584 kernels "in the wild" now include the EFI stub. Thus, enabling this
585 support by default seems worthwhile. If you prefer to not scan Linux
586 kernels by default, simply uncomment the "scan_all_linux_kernels" line
587 and ensure it's set to "false".
588
589 0.8.2.1 (6/8/2014):
590 -------------------
591
592 - Removed stray bit of debugging code that caused a prompt to press a
593 key to appear at rEFInd startup.
594
595 0.8.2 (6/8/2014):
596 -----------------
597
598 - Changed behavior when default_selection is not set: It now boots the
599 previously-booted loader, assuming it's still available; if not, rEFInd
600 boots the first loader (as it does now). Behavior is unchanged if
601 default_selection is set. Note that this behavior depends on the ability
602 of rEFInd to store an EFI variable in NVRAM. It therefore fails on
603 systems with flaky NVRAM storage. You can view the previously-booted
604 loader in the
605 /sys/firmware/efi/efivars/PreviousBoot-36d08fa7-cf0b-42f5-8f14-68df73ed3740
606 variable under Linux.
607
608 - Added icon for Mageia Linux (os_mageia.png).
609
610 - Fixed bug that could misidentify a not-quite-GUID as a GUID in a
611 manual boot stanza's "volume" line.
612
613 - I've updated my personal build system, and therefore the rEFInd Makefiles
614 and related files, to use TianoCore UDK2014 rather than UDK2010.
615
616 - Added "deep_uefi_legacy_scan" token. When not set (the default), rEFInd
617 does not modify EFI NVRAM settings when scanning for BIOS-mode boot
618 loaders on UEFI-based (non-Mac) computers. Some computers require
619 uncommenting this setting for rEFInd to reliably detect some BIOS-mode
620 boot devices. Passing "0", "off", or "false" as an option resets it to
621 the default value (useful in a loaded secondary configuration file to
622 override a setting in the main file).
623
624 0.8.1 (5/15/2014):
625 ------------------
626
627 - Fixed bug that could cause rEFInd to fail to detect boot loaders stored
628 on the root directory of a partition.
629
630 - Added two new bitmap fonts to those distributed with rEFInd: Ubuntu Mono
631 and Nimbus Mono. Both come in 12-, 14-, 16-, and 24-point sizes.
632
633 - Messages about pauses for scanning and re-scanning of boot loaders are
634 now suppressed when doing an initial delayed scan when scan_delay is 1
635 second.
636
637 - Improved centering of legacy boot option descriptions on some systems'
638 screens.
639
640 - Fixed bug that could cause a BIOS-mode boot to boot from an inappropriate
641 device if that device had an innately high boot priority (as set by the
642 firmware).
643
644 - Changed icons from ICNS to PNG form. There are several reasons to do
645 this, all of them minor; but together they're enough to warrant a change.
646 PNG is more common, and therefore more accessible to most users --
647 particularly those who don't use OS X. The PNG files are smaller than
648 their ICNS equivalents. PNG supports a wider range of sizes (although I'm
649 not now using anything that ICNS doesn't support, I might in the future).
650 The icon-scaling support added a few versions ago makes ICNS's support
651 for multiple icon sizes relatively unimportant.
652
653 - Reversed order of search for icons by extension: rEFInd now searches
654 for PNG files before ICNS files, rather than the other way around. This
655 makes it possible to override a volume icon for rEFInd by giving it the
656 name .VolumeIcon.png, even when a .VolumeIcon.icns file exists on the
657 volume and is used by OS X.
658
659 - Fixed bug that caused .VolumeIcon.icns to take higher-than-intended
660 precedence in icon setting for OS X.
661
662 - Chainloading to BIOS-mode boot loaders now works on UEFI-based PCs when
663 rEFInd is built with GNU-EFI, not just when built with Tianocore.
664
665 0.8.0 (5/4/2014):
666 -----------------
667
668 - The "dont_scan_volumes" parameter now also works with legacy-boot
669 volumes. Unlike with EFI volumes, where the option you pass must exactly
670 match an entire volume name, when applied to legacy-boot volumes, it
671 matches any part of the description that appears beneath the item when
672 you select it in the rEFInd main menu.
673
674 - Can now boot in legacy mode from second (and probably later) hard disks!
675
676 - rEFInd now limits the length of the firmware name string shown in the
677 system information screen to 65 characters. This is done because at least
678 one EFI presents a longer string by default, and this causes the entire
679 information display to come up empty on 800x600 displays.
680
681 - rEFInd now uses the partition's name (as stored in the GPT data
682 structures) as a fallback for the filesystem's name if the latter can't
683 be found. Exceptions are if the partition name is one of three generic
684 names used by GPT fdisk: "Microsoft basic data", "Linux filesystem", or
685 "Apple HFS/HFS+". These are ignored in favor of the descriptive fallback
686 (e.g., "20 GiB Btrfs volume")
687
688 - It's now possible to specify a volume by partition GUID number in a
689 manual boot stanza. This should be more reliable (albeit also more
690 awkward) than using a filesystem number (such as fs0: or fs1:).
691
692 - Fixed memory-allocation bug that could cause error message displays,
693 and possibly hangs, when re-scanning boot loaders.
694
695 0.7.9 (4/20/2014):
696 ------------------
697
698 - Attempt to fix rEFInd perpetually re-scanning after ejecting a disc on
699 some Macs.
700
701 - Added check to remove redundant (or non-functional if Secure Boot is
702 active) kernel entries for Ubuntu, which is now including two versions of
703 kernels, one signed and the other unsigned.
704
705 - Fixed bug in install.sh that could cause it to display error messages
706 if the dmraid utility was not installed.
707
708 - The HFS+ driver now reports a correct volume name.
709
710 - Fixed some EFI filesystem driver bugs that could cause lockups under
711 some circumstances. These bugs could affect any of the filesystem
712 drivers.
713
714 - Added "gdisk" option to the "showtools" configuration file token. When
715 active, this adds gdisk.efi or gdisk_{arch}.efi, if present in the
716 EFI\tools directory, to the tools row.
717
718 - Fixed mistaken identification of the MOK utility as the "MOK utility
719 utility."
720
721
722 0.7.8 (3/9/2014):
723 -----------------
724
725 - Added "debian" directory to source, which facilitates creation of Debian
726 packages. Packages built in this way are built with GNU-EFI and don't run
727 any post-installation script, so although the rEFInd binaries are on the
728 hard disk, they aren't installed to be bootable; you must manually run
729 install.sh. Also, at least on Ubuntu, the Make.common file's /usr/lib64
730 references must be changed to /usr/lib. This is more of a proof of
731 concept and a "leg up" for distribution maintainers than anything else.
732
733 - Two new options, big_icon_size and small_icon_size, set the size of
734 the first-row OS icons and of the second-row tool icons, respectively.
735 The big_icon_size option also indirectly sets the size of disk-type
736 badges; they're 1/4 the size of the big icons. Default values are 128 and
737 48, respectively, to match the actual icon files provided with rEFInd. If
738 the icon you're using is of a different size than you've specified,
739 rEFInd scales it. For best quality, you should both provide icons drawn
740 to the right size and set the icon sizes in refind.conf.
741
742 - rEFInd now automatically scales icons to fit the standard icon sizes.
743 This won't have any effect with the icons that come with rEFInd, but it
744 can help if you want to use another icon, since you needn't scale it in a
745 graphics program before using it. Note that rEFInd uses bitmap icons, so
746 scaling by a huge amount (say, a 16x16 icon to fit the standard 128x128
747 OS icon) is not likely to look good.
748
749 - Added new option, banner_scale, that tells rEFInd how to handle banners:
750 Set to "noscale" (the default), banners are not scaled, although they'll
751 be cropped if they're too big for the display. This is the same as the
752 behavior in previous versions. Set to "fillscreen", rEFInd now scales the
753 banner image (larger or smaller) to fill the display.
754
755 - Adjusted the post-installation script in refind.spec (used to generate
756 RPMs, and therefore also indirectly Debian packages) to search for
757 existing shim program files under the filesnames shim.efi and shimx64.efi
758 rather than just shim.efi. Ubuntu uses shimx64.efi, so Debian packages
759 were failing to detect Ubuntu's shim in previous versions. (Note,
760 however, that Ubuntu's early shim 0.1 is unsuitable for use with rEFInd
761 The newer 0.4 version that's in the repositories now should work fine;
762 it's only when installing on an older system that's NOT been updated that
763 problems might arise.
764
765 0.7.7 (1/3/2014):
766 -----------------
767
768 - Can now specify complete paths, optionally including volumes, in
769 dont_scan_files.
770
771 - Added shimx64.efi to the default dont_scan_files list.
772
773 - Added windows_recovery_files token, to specify what program(s) launch a
774 Windows recovery utility; and the "windows_recovery" option to
775 "showtools," to control whether or not to display the Windows recovery
776 utility on the second row of icons.
777
778 - The use_graphics_for, also_scan_dirs, dont_scan_dirs, dont_scan_files,
779 and scan_driver_dirs tokens in refind.conf now support "+" as the first
780 option, which causes the remaining options to be added to the default
781 value rather than replacing that value. (This has no practical effect for
782 scan_driver_dirs, though, since it has a null default value.)
783
784 - Added support for specifying the configuration file at program launch,
785 via the "-c" parameter, as in "refind_x64.efi -c foo.conf" to use the
786 foo.conf file as the main configuration file.
787
788 - Scans of ext2/3/4fs and ReiserFS partitions now omit partitions with
789 duplicate filesystem UUIDs. These are likely parts of RAID arrays and so
790 would have the same boot loaders or kernels as the first one with a given
791 UUID.
792
793 - Added feature in install.sh: Script now tries to locate and mount an ESP
794 in Linux, if it's currently unmounted.
795
796 - Fixed bug in mkrlconf.sh and install.sh that caused a stray line break
797 and PARTUUID= specification to appear in generated refind_linux.conf file
798 under some circumstances.
799
800 0.7.6 (12/15/2013):
801 -------------------
802
803 - Added support for multiple "default_selection" targets. These MUST be
804 comma-separated AND enclosed in quotes, as in:
805 default_selection "fred,ginger"
806 This example will launch "fred" by default if it's available; and if
807 it's not, rEFInd will attempt to launch "ginger" as the default.
808
809 - Added support for time-sensitive "default_selection" setting. This token
810 may now have either one or three options. If one, it's interpreted as it
811 has been in the past, as setting a default that's independent of times.
812 If you follow this default by two times, however, those are interpreted
813 as the start and end times (in 24-hour format) for a default setting. For
814 instance, "default_selection foo 8:00 17:00" causes foo to be the default
815 from 8:00 (AM) to 17:00 (aka 5:00 PM). You can include multiple
816 "default_selection" lines to set different defaults for a variety of
817 times. If they're in conflict, the last one takes precedence. Note that
818 times are hardware clock's native value, which may be local time or UTC,
819 depending on your computer.
820
821 - Added support for a blank-screen startup: Set "screensaver -1" and the
822 screen saver will be initialized when rEFInd starts. If you set a low
823 "timeout" value, the result will be a boot straight to the default OS
824 unless you hit a key soon after rEFInd starts. Once you hit a key, the
825 screensaver will be disabled.
826
827 - Added --ownhfs {target} option to install.sh. This option causes rEFInd
828 to install to an HFS+ partition in a way that's more consistent with the
829 way the Mac's native boot loader is installed. Note that you should NOT
830 install to an already-bootable partition with this option, since it will
831 overwrite the existing boot loader, which would render OS X unbootable.
832
833 0.7.5 (11/10/2013):
834 -------------------
835
836 - Fixed bug that caused unbootable exFAT partitions to show up as
837 bootable on Macs with BIOS/CSM/legacy boot options enabled.
838
839 - Fixed bug in install.sh that caused installs to the ESP on recent
840 versions of OS X to fail.
841
842 - Fixed bug that caused rEFInd to hang on some Macs when multiple EFI
843 drivers were present.
844
845 - Fixed bug that caused clear to default gray screen when launching OSes
846 with 'use_graphics_for' enabled, even when the rEFInd background is not
847 gray. Now rEFInd clears to the same background color used in its menu.
848 When launching OS X, though, the OS X boot loader will itself clear to
849 gray a second or so later; and when launching Linux, it will clear to
850 black a second or so later.
851
852 0.7.4.1 (8/25/2013):
853 --------------------
854
855 - My initial 0.7.4 release broke legacy-boot ability on Macs, so I quickly
856 released this version using the original 0.7.4 filenames to fix the
857 problem.
858
859 0.7.4 (8/25/2013):
860 ------------------
861
862 - Fixed options passing to loader to include loader's filename as the first
863 option. This omission had no effect on most boot loaders, but caused
864 VMware's mboot64.efi to fail.
865
866 - Added support for memtest86 as second-row option. Program must be
867 stored in EFI/tools, EFI/tools/memtest, EFI/tools/memtest86, EFI/memtest,
868 or EFI/memtest86; and must use the name memtest86.efi, memtest86_x64.efi,
869 memtest86x64.efi, or bootx64.efi (changing "x64" to "ia32" on IA-32
870 systems). The memtest86 program is scanned for when the "showtools"
871 option includes the "memtest" or "memtest86" token, which it does by
872 default.
873
874 - Added space to end of "Boot %s from %s" string; enables adding a space
875 to the end of the "default_selection" item (in quotes) to set a default
876 that matches a volume name that's identical to another one except for
877 extra characters at the end of the non-wanted volume's name.
878
879 - Fixed bug that could cause rEFInd to hang when launching boot loaders
880 under some conditions. (Launching from Firewire drives on Macs is the
881 known case, but there may be others.)
882
883 0.7.3 (8/7/2013):
884 -----------------
885
886 - Fixed bug that caused missing media-type badges on BIOS-mode boot
887 loaders on Macs.
888
889 - Fixed bug that caused failure when launching BIOS-mode OSes on Macs.
890
891 0.7.2 (8/6/2013):
892 -----------------
893
894 - Fixed bug that caused display glitches in the final entry on the first
895 row of icons if the second row of icons was empty.
896
897 - Fixed bug that could cause incorrect scanning or even a rEFInd crash when
898 using volume specification in also_scan_dirs token.
899
900 - Added protection against loading invalid drivers and other EFI programs.
901 (Some EFIs crash when attempting to load such drivers and programs.)
902
903 - Added PreLoader.efi and shim-fedora.efi to default dont_scan_files list;
904 it's now "shim.efi, shim-fedora.efi, PreLoader.efi, TextMode.efi,
905 ebounce.efi, GraphicsConsole.efi, MokManager.efi, HashTool.efi,
906 HashTool-signed.efi".
907
908 - Added icon for Funtoo Linux.
909
910 - Fixed reading of volume badges from user-specified icons directory, which
911 was broken.
912
913 - Fixed handling of /.VolumeBadge.icns (or /.VolumeBadge.png) files, which
914 was broken.
915
916 0.7.1 (7/8/2013):
917 -----------------
918
919 - Fixed build problem with recent development versions of EDK2.
920
921 - Added scan for Boot Repair's backup of the Windows boot loader
922 (bkpbootmgfw.efi). If found, give separate entries for it and for
923 bootmgfw.efi, each with its own descriptive text label.
924
925 - Fixed also_scan_dirs; used to have bug that caused it to ignore
926 volume specification, if present.
927
928 - Fixed bug in driver cache that caused Btrfs driver to hang sometimes.
929
930 0.7.0 (6/27/2013):
931 ------------------
932
933 - Added Btrfs signature to rEFInd, so that it can identify the filesystem
934 type for volumes that lack labels.
935
936 - Changed some critical filesystem driver pointers from 32-bit to 64-bit.
937 This *SHOULD* enable use of over-2TiB filesystems (for those filesystems
938 that support such large volumes). This capability is largely untested,
939 though.
940
941 - Added a cache to the filesystem driver core, and therefore to all the
942 filesystem drivers. This cache greatly improves performance in
943 VirtualBox, and offers modest performance improvements on a few "real"
944 computers. The most dramatic improvement is on ext2/3fs under VirtualBox:
945 Loading a kernel and initrd used to take ~200 seconds on my system, but
946 now takes ~3 seconds! On most "real" hardware, the improvement is much
947 less dramatic -- an improvement of a second or less, presumably because
948 of cacheing within the EFI or on the hard disk itself.
949
950 - Filter boot loaders based on a test of their validity; keeps out Linux
951 kernels without EFI stub loader code, loaders for the wrong architecture,
952 non-EFI loaders, etc.
953
954 - New Btrfs driver, contributed by Samuel Liao based on GRUB 2.00 Btrfs
955 code.
956
957 0.6.12 (6/18/2013):
958 -------------------
959
960 - Changed the 64-bit EFI shell included in the CD-R and USB flash drive
961 images to a version 2 shell that should support the "bcfg" command.
962
963 - Added support for PreBootloader to refind.spec's built-in installation
964 script.
965
966 - Added support for the Linux Foundation's PreLoader to install.sh. It's
967 treated just like shim, including using the --shim option (or, now,
968 --preloader); but it searches for and copies HashTool.efi rather than
969 MokManager.efi, and filenames are adjusted appropriately.
970
971 - Added code to determine Linux root filesystem from /etc/fstab file, if
972 it's on the same partition as the kernel and if the refind_linux.conf
973 file is not available. This enables rEFInd to boot Linux without any
974 rEFInd-specific configuration files on some (but not all) systems.
975
976 0.6.11 (5/13/2013):
977 -------------------
978
979 - New feature: rEFInd now ignores symbolic links to files on filesystems
980 that support them. This prevents the "vmlinuz" symbolic link that some
981 distributions create in the root directory from appearing in the loader
982 list. Note that this does NOT affect symbolic links to directories.
983
984 - Added icons for Lubuntu and Kubuntu.
985
986 - Improved the install.sh script so that it does a better job dealing with
987 directory names that contain spaces.
988
989 - rEFInd now tries to guess the Linux distribution type based on the kernel
990 filename (Fedora and RHEL only) or the "ID" or "NAME" variables in
991 /etc/os-release on the kernel's partition. None of these is guaranteed to
992 work. A fallback of the Tux penguin icon remains in place in case rEFInd
993 can't find anything substantive enough for a guess.
994
995 - Added "EFI\opensuse" to the locations searched for MOK utilities, since
996 OpenSUSE now uses that name.
997
998 - Renamed "Reboot to Firmware User Interface" to "Reboot to Computer Setup
999 Utility" in menu.
1000
1001 - Fixed bug in gptsync that caused it to hang if the disk had too few GPT
1002 partitions to fill the MBR.
1003
1004 0.6.10 (5/5/2013):
1005 ------------------
1006
1007 - Added support for "screensaver" token. If set to a positive integer, this
1008 causes the screen to blank after the specified number of seconds of
1009 inactivity. Pressing most keys (unfortunately NOT including Shift, Alt,
1010 or Ctrl) will restore the display and restart the screen saver timeout.
1011
1012 - Added icon for ChromeOS (os_chrome.icns in the icons subdirectory).
1013 ChromeBooks reportedly boots using the fallback filename, but if a user
1014 wants to install rEFInd on a ChromeBook, renaming the original EFI/BOOT
1015 directory to EFI/chrome and then installing rEFInd in the fallback
1016 filename will bring up this new icon for ChromeOS.
1017
1018 - Added new option to reboot the computer into the firmware's user
1019 interface. This option is active by default, or can be set via the
1020 "firmware" option to the "showtools" token in refind.conf. It works
1021 on only some computers, though; older computers lack this feature, and
1022 when rEFInd is told to use this feature on such computers, the directive
1023 is quietly ignored.
1024
1025 - Upgraded LodePNG library from version 20121216 to 20130415 and
1026 restructured rEFInd-specific modifications to simplify future upgrades.
1027
1028 - Replaced hexadecimal error code with description if an error is
1029 encountered when saving a screen shot.
1030
1031 - Enable multiple screen shots: Rather than naming all screen shots
1032 "screenshot.bmp", the name is now "screenshot_###.bmp", where "###" is a
1033 sequence number, starting with "001".
1034
1035 0.6.9 (4/25/2013):
1036 ------------------
1037
1038 - Modified default banner to include the new rEFInd icon, provided by Erik
1039 Kemperman.
1040
1041 - Worked around a suspected firmware bug that caused rEFInd 0.6.6 to 0.6.8
1042 to hang at startup on some systems (DUET and some Macs).
1043
1044 - Modified rEFInd to search for gptsync under the names gptsync.efi and
1045 gptsync_{arch}.efi, where {arch} is ia32 or x64. (Previous versions
1046 searched only for gptsync.efi.)
1047
1048 - Added gptsync program from rEFIt project, but with some changes to
1049 improve flexibility and make it less likely that UEFI users will
1050 accidentally trash their systems.
1051
1052 - Changed timeout code so that the timeout continues if the keyboard is
1053 disconnected. This can help in booting a headless server or a system with
1054 a bluetooth or other keyboard that's not recognized by the EFI.
1055
1056 0.6.8 (3/18/2013):
1057 ------------------
1058
1059 - Added workaround for presumed EFI bug that was causing "Invalid
1060 Parameter" errors when scanning for boot loaders on some computers.
1061
1062 - Added search for an EFI shell called shell.efi in the root directory
1063 (previously this name was only accepted in EFI\tools).
1064
1065 - Fixed bug in install.sh that caused it to fail on some systems (Fedora
1066 18, for instance) because of a problem identifying the ESP.
1067
1068 - Fixed bug that caused icons named after boot loaders to not be used.
1069
1070 0.6.7 (2/3/2013):
1071 -----------------
1072
1073 - Added a more explicit error message summarizing options when a launch of
1074 a program results in a Secure Boot failure.
1075
1076 - Changed MOK tool detection to scan all volumes, not just the rEFInd
1077 home volume. This is desirable because the Linux Foundation's HashTool
1078 can only scan its own volume, making it desirable to place copies of this
1079 program on every volume that holds EFI boot loader binaries.
1080
1081 - Added support for launching the Linux Foundation HashTool as a means of
1082 managing MOKs (or MOK hashes, at any rate).
1083
1084 - Fixed bug that caused rEFInd to present an entry for itself as a
1085 Microsoft OS if it was launched as EFI/Microsoft/Boot/bootmgfw.efi.
1086
1087 - Fixed bug that caused dont_scan_volumes option to be added to
1088 also_scan_dirs list.
1089
1090 - Fixed dont_scan_volumes so that it works with OS X boot loaders.
1091
1092 - Fixed broken mixing of PNG and ICNS icons when using a user-specified
1093 icons directory -- previously, an ICNS file in the default directory
1094 would override a PNG file in the user-specified directory.
1095
1096 0.6.6 (1/26/2013):
1097 ------------------
1098
1099 - rEFInd now ignores the fallback boot loader (EFI/BOOT/bootx64.efi or
1100 EFI/BOOT/bootia32.efi) if it's identical to another boot loader on
1101 the same volume. This is intended to help unclutter the display on
1102 systems that run Windows, since Windows tends to duplicate its own boot
1103 loader under the fallback name.
1104
1105 - Added new "font" token to refind.conf, which enables specifying a font in
1106 the form of a PNG file. This file must contain monospace glyphs for the
1107 95 characters from ASCII 32 to 126 (space through tilde), inclusive, plus
1108 a glyph to be displayed for characters outside of this range, for a total
1109 of 96 glyphs.
1110
1111 - Replaced the old font (inherited from rEFInd) with an anti-aliased
1112 version of Luxi Mono Regular 14 point.
1113
1114 - Fixed bug that caused rEFInd to ignore manual boot stanzas in files
1115 included via the "include" token in refind.conf.
1116
1117 - Fixed bug that caused ASSERT error on some systems (and conceivably a
1118 crash on startup on some) when default_selection line in refind.conf was
1119 commented out or empty.
1120
1121 - Fixed bug that caused "Binary is whitelisted" message to persist on
1122 screen after loading MOK-signed drivers in Secure Boot mode.
1123
1124 - Fixed bug that caused rEFInd to ignore the "icon" token in refind.conf
1125 manual boot stanzas.
1126
1127 - Fixed bug in install.sh that caused the script to fail to update
1128 drivers when rEFInd was installed in EFI/BOOT/.
1129
1130 0.6.5 (1/16/2013):
1131 ------------------
1132
1133 - Improved text color support: rEFInd now uses black text against light
1134 backgrounds and white text against dark backgrounds.
1135
1136 - Added support for PNGs as banners, icons, and selectors.
1137
1138 - Added icon for ALT Linux.
1139
1140 - Added "safemode" option to "hideui" token, to hide option to boot into
1141 safe mode for OS X ("-v -x" option to boot.efi).
1142
1143 - Added icon for Haiku (os_haiku.icns).
1144
1145 - Enable transparency of icons & main-menu text when the banner icon is
1146 sized to cover these areas.
1147
1148 - Fixed bug that could cause rEFInd to crash if fed a banner image that's
1149 too big. Note that "too big" can be substantially smaller than the screen
1150 resolution!
1151
1152 0.6.4 (1/8/2013):
1153 -----------------
1154
1155 - Revised install.sh to copy ext2fs driver, rather than ext4fs driver, for
1156 ext2/3 filesystems. This can help keep non-functional entries from links
1157 from /vmlinuz to /boot/vmlinuz out of the menu if the system uses ext4fs
1158 on root and ext2fs or ext3fs on /boot.
1159
1160 - Fixed a couple of memory management bugs that cause rEFInd to hang at
1161 startup on some systems.
1162
1163 0.6.3 (1/6/2013):
1164 -----------------
1165
1166 - Added the ability to specify a volume name or number in the
1167 "dont_scan_dirs" and "also_scan_dirs" tokens.
1168
1169 - Fixed a bug that caused removable EFI media to not appear in scan lists
1170 if rEFInd was installed as EFI/BOOT/boot{arch}.efi on a hard disk.
1171
1172 - Modified ISO-9660 driver so that it can handle discs with other than
1173 2048-byte sectors. This makes it useful for reading "hybrid ISO" images
1174 burned to USB flash disks.
1175
1176 - New mvrefind.sh script to move a rEFInd installation between a standard
1177 location (typically EFI/refind) and one of the fallback locations
1178 (EFI/BOOT or EFI/Microsoft/Boot). It can also do more exotic locations.
1179
1180 - The install.sh script now installs to EFI/BOOT/bootx64.efi or
1181 EFI/Microsoft/Boot/bootmgfw.efi if it's run in BIOS mode. This is
1182 intended to give some chance of producing a bootable installation should
1183 a user accidentally install Linux in EFI mode and then install rEFInd
1184 from that installation.
1185
1186 - The install.sh script now tries to find an existing rEFInd installation
1187 and upgrade it, even if it's in EFI/BOOT or EFI/Microsoft/Boot rather
1188 than in EFI/refind.
1189
1190 - New "--yes" option to install.sh to help with unattended or automated
1191 installations (as from an RPM or Debian package).
1192
1193 0.6.2 (12/30/2012):
1194 -------------------
1195
1196 - Inclusion of a sample refind.spec file for the benefit of RPM
1197 distribution maintainers who might want to include rEFInd. It's a bit
1198 rough, but it gets you a good chunk of the way there....
1199
1200 - The EFI filesystem drivers can now be built with the GNU-EFI toolkit as
1201 well as with the TianoCore EDK2. See the BUILDING.txt file for details on
1202 how to build them with either toolkit. This improvement doesn't affect
1203 users of my binary packages, but it should make it easier for Linux
1204 distributions to adopt rEFInd into their package systems.
1205
1206 - Tweaked refind.inf file for better build results using "native" TianoCore
1207 EDK2 build process (vs. the Makefile-based build process that I use under
1208 Linux). This won't affect those who use my binary builds or build under
1209 Linux with the "make" command.
1210
1211 - Fixed bug that prevented Secure Boot launches from working when rEFInd
1212 was built with GNU-EFI rather than the TianoCore EDK2.
1213
1214 - Substantial reworking of Secure Boot code, based on James Bottomley's
1215 PreLoader program. This new code eliminates the limitation of launching
1216 just one driver in Secure Boot mode and is likely to be more reliable
1217 with future or obscure boot loaders. It should also work with non-x86-64
1218 systems, although this relies on a platform-specific shim program, which
1219 to date exists only for x86-64. The basic features are the same as before
1220 -- rEFInd relies on shim for authentication functions and will launch
1221 programs that are signed by Secure Boot keys, shim keys, or MOKs.
1222
1223 - Altered default for "textmode" option (when it's commented out) to not
1224 adjust the text mode at all. (Prior versions set it to mode 0 by
1225 default.)
1226
1227 0.6.1 (12/21/2012):
1228 -------------------
1229
1230 - Added "--root" option to install.sh, to enable installation of rEFInd
1231 to something other than the currently-running OS. This is intended for
1232 use on emergency discs.
1233
1234 - Thanks to Stefan Agner, the ext4fs driver now supports the "meta_bg"
1235 filesystem feature, which distributes metadata throughout the disk. This
1236 feature isn't used by default, but can be set at filesystem creation time
1237 by passing the "-O meta_bg,^resize_inode" option to mke2fs. (Using
1238 "^resize_inode" is necessary because meta_bg is incompatible with
1239 resize_inode, which IS used by default.) This feature can be used on
1240 ext3fs and ext2fs as well as on ext4fs, so the ext4fs driver can now
1241 handle some ext3fs and ext2fs partitions that the ext2fs driver can't
1242 handle.
1243
1244 - Fixed some screen resolution-setting bugs.
1245
1246 - Added the "words" that make up a filesystem's label (delimited by spaces,
1247 dashes, or underscores) to the list of bases used to search for OS icons.
1248 For instance, if the filesystem's label is "Arch", rEFInd searches for
1249 os_Arch.icns; if it's "Fedora 17", it searches for os_Fedora.icns and
1250 os_17.icns; and if it's "NEW_GENTOO", it searches for os_NEW.icns and
1251 os_GENTOO.icns.
1252
1253 - Refined hints displays to be more context-sensitive, particularly in text
1254 mode.
1255
1256 - Instead of displaying a blank filesystem label when a filesystem has
1257 none, rEFInd now displays the size and/or type of the filesystem, as in
1258 "boot EFI\foo\bar.efi from 200 MiB ext3 volume" rather than "boot
1259 EFI\foo\bar.efi from".
1260
1261 - Fixed a bug that caused the screen to clear after displaying an error
1262 message but before displaying the "Hit any key to continue" message when
1263 a boot loader launch failed.
1264
1265 0.6.0 (12/16/2012):
1266 -------------------
1267
1268 - Fixed a memory allocation bug that could cause a program crash when
1269 specifying certain values with the "also_scan_dirs", "dont_scan_volumes",
1270 "dont_scan_dirs", "dont_scan_files", and "scan_driver_dirs" refind.conf
1271 options.
1272
1273 - Modified Linux kernel initrd-finding code so that if an initrd is
1274 specified in refind_linux.conf, rEFInd will not add any initrd it finds.
1275 This enables an override of the default initrd, and is likely to be
1276 particularly helpful to Arch Linux users.
1277
1278 - Added ext4fs driver!
1279
1280 - Made "boot" the default value for "also_scan_dirs".
1281
1282 - Added identifying screen header to line editor.
1283
1284 - Fixed bug that caused rEFInd's display to be mis-sized upon return
1285 from a program that set the resolution itself.
1286
1287 - Adjusted "resolution" refind.conf parameter so that it can accept EITHER
1288 a resolution as width and height OR a single digit as a UEFI mode number
1289 (which is system-specific). This is done because some systems present the
1290 same mode twice in their mode lists, perhaps varying in refresh rate,
1291 monitor output, or some other salient characteristics; specifying the
1292 mode number enables selecting the higher-numbered mode, whereas using
1293 horizontal and vertical resolution values selects the lowest-numbered
1294 mode.
1295
1296 - Added "textmode" refind.conf parameter to set the text mode used in
1297 text-only displays, and for the line editor and boot-time handoff
1298 display even in graphics mode.
1299
1300 - Fixed bug that caused tools (shell, etc.) to launch when they were
1301 highlighted and F2 or Insert was pressed.
1302
1303 - Added "editor" option to the "hideui" token in refind.conf, which
1304 disables the boot options editor.
1305
1306 - Added hints text to rEFInd main menu and sub-menus. This can be disabled
1307 by setting the new "hints" option to the "hideui" token in refind.conf.
1308
1309 - Added "boot with minimal options" entry to refind_linux.conf file
1310 generated by install.sh. This entry boots without the options extracted
1311 from the /etc/default/grub file.
1312
1313 - Added keys subdirectory to main distribution, to hold public Secure
1314 Boot/shim keys from known sources.
1315
1316 - Changed install.sh --drivers option to --alldrivers, added new
1317 --nodrivers option, and made the default on Linux to install the one
1318 driver that's used on /boot (or the root filesystem if /boot isn't a
1319 separate partition). Of course, this won't install a non-existent driver,
1320 and it also won't work properly if run from an emergency disk unless you
1321 mount a separate /boot partition at that location.
1322
1323 - Fixed bug in install.sh that prevented creation of refind_linux.conf file
1324 on Linux systems.
1325
1326 0.5.1.1 (12/12/2012):
1327 ---------------------
1328
1329 - Fixed bug in install.sh that prevented it from working on OS X.
1330
1331 0.5.1 (12/11/2012):
1332 -------------------
1333
1334 - Added support for "0" options to "textonly" and "scan_all_linux_kernels"
1335 to reverse the usual meaning of these tokens. This is useful for
1336 including these options in a secondary configuration file called with the
1337 new "include" token to override a setting set in the main file.
1338
1339 - Added "include" token for refind.conf, to enable including a secondary
1340 configuration file from a primary one.
1341
1342 - Modified install.sh so that it creates a simple refind_linux.conf file in
1343 /boot, if that file doesn't already exist and if install.sh is run from
1344 Linux. If that directory happens to be on a FAT, HFS+, ext2fs, ext3fs, or
1345 ReiserFS volume, and if the necessary drivers are installed, the result
1346 is that rEFInd will detect the Linux installation with no further
1347 configuration on many systems. (Some may still require tweaking of kernel
1348 options, though; for instance, adding "dolvm" on Gentoo systems that use
1349 LVM.)
1350
1351 - Added --shim and --localkeys options to install.sh to help simplify setup
1352 on systems with Secure Boot active.
1353
1354 - Fixed (maybe) bug that caused resolution options to not be displayed on
1355 recent Macs with GOP graphics when specifying an invalid resolution in
1356 refind.conf.
1357
1358 - Fixed bug that caused some programs (EFI shells, in particular) to hang
1359 when launching on some systems (DUET, in particular).
1360
1361 - Implemented a fix to enable ELILO to launch with Secure Boot active.
1362 This fix might help with some other boot loaders in Secure Boot mode,
1363 too, but I don't know of any specifics.
1364
1365 0.5.0 (12/6/2012):
1366 ------------------
1367
1368 - Added the ability to include quote marks ('"') in refind.conf and
1369 refind_linux.conf tokens by doubling them up, as in:
1370 "ro root=/dev/sda4 some_value=""this is it"""
1371 This example results in the following string being passed as an
1372 option:
1373 ro root=/dev/sda4 some_value="this is it"
1374
1375 - Changed refind.conf-sample to uncomment the scan_all_linux_kernels
1376 option by default. If this option is deleted or commented out, the
1377 program default remains to not scan all Linux kernels; but with
1378 increasing numbers of distributions shipping with kernels that include
1379 EFI stub loader support, setting the configuration file default to scan
1380 for them makes sense.
1381
1382 - Modified the "resolution" token so that it affects text mode as well
1383 as graphics mode. On my systems, though, the actual text area is still
1384 restricted to an 80x25 area. (This seems to be a firmware limitation; my
1385 EFI shells are also so limited.)
1386
1387 - Fixed a bug that caused the options line editor to blank out lines that
1388 were not actually edited.
1389
1390 - Added support for using Matthew Garrett's Shim program and its Machine
1391 Owner Keys (MOKs) to extend Secure Boot capabilities. If rEFInd is
1392 launched from Shim on a computer with Secure Boot active, rEFInd will
1393 launch programs signed with either a standard UEFI Secure Boot key or a
1394 MOK. For the moment, this feature works only on x86-64 systems.
1395
1396 - Added new "dont_scan_files" (aka "don't_scan_files") token for
1397 refind.conf. The effect is similar to dont_scan_dirs, but it creates a
1398 blacklist of filenames within directories rather than directory names.
1399 I'm initially using it to place shim.efi and MokManager.efi in the
1400 blacklist to keep these programs out of the OS list. (MokManager.efi is
1401 scanned separately as a tool; see below.) I've moved checks for
1402 ebounce.efi, GraphicsConsole.efi, and TextMode.efi to this list. (These
1403 three had previously been blacklisted by hard-coding in ScanLoaderDir().)
1404
1405 - Added the directory from which rEFInd launched to dont_scan_dirs. This
1406 works around a bug in which rEFInd would show itself as a bogus Windows
1407 entry if it's installed as EFI/Microsoft/boot/bootmgfw.efi.
1408
1409 - Added support for launching MokManager.efi for managing the Machine Owner
1410 Keys (MOKs) maintained by the shim boot loader developed by Fedora and
1411 SUSE. This program is scanned and presented as a second-row tool.
1412
1413 - Added support for Apple's Recovery HD partition: If it's detected, a new
1414 icon appears on the second row. This icon can be removed by explicitly
1415 setting the "showtools" option in refind.conf and excluding the
1416 "apple_recovery" option from that line.
1417
1418 - Fixed bug that caused text-mode ("textonly" refind.conf option enabled)
1419 menu entries to be right-aligned rather than left-aligned when rEFInd was
1420 compiled with the TianoCore EDK2.
1421
1422 - Added "--usedefault {devicename}" and "--drivers" options to the
1423 install.sh script and changed the "esp" option to "--esp".
1424
1425 0.4.7 (11/6/2012):
1426 ------------------
1427
1428 - Added an icon for gummiboot.
1429
1430 - Added a boot option editor: Pressing the Insert or F2 key from a boot
1431 tag's options menu opens a simple text-mode line editor on which the boot
1432 options may be edited for a one-time boot with altered options.
1433
1434 - Modified the "scan_delay" feature to delay and then perform a re-scan,
1435 which may work better than the first attempt at this feature (which I'm
1436 told isn't working as planned).
1437
1438 - Modified rEFInd to add a space after the command-line options only when
1439 launching Mac OS X. On some early Macs, the extra space (which had been
1440 present by default, as a carryover from rEFIt) causes problems when
1441 booting Linux kernels from FAT partitions.
1442
1443 0.4.6 (10/6/2012):
1444 ------------------
1445
1446 - Fixed some minor memory management issues.
1447
1448 - Added new "scan_delay" feature to impose a delay before scanning
1449 for disks.
1450
1451 - Changed default "scanfor" option from internal-external-optical to either
1452 internal-external-optical-manual (for non-Macs) or
1453 internal-hdbios-external-biosexternal-optical-cd-manual (for Macs). I've
1454 done this for two reasons:
1455 - Many Mac users have been confused by the fact that rEFInd needs
1456 reconfiguration to detect Windows (or Linux installed in BIOS mode),
1457 since rEFIt scans BIOS devices by default. Adding the BIOS options as
1458 default for them should help them.
1459 - Adding the "manual" option enables users to simply add manual boot
1460 stanzas and have them work, which is more intuitive. Adding the
1461 "manual" option will have no effect unless manual stanzas are created
1462 or uncommented, so this part of the change won't affect users' working
1463 default configurations.
1464
1465 - Added new legacy (BIOS) boot support for UEFI-based PCs.
1466
1467 0.4.5 (8/12/2012):
1468 ------------------
1469
1470 - Fixed bug that caused a failure to boot BIOS-based OSes on Macs.
1471
1472 - Fixed bug in install.sh that caused it to fail to detect rEFItBlesser.
1473
1474 0.4.4 (6/23/2012):
1475 ------------------
1476
1477 - Fixed bug that caused filesystem labels to be corrupted by rEFInd on
1478 32-bit systems.
1479
1480 - Fixed bug that caused filesystem labels to be truncated in the drivers
1481 on 32-bit systems.
1482
1483 - Fixed bug in use_graphics_for option parsing that caused most options
1484 to set graphics mode for OS X and/or Linux but not other boot
1485 loaders/OSes.
1486
1487 - Tweaked install script to better isolate the ESP under OS X.
1488
1489 0.4.3 (6/21/2012):
1490 ------------------
1491
1492 - rEFInd now supports compilation using the TianoCore UDK2010/EDK2
1493 development kit in addition to GNU-EFI.
1494
1495 - Added new "use_graphics_for" option to control which OSes to boot in
1496 graphics mode. (This effect lasts for a fraction of a second on most
1497 systems, since the boot loader that rEFInd launches is likely to set
1498 graphics or text mode itself.)
1499
1500 - Graphics-mode booting now clears the screen to the current rEFInd
1501 background color (rather than black) and does NOT display boot messages.
1502 The intent is for a smoother transition when booting OS X, or perhaps
1503 other OSes that don't display boot loader messages. In practice, this
1504 effect will be tiny for many OSes, since the boot loader generally clears
1505 the screen within a fraction of a second of being launched; but the
1506 "flicker" of a rEFInd message in that time can sometimes be distracting.
1507
1508 - Filesystem drivers now work on EFI 1.x systems, such as Macs.
1509
1510 - Removed "linux.conf" as a valid alternative name for "refind_linux.conf"
1511 for holding Linux kernel options. The kernel developers plan to use
1512 "linux.conf" themselves.
1513
1514 0.4.2 (6/3/2012):
1515 -----------------
1516
1517 - Added a message to install.sh when run on Macs to remind users to update
1518 the "scanfor" line in refind.conf if they need to boot BIOS-based OSes
1519 via rEFInd.
1520
1521 - Modified install.sh script to be smarter about running efibootmgr on
1522 Linux. It now uses the whole path to the rEFInd binary as a key to
1523 determine whether an existing entry exists, rather than just the filename
1524 portion. If an entry exists and is the first entry in the boot order, the
1525 script does nothing to the NVRAM entries. If such an entry exists but is
1526 not the default, the script deletes that entry and creates a new one
1527 (implicitly making it the first in the boot order). If such an entry does
1528 not exist, the script creates a new one (again, making it the first in
1529 the boot order).
1530
1531 - Added "dont_scan_dirs" configuration file option, which adds directories
1532 to a "blacklist" of directories that are NOT scanned for boot loaders.
1533
1534 0.4.1 (5/25/2012):
1535 ------------------
1536
1537 - Added "scanning for new boot loaders" message to the re-scan function
1538 (hitting Esc at the main menu). It usually flashes up too quickly to
1539 be of importance, but if the scan function takes a while because of
1540 access to a CD that must be spun up, it should make it clear that the
1541 system hasn't hung.
1542
1543 - Modified install.sh script to detect rEFItBlesser on Macs, and if
1544 present, to ask the user if it should be removed.
1545
1546 - Cleaned up the Make.common file for the filesystem drivers.
1547
1548 - Changed HFS+ driver to return volume label of "HFS+ volume" rather than
1549 an empty label. (The driver doesn't currently read the real volume
1550 label.)
1551
1552 - Fixed bug that could cause rEFInd to appear in its own menu after
1553 running a shell and then re-scanning for boot loaders.
1554
1555 0.4.0 (5/20/2012):
1556 ------------------
1557
1558 - Inclusion of drivers for ISO-9660, HFS+, ReiserFS, and ext2fs. Most of
1559 these drivers originated with rEFIt, although the HFS+ driver seems to
1560 have come from Oracle's VirtualBox, with some files from Apple. I hadn't
1561 included these drivers previously because the build process proved
1562 challenging. As it is, they don't work on my Mac Mini, I suspect because
1563 the build process with the UDK2010 development kit may not work with the
1564 EFI 1.x that Apple uses.
1565
1566 - Addition of support for drivers in the "drivers_{arch}" subdirectory of
1567 the main rEFInd binary directory (e.g., "drivers_x64" or "drivers_ia32").
1568 Drivers may continue to be placed in the "drivers" subdirectory.
1569
1570 - Added new feature to eject CDs (and other removable media): Press F12 to
1571 eject all such media. This function works only on some Macs, though (it
1572 relies on an Apple-specific EFI extension, and this extension isn't even
1573 implemented on all Macs, much less on UEFI-based PCs).
1574
1575 - Fixed a problem that could cause GRUB 2 to fail to read its configuration
1576 file when launched from rEFInd.
1577
1578 0.3.5 (5/15/2012):
1579 ------------------
1580
1581 - Removed the GRUB 2 detection "reciped" added with 0.3.2, since I've
1582 received reports that it's not working as intended.
1583
1584 - Added re-scan feature: Press the Esc key to have rEFInd re-read its
1585 configuration file, tell the EFI to scan for new filesystems, and re-scan
1586 those filesystems for boot loaders. The main purpose is to enable
1587 scanning a new removable medium that you insert after launching rEFInd;
1588 however, it can also be used to immediately implement changes to the
1589 configuration file or new drivers you load from an EFI shell.
1590
1591 - Fixed a bug that could cause the scroll-right arrow to be replaced by the
1592 scroll-left arrow under some circumstances.
1593
1594 0.3.4 (5/9/2012):
1595 -----------------
1596
1597 - Added new configuration file option: "icons_dir", which sets the name
1598 of the subdirectory in which icons are found. See the documentation or
1599 sample configuration file for a full description.
1600
1601 - Modified Makefile to generate rEFInd binary that includes architecture
1602 code -- refind_ia32.efi or refind_x64.efi, rather than the generic
1603 refind.efi. This is done mainly to help the install.sh script. The
1604 program can be named anything you like on the disk. (The generic name
1605 refind.efi is used on unknown architectures.)
1606
1607 - Improved install.sh script: Fixed bug on OS X 10.7 and enable it to be
1608 used after building from source code (or via new "make install" Makefile
1609 target).
1610
1611 - Improved screen redraws to produce less flicker when moving among the
1612 second-row tags or to the last tag on the first row.
1613
1614 0.3.3 (5/6/2012):
1615 -----------------
1616
1617 - Improved menu navigation:
1618 - In graphics mode, left & right arrow keys move left & right, while up &
1619 down arrows move between rows.
1620 - Page Up and Page Down now move through chunks of visible tags (in both
1621 text & graphics modes), jumping from one row to another only when at
1622 the edge of the row. In text mode, the "rows" are broken down as in
1623 graphics mode, but they aren't visibly distinguished on the screen.
1624
1625 - Improved text-mode use: rEFInd now displays the proper number of entries
1626 when first started in text mode and scrolling is done sensibly when too
1627 many entries exist to fit on the screen.
1628
1629 0.3.2 (5/4/2012):
1630 -----------------
1631
1632 - Added the install.sh script to install rEFInd on Linux and Mac OS X
1633 systems. This script must be run as root (or via sudo). It requires
1634 no options, but on Mac OS X, passing it the "esp" option causes it
1635 to install rEFInd on the computer's ESP rather than the default of the
1636 currently OS X boot partition. (Under Linux, the default is to install to
1637 the ESP.) Note that there may be some unusual cases in which this script
1638 will fail to work.
1639
1640 - Does a better job of clearing the screen when launching OSes in text
1641 mode.
1642
1643 - Added detection "recipe" for GRUB 2's BIOS Boot Partition.
1644
1645 - Fixed bogus detection of ESPs created by Linux's mkdosfs utility or
1646 Windows as bootable partitions when "scanfor" includes BIOS scanning
1647 options.
1648
1649
1650 0.3.1 (4/27/2012):
1651 ------------------
1652
1653 - Fixed bug that caused spurious "Unsupported while scanning the root
1654 directory" messages under some conitions on Macs.
1655
1656 - Modified loader scanning code to sort boot loader entries within a
1657 directory by modification time, so that the most recently-modified loader
1658 is first among those in a given directory. Thus, if you specify a
1659 directory name (or volume name, for loaders stored in the root directory
1660 of a volume) as the default_selection, the most recent of those loaders
1661 will be the default. This is intended to help with Linux kernel
1662 maintenance when using the EFI stub loader; set up this way, the most
1663 recent kernel copied to your kernel directory will be the default,
1664 obviating the need to adjust the refind.conf file when adding a new
1665 kernel. If you want to change the default among those in the default
1666 directory, you can use "touch" to adjust the modification timestamp.
1667
1668 - Tweaked code to find loader-specific .icns file so that it finds files
1669 for Linux kernels without .efi extensions. In this case, files should be
1670 named the same as the kernels they match, but with .icns extensions. For
1671 instance, bzImage-3.3.2 should have an icon called bzImage-3.3.2.icns.
1672 (The old code would have looked for an icon called bzImage-3.3.icns.)
1673
1674 - Eliminated bogus OS loader tags for filenames that end in ".icns" when
1675 the scan_all_linux_kernels option is set.
1676
1677 0.3.0 (4/22/2012):
1678 ------------------
1679
1680 - I'm officially upgrading this project's status from "alpha" to "beta" and
1681 giving it a bump from 0.2.x to 0.3.0. This doesn't reflect any major
1682 milestone with this version; rather, it reflects my sense that rEFInd has
1683 been "out there" for a while, and although I've gotten bug reports,
1684 they've been minor and/or have been fixed. The program still has known
1685 bugs, but my impression is that it is, overall, usable by ordinary users.
1686
1687 - Added "resolution" option to refind.conf, which enables setting the video
1688 resolution. To use it, pass two numeric values, as in "resolution 1024
1689 768" to use a 1024x768 video mode. Note that not all modes are supported.
1690 If you specify a non-supported video mode on a UEFI system, a message
1691 appears listing the supported video modes and you must then press a key
1692 to continue, using the default video mode (usually 800x600).
1693 Unfortunately, I don't know the calls to get a list of supported video
1694 modes on older EFI 1.x systems (including Macs), so on Macs setting an
1695 incorrect video mode silently fails (you keep using the default mode).
1696 This makes changing your video mode a hit-or-miss proposition on Macs.
1697 CAUTION: It's possible to set a legal video mode that your monitor can't
1698 handle, in which case you'll get a blank display until you boot an OS
1699 that resets the video mode.
1700
1701 - Fixed (maybe) a bug that caused rEFInd to crash when returning from an
1702 EFI shell or other programs on Macs, particularly when rEFInd used
1703 graphical mode. I'm not 100% sure this bug is squashed because I still
1704 don't understand the cause and I only have one Mac for testing. See
1705 comments in the ReinitRefitLib() function in refit/lib.c for more
1706 details.
1707
1708 - Added new refind.conf option: scan_all_linux_kernels, which causes Linux
1709 kernels that lack ".efi" extensions to be included in scans for EFI boot
1710 loaders. This may help integration with Linux distributions that don't
1711 give their kernels such names by default. Beware, though: It can detect
1712 unwanted files, such as older non-stub-loader kernels or .icns files used
1713 to give kernels with .efi extensions custom icons.
1714
1715 - Improved EFI boot loader detection on boards with Gigabyte's Hybrid EFI,
1716 and perhaps other EFIs with a buggy StriCmp() function. Files with both
1717 ".efi" and ".EFI" extensions should now be detected as boot loaders.
1718
1719 - Fixed a bug that caused rEFInd to fail to scan for drivers if the
1720 filesystem driver didn't set a volume name (that is, if the relevant
1721 field was set to NULL rather than even an empty string). In such
1722 situations, rEFInd now reports the volume name as "Unknown".
1723
1724 0.2.7 (4/19/2012):
1725 ------------------
1726
1727 - After much trial and tribulation, I've overcome a GNU-EFI limitation and
1728 enabled rEFInd to load EFI drivers. This feature was present in the
1729 original build of rEFIt but was removed in the versions that could
1730 compile under Linux, but now it's back -- and still being compiled under
1731 Linux! To use it, you should place your drivers in a convenient directory
1732 on the ESP (or whatever partition you use to launch rEFInd) and add a
1733 "scan_driver_dirs" entry to refind.conf to tell rEFInd where to look. (As
1734 always, you should specify the driver directory relative to the root of
1735 the filesystem.) Note that you can't launch drivers from another
1736 filesystem; they must be on the same volume that holds rEFInd. Those who
1737 compile from source code should note that implementing this feature
1738 necessitated using a more recent version of the GNU-EFI library. I'm
1739 currently using version 3.0p, and version 3.0i does NOT work. I don't
1740 know where the change occurred, but you may need to upgrade your GNU-EFI
1741 installation.
1742
1743 - Fixed bug that caused rEFInd to show up in its own menu sometimes.
1744
1745 - Added new refind.conf token: also_scan_dirs. When scanning volumes for
1746 EFI boot loaders, rEFInd always scans the root directory and every
1747 subdirectory of the /EFI directory, but it doesn't recurse into these
1748 directories. The also_scan_dirs token adds more directories to the scan
1749 list. It defaults to "elilo,boot", but you can set it to any directory or
1750 directories you like.
1751
1752 0.2.6 (4/14/2012):
1753 ------------------
1754
1755 - Added "volume" keyword to configuration file's stanza options. This
1756 option changes the volume from which subsequent files (specified by
1757 "loader" and "icon") are loaded. You pass "volume" the name/label of the
1758 FILESYSTEM you want to use (not the GPT partition name), or a number
1759 followed by a colon (e.g., "1:"). The former should reliably identify a
1760 filesystem, assuming the name is unique. The latter assigns numbers based
1761 on the order in which they're scanned, which may not be as reliable but
1762 should work when a volume is unnamed.
1763
1764 - Fixed bug in 0.2.5 that caused failure of Linux initial RAM disk
1765 mapping on some (but not all) systems. Affected computers include at
1766 least some Intel motherboards, maybe others.
1767
1768 0.2.5 (4/9/2012):
1769 -----------------
1770
1771 - Fixed bug that caused an inability to associate initial RAM disks with
1772 Linux kernels stored in a volume's root directory.
1773
1774 - Volume badges (that override default badges) are now stored in
1775 .VolumeBadge.icns. Although undocumented, rEFInd formerly loaded custom
1776 volume badges from .VolumeIcon.icns. This carryover from rEFIt was a
1777 confusing name, given the next (new) feature, so I've changed and
1778 documented the name....
1779
1780 - Added ability to set a default icon for a loader stored in the root
1781 directory of a volume: The icon is stored in .VolumeIcon.icns. This icon
1782 is also used for Mac OS X volumes booted from the standard location.
1783
1784 - Fixed bug that caused icons to drop back to generic icons when rEFInd
1785 was launched in certain ways (such as from an EFI shell in rEFInd's
1786 directory) on certain systems.
1787
1788 - Fixed bug that caused "unknown disable flag" to be shown (very briefly)
1789 instead of "unknown hideui flag" when an improper hideui flag was set.
1790
1791 0.2.4 (4/5/2012):
1792 -----------------
1793
1794 - Created new refind.conf entry: "showtools". This entry takes options of
1795 "shell", "gptsync", "about", "exit", "reboot", and "shutdown". This
1796 option is in some respects an affirmative version of portions of the old
1797 "disable" and "hideui" options; however, it enables users to specify the
1798 order in which these options appear on the screen. Also, the "exit"
1799 option is new; it terminates the program. The effect is usually to return
1800 to whatever tool launched it or to launch a default OS; however, this is
1801 somewhat unpredictable. The default therefore omits the "exit" option, as
1802 well as "gptsync", which has always been dangerous (but necessary on most
1803 MacOS/Windows dual-boot setups on Macs). As part of this reconfiguration,
1804 I've eliminated the "rescue Linux" option, which always seemed pointless
1805 to me.
1806
1807 - Folded "disable" and "hideui" refind.conf entries into one ("disable"),
1808 and reduced the number of options to six: "banner", "label",
1809 "singleuser", "hwtest", "arrows", and "all". ("arrows" is new and
1810 disables the scroll arrows when a system has too many tags to display
1811 simultaneously.)
1812
1813 - Added max_tags option to the refind.conf file, enabling users to reduce
1814 the maximum number of OS loader tags that can be displayed at once.
1815
1816 - Updated rEFIt icon, based on the 128x128 volume label from the rEFIt CD
1817 image.
1818
1819 - Added x86 and x86-64 EFI shells to the CD image version of the binary,
1820 but NOT to the binary zip file. The logic is that the CD image is more
1821 likely to be used directly as an emergency disc and so may need this
1822 feature, even though the source isn't part of the rEFInd project. (The
1823 source is readily available from the TianoCore project.)
1824
1825 - EFI shells may now be stored at /shellx64.efi for x86-64 systems or at
1826 /shellia32.efi for x86 systems. The /EFI/tools/shell.efi name is also
1827 recognized; however, if both files are present, two EFI shell icons will
1828 appear on the main menu. The /efi/{refind-path/apps/shell.efi filename,
1829 which was never officially documented but worked as a carryover from
1830 rEFIt, is no longer valid.
1831
1832 0.2.3 (3/26/2012):
1833 ------------------
1834
1835 - Fixed (maybe) a bug that caused hangs when launching a second program
1836 after returning from a first. There are some weird system-to-system
1837 differences, though, and this fix causes (apparently harmless) error
1838 messages about "(re)opening our installation volume" on at least one
1839 system (a 32-bit Mac Mini). I'm committing this change because, imperfect
1840 though it is, it's preferable to the earlier version, at least on my
1841 small sample of computers.
1842
1843 - Because of news that the Linux kernel developers are planning to use the
1844 filename linux.conf to hold Linux kernel configuration data for EFI
1845 booting, I'm transitioning rEFInd away from that name and to
1846 refind_linux.conf to avoid a conflict. This version can use either name,
1847 with refind_linux.conf taking precedence if both are present.
1848
1849 - Added logo for Arch Linux.
1850
1851 0.2.2 (3/23/2012):
1852 ------------------
1853
1854 - Fixed bug that caused program failure when Linux kernels with EFI stub
1855 support were detected with no associated version numbers. rEFInd now
1856 permits automatic linking of *ONE* versionless kernel to *ONE*
1857 versionless initrd file.
1858
1859 - Fixed bug that caused program hangs when a boot loader filename or label
1860 was too long. Such names are now properly truncated and program execution
1861 continues.
1862
1863 - Fixed bug that caused no text to appear in submenus on UEFI systems with
1864 small screens (800x600). NOTE: Problem still occurs on screens smaller
1865 than this, but such systems are very rare.
1866
1867 0.2.1 (3/19/2012):
1868 ------------------
1869
1870 - Added ability to set a "default_selection" that's a title or a substring
1871 of one -- the name given to a stanza in a "menuentry" or the boot
1872 loader's filename, in most cases, although "Mac OS X", "Windows XP
1873 (XoM)", and "Microsoft EFI boot" are also titles.
1874
1875 - Added support for semi-automatic scans of Linux kernels with EFI stub
1876 loader support. The program auto-detects matching initial RAM disk files
1877 and loads additional options from the "linux.conf" file in the same
1878 directory as the kernel.
1879
1880 - Added support for "submenuentry" keyword and associated sub-stanza
1881 entries in refind.conf file.
1882
1883 - Renamed icons/os_mint.icns to icons/os_linuxmint.icns to match the
1884 filename Linux Mint ACTUALLY uses for its ESP boot loader directory.
1885
1886
1887 0.2.0 (3/14/2012):
1888 ------------------
1889
1890 - Initial public release