converted dchmod markdown to man page
-.\" Automatically generated by Pandoc 1.17.1
+.\" Automatically generated by Pandoc 1.19.1
.\"
.TH "DCHMOD" "1" "" "" ""
.hy
+.SH NAME
.PP
-NAME
+dchmod \- distributed chmod program
+.SH SYNOPSIS
.PP
-dchmod \- distributed change mode program
+\f[B]dchmod [OPTION] PATH...\f[]
+.SH DESCRIPTION
.PP
-SYNOPSIS
+Parallel MPI application to recurseively walk, and then change
+permissions starting from the top level directory.
.PP
-dchmod ...
+dchmod prrovides functionality similar to chmod.
+Like chmod, the tool supports the use of octal or symbolic mode to
+change the permissions.
+But unlinke chmod, there is no need to use a recursive option, as the
+permissions will be updated from the top level directory all the way to
+the bottom of the tree by default.
+.SH OPTIONS
+.TP
+.B \-g, \-\-group
+Change group to specified group name.
+.RS
+.RE
+.TP
+.B \-m, \-\-mode
+The mode that you want the file or directory to be.
+.RS
+.RE
+.TP
+.B \-e, \-\-exclude
+Exclude a set of files from command given a regular expression.
+.RS
+.RE
+.TP
+.B \-m, \-\-match
+Match a set of files from command given a regular expression.
+.RS
+.RE
+.TP
+.B \-n, \-\-name
+Match or exclude the regular expression based only on file name, and not
+the full path.
+Should be used in combination with the match and/or exclude options if
+you don not want to match/exclude the full path name, but just the file
+name.
+.RS
+.RE
+.TP
+.B \-h, \-\-help
+Print the command usage, and the list of options available.
+.RS
+.RE
+.TP
+.B \-v, \-\-verbose
+Prints a list of statistics/timing data for the command.
+How many files walked, how many levels there are in the tree, and how
+many files the command operated on.
+This option also prints the files/sec for each of those.
+.RS
+.RE
+.SS Known bugs
.PP
-DESCRIPTION
+N/A
+.SH SEE ALSO
.PP
-OPTIONS
+\f[C]dcmp\f[] (1).
+\f[C]dcp\f[] (1).
+\f[C]dfilemaker\f[] (1).
+\f[C]dfind\f[] (1).
+\f[C]dgrep\f[] (1).
+\f[C]dparallel\f[] (1).
+\f[C]drm\f[] (1).
+\f[C]dtar\f[] (1).
+\f[C]dwalk\f[] (1).
.PP
-\-h, \-\-help : Print a brief message listing the drm(1) options and
-usage.
-.PP
-\-v, \-\-version : Print version information and exit.
-.PP
-add the other options
-.PP
-Known bugs
-.PP
-SEE ALSO
-.PP
-dcmp (1).
-dcp (1).
-dfind:ilemaker (1).
-dfind (1).
-dgrep (1).
-dparallel (1).
-drm (1).
-dtar (1).
-dwalk (1).
-.PP
-The FileUtils source code and all documentation may be downloaded from
-http://fileutils.io
+The mpiFileUtils source code and all documentation may be downloaded
+from <http://fileutils.io>
