agners / rEFInd

Dismiss
Join GitHub today
GitHub is home to over 36 million developers working together to host
and review code, manage projects, and build software together.

Sign up

rEFInd EFI Boot Manager

198 commits 1 branch 0 releases 1 contributor View license

Branch: master New pull request Find File Clone or download

agners Added new test program catfile, extended/fixed Makefile Downloading ... commit 1af2fbe on 28 Jan 2013
Latest

EfiLib Fix to install.sh's efibootmgr filename; disable check for 2048-byte

Want to be notified of new releases in 6 years ago
agners/rEFInd?
docs Version 0.6.6 release. 6 years ago

filesystems Added new test program catfile, extended/fixed Makefile Sign in Sign6up
years ago

fonts Version 0.6.6 release. 6 years ago

icons ALT Linux icon. 6 years ago

images Added raw images directory for those who might want to change & 7 years ago

include Added transparency support for built-in selection icon. 6 years ago

keys Version 0.6.5 release. 6 years ago

libeg Fixed bug: ICNS file in main icons directory would override PNG file in 6 years ago

mok Shim/MOK fine-tuning & support for building drivers with GNU-EFI 6 years ago

refind Fixed bug: ICNS file in main icons directory would override PNG file in 6 years ago

BUILDING.txt Small build process changes. 6 years ago

COPYING.txt Initial commit. 7 years ago

CREDITS.txt Version 0.6.5 release. 6 years ago

LICENSE.txt Initial commit. 7 years ago

Make.common Small change. 6 years ago

Make.tiano Changes related to new shim/MOK code. 6 years ago

Makefile New ability to specify volume labels in "dont_scan_dirs" token to 6 years ago

NEWS.txt Fixed bug: ICNS file in main icons directory would override PNG file in 6 years ago

README.txt Version 0.6.3 release. 6 years ago

install.sh Version 0.6.6 release. 6 years ago

mkcdimage Fix memory management error; version 0.6.4 release. 6 years ago

mkdistrib Version 0.6.6 release. 6 years ago

mkrlconf.sh Version 0.6.1 official release 7 years ago

mvrefind.sh Version 0.6.3 release. 6 years ago

refind-alt.spec RPM spec file used by ALT Linux; maybe useful as a reference. 6 years ago

refind.conf-sample Support for loading fonts (as PNG files); new default font. 6 years ago

refind.inf Shim/MOK fine-tuning & support for building drivers with GNU-EFI 6 years ago
 refind.spec Fixed bug: ICNS file in main icons directory would override PNG file in 6 years ago

README.txt

Brief Installation Instructions (Binary Package)

================================================

This is rEFInd, an EFI boot manager. The binary package includes the
following files and subdirectories:

File Description
----------------------------- -----------------------------
refind/refind_ia32.efi The main IA32 rEFInd binary
refind/refind_x64.efi The main x86-64 rEFInd binary
refind/refind.conf-sample A sample configuration file
refind/icons/ Subdirectory containing icons
refind/drivers_ia32/ Subdirectory containing IA32 drivers
refind/drivers_x64/ Subdirectory containing x86-64 drivers
keys/ Subdirectory containing MOKs
install.sh Linux/MacOS installation script
mkrlconf.sh A script to create refind_linux.conf
mvrefind.sh A script to move a rEFInd installation
README.txt This file
NEWS.txt A summary of program changes
LICENSE.txt The original rEFIt license
COPYING.txt The rEFInd license
CREDITS.txt Acknowledgments of code sources
docs/ Documentation in HTML format

The easiest way of installing rEFInd is generally to use the install.sh

script; however, you must be running under Linux or OS X to do this. If
you're using either of those OSes, simply typing "./install.sh" will
generally install rEFInd. If you have problems with this method, though,
you'll have to do a manual installation. The install.sh script supports a
number of options that you might want to use; consult the
docs/refind/installing.html file for details.

To install the binary package manually, you must first access your EFI
System Partition (ESP). You can then place the files from the refind
subdirectory in a subdirectory of the ESP's EFI directory. You may omit the
.efi binary for the type of computer you're NOT using, and you may
optionally rename the .efi file for the binary you are using. If this is an
initial installation, you should rename refind.conf-sample to refind.conf;
but if you're replacing an existing installation, you should leave your
existing refind.conf intact. The end result might include the following
files on the ESP:

EFI/refind/refind_x64.efi
EFI/refind/refind.conf
EFI/refind/icons/

Unfortunately, dropping the files in the ESP is not sufficient; as

described in the docs/refind/installing.html file, you must also tell your
EFI about rEFInd. Precisely how to do this varies with your OS or, if you
choose to do it through the EFI, your EFI implementation. In some cases you
may need to rename the EFI/refind directory as EFI/boot, and rename
refind_x86.efi to bootx64.efi (or refind_ia32.efi to bootia32.efi on 32-bit
systems). Consult the installing.html file for full details.

If you want to use any of the filesystem drivers, you must install them,
too. Creating a subdirectory of the rEFInd binary directory called
drivers_x64 (for x86-64 systems), drivers_ia32 (for x86 systems), or
drivers (for any architecture) and copying the drivers you want to this
location should do the trick. When you next launch it, rEFInd should load
the drivers, giving you access to the relevant filesystems.

Brief Installation Instructions (Source Package)

================================================

rEFInd source code can be obtained from

https://sourceforge.net/projects/refind/. Consult the BUILDING.txt file in
the source code package for build instructions. Once you've built the
source code, you can use the install.sh script to install the binaries
you've built. Alternatively, you can duplicate the directory tree described
above by copying the individual files and the icons directory to the ESP.