FIND

Section: User Commands (1)
Index Return to Main Contents
 

NAME

find - find files  

SYNOPSIS

find pathname-list expression  

DESCRIPTION

Find recursively descends the directory hierarchy for each pathname in the pathname-list (i.e., one or more pathnames) seeking files that match a boolean expression written in the primaries given below. In the descriptions, the argument n is used as a decimal integer where +n means more than n, -n means less than n and n means exactly n.
-name filename
True if the filename argument matches the current file name. Normal Shell argument syntax may be used if escaped (watch out for `[', `?' and `*').
-perm onum
True if the file permission flags exactly match the octal number onum (see chmod(1)). If onum is prefixed by a minus sign, more flag bits (017777, see stat(2)) become significant and the flags are compared: (flags&onum)==onum.
-type c
True if the type of the file is c, where c is b, c, d or f for block special file, character special file, directory or plain file.
-links n
True if the file has n links.
-user uname
True if the file belongs to the user uname (login name or numeric user ID).
-group gname
True if the file belongs to group gname (group name or numeric group ID).
-size n
True if the file is n blocks long (512 bytes per block).
-inum n
True if the file has inode number n.
-atime n
True if the file has been accessed in n days.
-mtime n
True if the file has been modified in n days.
-exec command
True if the executed command returns a zero value as exit status. The end of the command must be punctuated by an escaped semicolon. A command argument `{}' is replaced by the current pathname.
-ok command
Like -exec except that the generated command is written on the standard output, then the standard input is read and the command executed only upon response y.
-print
Always true; causes the current pathname to be printed.
-newer file
True if the current file has been modified more recently than the argument file.

The primaries may be combined using the following operators (in order of decreasing precedence):

1)
A parenthesized group of primaries and operators (parentheses are special to the Shell and must be escaped).
2)
The negation of a primary (`!' is the unary not operator).
3)
Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries).
4)
Alternation of primaries (`-o' is the or operator).
 

EXAMPLE

To remove all files named `a.out' or `*.o' that have not been accessed for a week:
find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \;
 

FILES

/etc/passwd
/etc/group  

SEE ALSO

sh(1), test(1), filsys(5)  

BUGS

The syntax is painful.


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLE
FILES
SEE ALSO
BUGS

This document was created by man2html, using the manual pages.
Time: 10:16:49 GMT, December 28, 2024