Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 8 Dec 2019 14:21:39 +0000 (UTC)
From:      Benedict Reuschling <bcr@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r53667 - head/en_US.ISO8859-1/books/handbook/zfs
Message-ID:  <201912081421.xB8ELdwV068099@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
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@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>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201912081421.xB8ELdwV068099>