find(1)

NAME
     find - find files meeting a given condition

SYNOPSIS
     find directory expression

EXAMPLES

     find /  -name a.out -print
                         # Print all a.out paths

     find /usr/ast ! -newer f -ok rm {} \;
                         # Ask before removing

     find /usr -size +20 -exec mv {} /big \^;
                         # move files > 10k

     find / \( -name a.out -o -name '*.o' \) -exec rm {} \;
                         # 2 conds

DESCRIPTION

     Find descends the file tree starting at the given directory checking each
     file  in  that  directory and its subdirectories against a predicate.  If
     the predicate is true,  an  action  is  taken.   The  predicates  may  be
     connected by -a (Boolean and), -o (Boolean or) and !  (Boolean negation).
     Each predicate is true under the conditions specified below.  The integer
     n  may  also be +n to mean any value greater than n, -n to mean any value
     less than n, or just n for exactly n.

          -name s    true if current filename is s (include shell wild cards)
          -size n    true if file size is n blocks
          -inum n    true if the current file's i-node number is n
          -mtime n   true if modification time relative to today (in days)  is
                     n
          -links n   true if the number of links to the file is n
          -newer f   true if the file is newer than f
          -perm n    true if the file's permission bits = n (n is in octal)
          -user u    true if the uid = u (a numerical value, not a login name)
          -group g   true if the gid = g (a numerical value, not a group name)
          -type x    where x  is  bcdfug  (block,  char,  dir,  regular  file,
                     setuid, setgid)
          -xdev      do not cross devices to search mounted file systems

     Following the expression can be one of the following, telling what to  do
     when a file is found:

          -print     print the file name on standard output
          -print0    print the file name terminated by a null character, to be
                     used with xargs -0.  (Minix extension).

          -exec      execute a command, {} stands for the file name
          -ok        prompts before executing the command

SEE ALSO
     test(1), xargs(1).