From nobody Sun Mar 26 23:03:08 2023 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 4PlBLj0Fpcz41HtJ for ; Sun, 26 Mar 2023 23:03:09 +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 4PlBLh6xRmz4Q84; Sun, 26 Mar 2023 23:03:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679871789; 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=QqkNOrZiMvOdr0BhyMgdtx6iwEKXjBmmkBnPbzkKQ3A=; b=NOcUh47ju3lqoXfIRJqHzgQfKOCIOVFF36lU4tU3303qxW/2LERW6Q+7jSGMdUXe76e4Ms qeXYd19eEKKttxMQtV1nQYfbLmv5r37NauvJuqLawC4bfyKBO60+hWA8mGc2aefERJ98Uk z0vuPfPCkOabXYvLAWDK6x6VuPXXv2TcWBBuCwN7eXzDNirsXd5pSSHRi3fuhhwsz3AnBO zXSQKLwE4HwFXI5IA/BwwGAYhlNgr3imHDV0BjCrzngWEfWLWd9D6G2sjnLIGlkSJHT2pI lWmh1YS6W04+4BB3wsH51i5XxBf3XXMpBSI8UoTHL3EPpkqcSmpVxkRlXW3HMg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679871789; 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=QqkNOrZiMvOdr0BhyMgdtx6iwEKXjBmmkBnPbzkKQ3A=; b=qTZmZDPHz4HZXhsAbRfeqAYNRenR+5vgvbe/PTqjRxNyTuX1EesLiyOJyhisl4N751s2y5 JHYtDWio3d5LOSEfdhWzb2LHj1mqm3gYH+Zb+1nIWjDW6BWwxMipLDRQ0HpwqsoU1LcdId fekgYGw97wPIW3wnjEY5V4wcTvXy0KDptlP4CQ96SMwZi+nQLoFyjjvcY1hgpkLZDgt/4g nFhJW5TbMfsEH/7M3MJ5L8CM9nzHTHgLy+G7FbJYvx3Oa0fdocVJRjLOD+bShh2/WyummA OHQolj7BEtk76Piv5VcO8jrGVsJr3aHsP3Zn7MueUPW0ohF8Zkh5OFPcCcULaA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1679871789; a=rsa-sha256; cv=none; b=mcqRkPHgIH9512O++iUn1VrJuV/6dlbUMcfYGCF2kgQ8G2sMxTJHKwBMbJCUJqNfyNWls7 uE46YFfdorrOXaMTd+XMgZaDNC38nYp9SZi+QQmRLJJxkem9Z62gtotHaa89g7buL21xah Wxmm+2RRmY6dxW2HexObFP5PzqJ+HQwEfUpO6pxgKlMGwUJWmVNt0iKqgzAiYAXt0OoFvc bAWH8z9yEtumdukSRoeyW9zXw9tchZxH8Y6ojSy3tEGLTmro6wuiHVGU4ygsi2vvkp4fN2 KesD+4FGhswfy1Rp/fwYLvaKE4XG6fcrxJ39qz3SfaFB+XN8iDQGenCnkeUR0w== 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 4PlBLh5zcXzykw; Sun, 26 Mar 2023 23:03:08 +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 32QN38YP041588; Sun, 26 Mar 2023 23:03:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 32QN385e041587; Sun, 26 Mar 2023 23:03:08 GMT (envelope-from git) Date: Sun, 26 Mar 2023 23:03:08 GMT Message-Id: <202303262303.32QN385e041587@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 6148547a28 - main - handbook: Fix typos in ZFS arc legacy sysctl tunables 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: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6148547a289d0a901b832518ef7cb304b36c8ba1 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=6148547a289d0a901b832518ef7cb304b36c8ba1 commit 6148547a289d0a901b832518ef7cb304b36c8ba1 Author: Jerry Jacobs AuthorDate: 2022-11-28 17:43:57 +0000 Commit: Danilo G. Baio CommitDate: 2023-03-26 22:58:28 +0000 handbook: Fix typos in ZFS arc legacy sysctl tunables Reviewed by: dbaio Pull Request: https://github.com/freebsd/freebsd-doc/pull/98 --- documentation/content/en/books/handbook/zfs/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc index cdf1965dd6..378987e169 100644 --- a/documentation/content/en/books/handbook/zfs/_index.adoc +++ b/documentation/content/en/books/handbook/zfs/_index.adoc @@ -2618,9 +2618,9 @@ If a user has the `snapshot` permission and the `allow` permission, that user ca Adjust tunables to make ZFS perform best for different workloads. -* [[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` starting with 13.x (`_vfs.zfs.arc_max` for 12.x) - Upper size of the <>. The default is all RAM but 1 GB, or 5/8 of all RAM, whichever is more. Use a lower value if the system runs any other daemons or processes that may require memory. Adjust this value at runtime with man:sysctl[8] and set it in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` starting with 13.x (`_vfs.zfs.arc_meta_limit` for 12.x)` - Limit the amount of the <> used to store metadata. The default is one fourth of `vfs.zfs.arc.max`. Increasing this value will improve performance if the workload involves operations on a large number of files and directories, or frequent metadata operations, at the cost of less file data fitting in the <>. Adjust this value at runtime with man:sysctl[8] in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. -* [[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` starting with 13.x (`_vfs.zfs.arc_min` for 12.x) - Lower size of the <>. The default is one half of `vfs.zfs.arc.meta_limit`. Adjust this value to prevent other applications from pressuring out the entire <>. Adjust this value at runtime with man:sysctl[8] and in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. +* [[zfs-advanced-tuning-arc_max]] `_vfs.zfs.arc.max_` starting with 13.x (`vfs.zfs.arc_max` for 12.x) - Upper size of the <>. The default is all RAM but 1 GB, or 5/8 of all RAM, whichever is more. Use a lower value if the system runs any other daemons or processes that may require memory. Adjust this value at runtime with man:sysctl[8] and set it in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. +* [[zfs-advanced-tuning-arc_meta_limit]] `_vfs.zfs.arc.meta_limit_` starting with 13.x (`vfs.zfs.arc_meta_limit` for 12.x)` - Limit the amount of the <> used to store metadata. The default is one fourth of `vfs.zfs.arc.max`. Increasing this value will improve performance if the workload involves operations on a large number of files and directories, or frequent metadata operations, at the cost of less file data fitting in the <>. Adjust this value at runtime with man:sysctl[8] in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. +* [[zfs-advanced-tuning-arc_min]] `_vfs.zfs.arc.min_` starting with 13.x (`vfs.zfs.arc_min` for 12.x) - Lower size of the <>. The default is one half of `vfs.zfs.arc.meta_limit`. Adjust this value to prevent other applications from pressuring out the entire <>. Adjust this value at runtime with man:sysctl[8] and in [.filename]#/boot/loader.conf# or [.filename]#/etc/sysctl.conf#. * [[zfs-advanced-tuning-vdev-cache-size]] `_vfs.zfs.vdev.cache.size_` - A preallocated amount of memory reserved as a cache for each device in the pool. The total amount of memory used will be this value multiplied by the number of devices. Set this value at boot time and in [.filename]#/boot/loader.conf#. * [[zfs-advanced-tuning-min-auto-ashift]] `_vfs.zfs.min_auto_ashift_` - Lower `ashift` (sector size) used automatically at pool creation time. The value is a power of two. The default value of `9` represents `2^9 = 512`, a sector size of 512 bytes. To avoid _write amplification_ and get the best performance, set this value to the largest sector size used by a device in the pool. +