From owner-freebsd-doc@FreeBSD.ORG Fri Feb 13 02:00:08 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4F5A0106567D for ; Fri, 13 Feb 2009 02:00:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0FFC48FC24 for ; Fri, 13 Feb 2009 02:00:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n1D207g6049201 for ; Fri, 13 Feb 2009 02:00:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n1D207Oc049200; Fri, 13 Feb 2009 02:00:07 GMT (envelope-from gnats) Resent-Date: Fri, 13 Feb 2009 02:00:07 GMT Resent-Message-Id: <200902130200.n1D207Oc049200@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Andrew Wright Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C75AB10658AE for ; Fri, 13 Feb 2009 01:53:45 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id B4D0C8FC1F for ; Fri, 13 Feb 2009 01:53:45 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n1D1rjiC032274 for ; Fri, 13 Feb 2009 01:53:45 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n1D1rjea032267; Fri, 13 Feb 2009 01:53:45 GMT (envelope-from nobody) Message-Id: <200902130153.n1D1rjea032267@www.freebsd.org> Date: Fri, 13 Feb 2009 01:53:45 GMT From: Andrew Wright To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/131626: dump(8) "recommended" cache option confusing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2009 02:00:09 -0000 >Number: 131626 >Category: docs >Synopsis: dump(8) "recommended" cache option confusing >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Feb 13 02:00:07 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Andrew Wright >Release: 7.1 >Organization: Mount Allison University >Environment: FreeBSD qemg.org 7.1-RELEASE-p1 FreeBSD 7.1-RELEASE-p1 #9: Tue Jan 13 21:17:15 AST 2009 root@qemg.org:/usr/obj/usr/src/sys/GENERIC amd64 >Description: The description of the "recommended" use of cache and snapshots in dump(8) is somewhat confusing, as the reason for the recommendation is left unclear. >How-To-Repeat: See docs for dump(8) option "C" -> cache size. >Fix: Doc update, patch attached. Patch attached with submission follows: --- dump.8 2009-01-09 13:07:26.000000000 -0400 +++ /tmp/dump.8 2009-02-12 21:52:03.000000000 -0400 @@ -136,9 +136,11 @@ 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 >Release-Note: >Audit-Trail: >Unformatted: