/ 
PerlPowerTools-1.047
River stage one • 1 direct dependent • 1 total dependent
/ find

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.