mirror of
https://git.FreeBSD.org/src.git
synced 2025-01-11 14:10:34 +00:00
* 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.
This commit is contained in:
parent
ed9b87e322
commit
7cd36f5d04
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=63304
@ -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 .
|
||||
|
Loading…
Reference in New Issue
Block a user