svn commit: r43152 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs

[Benedict Reuschling]

Author: bcr
Date: Sun Nov 10 18:37:20 2013
New Revision: 43152
URL: http://svnweb.freebsd.org/changeset/doc/43152

Log:
  Provide a big fat warning message for those people who think disabling
  checksums on a ZFS pool is a good idea.

Modified:
  projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml

Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
==============================================================================
--- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml	Sun Nov 10 14:44:46 2013	(r43151)
+++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml	Sun Nov 10 18:37:20 2013	(r43152)
@@ -459,12 +459,17 @@ errors: No known data errors</screen>
 
       <screen>&prompt.root; <userinput>zfs set checksum=off storage/home</userinput></screen>
 
-      <para>Doing so is <emphasis>not</emphasis> recommended.
-	Checksums take very little storage space and provide
-	data integrity.  Checksum verification is
-	known as <quote>scrubbing</quote>.  Verify the data
-	integrity of the <literal>storage</literal> pool, with this
-	command:</para>
+      <warning>
+	<para>Doing so is <emphasis>not</emphasis> recommended!
+	  Checksums take very little storage space and provide data
+	  integrity.  Many ZFS features will not work properly with
+	  checksums disabled.  There is also no noticeable performance
+	  gain from disabling these checksums.</para>
+      </warning>
+	
+      <para>Checksum verification is known as <quote>scrubbing</quote>.
+	Verify the data integrity of the <literal>storage</literal>
+	pool, with this command:</para>
 
       <screen>&prompt.root; <userinput>zpool scrub storage</userinput></screen>