4 - Replaced hexadecimal error code with description if an error is
5 encountered when saving a screen shot.
7 - Enable multiple screen shots: Rather than naming all screen shots
8 "screenshot.bmp", the name is now "screenshot_###.bmp", where "###" is a
9 sequence number, starting with "001".
14 - Modified default banner to include the new rEFInd icon, provided by Erik
17 - Worked around a suspected firmware bug that caused rEFInd 0.6.6 to 0.6.8
18 to hang at startup on some systems (DUET and some Macs).
20 - Modified rEFInd to search for gptsync under the names gptsync.efi and
21 gptsync_{arch}.efi, where {arch} is ia32 or x64. (Previous versions
22 searched only for gptsync.efi.)
24 - Added gptsync program from rEFIt project, but with some changes to
25 improve flexibility and make it less likely that UEFI users will
26 accidentally trash their systems.
28 - Changed timeout code so that the timeout continues if the keyboard is
29 disconnected. This can help in booting a headless server or a system with
30 a bluetooth or other keyboard that's not recognized by the EFI.
35 - Added workaround for presumed EFI bug that was causing "Invalid
36 Parameter" errors when scanning for boot loaders on some computers.
38 - Added search for an EFI shell called shell.efi in the root directory
39 (previously this name was only accepted in EFI\tools).
41 - Fixed bug in install.sh that caused it to fail on some systems (Fedora
42 18, for instance) because of a problem identifying the ESP.
44 - Fixed bug that caused icons named after boot loaders to not be used.
49 - Added a more explicit error message summarizing options when a launch of
50 a program results in a Secure Boot failure.
52 - Changed MOK tool detection to scan all volumes, not just the rEFInd
53 home volume. This is desirable because the Linux Foundation's HashTool
54 can only scan its own volume, making it desirable to place copies of this
55 program on every volume that holds EFI boot loader binaries.
57 - Added support for launching the Linux Foundation HashTool as a means of
58 managing MOKs (or MOK hashes, at any rate).
60 - Fixed bug that caused rEFInd to present an entry for itself as a
61 Microsoft OS if it was launched as EFI/Microsoft/Boot/bootmgfw.efi.
63 - Fixed bug that caused dont_scan_volumes option to be added to
66 - Fixed dont_scan_volumes so that it works with OS X boot loaders.
68 - Fixed broken mixing of PNG and ICNS icons when using a user-specified
69 icons directory -- previously, an ICNS file in the default directory
70 would override a PNG file in the user-specified directory.
75 - rEFInd now ignores the fallback boot loader (EFI/BOOT/bootx64.efi or
76 EFI/BOOT/bootia32.efi) if it's identical to another boot loader on
77 the same volume. This is intended to help unclutter the display on
78 systems that run Windows, since Windows tends to duplicate its own boot
79 loader under the fallback name.
81 - Added new "font" token to refind.conf, which enables specifying a font in
82 the form of a PNG file. This file must contain monospace glyphs for the
83 95 characters from ASCII 32 to 126 (space through tilde), inclusive, plus
84 a glyph to be displayed for characters outside of this range, for a total
87 - Replaced the old font (inherited from rEFInd) with an anti-aliased
88 version of Luxi Mono Regular 14 point.
90 - Fixed bug that caused rEFInd to ignore manual boot stanzas in files
91 included via the "include" token in refind.conf.
93 - Fixed bug that caused ASSERT error on some systems (and conceivably a
94 crash on startup on some) when default_selection line in refind.conf was
95 commented out or empty.
97 - Fixed bug that caused "Binary is whitelisted" message to persist on
98 screen after loading MOK-signed drivers in Secure Boot mode.
100 - Fixed bug that caused rEFInd to ignore the "icon" token in refind.conf
103 - Fixed bug in install.sh that caused the script to fail to update
104 drivers when rEFInd was installed in EFI/BOOT/.
109 - Improved text color support: rEFInd now uses black text against light
110 backgrounds and white text against dark backgrounds.
112 - Added support for PNGs as banners, icons, and selectors.
114 - Added icon for ALT Linux.
116 - Added "safemode" option to "hideui" token, to hide option to boot into
117 safe mode for OS X ("-v -x" option to boot.efi).
119 - Added icon for Haiku (os_haiku.icns).
121 - Enable transparency of icons & main-menu text when the banner icon is
122 sized to cover these areas.
124 - Fixed bug that could cause rEFInd to crash if fed a banner image that's
125 too big. Note that "too big" can be substantially smaller than the screen
131 - Revised install.sh to copy ext2fs driver, rather than ext4fs driver, for
132 ext2/3 filesystems. This can help keep non-functional entries from links
133 from /vmlinuz to /boot/vmlinuz out of the menu if the system uses ext4fs
134 on root and ext2fs or ext3fs on /boot.
136 - Fixed a couple of memory management bugs that cause rEFInd to hang at
137 startup on some systems.
142 - Added the ability to specify a volume name or number in the
143 "dont_scan_dirs" and "also_scan_dirs" tokens.
145 - Fixed a bug that caused removable EFI media to not appear in scan lists
146 if rEFInd was installed as EFI/BOOT/boot{arch}.efi on a hard disk.
148 - Modified ISO-9660 driver so that it can handle discs with other than
149 2048-byte sectors. This makes it useful for reading "hybrid ISO" images
150 burned to USB flash disks.
152 - New mvrefind.sh script to move a rEFInd installation between a standard
153 location (typically EFI/refind) and one of the fallback locations
154 (EFI/BOOT or EFI/Microsoft/Boot). It can also do more exotic locations.
156 - The install.sh script now installs to EFI/BOOT/bootx64.efi or
157 EFI/Microsoft/Boot/bootmgfw.efi if it's run in BIOS mode. This is
158 intended to give some chance of producing a bootable installation should
159 a user accidentally install Linux in EFI mode and then install rEFInd
160 from that installation.
162 - The install.sh script now tries to find an existing rEFInd installation
163 and upgrade it, even if it's in EFI/BOOT or EFI/Microsoft/Boot rather
166 - New "--yes" option to install.sh to help with unattended or automated
167 installations (as from an RPM or Debian package).
172 - Inclusion of a sample refind.spec file for the benefit of RPM
173 distribution maintainers who might want to include rEFInd. It's a bit
174 rough, but it gets you a good chunk of the way there....
176 - The EFI filesystem drivers can now be built with the GNU-EFI toolkit as
177 well as with the TianoCore EDK2. See the BUILDING.txt file for details on
178 how to build them with either toolkit. This improvement doesn't affect
179 users of my binary packages, but it should make it easier for Linux
180 distributions to adopt rEFInd into their package systems.
182 - Tweaked refind.inf file for better build results using "native" TianoCore
183 EDK2 build process (vs. the Makefile-based build process that I use under
184 Linux). This won't affect those who use my binary builds or build under
185 Linux with the "make" command.
187 - Fixed bug that prevented Secure Boot launches from working when rEFInd
188 was built with GNU-EFI rather than the TianoCore EDK2.
190 - Substantial reworking of Secure Boot code, based on James Bottomley's
191 PreLoader program. This new code eliminates the limitation of launching
192 just one driver in Secure Boot mode and is likely to be more reliable
193 with future or obscure boot loaders. It should also work with non-x86-64
194 systems, although this relies on a platform-specific shim program, which
195 to date exists only for x86-64. The basic features are the same as before
196 -- rEFInd relies on shim for authentication functions and will launch
197 programs that are signed by Secure Boot keys, shim keys, or MOKs.
199 - Altered default for "textmode" option (when it's commented out) to not
200 adjust the text mode at all. (Prior versions set it to mode 0 by
206 - Added "--root" option to install.sh, to enable installation of rEFInd
207 to something other than the currently-running OS. This is intended for
208 use on emergency discs.
210 - Thanks to Stefan Agner, the ext4fs driver now supports the "meta_bg"
211 filesystem feature, which distributes metadata throughout the disk. This
212 feature isn't used by default, but can be set at filesystem creation time
213 by passing the "-O meta_bg,^resize_inode" option to mke2fs. (Using
214 "^resize_inode" is necessary because meta_bg is incompatible with
215 resize_inode, which IS used by default.) This feature can be used on
216 ext3fs and ext2fs as well as on ext4fs, so the ext4fs driver can now
217 handle some ext3fs and ext2fs partitions that the ext2fs driver can't
220 - Fixed some screen resolution-setting bugs.
222 - Added the "words" that make up a filesystem's label (delimited by spaces,
223 dashes, or underscores) to the list of bases used to search for OS icons.
224 For instance, if the filesystem's label is "Arch", rEFInd searches for
225 os_Arch.icns; if it's "Fedora 17", it searches for os_Fedora.icns and
226 os_17.icns; and if it's "NEW_GENTOO", it searches for os_NEW.icns and
229 - Refined hints displays to be more context-sensitive, particularly in text
232 - Instead of displaying a blank filesystem label when a filesystem has
233 none, rEFInd now displays the size and/or type of the filesystem, as in
234 "boot EFI\foo\bar.efi from 200 MiB ext3 volume" rather than "boot
235 EFI\foo\bar.efi from".
237 - Fixed a bug that caused the screen to clear after displaying an error
238 message but before displaying the "Hit any key to continue" message when
239 a boot loader launch failed.
244 - Fixed a memory allocation bug that could cause a program crash when
245 specifying certain values with the "also_scan_dirs", "dont_scan_volumes",
246 "dont_scan_dirs", "dont_scan_files", and "scan_driver_dirs" refind.conf
249 - Modified Linux kernel initrd-finding code so that if an initrd is
250 specified in refind_linux.conf, rEFInd will not add any initrd it finds.
251 This enables an override of the default initrd, and is likely to be
252 particularly helpful to Arch Linux users.
254 - Added ext4fs driver!
256 - Made "boot" the default value for "also_scan_dirs".
258 - Added identifying screen header to line editor.
260 - Fixed bug that caused rEFInd's display to be mis-sized upon return
261 from a program that set the resolution itself.
263 - Adjusted "resolution" refind.conf parameter so that it can accept EITHER
264 a resolution as width and height OR a single digit as a UEFI mode number
265 (which is system-specific). This is done because some systems present the
266 same mode twice in their mode lists, perhaps varying in refresh rate,
267 monitor output, or some other salient characteristics; specifying the
268 mode number enables selecting the higher-numbered mode, whereas using
269 horizontal and vertical resolution values selects the lowest-numbered
272 - Added "textmode" refind.conf parameter to set the text mode used in
273 text-only displays, and for the line editor and boot-time handoff
274 display even in graphics mode.
276 - Fixed bug that caused tools (shell, etc.) to launch when they were
277 highlighted and F2 or Insert was pressed.
279 - Added "editor" option to the "hideui" token in refind.conf, which
280 disables the boot options editor.
282 - Added hints text to rEFInd main menu and sub-menus. This can be disabled
283 by setting the new "hints" option to the "hideui" token in refind.conf.
285 - Added "boot with minimal options" entry to refind_linux.conf file
286 generated by install.sh. This entry boots without the options extracted
287 from the /etc/default/grub file.
289 - Added keys subdirectory to main distribution, to hold public Secure
290 Boot/shim keys from known sources.
292 - Changed install.sh --drivers option to --alldrivers, added new
293 --nodrivers option, and made the default on Linux to install the one
294 driver that's used on /boot (or the root filesystem if /boot isn't a
295 separate partition). Of course, this won't install a non-existent driver,
296 and it also won't work properly if run from an emergency disk unless you
297 mount a separate /boot partition at that location.
299 - Fixed bug in install.sh that prevented creation of refind_linux.conf file
302 0.5.1.1 (12/12/2012):
303 ---------------------
305 - Fixed bug in install.sh that prevented it from working on OS X.
310 - Added support for "0" options to "textonly" and "scan_all_linux_kernels"
311 to reverse the usual meaning of these tokens. This is useful for
312 including these options in a secondary configuration file called with the
313 new "include" token to override a setting set in the main file.
315 - Added "include" token for refind.conf, to enable including a secondary
316 configuration file from a primary one.
318 - Modified install.sh so that it creates a simple refind_linux.conf file in
319 /boot, if that file doesn't already exist and if install.sh is run from
320 Linux. If that directory happens to be on a FAT, HFS+, ext2fs, ext3fs, or
321 ReiserFS volume, and if the necessary drivers are installed, the result
322 is that rEFInd will detect the Linux installation with no further
323 configuration on many systems. (Some may still require tweaking of kernel
324 options, though; for instance, adding "dolvm" on Gentoo systems that use
327 - Added --shim and --localkeys options to install.sh to help simplify setup
328 on systems with Secure Boot active.
330 - Fixed (maybe) bug that caused resolution options to not be displayed on
331 recent Macs with GOP graphics when specifying an invalid resolution in
334 - Fixed bug that caused some programs (EFI shells, in particular) to hang
335 when launching on some systems (DUET, in particular).
337 - Implemented a fix to enable ELILO to launch with Secure Boot active.
338 This fix might help with some other boot loaders in Secure Boot mode,
339 too, but I don't know of any specifics.
344 - Added the ability to include quote marks ('"') in refind.conf and
345 refind_linux.conf tokens by doubling them up, as in:
346 "ro root=/dev/sda4 some_value=""this is it"""
347 This example results in the following string being passed as an
349 ro root=/dev/sda4 some_value="this is it"
351 - Changed refind.conf-sample to uncomment the scan_all_linux_kernels
352 option by default. If this option is deleted or commented out, the
353 program default remains to not scan all Linux kernels; but with
354 increasing numbers of distributions shipping with kernels that include
355 EFI stub loader support, setting the configuration file default to scan
356 for them makes sense.
358 - Modified the "resolution" token so that it affects text mode as well
359 as graphics mode. On my systems, though, the actual text area is still
360 restricted to an 80x25 area. (This seems to be a firmware limitation; my
361 EFI shells are also so limited.)
363 - Fixed a bug that caused the options line editor to blank out lines that
364 were not actually edited.
366 - Added support for using Matthew Garrett's Shim program and its Machine
367 Owner Keys (MOKs) to extend Secure Boot capabilities. If rEFInd is
368 launched from Shim on a computer with Secure Boot active, rEFInd will
369 launch programs signed with either a standard UEFI Secure Boot key or a
370 MOK. For the moment, this feature works only on x86-64 systems.
372 - Added new "dont_scan_files" (aka "don't_scan_files") token for
373 refind.conf. The effect is similar to dont_scan_dirs, but it creates a
374 blacklist of filenames within directories rather than directory names.
375 I'm initially using it to place shim.efi and MokManager.efi in the
376 blacklist to keep these programs out of the OS list. (MokManager.efi is
377 scanned separately as a tool; see below.) I've moved checks for
378 ebounce.efi, GraphicsConsole.efi, and TextMode.efi to this list. (These
379 three had previously been blacklisted by hard-coding in ScanLoaderDir().)
381 - Added the directory from which rEFInd launched to dont_scan_dirs. This
382 works around a bug in which rEFInd would show itself as a bogus Windows
383 entry if it's installed as EFI/Microsoft/boot/bootmgfw.efi.
385 - Added support for launching MokManager.efi for managing the Machine Owner
386 Keys (MOKs) maintained by the shim boot loader developed by Fedora and
387 SUSE. This program is scanned and presented as a second-row tool.
389 - Added support for Apple's Recovery HD partition: If it's detected, a new
390 icon appears on the second row. This icon can be removed by explicitly
391 setting the "showtools" option in refind.conf and excluding the
392 "apple_recovery" option from that line.
394 - Fixed bug that caused text-mode ("textonly" refind.conf option enabled)
395 menu entries to be right-aligned rather than left-aligned when rEFInd was
396 compiled with the TianoCore EDK2.
398 - Added "--usedefault {devicename}" and "--drivers" options to the
399 install.sh script and changed the "esp" option to "--esp".
404 - Added an icon for gummiboot.
406 - Added a boot option editor: Pressing the Insert or F2 key from a boot
407 tag's options menu opens a simple text-mode line editor on which the boot
408 options may be edited for a one-time boot with altered options.
410 - Modified the "scan_delay" feature to delay and then perform a re-scan,
411 which may work better than the first attempt at this feature (which I'm
412 told isn't working as planned).
414 - Modified rEFInd to add a space after the command-line options only when
415 launching Mac OS X. On some early Macs, the extra space (which had been
416 present by default, as a carryover from rEFIt) causes problems when
417 booting Linux kernels from FAT partitions.
422 - Fixed some minor memory management issues.
424 - Added new "scan_delay" feature to impose a delay before scanning
427 - Changed default "scanfor" option from internal-external-optical to either
428 internal-external-optical-manual (for non-Macs) or
429 internal-hdbios-external-biosexternal-optical-cd-manual (for Macs). I've
430 done this for two reasons:
431 - Many Mac users have been confused by the fact that rEFInd needs
432 reconfiguration to detect Windows (or Linux installed in BIOS mode),
433 since rEFIt scans BIOS devices by default. Adding the BIOS options as
434 default for them should help them.
435 - Adding the "manual" option enables users to simply add manual boot
436 stanzas and have them work, which is more intuitive. Adding the
437 "manual" option will have no effect unless manual stanzas are created
438 or uncommented, so this part of the change won't affect users' working
439 default configurations.
441 - Added new legacy (BIOS) boot support for UEFI-based PCs.
446 - Fixed bug that caused a failure to boot BIOS-based OSes on Macs.
448 - Fixed bug in install.sh that caused it to fail to detect rEFItBlesser.
453 - Fixed bug that caused filesystem labels to be corrupted by rEFInd on
456 - Fixed bug that caused filesystem labels to be truncated in the drivers
459 - Fixed bug in use_graphics_for option parsing that caused most options
460 to set graphics mode for OS X and/or Linux but not other boot
463 - Tweaked install script to better isolate the ESP under OS X.
468 - rEFInd now supports compilation using the TianoCore UDK2010/EDK2
469 development kit in addition to GNU-EFI.
471 - Added new "use_graphics_for" option to control which OSes to boot in
472 graphics mode. (This effect lasts for a fraction of a second on most
473 systems, since the boot loader that rEFInd launches is likely to set
474 graphics or text mode itself.)
476 - Graphics-mode booting now clears the screen to the current rEFInd
477 background color (rather than black) and does NOT display boot messages.
478 The intent is for a smoother transition when booting OS X, or perhaps
479 other OSes that don't display boot loader messages. In practice, this
480 effect will be tiny for many OSes, since the boot loader generally clears
481 the screen within a fraction of a second of being launched; but the
482 "flicker" of a rEFInd message in that time can sometimes be distracting.
484 - Filesystem drivers now work on EFI 1.x systems, such as Macs.
486 - Removed "linux.conf" as a valid alternative name for "refind_linux.conf"
487 for holding Linux kernel options. The kernel developers plan to use
488 "linux.conf" themselves.
493 - Added a message to install.sh when run on Macs to remind users to update
494 the "scanfor" line in refind.conf if they need to boot BIOS-based OSes
497 - Modified install.sh script to be smarter about running efibootmgr on
498 Linux. It now uses the whole path to the rEFInd binary as a key to
499 determine whether an existing entry exists, rather than just the filename
500 portion. If an entry exists and is the first entry in the boot order, the
501 script does nothing to the NVRAM entries. If such an entry exists but is
502 not the default, the script deletes that entry and creates a new one
503 (implicitly making it the first in the boot order). If such an entry does
504 not exist, the script creates a new one (again, making it the first in
507 - Added "dont_scan_dirs" configuration file option, which adds directories
508 to a "blacklist" of directories that are NOT scanned for boot loaders.
513 - Added "scanning for new boot loaders" message to the re-scan function
514 (hitting Esc at the main menu). It usually flashes up too quickly to
515 be of importance, but if the scan function takes a while because of
516 access to a CD that must be spun up, it should make it clear that the
519 - Modified install.sh script to detect rEFItBlesser on Macs, and if
520 present, to ask the user if it should be removed.
522 - Cleaned up the Make.common file for the filesystem drivers.
524 - Changed HFS+ driver to return volume label of "HFS+ volume" rather than
525 an empty label. (The driver doesn't currently read the real volume
528 - Fixed bug that could cause rEFInd to appear in its own menu after
529 running a shell and then re-scanning for boot loaders.
534 - Inclusion of drivers for ISO-9660, HFS+, ReiserFS, and ext2fs. Most of
535 these drivers originated with rEFIt, although the HFS+ driver seems to
536 have come from Oracle's VirtualBox, with some files from Apple. I hadn't
537 included these drivers previously because the build process proved
538 challenging. As it is, they don't work on my Mac Mini, I suspect because
539 the build process with the UDK2010 development kit may not work with the
540 EFI 1.x that Apple uses.
542 - Addition of support for drivers in the "drivers_{arch}" subdirectory of
543 the main rEFInd binary directory (e.g., "drivers_x64" or "drivers_ia32").
544 Drivers may continue to be placed in the "drivers" subdirectory.
546 - Added new feature to eject CDs (and other removable media): Press F12 to
547 eject all such media. This function works only on some Macs, though (it
548 relies on an Apple-specific EFI extension, and this extension isn't even
549 implemented on all Macs, much less on UEFI-based PCs).
551 - Fixed a problem that could cause GRUB 2 to fail to read its configuration
552 file when launched from rEFInd.
557 - Removed the GRUB 2 detection "reciped" added with 0.3.2, since I've
558 received reports that it's not working as intended.
560 - Added re-scan feature: Press the Esc key to have rEFInd re-read its
561 configuration file, tell the EFI to scan for new filesystems, and re-scan
562 those filesystems for boot loaders. The main purpose is to enable
563 scanning a new removable medium that you insert after launching rEFInd;
564 however, it can also be used to immediately implement changes to the
565 configuration file or new drivers you load from an EFI shell.
567 - Fixed a bug that could cause the scroll-right arrow to be replaced by the
568 scroll-left arrow under some circumstances.
573 - Added new configuration file option: "icons_dir", which sets the name
574 of the subdirectory in which icons are found. See the documentation or
575 sample configuration file for a full description.
577 - Modified Makefile to generate rEFInd binary that includes architecture
578 code -- refind_ia32.efi or refind_x64.efi, rather than the generic
579 refind.efi. This is done mainly to help the install.sh script. The
580 program can be named anything you like on the disk. (The generic name
581 refind.efi is used on unknown architectures.)
583 - Improved install.sh script: Fixed bug on OS X 10.7 and enable it to be
584 used after building from source code (or via new "make install" Makefile
587 - Improved screen redraws to produce less flicker when moving among the
588 second-row tags or to the last tag on the first row.
593 - Improved menu navigation:
594 - In graphics mode, left & right arrow keys move left & right, while up &
595 down arrows move between rows.
596 - Page Up and Page Down now move through chunks of visible tags (in both
597 text & graphics modes), jumping from one row to another only when at
598 the edge of the row. In text mode, the "rows" are broken down as in
599 graphics mode, but they aren't visibly distinguished on the screen.
601 - Improved text-mode use: rEFInd now displays the proper number of entries
602 when first started in text mode and scrolling is done sensibly when too
603 many entries exist to fit on the screen.
608 - Added the install.sh script to install rEFInd on Linux and Mac OS X
609 systems. This script must be run as root (or via sudo). It requires
610 no options, but on Mac OS X, passing it the "esp" option causes it
611 to install rEFInd on the computer's ESP rather than the default of the
612 currently OS X boot partition. (Under Linux, the default is to install to
613 the ESP.) Note that there may be some unusual cases in which this script
616 - Does a better job of clearing the screen when launching OSes in text
619 - Added detection "recipe" for GRUB 2's BIOS Boot Partition.
621 - Fixed bogus detection of ESPs created by Linux's mkdosfs utility or
622 Windows as bootable partitions when "scanfor" includes BIOS scanning
629 - Fixed bug that caused spurious "Unsupported while scanning the root
630 directory" messages under some conitions on Macs.
632 - Modified loader scanning code to sort boot loader entries within a
633 directory by modification time, so that the most recently-modified loader
634 is first among those in a given directory. Thus, if you specify a
635 directory name (or volume name, for loaders stored in the root directory
636 of a volume) as the default_selection, the most recent of those loaders
637 will be the default. This is intended to help with Linux kernel
638 maintenance when using the EFI stub loader; set up this way, the most
639 recent kernel copied to your kernel directory will be the default,
640 obviating the need to adjust the refind.conf file when adding a new
641 kernel. If you want to change the default among those in the default
642 directory, you can use "touch" to adjust the modification timestamp.
644 - Tweaked code to find loader-specific .icns file so that it finds files
645 for Linux kernels without .efi extensions. In this case, files should be
646 named the same as the kernels they match, but with .icns extensions. For
647 instance, bzImage-3.3.2 should have an icon called bzImage-3.3.2.icns.
648 (The old code would have looked for an icon called bzImage-3.3.icns.)
650 - Eliminated bogus OS loader tags for filenames that end in ".icns" when
651 the scan_all_linux_kernels option is set.
656 - I'm officially upgrading this project's status from "alpha" to "beta" and
657 giving it a bump from 0.2.x to 0.3.0. This doesn't reflect any major
658 milestone with this version; rather, it reflects my sense that rEFInd has
659 been "out there" for a while, and although I've gotten bug reports,
660 they've been minor and/or have been fixed. The program still has known
661 bugs, but my impression is that it is, overall, usable by ordinary users.
663 - Added "resolution" option to refind.conf, which enables setting the video
664 resolution. To use it, pass two numeric values, as in "resolution 1024
665 768" to use a 1024x768 video mode. Note that not all modes are supported.
666 If you specify a non-supported video mode on a UEFI system, a message
667 appears listing the supported video modes and you must then press a key
668 to continue, using the default video mode (usually 800x600).
669 Unfortunately, I don't know the calls to get a list of supported video
670 modes on older EFI 1.x systems (including Macs), so on Macs setting an
671 incorrect video mode silently fails (you keep using the default mode).
672 This makes changing your video mode a hit-or-miss proposition on Macs.
673 CAUTION: It's possible to set a legal video mode that your monitor can't
674 handle, in which case you'll get a blank display until you boot an OS
675 that resets the video mode.
677 - Fixed (maybe) a bug that caused rEFInd to crash when returning from an
678 EFI shell or other programs on Macs, particularly when rEFInd used
679 graphical mode. I'm not 100% sure this bug is squashed because I still
680 don't understand the cause and I only have one Mac for testing. See
681 comments in the ReinitRefitLib() function in refit/lib.c for more
684 - Added new refind.conf option: scan_all_linux_kernels, which causes Linux
685 kernels that lack ".efi" extensions to be included in scans for EFI boot
686 loaders. This may help integration with Linux distributions that don't
687 give their kernels such names by default. Beware, though: It can detect
688 unwanted files, such as older non-stub-loader kernels or .icns files used
689 to give kernels with .efi extensions custom icons.
691 - Improved EFI boot loader detection on boards with Gigabyte's Hybrid EFI,
692 and perhaps other EFIs with a buggy StriCmp() function. Files with both
693 ".efi" and ".EFI" extensions should now be detected as boot loaders.
695 - Fixed a bug that caused rEFInd to fail to scan for drivers if the
696 filesystem driver didn't set a volume name (that is, if the relevant
697 field was set to NULL rather than even an empty string). In such
698 situations, rEFInd now reports the volume name as "Unknown".
703 - After much trial and tribulation, I've overcome a GNU-EFI limitation and
704 enabled rEFInd to load EFI drivers. This feature was present in the
705 original build of rEFIt but was removed in the versions that could
706 compile under Linux, but now it's back -- and still being compiled under
707 Linux! To use it, you should place your drivers in a convenient directory
708 on the ESP (or whatever partition you use to launch rEFInd) and add a
709 "scan_driver_dirs" entry to refind.conf to tell rEFInd where to look. (As
710 always, you should specify the driver directory relative to the root of
711 the filesystem.) Note that you can't launch drivers from another
712 filesystem; they must be on the same volume that holds rEFInd. Those who
713 compile from source code should note that implementing this feature
714 necessitated using a more recent version of the GNU-EFI library. I'm
715 currently using version 3.0p, and version 3.0i does NOT work. I don't
716 know where the change occurred, but you may need to upgrade your GNU-EFI
719 - Fixed bug that caused rEFInd to show up in its own menu sometimes.
721 - Added new refind.conf token: also_scan_dirs. When scanning volumes for
722 EFI boot loaders, rEFInd always scans the root directory and every
723 subdirectory of the /EFI directory, but it doesn't recurse into these
724 directories. The also_scan_dirs token adds more directories to the scan
725 list. It defaults to "elilo,boot", but you can set it to any directory or
726 directories you like.
731 - Added "volume" keyword to configuration file's stanza options. This
732 option changes the volume from which subsequent files (specified by
733 "loader" and "icon") are loaded. You pass "volume" the name/label of the
734 FILESYSTEM you want to use (not the GPT partition name), or a number
735 followed by a colon (e.g., "1:"). The former should reliably identify a
736 filesystem, assuming the name is unique. The latter assigns numbers based
737 on the order in which they're scanned, which may not be as reliable but
738 should work when a volume is unnamed.
740 - Fixed bug in 0.2.5 that caused failure of Linux initial RAM disk
741 mapping on some (but not all) systems. Affected computers include at
742 least some Intel motherboards, maybe others.
747 - Fixed bug that caused an inability to associate initial RAM disks with
748 Linux kernels stored in a volume's root directory.
750 - Volume badges (that override default badges) are now stored in
751 .VolumeBadge.icns. Although undocumented, rEFInd formerly loaded custom
752 volume badges from .VolumeIcon.icns. This carryover from rEFIt was a
753 confusing name, given the next (new) feature, so I've changed and
754 documented the name....
756 - Added ability to set a default icon for a loader stored in the root
757 directory of a volume: The icon is stored in .VolumeIcon.icns. This icon
758 is also used for Mac OS X volumes booted from the standard location.
760 - Fixed bug that caused icons to drop back to generic icons when rEFInd
761 was launched in certain ways (such as from an EFI shell in rEFInd's
762 directory) on certain systems.
764 - Fixed bug that caused "unknown disable flag" to be shown (very briefly)
765 instead of "unknown hideui flag" when an improper hideui flag was set.
770 - Created new refind.conf entry: "showtools". This entry takes options of
771 "shell", "gptsync", "about", "exit", "reboot", and "shutdown". This
772 option is in some respects an affirmative version of portions of the old
773 "disable" and "hideui" options; however, it enables users to specify the
774 order in which these options appear on the screen. Also, the "exit"
775 option is new; it terminates the program. The effect is usually to return
776 to whatever tool launched it or to launch a default OS; however, this is
777 somewhat unpredictable. The default therefore omits the "exit" option, as
778 well as "gptsync", which has always been dangerous (but necessary on most
779 MacOS/Windows dual-boot setups on Macs). As part of this reconfiguration,
780 I've eliminated the "rescue Linux" option, which always seemed pointless
783 - Folded "disable" and "hideui" refind.conf entries into one ("disable"),
784 and reduced the number of options to six: "banner", "label",
785 "singleuser", "hwtest", "arrows", and "all". ("arrows" is new and
786 disables the scroll arrows when a system has too many tags to display
789 - Added max_tags option to the refind.conf file, enabling users to reduce
790 the maximum number of OS loader tags that can be displayed at once.
792 - Updated rEFIt icon, based on the 128x128 volume label from the rEFIt CD
795 - Added x86 and x86-64 EFI shells to the CD image version of the binary,
796 but NOT to the binary zip file. The logic is that the CD image is more
797 likely to be used directly as an emergency disc and so may need this
798 feature, even though the source isn't part of the rEFInd project. (The
799 source is readily available from the TianoCore project.)
801 - EFI shells may now be stored at /shellx64.efi for x86-64 systems or at
802 /shellia32.efi for x86 systems. The /EFI/tools/shell.efi name is also
803 recognized; however, if both files are present, two EFI shell icons will
804 appear on the main menu. The /efi/{refind-path/apps/shell.efi filename,
805 which was never officially documented but worked as a carryover from
806 rEFIt, is no longer valid.
811 - Fixed (maybe) a bug that caused hangs when launching a second program
812 after returning from a first. There are some weird system-to-system
813 differences, though, and this fix causes (apparently harmless) error
814 messages about "(re)opening our installation volume" on at least one
815 system (a 32-bit Mac Mini). I'm committing this change because, imperfect
816 though it is, it's preferable to the earlier version, at least on my
817 small sample of computers.
819 - Because of news that the Linux kernel developers are planning to use the
820 filename linux.conf to hold Linux kernel configuration data for EFI
821 booting, I'm transitioning rEFInd away from that name and to
822 refind_linux.conf to avoid a conflict. This version can use either name,
823 with refind_linux.conf taking precedence if both are present.
825 - Added logo for Arch Linux.
830 - Fixed bug that caused program failure when Linux kernels with EFI stub
831 support were detected with no associated version numbers. rEFInd now
832 permits automatic linking of *ONE* versionless kernel to *ONE*
833 versionless initrd file.
835 - Fixed bug that caused program hangs when a boot loader filename or label
836 was too long. Such names are now properly truncated and program execution
839 - Fixed bug that caused no text to appear in submenus on UEFI systems with
840 small screens (800x600). NOTE: Problem still occurs on screens smaller
841 than this, but such systems are very rare.
846 - Added ability to set a "default_selection" that's a title or a substring
847 of one -- the name given to a stanza in a "menuentry" or the boot
848 loader's filename, in most cases, although "Mac OS X", "Windows XP
849 (XoM)", and "Microsoft EFI boot" are also titles.
851 - Added support for semi-automatic scans of Linux kernels with EFI stub
852 loader support. The program auto-detects matching initial RAM disk files
853 and loads additional options from the "linux.conf" file in the same
854 directory as the kernel.
856 - Added support for "submenuentry" keyword and associated sub-stanza
857 entries in refind.conf file.
859 - Renamed icons/os_mint.icns to icons/os_linuxmint.icns to match the
860 filename Linux Mint ACTUALLY uses for its ESP boot loader directory.
866 - Initial public release