diff options
author | sheldonh <sheldonh@FreeBSD.org> | 2000-07-17 10:59:38 +0000 |
---|---|---|
committer | sheldonh <sheldonh@FreeBSD.org> | 2000-07-17 10:59:38 +0000 |
commit | 6352ad1f94aac2b5807b28fbf6030ddddac6b574 (patch) | |
tree | 11430c110c1d56001b4cef6fca0f7716c1848708 /usr.sbin | |
parent | 98a35e882351638d9d0273998f93c1cf564a724a (diff) | |
download | FreeBSD-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.8 | 74 |
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 . |