]> code.delx.au - refind/blobdiff - docs/refind/drivers.html
Version 0.10.2 release.
[refind] / docs / refind / drivers.html
index 5b24292a19b3a4651a142dcac9733f05cff6b0d3..8869ca0c37643e19c47696c203ec02cce6179335 100644 (file)
@@ -17,7 +17,7 @@
 href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <p>Originally written: 4/19/2012; last Web page update:
-12/12/2015, referencing rEFInd 0.10.1</p>
+1/26/2016, referencing rEFInd 0.10.2</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>
@@ -185,19 +185,10 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
 
 <ul>
 
-<li><b>ReiserFS</b>&mdash;This driver originated with rEFIt. It's useful
+<li><b>Ext2fs</b>&mdash;This driver originated with rEFIt. It's useful
     for reading Linux kernels from a separate <tt>/boot</tt> partition, or
-    even from a root (<tt>/</tt>) filesystem, if you use ReiserFS on it.
-    <b>Caution:</b> If you use this driver, you should use the
-    <tt>notail</tt> option in Linux's <tt>/etc/fstab</tt> file for the
-    partition(s) you want the EFI to read. This is because the driver
-    doesn't properly handle ReiserFS's "tail-packing" feature, so files can
-    seem to be corrupted in EFI if you use this feature, which is disabled
-    by <tt>notail</tt>.</li>
-
-<li><b>Ext2fs</b>&mdash;This driver also originated with rEFIt. It can be
-    used in the same way as the ReiserFS driver. Although it's called an
-    "ext2fs" driver, it also works with ext3fs.</li>
+    even from a root (<tt>/</tt>) filesystem, if you use ext2fs on it.
+    Although it's called an "ext2fs" driver, it also works with ext3fs.</li>
 
 <li><b>Ext4fs</b>&mdash;Stefan Agner <a
     href="https://github.com/falstaff84/rEFInd">modified the rEFIt/rEFInd
@@ -217,27 +208,34 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
     changing <tt class="userinput"><i>/dev/sda2</i></tt> to your
     filesystem's device.</li>
 
+<li><b>ReiserFS</b>&mdash;This driver originated with rEFIt. It can be used
+    in the same way as the ext2fs and ext4fs drivers. <b>Caution:</b> If you
+    use this driver, you should use the <tt>notail</tt> option in Linux's
+    <tt>/etc/fstab</tt> file for the partition(s) you want the EFI to read.
+    This is because the driver doesn't properly handle ReiserFS's
+    "tail-packing" feature, so files can seem to be corrupted in EFI if you
+    use this feature, which is disabled by <tt>notail</tt>.</li>
+
 <li><b>Btrfs</b>&mdash;</b>Samuel Liao contributed this driver, which is
     based on the rEFIt/rEFInd driver framework and algorithms from the GRUB
-    2.0 Btrfs driver. I've tested this driver with a simple one-partition
-    filesystem and with a filesystem that spans two physical devices
-    (although I've made no attempt to ensure that the driver can actually
-    read files written to both devices). Samuel Liao has used the driver
-    with a compressed Btrfs volume. The driver will handle subvolumes, but
-    you may need to add kernel options if you're booting a Linux kernel
-    directly from a filesystem that uses subvolumes. For instance, on a
-    test installation of Ubuntu 14.04 alpha on such a system, I needed to
-    set <tt>also_scan_dirs + @/boot</tt> in <tt>refind.conf</tt> and add
-    <tt>rootflags=subvol=@</tt> to the kernel options in my
-    <tt>refind_linux.conf</tt> file. Without the first of these options,
-    rEFInd could not locate my kernel; and without the second, the boot
-    failed with a message to the effect that the initial RAM disk could not
-    find <tt>/sbin/init</tt>. rEFInd 0.10.0 adds <tt>@/boot</tt> as a
-    standard option to <tt>also_scan_dirs</tt>, and its
-    <tt>refind-install</tt> and <tt>mkrlconf</tt> scripts should pick up
-    the root flags, assuming the system is booted into the regular
-    installation. These additions make it easier to set up rEFInd to work
-    with Btrfs.</li>
+    2.0 Btrfs driver. I've tested this driver with simple one-partition
+    filesystems on several installations, and with a filesystem that spans
+    two physical devices on one (although I've made no attempt to ensure
+    that the driver can actually read files written to both devices). Samuel
+    Liao has used the driver with a compressed Btrfs volume. The driver will
+    handle subvolumes, but you may need to add kernel options if you're
+    booting a Linux kernel directly from a filesystem that uses subvolumes.
+    For instance, when booting Ubuntu from Btrfs, <tt>also_scan_dirs +
+    @/boot</tt> must be set in <tt>refind.conf</tt> and
+    <tt>rootflags=subvol=@</tt> must be added to the kernel options in
+    <tt>refind_linux.conf</tt>. Without the first of these options, rEFInd
+    can not locate the kernel; and without the second, the boot fails with a
+    message to the effect that the initial RAM disk could not find
+    <tt>/sbin/init</tt>. rEFInd 0.10.0 adds <tt>@/boot</tt> as a standard
+    option to <tt>also_scan_dirs</tt>, and its <tt>refind-install</tt> and
+    <tt>mkrlconf</tt> scripts should pick up the root flags, assuming the
+    system is booted into the regular installation. These additions make it
+    easier to set up rEFInd to work with Btrfs.</li>
 
 <li><b>ISO-9660</b>&mdash;This driver originated with rEFIt's author, but
     he never released a final version. Its code was improved by Oracle for
@@ -264,7 +262,7 @@ href="mailto:rodsmith@rodsbooks.com">rodsmith@rodsbooks.com</a></p>
     providing the driver mainly because it compiled cleanly with no extra
     work, aside from providing a Makefile entry for it.</li>
 
-<p class="sidebar"><b>Warning:</b> I've received multiple reports of system hangs when using the NTFS driver; however, I've been unable to replicate the problem. (The problem is probably triggered either by interactions with specific EFIs or by unique features of the "problem" NTFS volumes.) I therefore recommend avoiding it unless it's absolutely necessary. I've added a couple of checks to the driver code in rEFInd 0.9.1 that <i>may</i> fix this problem, but these checks may also have no effect.</p>
+<p class="sidebar"><b>Warning:</b> I've received multiple reports of system hangs when using the NTFS driver; however, I've been unable to replicate the problem. (The problem is probably triggered either by interactions with specific EFIs or by unique features of the "problem" NTFS volumes.) I therefore recommend avoiding the NTFS driver unless it's absolutely necessary. I've added a couple of checks to the driver code in rEFInd 0.9.1 that <i>may</i> fix this problem, but these checks may also have no effect.</p>
 
 <li><b>NTFS</b>&mdash;Samuel Liao contributed this driver, which uses the
     rEFIt/rEFInd driver framework. Note that this driver is
@@ -377,7 +375,7 @@ ways.</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>