From owner-freebsd-bugs  Thu Oct 16 17:40:04 1997
Return-Path: <owner-freebsd-bugs>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id RAA05877
          for bugs-outgoing; Thu, 16 Oct 1997 17:40:04 -0700 (PDT)
          (envelope-from owner-freebsd-bugs)
Received: (from gnats@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id RAA05853;
          Thu, 16 Oct 1997 17:40:02 -0700 (PDT)
          (envelope-from gnats)
Resent-Date: Thu, 16 Oct 1997 17:40:02 -0700 (PDT)
Resent-Message-Id: <199710170040.RAA05853@hub.freebsd.org>
Resent-From: gnats (GNATS Management)
Resent-To: freebsd-bugs
Resent-Reply-To: FreeBSD-gnats@FreeBSD.ORG, dillon@backplane.com
Received: from apollo.backplane.com (dillon@apollo.backplane.com [207.33.240.2])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id RAA05254
          for <FreeBSD-gnats-submit@freebsd.org>; Thu, 16 Oct 1997 17:31:11 -0700 (PDT)
          (envelope-from dillon@backplane.com)
Received: (dillon@localhost) by apollo.backplane.com (8.8.5/8.6.5) id RAA01804; Thu, 16 Oct 1997 17:31:08 -0700 (PDT)
Message-Id: <199710170031.RAA01804@apollo.backplane.com>
Date: Thu, 16 Oct 1997 17:31:08 -0700 (PDT)
From: Matthew Dillon <dillon@backplane.com>
Reply-To: dillon@backplane.com
To: FreeBSD-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: 3.2
Subject: docs/4785: manual page for dump incorrect
Sender: owner-freebsd-bugs@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk


>Number:         4785
>Category:       docs
>Synopsis:       incorrect explanaion in manual page for dump
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 16 17:40:01 PDT 1997
>Last-Modified:
>Originator:     Matthew Dillon
>Organization:
Best Internet
>Release:        FreeBSD 2.2-STABLE i386
>Environment:


>Description:

	The manual page for dump, for the 0-9 options, specifies:

     -0-9    Dump levels.  A level 0, full backup, guarantees the entire file
             system is copied (but see also the -h option below).  A level
             number above 0, incremental backup, tells dump to copy all files
             new or modified since the last dump of the same or lower level.
             The default level is 9.

	It says "last dump of the SAME or lower level".   As best as I can
	determine, dump's actual mechanism is to copy all files new or
	modified since the last dump of a lower level.  Not the same level.

>How-To-Repeat:

	dump 0ubf 64 - / > /dev/null
	dd if=/dev/zero of=/xxx bs=32k count=10		(create big file)
	dump 1ubf 64 - / > /dev/null
	dump 1ubf 64 - / > /dev/null
	dump 1ubf 64 - / > /dev/null
	...

	note that the second and third level 1 dumps are the same size as
	the first level 1 dump.

>Fix:
	
	The documentation needs to be fixed.  I don't think the program is
	broken.

>Audit-Trail:
>Unformatted: