- Wikipedia, the free encyclopedia Page 1 of 6

find

From Wikipedia, the free encyclopedia

The find program is a directory search utility on -like platforms. It searches through one or directory trees of a filesystem, locating files based on some user-specified criteria. By default, find returns all files below the current working directory. Further, find allows the user to specify an action to be taken on each matched . Thus, it is an extremely powerful program for applying actions to many files. It also supports regex matching.

The related, locate programs, use a database of indexed files obtained through find (updated regular intervals, typically by job) to provide a faster method of searching the entire filesystem for files by name. This sacrifices overall efficiency (because filesystems are regularly interrogated even when no users needs information)and absolute accuracy (since the database is not updated in real ) for significant speed improvements (particularly on very large filesystems). On fast systems with small drives, locate is not necessary or desirable. Contents

„ 1 Find syntax „ 2 POSIX protection from infinite output „ 3 Examples „ 3.1 From current directory „ 3.2 Files only „ 3.3 Commands „ 3.4 Search all directories „ 3.5 Search all but one directory subtree „ 3.6 Specify a directory „ 3.7 Search several directories „ 3.8 Ignore errors „ 3.9 Find any one of differently named files „ 3.10 Execute an action „ 3.11 Search for a string „ 3.12 Search for all files owned by a user „ 3.13 Search in case insensitive mode „ 3.14 Search files by size

„ 4 See also „ 5 External links

Find syntax

find [-H] [-L] [-P] [path...] [expression]

The three options control how the find command should treat symbolic links. The default behaviour is to never follow symbolic links. This can be explicitly specified using the -P flag. The -L flag will cause the find command to follow symbolic links. The -H flag will only follow symbolic links while processing the command line arguments.

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009 find - Wikipedia, the free encyclopedia Page 2 of 6

At least one path must precede the expression. Find is capable of interpreting wildcards internally and commands must be constructed carefully in order to control shell globbing.

Expression elements are whitespace-separated and evaluated from left to right. They can contain logical elements such as AND (-a) and OR (-o) as well as more complex predicates.

The GNU find has a large number of additional features not specified by POSIX. POSIX protection from infinite output

Real-world filesystems often contain looped structures created through the use of hard or soft links. The POSIX standard requires that

The find utility shall detect infinite loops; that is, entering a previously visited directory that is an ancestor of the last file encountered. When it detects an infinite loop, find shall a diagnostic message to standard error and shall either recover its position in the hierarchy or terminate.

Examples

From current directory

find . -name 'my*'

This searches in the current directory (represented by a period) and below it, for files and directories with names starting with my. The quotes avoid the shell expansion - without them the shell would replace my* with the list of files whose names begin with my in the current directory. In newer versions of the program, the directory may be omitted, and it will imply the current directory.

Files only

find . -name "my*" - f

This limits the results of the above search to only regular files, therefore excluding directories, special files, pipes, symbolic links, etc. my* is enclosed in quotes as otherwise the shell would replace it with the list of files in the current directory starting with my...

Commands

The previous examples created listings of results because, by default, find executes the '-print' action. (Note that early versions of the find command had no default action at all; therefore the resulting list of files would be discarded, to the bewilderment of users.)

find . -name "my*" -type f -

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009 find - Wikipedia, the free encyclopedia Page 3 of 6

This prints an extended file information.

Search all directories

find / -type f -name "myfile" -print

This searches every file on the computer for a file with the name myfile and prints it to the screen. It is generally not a good idea to look for data files this way. This can take a considerable amount of time, so it is best to specify the directory more precisely. Some operating systems may mount dynamic filesystems that are not congenial to find.

Search all but one directory subtree

find / -path excluded_folder -prune -o -type f -name myfile -print

This searches every folder on the computer except the subtree excluded_folder for a file with the name myfile. It will not detect directories, devices, links, doors, or other "special" filetypes.

Specify a directory

find /home/weedly -name "myfile" -type f -print

This searches for files named myfile in the /home/weedly directory, the home directory for userid weedly. You should always specify the directory to the deepest level you can remember.

Search several directories

find local /tmp -name mydir -type d -print

This searches for directories named mydir in the local subdirectory of the current working directory and the /tmp directory.

Ignore errors

If you're doing this as a user other than root, you might want to ignore permission denied (and any other) errors. Since errors are printed to stderr, they can be suppressed by redirecting the output to /dev/null. The following example shows how to do this in the bash shell:

find / -name "myfile" -type f -print 2>/dev/null

If you are a csh or tcsh user, you cannot redirect stderr without redirecting stdout as well. You can use sh to run the find command to get around this:

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009 find - Wikipedia, the free encyclopedia Page 4 of 6

sh -c find / -name "myfile" -type f -print 2>/dev/null

An alternate method when using csh or tcsh is to pipe the output from stdout and stderr into a command. This example shows how to suppress lines that contain permission denied errors.

find . -name "myfile" |& grep -v "Permission denied"

Find any one of differently named files

find . \( -name "*jsp" -o -name "*java" \) -type f -ls

The -ls option prints extended information, and the example finds any file whose name ends with either 'jsp' or 'java'. Note that the parentheses are required. Also note that the operator "or" can be abbreviated as "o". The "and" operator is assumed where no operator is given. In many shells the parentheses must be escaped with a backslash, "\(" and "\)", to prevent them from being interpreted as special shell characters. The -ls option and the -or operator are not available on all versions of find.

Execute an action

find /var/ftp/mp3 -name "*.mp3" -type f -exec 644 {} \;

This command changes the permissions of all files with a name ending in .mp3 in the directory /var/ftp/mp3. The action is carried out by specifying the option -exec chmod 644 {} \; in the command. For every file whose name ends in .mp3, the command chmod 644 {} is executed replacing {} with the name of the file. The semicolon (backslashed to avoid the shell interpreting it as a command separator) indicates the end of the command. Permission 644, usually shown as rw-r--r--, gives the file owner full permission to read and write the file, while other users have read-only access. In some shells, the {} must be quoted.

Note that the command itself should *not* be quoted; otherwise you get error messages like

find: " ./3bfn rel071204": No such file or directory

which means that find is trying to run a file called 'echo "mv ./3bfn rel071204"' and failing.

If you will be executing over many results, it is more efficient to pipe the results to the command instead.

If running under Windows, don't include the backslash before the semicolon:

find . -exec grep blah {} ;

Search for a string

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009 find - Wikipedia, the free encyclopedia Page 5 of 6

This command will search for a string in all files from the /tmp directory and below:

find /tmp -exec grep "search string" '{}' /dev/null \; -print

The /dev/null argument is used to show the name of the file before the text that is found. Without it, only the text found is printed. An equivalent mechanism is to use the "-H" or "--with-filename" option to grep:

find /tmp -exec grep -H "search string" '{}' \; -print

GNU grep can be used on its own to perform this task:

grep -r "search string" /tmp

Example of search for "LOG" in jsmith's home directory

find ~jsmith -exec grep "LOG" '{}' /dev/null \; -print /home/jsmith/scripts/errpt.sh: $LOG $FIXEDLOGNAME /home/jsmith/scripts/errpt.sh: $LOG /home/jsmith/scripts/title:USER=$

Example of search for the string "ERROR" in all xml files in the current directory and all sub-directories

find . -name "*.xml" -exec grep "ERROR" '{}' \; -print

The double quotes (" ") surrounding the search string and single quotes (' ') surrounding the braces are optional in this example, but needed to allow spaces and other special characters in the string.

Search for all files owned by a user

find . -user

Search in case insensitive mode

find . -iname -type f -print

Search files by size

Example of searching files with size between 100 kilobytes and 500 kilobytes.

find . -size +100k -a -size -500k

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009 find - Wikipedia, the free encyclopedia Page 6 of 6

The units should be one of [bckw], 'b' means 512-byte blocks, 'c' means byte, 'k' means kilobytes and 'w' means 2-byte words. The size does not count indirect blocks, but it does count blocks in sparse files that are not actually allocated. See also

„ GNU locate, a Unix search tool based on a prebuilt database therefore faster and less accurate than find „ mdfind, a similar utility that utilizes metadata for Mac OS X and Darwin „ List of Unix programs „ List of DOS commands „ find (command), a DOS and Windows command that is very different from UNIX find External links

„ find: find files – Commands & Utilities Reference, The Single UNIX® Specification, Issue 7 from The Open Group „ find(1): search for files in a directory hierarchy – User Commands Manual „ GNU Findutils - Comes with the xargs and locate commands. „ Official webpage for GNU find „ Softpanorama find tutorial „ Exercises "Find" „ "Find helper" - unix "find" wizard „ Guide to Linux Find Command Mastery „ Top 'find' commands - interesting usage Retrieved from "http://en.wikipedia.org/wiki/Find" Categories: Unix software | Searching | Standard Unix programs

„ This page was last modified on 19 December 2009 at 13:08. „ Text is available under the Creative Commons Attribution-ShareAlike License; additional terms may apply. See Terms of Use for details. Wikipedia® is a registered trademark of the Wikimedia Foundation, Inc., a non-profit organization. „ Contact us

http://en.wikipedia.org/w/index.php?title=Find&printable=yes 12/29/2009