FIND(1)

NAME
find - search directory tree for files matching a pattern

SYNOPSIS
find [ -HdhXxW ] [ Directory ] [ expression ]

DESCRIPTION
This is actually a front end for find2perl, it automatically converts your request to perl and executes it (unless something goes wrong, you probably will not see a difference). If you want to do something fancier, or are going to do the same search often, you should give the commands straight to find2perl and run the perl code yourself (after possible modification).

find searches a directory tree for files matching given criteria, then executes user specified commands on those files.

 Examples:

find and print a list of all files on the system (disk) with a .pm extension (perl modules).

"find / -name "*.pm" -print"

find and delete all files in the current directory and subdirectories that end with .bak and have not been accessed in the last 10 days (using unix rm command to do the deleting).

"find . -name "*.bak" -atime +10 -exec rm {};"

SEE ALSO
find

File/Find.pm

RESTRICTIONS
find2perl may not cover all the options that various versions of find implement. It is only a wrapper to find2perl and so has all the same restrictions (some have said that find2perl needs updating).

BUGS
This manpage should probably include the entire find manpage, and perhaps that of find2perl as well.

AUTHOR
This front-end written by Greg Snow, snow@biostat.washington.edu, with many things "borrowed" from the awk front-end by Tom Christiansen, tchrist@perl.com. The find2perl translator was written by Larry Wall, larry@wall.org, author of Perl.

COPYRIGHT and LICENSE
This program is copyright (c) Gregory L. Snow 1999 (with parts "borrowed" from things copyright (c) Tom Christiansen 1999).

This program is free and open software. You may use, modify, distribute, and sell this program (and any modified variants) in any way you wish, provided you do not restrict others from doing the same.