DFIND(1) mpiFileUtils DFIND(1) NAME dfind - distributed file filtering SYNOPSIS dfind [OPTION] [EXPRESSION] PATH ... DESCRIPTION Parallel MPI application to filter a list of files according to an expres- sion. dfind provides functionality similar to find(1). The file list can be obtained by either walking one or more paths provided on the command line or through an input list. The filtered list can be written to an output file. OPTIONS -i, --input FILE Read source list from FILE. FILE must be generated by another tool from the mpiFileUtils suite. -o, --output FILE Write the processed list to a file. -t, --text Must be used with the --output option. Write processed list of files to FILE in ascii text format. -v, --verbose Run in verbose mode. -q, --quiet Run tool silently. No output is printed. -h, --help Print a brief message listing the dfind(1) options and usage. EXPRESSIONS Numeric arguments can be specified as: +----+-------------+ | +N | more than N | +----+-------------+ | -N | less than N | +----+-------------+ | N | exactly N | +----+-------------+ --amin N File was last accessed N minutes ago. --anewer FILE File was last accessed more recently than FILE was modified. --atime N File was last accessed N days ago. --cmin N File's status was last changed N minutes ago. --cnewer FILE File's status was last changed more recently than FILE was modified. --ctime N File's status was last changed N days ago. --mmin N File's data was last modified N minutes ago. --newer FILE File was modified more recently than FILE. --mtime N File's data was last modified N days ago. --gid N File's numeric group ID is N. --group NAME File belongs to group NAME. --uid N File's numeric user ID is N. --user NAME File is owned by user NAME. --name PATTERN Base of file name matches shell pattern PATTERN. --path PATTERN Full path to file matches shell pattern PATTERN. --regex REGEX Full path to file matches POSIX regular expression REGEX. Regular expressions processed by regexec(3). --size N File size is N bytes. Units can be used like 'KB', 'MB', 'GB'. --type C File is of type C: +---+---------------+ | b | block device | +---+---------------+ | c | char device | +---+---------------+ | d | directory | +---+---------------+ | f | regular file | +---+---------------+ | l | symbolic link | +---+---------------+ | p | pipe | +---+---------------+ | s | socket | +---+---------------+ ACTIONS --print Print file name to stdout. --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. EXAMPLES 1. Print all files owner by user1 under given path: mpirun -np 128 dfind -v --user user1 --print /path/to/target 2. To find all files less than 1GB and write them to a file: mpirun -np 128 dfind -v -o outfile --size -1GB /path/to/target 3. Filter list in infile to find all regular files not changed in the past 180 days and write new list to outfile: mpirun -np 128 dfind -v -i infile -o outfile --type f --mtime +180 SEE ALSO The mpiFileUtils source code and all documentation may be downloaded from <https://github.com/hpc/mpifileutils> AUTHOR HPC COPYRIGHT 2022, LLNL/LANL/UT-Battelle/DDN 0.12 Jan 29, 2025 DFIND(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXPRESSIONS | ACTIONS | EXAMPLES | SEE ALSO | AUTHOR | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dfind&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>