]> code.delx.au - refind/blobdiff - docs/refind/getting.html
Documentation update
[refind] / docs / refind / getting.html
index 8e9a33ff3e3782d9cae5d87c48f949dc5a10721d..f80f3a202579baa4523ec896156680ce93d59106 100644 (file)
@@ -8,6 +8,8 @@
   <link href="../Styles/styles.css" rel="stylesheet" type="text/css" />
 </head>
 
+<meta name="viewport" content="width=device-width, initial-scale=1">
+
 <body>
   <h1>The rEFInd Boot Manager:<br />Getting rEFInd</h1>
 
@@ -15,7 +17,7 @@
 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p>Originally written: 3/14/2012; last Web page update:
-6/8/2014, referencing rEFInd 0.8.2</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>
 
@@ -40,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>
 
@@ -55,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>
 
@@ -71,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>
 
@@ -86,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>
 
@@ -101,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>
 
@@ -115,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>
@@ -136,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.2/refind-bin-0.8.2.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.2/refind-bin-gnuefi-0.8.2.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.2/refind-0.8.2-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.2/refind-0.8.2-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.2/refind_0.8.2-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,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.2/refind-cd-0.8.2.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
@@ -207,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.2/refind-flashdrive-0.8.2.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.2/refind-src-0.8.2.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>
 
@@ -252,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, 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">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
@@ -284,6 +296,18 @@ 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
+    package from SlackBuilds</a> is available.</li>
+
 <li><b><a href="http://distro.ibiblio.org/fatdog/web/">Fat
     Dog</a></b>&mdash;This variant of Puppy Linux uses a combination of
     rEFInd and GRUB 2 to boot its installation medium in EFI mode and
@@ -293,18 +317,13 @@ computer.</p>
     collection</a></b>&mdash;This site creates packages for a number of
     OSes using its own packaging system.</li>
 
-<li><b>Slackware</b>&mdash;Although it doesn't seem to provide an official
-    build, <a href="http://franck-barbenoire.fr/spip.php?article198">this
-    site</a> has links to rEFInd binary packages for Slackware 13.37 and
-    14.0.</li>
-
 </ul>
 
 <p>To the best of my knowledge, no other Linux distribution yet includes rEFInd in its repositories. That's likely to change in time. If you hear of rEFInd being included in an OS's official package set, feel free to <a href="mailto:rodsmith@rodsbooks.com">drop me a line.</a></p>
 
 <hr />
 
-<p>copyright &copy; 2012&ndash;2014 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>