svn commit: r53667 - head/en_US.ISO8859-1/books/handbook/zfs

[Benedict Reuschling]

Author: bcr
Date: Sun Dec  8 14:21:38 2019
New Revision: 53667
URL: https://svnweb.freebsd.org/changeset/doc/53667

Log:
  Add a caution against using whole disks for
  zpools that are used for booting, mirrors,
  and RAIDZ.
  
  PR:		241956
  Submitted by:	pauamma at gundo.com
  Approved by:	tsoome@
  Differential Revision:	https://reviews.freebsd.org/D22663

Modified:
  head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml	Sun Dec  8 10:32:49 2019	(r53666)
+++ head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml	Sun Dec  8 14:21:38 2019	(r53667)
@@ -3553,6 +3553,18 @@ vfs.zfs.vdev.cache.size="5M"</programlisting>
 		    a partition rather than the entire disk.  This
 		    differs from recommendations made by the Solaris
 		    documentation.</para>
+
+		  <caution>
+		    <para>Using an entire disk as part of a bootable
+		      pool is strongly discouraged, as this may render
+		      the pool unbootable.  Likewise, you should not
+		      use an entire disk as part of a mirror or
+		      <acronym>RAID-Z</acronym> vdev.  These are
+		      because it it impossible to reliably determine
+		      the size of an unpartitioned disk at boot time
+		      and because there's no place to put in boot
+		      code.</para>
+                  </caution>
 		</listitem>
 
 		<listitem>