From nobody Sun Nov 06 20:26:20 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4N55VP0G4Bz4h2xp for ; Sun, 6 Nov 2022 20:26:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4N55VN6wwyz47nc; Sun, 6 Nov 2022 20:26:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667766381; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=e0NDZ4o7wyH6bIulU+1WegLLvw8TyJKB3205Yuhnikw=; b=FM/eDLxRZgBWil+WpzfPd4zk9yHWt11Om0YAW2IBDqY7vUNgLl73zEAzIj/oE8ffq2Ioli mYFokqldlA3udm2LY2ViUEcddc5DRSlUtZfj19wamqZ0c4SsxDZVBpGsvHUxUX0GNTBL1Z CjchemHVmg1sUDOkgIATHQK9YqcdshKOKnUdD4Jk2I165jv5bu6q5wg34wMtVJdqLpfKAN u8sZ61TDK3XebyTLH5YnZdUzCI9VcAesY5VP35+gY1+2K4eeBYBfGDMkrCWR/gFPA/VLXA EO1jyyl1GMBGLkJJ5QywmvQyFC3qdeBWRCwkBTIHeACLDIaDUAbE9Kr69K/6yA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4N55VN5zxrzZlM; Sun, 6 Nov 2022 20:26:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2A6KQKIp094713; Sun, 6 Nov 2022 20:26:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2A6KQKcp094712; Sun, 6 Nov 2022 20:26:20 GMT (envelope-from git) Date: Sun, 6 Nov 2022 20:26:20 GMT Message-Id: <202211062026.2A6KQKcp094712@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 1fb34fa053 - main - Fix misuse of the phrase zpool in ZFS chapter handbook List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1fb34fa0530a7cd0554371f0b5c0b6bdf8a9507d Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667766381; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=e0NDZ4o7wyH6bIulU+1WegLLvw8TyJKB3205Yuhnikw=; b=glLtTrZHs6WoHsaEP8PGgVny6GURmqEHz7Abaa341rfWaUJX4jhJAkPRtxYBzHL/AogtYD 6eHVjAvFN10CzCHbvmaFMY61tWBg5vdJ4Us4sRJ+BmUH3S9H8eUFxF3rzGjwBtMt90wvn1 ij8UOElk6bC3lj01Hs6TIMDW0/jDY+buQW5RGoZEfUHxEUqVxtwALs5oJJfqCy0Lcvzi6J iZbCwFYHVrZ3jMrSGQgyDb95hgas25J7F4VoJU1sCx3fopG08aEyylnIlJ0lo1NZYUHc0H hsHUVTp3MJ8Z2/fp3g1U0EQZdRNCwtCnTJMIR2BzJPwg3B9EQKMDtnO/+eBfrA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1667766381; a=rsa-sha256; cv=none; b=cj3NcGhakRkS9NGqGx+gZOk5WxAJsF2IZzC5W3U5oed2tLbgqqRAaF2vmHBABqPdvUw5vw Wq7FjX/2PIx70jGCfiuOklsep9w8ma1Qem8t6lnfzJp8GNkV2JOkW4tXj5oFw6bS8Y49Y1 epO+cPfBFtP0G7uMgNOJ1Y+La4cJnGvDnB6xExlqDVQPNZQj5SA+i+ffNN/wSOg8lX8MGA 3+ZokO5HFOB1ncs33/BSvvFj1SnUlBOyS7JQhS6zXTHLWWjHVwwHM2qJ3k9yI5OtpC0jUq kAsX2VDD0wBPw3QvCDFKc9UdrgCk4B4RkDvdmkQtB2MZNtWmfmcjPnOULX2K9Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=1fb34fa0530a7cd0554371f0b5c0b6bdf8a9507d commit 1fb34fa0530a7cd0554371f0b5c0b6bdf8a9507d Author: John Darrah AuthorDate: 2022-11-06 20:25:07 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2022-11-06 20:25:07 +0000 Fix misuse of the phrase zpool in ZFS chapter handbook PR: 257405 Reviewed by: grahamperrin@, pauamma@ --- documentation/content/en/books/handbook/zfs/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc index 9720122a84..397f592208 100644 --- a/documentation/content/en/books/handbook/zfs/_index.adoc +++ b/documentation/content/en/books/handbook/zfs/_index.adoc @@ -489,7 +489,7 @@ The <> utility allows creating, destroying, and managing datasets [[zfs-zpool-create]] === Creating and Destroying Storage Pools -Creating a ZFS storage pool (_zpool_) requires permanent decisions, as the pool structure cannot change after creation. +Creating a ZFS storage pool requires permanent decisions, as the pool structure cannot change after creation. The most important decision is which types of vdevs to group the physical disks into. See the list of <> for details about the possible options. After creating the pool, most vdev types do not allow adding disks to the vdev. @@ -581,7 +581,7 @@ This can cause undefined behavior in applications which had open files on those [[zfs-zpool-attach]] === Adding and Removing Devices -Two ways exist for adding disks to a zpool: attaching a disk to an existing vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`. +Two ways exist for adding disks to a pool: attaching a disk to an existing vdev with `zpool attach`, or adding vdevs to the pool with `zpool add`. Some <> allow adding disks to the vdev after creation. A pool created with a single disk lacks redundancy.