From 2276e5640c7176fd82731010a098e6a880fa45af Mon Sep 17 00:00:00 2001 From: Benedict Reuschling Date: Sun, 8 Dec 2019 14:21:38 +0000 Subject: [PATCH] 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 --- en_US.ISO8859-1/books/handbook/zfs/chapter.xml | 12 ++++++++++++ 1 file changed, 12 insertions(+) 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" a partition rather than the entire disk. This differs from recommendations made by the Solaris documentation. + + + 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 + RAID-Z 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. +