aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook
diff options
context:
space:
mode:
authorBenedict Reuschling <bcr@FreeBSD.org>2019-12-08 14:21:38 +0000
committerBenedict Reuschling <bcr@FreeBSD.org>2019-12-08 14:21:38 +0000
commit2276e5640c7176fd82731010a098e6a880fa45af (patch)
treec43301f56515ee2dbbbd0c0cf9435c338254dc1d /en_US.ISO8859-1/books/handbook
parent796979955478285e5d47eab068ff2563e939ac9e (diff)
downloaddoc-2276e5640c7176fd82731010a098e6a880fa45af.tar.gz
doc-2276e5640c7176fd82731010a098e6a880fa45af.zip
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
Notes
Notes: svn path=/head/; revision=53667
Diffstat (limited to 'en_US.ISO8859-1/books/handbook')
-rw-r--r--en_US.ISO8859-1/books/handbook/zfs/chapter.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
index 2bc394bba6..b9ff8cd61c 100644
--- a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -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>