From owner-freebsd-doc Mon Jan 14 18:40:15 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id E66E237B41C for ; Mon, 14 Jan 2002 18:40:00 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0F2e0J27196; Mon, 14 Jan 2002 18:40:00 -0800 (PST) (envelope-from gnats) Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id 157A237B405 for ; Mon, 14 Jan 2002 18:31:28 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id BF5C5BCFF for ; Mon, 14 Jan 2002 18:31:27 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id SAA32581 for ; Mon, 14 Jan 2002 18:31:27 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id g0F2YBb04988; Mon, 14 Jan 2002 18:34:11 -0800 (PST) (envelope-from swear@blarg.net) Message-Id: Date: 14 Jan 2002 18:34:11 -0800 From: "Gary W. Swearingen" Reply-To: swear@blarg.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/33907: dump(8) man page is misleading in nodump paragraph Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 33907 >Category: docs >Synopsis: dump(8) man page is misleading in nodump paragraph >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: Mon Jan 14 18:40:00 PST 2002 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.5-PRERELEASE i386 >Organization: none >Environment: n/a ================ >Description: The paragraph of the dump(8) man page which discusses the "nodump" file flag is only true with certain values of dump level and the -h option which the paragraph doesn't mention. The lack of -h mention makes the paragraph strictly untrue and will mislead those who have forgotten or not noticed the -h option. (I say from personal experience which would have cost me much wasted "chflags"ing, save a lucky -questions thread.) Also: The man page doesn't have "chflags(1)" in "SEE ALSO" which may be used to change the "nodump" flag and which references "chflags(2)" which discusses the "UF_NODUMP" constant mentioned in the dump(8) man page. ================ >How-To-Repeat: n/a ================ >Fix: Note: Maybe "chflags(2)" should also be in SEE ALSO; I omitted it. patch -d "unknown uncompressed man directory" < this-PR --- /tmp/dump..orig.8 Mon Jan 14 17:03:21 2002 +++ /tmp/dump.8 Mon Jan 14 17:49:46 2002 @@ -264,21 +264,12 @@ Is like W, but prints only those filesystems which need to be dumped. .El .Pp -.Nm Dump -honors the user +Directories and regular files which have their .Dq nodump flag .Pq Dv UF_NODUMP -on regular files and directories. -If a directory is marked -.Dq nodump , -the latter and all files and directories under it will not be backed -up. -That is, -.Nm -propagates the -.Dq nodump -flag on directories. +set will be omitted along with everything under such directories, +all subject to the -h option. .Pp .Nm Dump requires operator intervention on these conditions: @@ -386,6 +377,7 @@ .Em operator .El .Sh SEE ALSO +.Xr chflags 1 , .Xr fstab 5 , .Xr restore 8 , .Xr rmt 8 >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message