find is as specified in the Single UNIX Specification but with additional options as specified below.
Certain aspects of internationalized filename globbing are optional; see Internationalization and Filename Globbing>.
The behaviors specified in this section are expected to disappear from a future version of the LSB; applications should only use the non-LSB-deprecated behaviors.
measures times (for -amin, -atime, -cmin, -ctime, -mmin, and -mtime) from the beginning of today rather than from 24 hours ago.
dereferences symbolic links. Implies -noleaf.
descends at most levels (a non-negative integer) levels of directories below the command line arguments. -maxdepth 0 means only apply the tests and actions to the command line arguments.
applies no tests or actions at levels less than levels (a non-negative integer). -mindepth 1 means process all files except the command line arguments.
is equivalent to -xdev as specified in the Single UNIX Specification.
does not optimize by assuming that directories contain 2 fewer subdirectories than their hard link count.
prints the find version number and exits.
displays files last accessed n minutes ago.
displays files last accessed more recently than file was modified. -anewer is affected by -follow only if -follow comes before -anewer on the command line.
displays files with status last changed n minutes ago.
displays files with status last changed more recently than file was modified. -cnewer is affected by -follow only if -follow comes before -cnewer on the command line.
displays files that are empty and are either regular or directory files.
is always false.
displays files on a filesystem of type type.
displays files with numeric group ID of n.
is like -lname, but the match is case-insensitive.
is like -name, but the match is case-insensitive.
displays files with inode number of n.
is like -path, but the match is case-insensitive.
is like -regex, but the match is case-insensitive.
displays files that are symbolic links whose contents match shell pattern pattern. The metacharacters do not treat / or . specially.
displays files with data last modified n minutes ago.
displays files with numeric user ID corresponding to no user.
displays files with numeric group ID corresponding to no group.
displays files with name matching shell pattern pattern.
displays files with any of the permission bits mode set.
displays files with names matching regular expression pattern. This is a match on the whole path, not a search.
is always true.
supplements types as specified in the Single UNIX Specification with the letters l and s (symbolic links and sockets, respectively).
displays files with numeric user ID of n.
displays files last accessed n days after status was last changed.
is equivalent to -type unless the file is a symbolic link. For symbolic links: if -follow has not been given, true if the file is a link to a file of type c; if -follow has been given, true if c is l. In other words, for symbolic links, -xtype checks the type of the file that -type does not check.
is true. Is like -ls but write to file like -fprint.
is true. Prints the full file name into file file. If file does not exist when find is run, it is created; if it does exist, it is truncated. The file names `/dev/stdout' and `/dev/stderr' are handled specially; they refer to the standard output and standard error output, respectively.
is true. Is like -print0 but write to file like -fprint.
is true. Like -printf but write to file like -fprint.
is true. Prints the full file name on the standard output, followed by a null character. This allows file names that contain newlines to be correctly interpreted by programs that process the find output.
is true. Prints format on the standard output, interpreting \ escapes and % directives. Field widths and precisions can be specified as with the printf C function. Unlike -print, -printf does not add a newline at the end of the string. The escapes and directives are:
stops printing from this format immediately and flushes the output.
literal backslash (\).
literal percent sign.
last file access time in the format returned by the C ctime function.
last file access time in the format specified by k, which is either @ or a directive for the C strftime function. The possible values for k are listed below; some of them might not be available on all systems, due to differences in strftime between systems.
seconds since Jan. 1, 1970, 00:00 GMT.
hour ( 0..23).
hour ( 1..12).
locale's AM or PM.
time, 12-hour (hh:mm:ss [AP]M).
time, 24-hour (hh:mm:ss).
locale's time representation (H:M:S).
time zone (e.g., EDT), or nothing if no time zone is determinable.
locale's abbreviated weekday name (Sun..Sat).
locale's full weekday name, variable length (Sunday..Saturday).
locale's abbreviated month name (Jan..Dec).
locale's full month name, variable.
locale's date and time (Sat Nov 04 12:02:33 EST 1989).
day of month (01..31).
same as b.
day of year (001.366).
week number of year with Sunday as first day of week (00..53).
day of week (0..6).
week number of year with Monday as first day of week (00..53).
locale's date representation (mm/dd/yy).
last two digits of year (00..99).
file's size in 512-byte blocks (rounded up).
last file status change time in the format returned by the C ctime function.
last file status change time in the format specified by k, which is the same as for %A.
file's depth in the directory tree; 0 means the file is a command line argument.
file's name with any leading directories removed (only the last element).
type of the filesystem the file is on; this value can be used for -fstype.
file's group name, or numeric group ID if the group has no name.
file's numeric group ID.
leading directories of file's name (all but the last element).
mommand line argument under which file was found.
file's inode number (in decimal).
file's size in 1K blocks (rounded up).
object of symbolic link (empty string if file is not a symbolic link).
file's permission bits (in octal).
number of hard links to file.
file's name with the name of the command line argument under which it was found removed.
file's size in bytes.
file's last modification time in the format returned by the C ctime function.
file's last modification time in the format specified by k, which is the same as for %A.
file's user name, or numeric user ID if the user has no name.
file's numeric user ID.
is true. Lists current file in ls -dils format on standard output. The block counts are of 1K blocks, unless the environment variable POSIXLY_CORRECT is set, in which case 512-byte blocks are used.
The following operators are supported in order of decreasing precedence and override what is specified in the Single UNIX Specification.
true if expr is false
same as ! expr.
and (implied); expr2 is not evaluated if expr1 is false.
same as expr1 expr2.
same as expr1 expr2.
or; expr2 is not evaluated if expr1 is true.
same as expr1 -o expr2.
list; both expr1 and expr2 are always evaluated. The value of expr1 is discarded; the value of the list is the value of expr2.