Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 9 Jan 2021 01:29:39 GMT
From:      Guangyuan Yang <ygy@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 91006937a3b9 - stable/12 - dump(8): clarify the recommended use of cache and snapshots
Message-ID:  <202101090129.1091TdoF087943@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/12 has been updated by ygy (doc committer):

URL: https://cgit.FreeBSD.org/src/commit/?id=91006937a3b9535476a9291dbc816ccb2883ccde

commit 91006937a3b9535476a9291dbc816ccb2883ccde
Author:     Guangyuan Yang <ygy@FreeBSD.org>
AuthorDate: 2020-12-28 21:54:36 +0000
Commit:     Guangyuan Yang <ygy@FreeBSD.org>
CommitDate: 2021-01-09 01:29:12 +0000

    dump(8): clarify the recommended use of cache and snapshots
    
    PR:             131626
    Submitted by:   Andrew Hamilton-Wright <andrew@qemg.org>
    Reviewed by:    bcr
    Differential Revision:  https://reviews.freebsd.org/D27775
    
    (cherry picked from commit 70a2e109bd486f97e6fa5f969be9d90e404de016)
---
 sbin/dump/dump.8 | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8
index 56aea04551f8..80e8eae21d19 100644
--- a/sbin/dump/dump.8
+++ b/sbin/dump/dump.8
@@ -29,7 +29,7 @@
 .\"     @(#)dump.8	8.3 (Berkeley) 5/1/95
 .\" $FreeBSD$
 .\"
-.Dd June 13, 2019
+.Dd December 28, 2020
 .Dt DUMP 8
 .Os
 .Sh NAME
@@ -134,9 +134,11 @@ Specify the cache size in megabytes.
 This will greatly improve performance
 at the cost of
 .Nm
-possibly not noticing changes in the file system between passes.
-It is
-recommended that you always use this option when dumping a snapshot.
+possibly not noticing changes in the file system between passes
+unless a snapshot is being used.
+The potential for performance improvement indicates that
+use of this option together with snapshots is the recommended
+course of action.
 Beware that
 .Nm
 forks, and the actual memory use may be larger than the specified cache



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