document the "opaque", "arch", and "nodump" flags more fully;

closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart

2 files changed, 34 insertions, 5 deletions

diff --git a/bin/chmod/chflags.1 b/bin/chmod/chflags.1
index 56c864ee37e..f4390b4a63d 100644
--- a/bin/chmod/chflags.1
+++ b/bin/chmod/chflags.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: chflags.1,v 1.7 2005/10/15 08:42:14 jmc Exp $
+.\"	$OpenBSD: chflags.1,v 1.8 2007/02/25 09:39:48 jmc Exp $
 .\"	$NetBSD: chflags.1,v 1.4 1995/08/31 22:50:22 jtc Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993, 1994
@@ -92,6 +92,24 @@ uappnd	set the user append-only flag (owner or superuser only)
 uchg	set the user immutable flag (owner or superuser only)
 .Ed
 .Pp
+The
+.Dq arch
+and
+.Dq opaque
+flags are for compatibility only,
+and currently have no effect.
+.Pp
+A file with the
+.Dq nodump
+flag set will by default only be backed up by
+.Xr dump 8
+during full backups.
+The
+.Fl h
+option of
+.Xr dump 8
+can be used to alter this.
+.Pp
 An immutable file may not be changed, moved, or deleted.
 An append-only file is immutable except that data may be appended to it.
 .Pp
@@ -148,7 +166,8 @@ utility exits 0 on success or >0 if an error occurred.
 .Xr stat 2 ,
 .Xr fts 3 ,
 .Xr securelevel 7 ,
-.Xr symlink 7
+.Xr symlink 7 ,
+.Xr dump 8
 .Sh HISTORY
 The
 .Nm
diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8
index f48a5148eaf..fb59274cfc8 100644
--- a/sbin/dump/dump.8
+++ b/sbin/dump/dump.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: dump.8,v 1.36 2007/02/22 09:40:11 jmc Exp $
+.\"	$OpenBSD: dump.8,v 1.37 2007/02/25 09:39:48 jmc Exp $
 .\"	$NetBSD: dump.8,v 1.17 1997/06/05 11:15:06 lukem Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -71,6 +71,16 @@ This can be enforced by using the
 .Fl a
 option.
 .Pp
+Files can be marked with the
+.Dq nodump
+flag using
+.Xr chflags 1 ,
+settable only by the file's owner or the superuser.
+Files with this flag set will only be dumped during full backups.
+See also the
+.Fl h
+option, below.
+.Pp
 .Nm
 works across networks,
 replacing the functionality of the old
@@ -192,8 +202,7 @@ writes to the named file on the remote host using
 .It Fl h Ar level
 Honor the user
 .Dq nodump
-flag
-.Dp Dv UF_NODUMP
+flag (see above),
 only for dumps at or above the given
 .Ar level .
 The default honor level is 1,
@@ -405,6 +414,7 @@ exits with zero status on success.
 Startup errors are indicated with an exit code of 1;
 abnormal termination is indicated with an exit code of 3.
 .Sh SEE ALSO
+.Xr chflags 1 ,
 .Xr stty 1 ,
 .Xr fts 3 ,
 .Xr rcmd 3 ,