]> code.delx.au - refind/blobdiff - docs/refind/getting.html
Documentation update
[refind] / docs / refind / getting.html
index a154f0ae88217e2f23eb7c70d6b9fbca18a55174..f80f3a202579baa4523ec896156680ce93d59106 100644 (file)
@@ -17,7 +17,7 @@
 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p>Originally written: 3/14/2012; last Web page update:
-11/8/2015, referencing rEFInd 0.10.0</p>
+6/24/2016, referencing rEFInd 0.10.3</p>
 
 <p>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!</p>
 
@@ -42,7 +42,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="amount" value="1.00">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -56,7 +56,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="amount" value="2.50">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -71,7 +71,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="amount" value="5.00">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -85,7 +85,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="amount" value="10.00">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -99,7 +99,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="amount" value="20.00">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -112,7 +112,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <input type="hidden" name="currency_code" value="USD">
 <input type="hidden" name="item_name" value="rEFInd Boot Manager">
 <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHostedGuest">
-<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td></tr>
 </table>
@@ -132,39 +132,39 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <ul>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-bin-0.10.0.zip/download">A
-    binary zip file</a></b>&mdash;Download this if you want to install
-    rEFInd and/or its filesystem drivers on an <i>x</i>86 or <i>x</i>86-64
-    computer and have no need to test rEFInd first by booting it on an
-    optical disc. This zip file package includes both <i>x</i>86 (aka IA32)
-    and <i>x</i>86-64 (aka <i>x</i>64, AMD64, or EM64T) versions of rEFInd.
-    Which you install depends on your architecture, as described on the <a
-    href="installing.html">Installing rEFInd</a> page. Some users of Arch
-    Linux have reported problems booting some specific Arch Linux kernels
-    with rEFInd and some other tools. For them, a <a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-bin-gnuefi-0.10.0.zip/download">variant
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-bin-0.10.3.zip/download">A
+    binary zip file</a></b>&mdash;Download this if you want to install rEFInd
+    and/or its filesystem drivers on an <i>x</i>86, <i>x</i>86-64, or ARM64
+    computer and have no need to test rEFInd first by booting it on an optical
+    disc. This zip file package includes <i>x</i>86 (aka IA32), <i>x</i>86-64
+    (aka <i>x</i>64, AMD64, or EM64T), and ARM64 (aka AARCH64 or AA64) versions
+    of rEFInd. Which you install depends on your architecture, as described on
+    the <a href="installing.html">Installing rEFInd</a> page. Some users of Arch
+    Linux have reported problems booting some specific Arch Linux kernels with
+    rEFInd and some other tools. For them, a <a
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-bin-gnuefi-0.10.3.zip/download">variant
     package</a> exists in which the <i>x</i>86-64 binary was compiled with
-    GNU-EFI rather than the usual TianoCore EDK2. This change helps some
-    users with this problem.</li>
+    GNU-EFI rather than the usual TianoCore EDK2. This change helps some users
+    with this problem.</li>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-0.10.0-1.x86_64.rpm/download">A
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-0.10.3-1.x86_64.rpm/download">A
     binary RPM file</a></b>&mdash;If you use an RPM-based <i>x</i>86-64
     Linux system such as Fedora or openSUSE, you can install the binary RPM
-    package rather than use the binary zip file. (I don't provide an
-    equivalent 32-bit package.) This package runs the
+    package rather than use the binary zip file. (I don't provide
+    equivalent 32-bit [<i>x</i>86] or ARM64 packages.) This package runs the
     <tt>refind-install</tt> script (described on the <a
     href="installing.html">Installing rEFInd</a> page) as part of the
     installation process. Distribution maintainers can examine the
     <tt>refind.spec</tt> file in the source package and tweak it to their
     needs. The <a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-0.10.0-1.src.rpm/download">source
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-0.10.3-1.src.rpm/download">source
     RPM file</a> might or might not build on your system as-is; it relies
     on assumptions about the locations of the GNU-EFI development
     files.</li>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind_0.10.0-1_amd64.deb/download">A
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind_0.10.3-1_amd64.deb/download">A
     binary Debian package</a></b>&mdash;If you use an <i>x</i>86-64 version
     of Debian, Ubuntu, Mint, or another Debian-based distribution, you can
     install from this package, which was converted from the binary RPM
@@ -175,7 +175,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <p class="sidebar"><b>Note:</b> At the moment, neither the bootable CD-R image file nor the bootable USB flash drive image file supports booting with Secure Boot active. The x86-64 version of the <a href="http://en.altlinux.org/Rescue">ALT Linux Rescue disc</a> uses a Secure Boot-enabled rEFInd, though, so you may find that useful in some situations.</p>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-cd-0.10.0.zip/download">A
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-cd-0.10.3.zip/download">A
     CD-R image file</a></b>&mdash;This download contains the same files as
     the binary zip file, but you can burn it to a CD-R to test rEFInd
     (and its filesystem drivers) without installing it first. (It boots on
@@ -199,14 +199,14 @@ first partition on <tt>/dev/sdd</tt>. This procedure should work even on a
 BIOS-booted computer.</p>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-flashdrive-0.10.0.zip/download">A
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-flashdrive-0.10.3.zip/download">A
     USB flash drive image file</a></b>&mdash;Although you     can create
     your own rEFInd USB flash drive, you may find it easier to download
     this version and copy it to your USB drive with <tt>dd</tt> or some
     other low-level disk copying utility.</li>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.10.0/refind-src-0.10.0.tar.gz/download">A
+    href="http://sourceforge.net/projects/refind/files/0.10.3/refind-src-0.10.3.tar.gz/download">A
     source code tarball</a></b>&mdash;This is useful if you want to compile
     the software locally. Note that I use Linux with the <a
     href="https://sourceforge.net/projects/tianocore/">TianoCore EFI
@@ -237,21 +237,48 @@ BIOS-booted computer.</p>
 
 <ul>
 
-<li><a name="ppa"><b>Ubuntu</b></a>&mdash;Although an official Ubuntu
-    package isn't available, I've created a <a
-    href="https://launchpad.net/~rodsmith/+archive/refind">rEFInd PPA</a>
-    for Ubuntu. To use it, open a Terminal window and type <tt
-    class="userinput">sudo apt-add-repository ppa:rodsmith/refind</tt>,
-    then <tt class="userinput">sudo apt-get update</tt>. You can then type
-    <tt class="userinput">sudo apt-get install refind</tt> to install the
-    package. Thereafter, the rEFInd version will update along with your
-    other software. This package is built with GNU-EFI and is not signed
-    with a Secure Boot key; however, the install script (which launches
-    automatically when you install the package) should sign the binary with
-    a locally-generated key if it detects that your system uses Secure
-    Boot. Thus, if you've previously installed one of my binaries on a
-    Secure Boot system and added its key as a MOK, you'll have to add your
-    local key when you reboot.</li>
+<li><b>Debian</b>&mdash;Debian added rEFInd 0.10.3 to its "sid" (unstable")
+    repository in June of 2016. Because most people don't use this
+    "bleeding-edge" version of the distribution, it is not yet a practical
+    option for most users; but it is on the way. You can download and
+    install it as a separate package <a
+    href="https://packages.debian.org/unstable/admin/refind">here.</a>
+    Debian's inclusion of rEFInd means that derivative distributions, such
+    as Ubuntu and Mint, will eventually receive rEFInd packages, too. Be
+    aware that Debian's package is not signed with a Secure Boot key,
+    although if the <tt>sbsigntool</tt> package is installed, the
+    installation scripts will generate and use their own Secure Boot
+    keys and sign the binary with them.</li>
+
+<li><b>Ubuntu</b>&mdash;Two Ubuntu-specific methods of installing rEFInd in
+    this distribution exist:
+
+    <ul>
+
+    <li>Ubuntu 16.10 ("Yakkety Yak") has synced the Debian package. As I
+       write (in late June, 2016), it's not yet available in the
+       repositories, but it should appear there eventually. Note that, like
+       the Debian package, this one is not signed for use with Secure Boot,
+       but if your system includes the <tt>sbsigntool</tt> package, the
+       installer will generate a local key for this purpose.</li>
+
+    <li>I've created a <a
+       href="https://launchpad.net/~rodsmith/+archive/refind">rEFInd
+       PPA</a> for Ubuntu. To use it, open a Terminal window and type <tt
+       class="userinput">sudo apt-add-repository ppa:rodsmith/refind</tt>,
+       then <tt class="userinput">sudo apt-get update</tt>. You can then
+       type <tt class="userinput">sudo apt-get install refind</tt> to
+       install the package. You'll be asked to decide whether to install
+       rEFInd to the ESP when you first install it. Thereafter, the rEFInd
+       version will update along with your other software. This package is
+       built with GNU-EFI and is not signed with a Secure Boot key;
+       however, the install script should sign the binary with a
+       locally-generated key if it detects that your system uses Secure
+       Boot. Thus, if you've previously installed one of my binaries on a
+       Secure Boot system and added its key as a MOK, you'll have to add
+       your local key when you reboot.</li>
+
+    </ul></li>
 
 <li><b>Arch Linux</b>&mdash;You can obtain rEFInd from the Arch
     repositories, in both a stable version (the <tt>refind-efi</tt> package
@@ -269,11 +296,12 @@ BIOS-booted computer.</p>
     href="http://packages.altlinux.org/en/Sisyphus/srpms/refind">this
     page</a> for details.</li>
 
-<li><b>Gentoo Linux</b>&mdash;An official ebuild of rEFInd is available;
-    see <a
-    href="https://packages.gentoo.org/packages/sys-boot/refind">here</a>
-    for details and <a href="https://wiki.gentoo.org/wiki/Refind">here</a>
-    for Gentoo's official rEFInd documentation.</a></li>
+<li><b>Gentoo Linux</b>&mdash;An official ebuild of rEFInd is available; see <a
+    href="https://packages.gentoo.org/packages/sys-boot/refind">here</a> for
+    details and <a href="https://wiki.gentoo.org/wiki/Refind">here</a> for
+    Gentoo's official rEFInd documentation.</a> A separately-maintained overlay
+    exists (see <a href="https://github.com/sveyret/sveyret-overlay">here</a>),
+    which can be compiled with TianoCore and may be more up-to-date.</li>
 
 <li><b>Slackware</b>&mdash;As far as I know, an official rEFInd package is
     not available as part of Slackware; however, a <a
@@ -295,7 +323,7 @@ BIOS-booted computer.</p>
 
 <hr />
 
-<p>copyright &copy; 2012&ndash;2015 by Roderick W. Smith</p>
+<p>copyright &copy; 2012&ndash;2016 by Roderick W. Smith</p>
 
 <p>This document is licensed under the terms of the <a href="FDL-1.3.txt">GNU Free Documentation License (FDL), version 1.3.</a></p>