]> code.delx.au - refind/blobdiff - docs/refind/getting.html
Version 0.7.0 release with misc. filesystem driver improvements.
[refind] / docs / refind / getting.html
index 811ebf5b11230ce9ee77551a2c4ee440d7627ac1..a7d35057dc12e1eecf52d8e6c98d14cb0b8ae35f 100644 (file)
@@ -15,7 +15,7 @@
 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p>Originally written: 3/14/2012; last Web page update:
-11/6/2012, referencing rEFInd 0.4.7</p>
+6/27/2013, referencing rEFInd 0.7.0</p>
 
 <p>I'm a technical writer and consultant specializing in Linux technologies. 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>
 
@@ -25,49 +25,87 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <td>Donate $2.50</td>
 <td>Donate $5.00</td>
 <td>Donate $10.00</td>
+<td>Donate $20.00</td>
 <td>Donate another value</td>
 </tr>
 <tr>
-<td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
-<input type="hidden" name="cmd" value="_xclick">
+
+<td>
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_donations">
 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
-<input type="hidden" name="item_name" value="rEFInd Boot Manager">
+<input type="hidden" name="lc" value="US">
+<input type="hidden" name="no_note" value="0">
 <input type="hidden" name="currency_code" value="USD">
 <input type="hidden" name="amount" value="1.00">
-<input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
+<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">
 </form>
-
 </td>
-<td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
-<input type="hidden" name="cmd" value="_xclick">
+
+<td>
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_donations">
 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
-<input type="hidden" name="item_name" value="rEFInd Boot Manager">
+<input type="hidden" name="lc" value="US">
+<input type="hidden" name="no_note" value="0">
 <input type="hidden" name="currency_code" value="USD">
 <input type="hidden" name="amount" value="2.50">
-<input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
+<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">
 </form>
-
 </td>
-<td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
-<input type="hidden" name="cmd" value="_xclick">
+
+
+<td>
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_donations">
 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
-<input type="hidden" name="item_name" value="rEFInd Boot Manager">
+<input type="hidden" name="lc" value="US">
+<input type="hidden" name="no_note" value="0">
 <input type="hidden" name="currency_code" value="USD">
 <input type="hidden" name="amount" value="5.00">
-<input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
+<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">
 </form>
-
 </td>
-<td><form name="_xclick" action="https://www.paypal.com/cgi-bin/webscr" method="post">
-<input type="hidden" name="cmd" value="_xclick">
+
+<td>
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_donations">
 <input type="hidden" name="business" value="rodsmith@rodsbooks.com">
-<input type="hidden" name="item_name" value="rEFInd Boot Manager">
+<input type="hidden" name="lc" value="US">
+<input type="hidden" name="no_note" value="0">
 <input type="hidden" name="currency_code" value="USD">
 <input type="hidden" name="amount" value="10.00">
-<input type="image" src="http://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
+<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">
 </form>
+</td>
 
+<td>
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_donations">
+<input type="hidden" name="business" value="rodsmith@rodsbooks.com">
+<input type="hidden" name="lc" value="US">
+<input type="hidden" name="no_note" value="0">
+<input type="hidden" name="currency_code" value="USD">
+<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">
+</form>
 </td>
+
 <td>
 <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
 <input type="hidden" name="cmd" value="_donations">
@@ -81,7 +119,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <img alt="Donate with PayPal" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
 </form>
 </td></tr>
-</table> 
+</table>
 
 <hr />
 
@@ -93,30 +131,48 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <h2>Getting rEFInd from Sourceforge</h2>
 
-<p>You can find the rEFInd source code and binary packages at <a href="http://www.sourceforge.net/projects/refind/">its SourceForge page.</a> Note that rEFInd is OS-independent&mdash;it runs before the OS, so you download the same binary package for any OS. You can obtain rEFInd in four different forms:</p>
+<p>You can find the rEFInd source code and binary packages at <a href="http://www.sourceforge.net/projects/refind/">its SourceForge page.</a> Note that rEFInd is OS-independent&mdash;it runs before the OS, so you download the same binary package for any OS. You can obtain rEFInd in several different forms:</p>
 
 <ul>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.4.7/refind-src-0.4.7.zip/download">A
-    source code zip file</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 binaries (below), although the
-    <a href="http://sourceforge.net/projects/gnu-efi">GNU-EFI</a>
-    development tools are also supported. rEFIt used an Intel/Microsoft
-    toolchain. Backporting rEFInd to that toolchain is theoretically
-    possible, but I've not attempted it.</li>
-
-<li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.4.7/refind-bin-0.4.7.zip/download">A
+    href="http://sourceforge.net/projects/refind/files/0.7.0/refind-bin-0.7.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.</li>
+    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.7.0/refind-bin-gnuefi-0.7.0.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; but using GNU-EFI also means that this version
+    can't launch BIOS-mode OSes.</li>
+
+<li><b><a
+    href="http://sourceforge.net/projects/refind/files/0.7.0/refind-0.7.0-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.7.0/refind-0.7.0-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.7.0/refind_0.7.0-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
+    package using <tt>alien</tt>.</li>
 
 <!--
 <li><b><a
@@ -131,10 +187,10 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
     either build.)</li>
 -->
 
-<p class="sidebar"><b>Tip:</b> If you want a bootable USB flash drive, download the binary zip file or CD-R image file, prepare a USB flash drive with a FAT32 ESP, and then use the <tt>install.sh</tt> program's <tt>--usedefault</tt> option, as in <tt class="userinput">bash install.sh --usedefault /dev/sdd1</tt> to install to the first partition on <tt>/dev/sdd</tt>. This procedure should work even on a BIOS-booted computer.</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.</p>
 
 <li><b><a
-    href="http://sourceforge.net/projects/refind/files/0.4.7/refind-cd-0.4.7.zip/download">A
+    href="http://sourceforge.net/projects/refind/files/0.7.0/refind-cd-0.7.0.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
@@ -148,6 +204,31 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
     be an extremely valuable diagnostic tool if you know how to use an EFI
     shell.</li>
 
+<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>
+
+<li><b><a
+    href="http://sourceforge.net/projects/refind/files/0.7.0/refind-flashdrive-0.7.0.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.7.0/refind-src-0.7.0.zip/download">A
+    source code zip file</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>
+
 <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
@@ -171,32 +252,36 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 <ul>
 
 <li><b>Arch Linux</b>&mdash;You can obtain rEFInd from the Arch
-    repositories, in both <a
-    href="https://www.archlinux.org/packages/extra/any/refind-efi/">stable</a>
-    and <a
-    href="https://aur.archlinux.org/packages/refind-efi-tianocore-git/">git
-    (experimental)</a> releases. The git release is likely to include
+    repositories, in both a stable version (the <tt>refind-efi</tt> package
+    installable via <tt>pacman</tt>) and an experimental release built from
+    rEFInd's git repository in the Arch User Repository (AUR), under the
+    name <tt>refind-efi-git</tt>. The git release is likely to include
     pre-release bug fixes and new features, but those features may be
     poorly tested or undocumented. The last I checked, both builds used the
     Tianocore toolkit, and so support booting BIOS/legacy boot loaders on
     UEFI-based PCs.</li>
 
+<li><b>ALT Linux</b>&mdash;This RPM-based distribution is experimenting with
+    using rEFInd on EFI-based computers. As I write, the ALT developers haven't
+    yet nailed down booting from an optical disc (it's a tricky and delicate
+    task, especially when preparing a "hybrid" image), but they're working on
+    the problem. They have an RPM of rEFInd; see <a
+    href="http://packages.altlinux.org/en/Sisyphus/srpms/refind">this page</a>
+    for details.</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
+    provides a rEFInd package in its repository set.</li>
+
 <li><b>The <a href="http://nixos.org/nixpkgs/">Nix Packages
     collection</a></b>&mdash;This site creates packages for a number of
     OSes using its own packaging system.</li>
 
-<li><b><a
-    href="https://build.opensuse.org/package/show?package=refind&project=home%3Amichael-chang%3AUEFI">OpenSUSE
-    Build Service (OBS)</a></b>&mdash;This site holds a binary x86-64 build
-    of rEFInd that should install on any RPM-based distribution. It doesn't
-    completely set up rEFInd, though; it just places the rEFInd files in
-    the <tt>/usr/share/refind</tt> directory, and a copy of
-    <tt>install.sh</tt> as <tt>/usr/sbin/refind_install</tt>.
-    Unfortunately, the script makes assumptions about the locations of
-    files and so is useless when files are moved around in this way. Thus,
-    you'll need to install manually after installing this RPM, so you might
-    as well download the rEFInd binary <tt>.zip</tt> file from Sourceforge
-    instead.</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>
 
@@ -204,7 +289,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <hr />
 
-<p>copyright &copy; 2012 by Roderick W. Smith</p>
+<p>copyright &copy; 2012&ndash;2013 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>