diff options
-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 . |