Date: 14 Jan 2002 18:34:11 -0800 From: "Gary W. Swearingen" <swear@blarg.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/33907: dump(8) man page is misleading in nodump paragraph Message-ID: <jwofjwuyu4.fjw@localhost.localdomain>
next in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?jwofjwuyu4.fjw>