<html><head><title>find</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
</head>
<body class='pod'>
<!--
generated by Pod::Simple::HTML v3.01,
using Pod::Simple::PullParser v2.02,
under Perl v5.008002 at Thu Aug 5 13:56:27 2004 GMT.
If you want to change this HTML document, you probably shouldn't do that
by changing it directly. Instead, see about changing the calling options
to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
then reconverting this document from the Pod source.
When in doubt, email the author of Pod::Simple::HTML for advice.
See 'perldoc Pod::Simple::HTML' for more info.
-->
<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>find - search directory tree for files matching a pattern</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<p><b>find</b> [ -HdhXxW ] [ <em lang='und' xml:lang='und'>Directory</em> ] [ expression ]</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>This is actually a front end for <b>find2perl</b>,
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 <b>find2perl</b> and run the perl code yourself (after possible modification).</p>
<p><b>find</b> searches a directory tree for files matching given criteria,
then executes user specified commands on those files.</p>
<pre lang='und' xml:lang='und'> Examples:</pre>
<p>find and print a list of all files on the system (disk) with a <em lang='und' xml:lang='und'>.pm</em> extension (perl modules).</p>
<p><code lang='und' xml:lang='und'>find / -name "*.pl" -print</code></p>
<p>find and delete all files in the current directory and subdirectories that end with <em lang='und' xml:lang='und'>.bak</em> and have not been accessed in the last 10 days (using unix rm command to do the deleting).</p>
<p><code lang='und' xml:lang='und'>find . -name "*.bak" -atime +10 -exec rm {};</code></p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SEE_ALSO"
>SEE ALSO</a></h1>
<p>find</p>
<p>File/Find.pm</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="RESTRICTIONS"
>RESTRICTIONS</a></h1>
<p><i>find2perl</i> 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).</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="BUGS"
>BUGS</a></h1>
<p>This manpage should probably include the entire <i>find</i> manpage, and perhaps that of <i>find2perl</i> as well.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>
<p>This front-end written by Greg Snow, <i>snow@biostat.washington.edu</i>, with many things "borrowed" from the <i>awk</i> front-end by Tom Christiansen, <i>tchrist@perl.com</i>. The <i>find2perl</i> translator was written by Larry Wall, <i>larry@wall.org</i>, author of Perl.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT_and_LICENSE"
>COPYRIGHT and LICENSE</a></h1>
<p>This program is copyright (c) Gregory L. Snow 1999 (with parts "borrowed" from things copyright (c) Tom Christiansen 1999).</p>
<p>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.</p>
<!-- end doc -->
</body></html>