From: srs5694 Date: Sun, 9 Oct 2016 23:23:54 +0000 (-0400) Subject: Version 0.10.4 release. X-Git-Url: https://code.delx.au/refind/commitdiff_plain/bda402d8bb74587c5a813c94a0c8626e0e4f18fe Version 0.10.4 release. --- diff --git a/Makefile b/Makefile index 04b0ca7..2ae341a 100644 --- a/Makefile +++ b/Makefile @@ -12,7 +12,7 @@ MOK_DIR=mok GPTSYNC_DIR=gptsync EFILIB_DIR=EfiLib export EDK2BASE=/usr/local/UDK2014/MyWorkSpace -export REFIND_VERSION='L"0.10.3.2"' +export REFIND_VERSION='L"0.10.4"' # The "all" target builds with the TianoCore library if possible, but falls # back on the more easily-installed GNU-EFI library if TianoCore isn't diff --git a/NEWS.txt b/NEWS.txt index 4c0579d..299334d 100644 --- a/NEWS.txt +++ b/NEWS.txt @@ -1,6 +1,9 @@ -0.10.4 (?/??/2016): +0.10.4 (10/9/2016): ------------------- +- Fixed compile problem for drivers with recent versions of GNU-EFI + (3.0.4, maybe 3.0.3). + - Fixed bug that could cause program crash on startup. (In practice, it manifested with GNU-EFI starting with version 3.0.3 or 3.0.4.) diff --git a/debian/changelog b/debian/changelog index 0256184..3126dc9 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,9 @@ +refind (0.10.4-0ppa1) xenial; urgency=medium + + * Version bump + + -- Roderick Smith Sun, 09 Oct 2016 19:10:59 -0400 + refind (0.10.3-0ppa1) wily; urgency=medium * Version bump diff --git a/docs/man/mkrlconf.8 b/docs/man/mkrlconf.8 index 7cf38b7..3755a4f 100644 --- a/docs/man/mkrlconf.8 +++ b/docs/man/mkrlconf.8 @@ -1,7 +1,7 @@ .\" Copyright 2015-2016 Roderick W. Smith (rodsmith@rodsbooks.com) .\" May be distributed under the GNU Free Documentation License version 1.3 or any later version -.TH "MKRLCONF" "8" "0.10.3" "Roderick W. Smith" "rEFInd Manual" +.TH "MKRLCONF" "8" "0.10.4" "Roderick W. Smith" "rEFInd Manual" .SH "NAME" mkrlconf \- Create a Linux kernel configuration file for rEFInd .SH "SYNOPSIS" diff --git a/docs/man/mvrefind.8 b/docs/man/mvrefind.8 index dc04d9d..a45b23e 100644 --- a/docs/man/mvrefind.8 +++ b/docs/man/mvrefind.8 @@ -1,7 +1,7 @@ .\" Copyright 2015-2016 Roderick W. Smith (rodsmith@rodsbooks.com) .\" May be distributed under the GNU Free Documentation License version 1.3 or any later version -.TH "MVREFIND" "8" "0.10.3" "Roderick W. Smith" "rEFInd Manual" +.TH "MVREFIND" "8" "0.10.4" "Roderick W. Smith" "rEFInd Manual" .SH "NAME" mvrefind \- Move a rEFInd installation from one location to another .SH "SYNOPSIS" diff --git a/docs/man/refind-install.8 b/docs/man/refind-install.8 index 857c3a0..d479e29 100644 --- a/docs/man/refind-install.8 +++ b/docs/man/refind-install.8 @@ -1,13 +1,13 @@ .\" Copyright 2015-2016 Roderick W. Smith (rodsmith@rodsbooks.com) .\" May be distributed under the GNU Free Documentation License version 1.3 or any later version -.TH "REFIND-INSTALL" "8" "0.10.3" "Roderick W. Smith" "rEFInd Manual" +.TH "REFIND-INSTALL" "8" "0.10.4" "Roderick W. Smith" "rEFInd Manual" .SH "NAME" refind-install \- Install rEFInd to the ESP and create an NVRAM entry .SH "SYNOPSIS" .BI "refind-install " [--notesp | --usedefault \fIdevice-file\fR | --root \fImount-point\fR | ---ownhfs \fIdevice-file\fR ] [--keepname ] [--nodrivers | --alldrivers] +--ownhfs \fIdevice-file\fR ] [--keepname] [--nodrivers | --alldrivers] [--shim \fIshim-filename\fR] [--localkeys] [--yes] diff --git a/docs/man/refind-mkdefault.8 b/docs/man/refind-mkdefault.8 index 3ac2dde..7006a2f 100644 --- a/docs/man/refind-mkdefault.8 +++ b/docs/man/refind-mkdefault.8 @@ -1,7 +1,7 @@ .\" Copyright 2016 Roderick W. Smith (rodsmith@rodsbooks.com) .\" May be distributed under the GNU Free Documentation License version 1.3 or any later version -.TH "REFIND-MKDEFAULT" "8" "0.10.3" "Roderick W. Smith" "rEFInd Manual" +.TH "REFIND-MKDEFAULT" "8" "0.10.4" "Roderick W. Smith" "rEFInd Manual" .SH "NAME" refind-mkdefault \- Set rEFInd as the default EFI boot option .SH "SYNOPSIS" diff --git a/docs/refind/bootcoup.html b/docs/refind/bootcoup.html index af1c4fd..fd3b591 100644 --- a/docs/refind/bootcoup.html +++ b/docs/refind/bootcoup.html @@ -16,7 +16,7 @@

by Roderick W. Smith, rodsmith@rodsbooks.com

-

Originally written: 4/24/2016, referencing rEFInd 0.10.3

+

Originally written: 10/9/2016, referencing rEFInd 0.10.4

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

diff --git a/docs/refind/bootmode.html b/docs/refind/bootmode.html index bfccd67..37b8eed 100644 --- a/docs/refind/bootmode.html +++ b/docs/refind/bootmode.html @@ -17,7 +17,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

Originally written: 3/14/2012; last Web page update: -4/24/2016, referencing rEFInd 0.10.3

+10/9/2016, referencing rEFInd 0.10.4

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

diff --git a/docs/refind/configfile.html b/docs/refind/configfile.html index 4c3d9d2..af2d618 100644 --- a/docs/refind/configfile.html +++ b/docs/refind/configfile.html @@ -17,7 +17,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

Originally written: 3/14/2012; last Web page update: -4/24/2016, referencing rEFInd 0.10.3

+10/9/2016, referencing rEFInd 0.10.4

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

diff --git a/docs/refind/drivers.html b/docs/refind/drivers.html index 7dc2311..90ea588 100644 --- a/docs/refind/drivers.html +++ b/docs/refind/drivers.html @@ -17,7 +17,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

Originally written: 4/19/2012; last Web page update: -4/24/2016, referencing rEFInd 0.10.3

+10/9/2016, referencing rEFInd 0.10.4

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

@@ -138,7 +138,9 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

  • Why Should You Use Drivers?
    • -
  • Using rEFInd's EFI Drivers
    • +
  • Installing rEFInd's EFI Drivers
    • + +
  • Selecting an EFI Driver
  • Finding Additional Drivers
    • @@ -175,36 +177,77 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com

    As a side note, using an ISO-9660 driver can theoretically help you keep the size of a custom Linux boot CD/DVD down to a reasonable value. This is because EFI systems normally boot from optical discs by reading a FAT image file in El Torito format and treating that file as an ESP. If you need to store the kernel both in that file and directly in the ISO-9660 filesystem (to maintain bootability on BIOS systems), that can represent an unwanted extra space requirement. Placing rEFInd and an ISO-9660 driver in the FAT image file should enable you to store the kernel on the disc only once. Unfortunately, this doesn't work in practice. When the ISO-9660 driver is loaded from the El Torito image, the driver discovers that the optical disc is in use and refuses to access it. It's possible to use EFI shell commands to give the ISO-9660 driver access to the shell device, but this causes the El Torito access to go away, which means that anything loaded from the El Torito image (such as rEFInd) is likely to malfunction. Also, some EFI implementations include ISO-9660 drivers, so you might not need a separate ISO-9660 driver if you're building a disc for a particular computer.

    - -

    Using rEFInd's EFI Drivers

    +     +

    Installing rEFInd's EFI Drivers

     +

    If you install rEFInd via the refind-install script or by installing an RPM or Debian package in a Linux distribution, the script should install the driver that matches the filesystem on which your kernels are stored automatically, with a couple of important caveats:

    + + + +

    rEFInd's filesystem drivers reside in the refind/drivers_arch subdirectory of the rEFInd .zip file, where arch is a CPU architecture code, such as x64 or ia32. If you installed rEFInd using an RPM or Debian package, chances are the relevant files will be stored in /usr/share/refind/refind/drivers_x64/ or a similar location. You can type find /usr/share/ -name "ext4*" to find the exact location, or use your package manager to list all the files installed from the refind package. The files are named after the filesystems they handle, such as ext4_x64.efi for the x86-64 ext4fs driver. You should copy the files for the filesystems you want to use to (You may need to create this subdirectory.)

    + +

    To install a driver, you must copy it from the package .zip file or from where the rEFInd RPM or Debian package placed it to the drivers or drivers_arch subdirectory of the main rEFInd installation directory. The main rEFInd directory is usually either EFI/refind or EFI/BOOT on the EFI System Partition (ESP). How to identify and access the ESP varies from one OS to another:

    + + + +

    Be careful to install drivers only for your own architecture. Attempting to load drivers for the wrong CPU type will cause a small delay at best, or may cause the computer to crash at worst. I've placed rEFInd's drivers in directories that are named to minimize this risk, but you should exercise care when copying driver files.

    + +

    Warning: Do not place EFI program files in your driver directories! Unfortunately, EFI uses the same .efi filename extension to identify both EFI program files and EFI drivers. Therefore, rEFInd can't distinguish between the two prior to loading them, and if you place program files in a drivers directory, rEFInd will run the EFI program file when it does its driver scan.

    + +

    When you reboot after installing drivers, rEFInd should automatically detect and use the drivers you install. There's likely to be an extra delay, typically from one to five seconds, as rEFInd loads the drivers and tells the EFI to detect the filesystems they handle. For this reason, and because of the possibility of drivers harboring bugs, I recommend installing only those drivers that you need. If you like, you can install drivers you don't plan on using to some other directory, such as /drivers on the ESP's root. You can then load these drivers manually with the EFI shell's load command if the need arises in the future. You can then tell the shell to re-assign drive identifiers with map -r:

    + +
    +fs0: load btrfs_x64.efi
+fs0: map -r
+
    + + +

    Selecting an EFI Driver

    +     + +

    Warning: When compiled with GNU-EFI, rEFInd's drivers hang when run on my 32-bit Mac Mini. The TianoCore-compiled versions are fine, and the GNU-EFI-built binaries are fine on a 32-bit VirtualBox. The 64-bit GNU-EFI-built versions are fine on a MacBook Pro. Thus, the problem is very limited in scope. The problem can be quite serious if you run into it, though, since you must bypass rEFInd to boot the computer. In debugging the problem, I found that a key funtion was being entered mid-function, which suggests either an EFI bug or a problem with the compiler or related tools. In any event, the solution is simple: Use driver binaries built with TianoCore if you have a 32-bit Mac.

    +

    Since version 0.4.0, rEFInd has shipped with a small collection of read-only EFI filesystem drivers. These are: