]> code.delx.au - refind/blobdiff - docs/refind/getting.html
Documentation update
[refind] / docs / refind / getting.html
index ee948b535c9642b908454cec1b2c70e8df4b1312..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:
-3/1/2015, referencing rEFInd 0.8.7</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,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -57,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -73,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -88,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -103,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td>
 
@@ -117,8 +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!">
-<img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+<input type="image" src="donate.png" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
 </form>
 </td></tr>
 </table>
@@ -138,38 +132,39 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <ul>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.8.7/refind-bin-0.8.7.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.8.7/refind-bin-gnuefi-0.8.7.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.8.7/refind-0.8.7-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 <tt>install.sh</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.8.7/refind-0.8.7-1.src.rpm/download">source
+    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.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.8.7/refind_0.8.7-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
@@ -177,23 +172,10 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
     PPA</a> is available, which may install more smoothly and will cause
     rEFInd to automatically update with other packages.</li>
 
-<!--
-<li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.4.7/refind-bin-gnuefi-0.4.7.zip/download">A
-    binary zip file (built with GNU-EFI)</a></b>&mdash;This package is just
-    like the preceding one, except that it was built using the GNU-EFI
-    development kit rather than the TianoCore EFI Development Kit 2 (EDK2)
-    that was used to build the other binary. I originally used GNU-EFI to
-    develop rEFInd, but the GNU-EFI toolkit doesn't support the legacy
-    (BIOS-mode) boot calls on UEFI-based PCs, so I now consider the
-    TianoCore build to be the primary one. (Macs can boot legacy OSes using
-    either build.)</li>
--->
-
 <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.8.7/refind-cd-0.8.7.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
@@ -209,36 +191,37 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p class="sidebar"><b>Tip:</b> If you want to make your own bootable USB
 flash drive, download the binary zip file or CD-R image file, prepare a USB
-flash drive with a FAT32 partition, and then use the <tt>install.sh</tt>
-program's <tt>--usedefault</tt> option, and perhaps the
-<tt>--alldrivers</tt> option, as in <tt class="userinput">bash install.sh
---usedefault /dev/sdd1 --alldrivers</tt> to install to the first partition
-on <tt>/dev/sdd</tt>. This procedure should work even on a BIOS-booted
-computer.</p>
+flash drive with a FAT32 partition, and then use the
+<tt>refind-install</tt> program's <tt>--usedefault</tt> option, and perhaps
+the <tt>--alldrivers</tt> option, as in <tt class="userinput">bash
+refind-install --usedefault /dev/sdd1 --alldrivers</tt> to install to the
+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.8.7/refind-flashdrive-0.8.7.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.8.7/refind-src-0.8.7.zip/download">A
-    source code zip file</a></b>&mdash;This is useful if you want to compile
+    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
     Development Kit 2 (EDK2)</a> to build my binary packages (above),
-    although the <a href="http://sourceforge.net/projects/gnu-efi">GNU-EFI</a>
-    development tools are also supported.</li>
+    although the <a
+    href="http://sourceforge.net/projects/gnu-efi">GNU-EFI</a> development
+    tools are also supported, and are used in building the Ubuntu PPA.</li>
 
 <li><b><a href="https://sourceforge.net/p/refind/code">Source code via
     git</a></b>&mdash;If you want to peruse the source code in your Web
     browser or get the very latest version (including pre-release bug fixes
     and updates), you can use the Sourceforge git repository. This access
     method is most useful to programmers, or at least to those who are
-    familiar with programming tools. Note that if you need to ask "what's
-    git?", this is probably not the best way for you to obtain rEFInd.</li>
+    familiar with programming tools. If you need to ask "what's git?", this
+    is probably not the best way for you to obtain rEFInd.</li>
 
 </ul>
 
@@ -254,21 +237,48 @@ 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
@@ -286,6 +296,13 @@ 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> 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
     href="http://slackbuilds.org/repository/14.1/system/refind/?search=refind">Slackware
@@ -306,7 +323,7 @@ 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>