dfind.1

.\" Man page generated from reStructuredText.
.
.TH "DFIND" "1" "Jan 27, 2020" "0.10" "mpiFileUtils"
.SH NAME
dfind \- distributed file filtering
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBdfind [OPTION] [EXPRESSION] PATH …\fP
.SH DESCRIPTION
.sp
Parallel MPI application to filter a list of files according to an expression.
.sp
dfind provides functionality similar to \fBfind(1)\fP\&.
.sp
The file list can be obtained by either walking one or more paths provided on the command line or through an input list.
.sp
The filtered list can be written to an output file.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-i, \-\-input FILE
Read source list from FILE. FILE must be generated by another tool
from the mpiFileUtils suite.
.UNINDENT
.INDENT 0.0
.TP
.B \-o, \-\-output FILE
Write the processed list to a file.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-verbose
Run in verbose mode.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
Run tool silently. No output is printed.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
Print a brief message listing the \fBdfind(1)\fP options and usage.
.UNINDENT
.SH EXPRESSIONS
.sp
Numeric arguments can be specified as:
.INDENT 0.0
.INDENT 3.5
.TS
center;
|l|l|.
_
T{
+N
T}	T{
more than N
T}
_
T{
\-N
T}	T{
less than N
T}
_
T{
N
T}	T{
exactly N
T}
_
.TE
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-amin N
File was last accessed N minutes ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-anewer FILE
File was last accessed more recently than FILE was modified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-atime N
File was last accessed N days ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cmin N
File’s status was last changed N minutes ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cnewer FILE
File’s status was last changed more recently than FILE was modified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ctime N
File’s status was last changed N days ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mmin N
File’s data was last modified N minutes ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-newer FILE
File was modified more recently than FILE.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mtime N
File’s data was last modified N days ago.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-gid N
File’s numeric group ID is N.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-group NAME
File belongs to group NAME.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-uid N
File’s numeric user ID is N.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-user NAME
File is owned by user NAME.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-name PATTERN
Base of file name matches shell pattern PATTERN.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-path PATTERN
Full path to file matches shell pattern PATTERN.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-regex REGEX
Full path to file matches POSIX regular expression REGEX.  Regular expressions processed by \fBregexec(3)\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-size N
File size is N bytes.  Units can be used like ‘KB’, ‘MB’, ‘GB’.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-type C
File is of type C:
.TS
center;
|l|l|.
_
T{
b
T}	T{
block device
T}
_
T{
c
T}	T{
char device
T}
_
T{
d
T}	T{
directory
T}
_
T{
f
T}	T{
regular file
T}
_
T{
l
T}	T{
symbolic link
T}
_
T{
p
T}	T{
pipe
T}
_
T{
s
T}	T{
socket
T}
_
.TE
.UNINDENT
.SH ACTIONS
.INDENT 0.0
.TP
.B \-\-print
Print file name to stdout.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exec CMD ;
Execute command CMD on file.  All following arguments are taken as arguments to the command until ‘;’ is encountered.  The string ‘{}’ is replaced by the current file name.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.IP 1. 3
Print all files owner by user1 under given path:
.UNINDENT
.sp
\fBmpirun \-np 128 dfind \-v \-\-user user1 \-\-print /path/to/target\fP
.INDENT 0.0
.IP 2. 3
To find all files less than 1GB and write them to a file:
.UNINDENT
.sp
\fBmpirun \-np 128 dfind \-v \-o outfile \-\-size \-1GB /path/to/target\fP
.INDENT 0.0
.IP 3. 3
Filter list in infile to find all regular files not changed in the past 180 days and write new list to outfile:
.UNINDENT
.sp
\fBmpirun \-np 128 dfind \-v \-i infile \-o outfile \-\-type f \-\-mtime +180\fP
.SH SEE ALSO
.sp
The mpiFileUtils source code and all documentation may be downloaded
from <\fI\%https://github.com/hpc/mpifileutils\fP>
.SH AUTHOR
HPC
.SH COPYRIGHT
2018, LLNL/LANL/UT-Battelle/DDN
.\" Generated by docutils manpage writer.
.