summaryrefslogtreecommitdiffstats
path: root/usr.sbin
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-07-17 10:59:38 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-07-17 10:59:38 +0000
commit6352ad1f94aac2b5807b28fbf6030ddddac6b574 (patch)
tree11430c110c1d56001b4cef6fca0f7716c1848708 /usr.sbin
parent98a35e882351638d9d0273998f93c1cf564a724a (diff)
downloadFreeBSD-src-6352ad1f94aac2b5807b28fbf6030ddddac6b574.zip
FreeBSD-src-6352ad1f94aac2b5807b28fbf6030ddddac6b574.tar.gz
* Order options in the SYNOPSIS correctly.
* Re-order the list of options in teh DESCRIPTION as per the SYNOPSIS. * Move the description of exit conditions from the DESCRIPTION section to a new DIAGNOSTICS section. * Typo fix: "effect" -> "affect" when used as a verb. * Clear the Nm macro as appropriate. * Typo fix: "consider" -> "considers" for a singular subject. * Use Nx instead of NetBSD.
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/mtree/mtree.874
1 files changed, 39 insertions, 35 deletions
diff --git a/usr.sbin/mtree/mtree.8 b/usr.sbin/mtree/mtree.8
index bca96f2..b3ecffc 100644
--- a/usr.sbin/mtree/mtree.8
+++ b/usr.sbin/mtree/mtree.8
@@ -40,7 +40,7 @@
.Nd map a directory hierarchy
.Sh SYNOPSIS
.Nm mtree
-.Op Fl cdeiLnrUux
+.Op Fl LUcdeinrux
.Bk -words
.Op Fl f Ar spec
.Ek
@@ -70,6 +70,16 @@ missing from either the file hierarchy or the specification.
.Pp
The options are as follows:
.Bl -tag -width flag
+.It Fl L
+Follow all symbolic links in the file hierarchy (by default
+.Nm
+considers the symbolic link itself).
+.It Fl U
+Modify the owner, group and permissions of existing files to match
+the specification and create any missing directories or symbolic links.
+User, group and permissions must all be specified for missing directories
+to be created.
+Corrected mismatches are not considered errors.
.It Fl c
Print a specification for the file hierarchy to the standard output.
.It Fl d
@@ -77,18 +87,34 @@ Ignore everything except directory type files.
.It Fl e
Don't complain about files that are in the file hierarchy, but not in the
specification.
-.It Fl f Ar file
-Read the specification from
-.Ar file ,
-instead of from the standard input.
.It Fl i
Indent the output 4 spaces each time a directory level is descended when
create a specification with the
.Fl c
option.
-This does not effect either the /set statements or the comment before each
+This does not affect either the /set statements or the comment before each
directory.
-It does however effect the comment before the close of each directory.
+It does however affect the comment before the close of each directory.
+.It Fl n
+Do not emit pathname comments when creating a specification. Normally
+a comment is emitted before each directory and before the close of that
+directory when using the
+.Fl c
+option.
+.It Fl r
+Remove any files in the file hierarchy that are not described in the
+specification.
+.It Fl u
+Same as
+.Fl U
+except a status of 2 is returned if the file hierarchy did not match
+the specification.
+.It Fl x
+Don't descend below mount points in the file hierarchy.
+.It Fl f Ar file
+Read the specification from
+.Ar file ,
+instead of from the standard input.
.It Fl K Ar keywords
Add the specified (whitespace or comma separated)
.Ar keywords
@@ -97,43 +123,16 @@ to the current set of keywords.
Use the ``type'' keyword plus the specified (whitespace or comma separated)
.Ar keywords
instead of the current set of keywords.
-.It Fl L
-Follow all symbolic links in the file hierarchy (by default
-.Nm mtree
-consider the symbolic link itself).
-.It Fl n
-Do not emit pathname comments when creating a specification. Normally
-a comment is emitted before each directory and before the close of that
-directory when using the
-.Fl c
-option.
.It Fl p Ar path
Use the file hierarchy rooted in
.Ar path ,
instead of the current directory.
-.It Fl r
-Remove any files in the file hierarchy that are not described in the
-specification.
.It Fl s Ar seed
Display a single checksum to the standard error output that represents all
of the files for which the keyword
.Cm cksum
was specified.
The checksum is seeded with the specified value.
-.It Fl U
-Modify the owner, group, and permissions of existing files to match
-the specification and create any missing directories or symbolic links.
-User, group, and permissions must all be specified for missing directories
-to be created.
-Exit with a status of 0 on success, 1 if any error occurred;
-a mismatch is not considered an error if it was corrected.
-.It Fl u
-Same as
-.Fl U
-except a status of 2 is returned if the file hierarchy did not match
-the specification.
-.It Fl x
-Don't descend below mount points in the file hierarchy.
.It Fl X Ar exclude-list
The specified file contains
.Xr fnmatch 3
@@ -318,6 +317,10 @@ distribution.
.It Pa /etc/mtree
system specification directory
.El
+.Sh DIAGNOSTICS
+The
+.Nm
+utility exits 0 on success, and >0 if an error occurs.
.Sh SEE ALSO
.Xr chflags 1 ,
.Xr chgrp 1 ,
@@ -349,4 +352,5 @@ as new attacks have demonstrated weaknesses in
.Tn MD5 .
Support for file flags was added in
.Fx 4.0 ,
-and mostly comes from NetBSD.
+and mostly comes from
+.Nx .
OpenPOWER on IntegriCloud