-P Never follow symbolic links. This is the default behaviour. When find examines or prints
information a file, and the file is a symbolic link, the information used shall be taken from the
properties of the symbolic link itself.
-L Follow symbolic links. When find examines or prints information about files, the information used
shall be taken from the properties of the file to which the link points, not from the link itself
(unless it is a broken symbolic link or find is unable to examine the file to which the link
points). Use of this option implies -noleaf. If you later use the -P option, -noleaf will still
be in effect. If -L is in effect and find discovers a symbolic link to a subdirectory during its
search, the subdirectory pointed to by the symbolic link will be searched.
When the -L option is in effect, the -type predicate will always match against the type of the
file that a symbolic link points to rather than the link itself (unless the symbolic link is
broken). Using -L causes the -lname and -ilname predicates always to return false.
-H Do not follow symbolic links, except while processing the command line arguments. When find
examines or prints information about files, the information used shall be taken from the
properties of the symbolic link itself. The only exception to this behaviour is when a file
specified on the command line is a symbolic link, and the link can be resolved. For that
situation, the information used is taken from whatever the link points to (that is, the link is
followed). The information about the link itself is used as a fallback if the file pointed to by
the symbolic link cannot be examined. If -H is in effect and one of the paths specified on the
command line is a symbolic link to a directory, the contents of that directory will be examined
(though of course -maxdepth 0 would prevent this).
If more than one of -H, -L and -P is specified, each overrides the others; the last one appearing on the
command line takes effect. Since it is the default, the -P option should be considered to be in effect
unless either -H or -L is specified.
GNU find frequently stats files during the processing of the command line itself, before any searching
has begun. These options also affect how those arguments are processed. Specifically, there are a
number of tests that compare files listed on the command line against a file we are currently
considering. In each case, the file specified on the command line will have been examined and some of
its properties will have been saved. If the named file is in fact a symbolic link, and the -P option is
in effect (or if neither -H nor -L were specified), the information used for the comparison will be taken
from the properties of the symbolic link. Otherwise, it will be taken from the properties of the file
the link points to. If find cannot follow the link (for example because it has insufficient privileges
or the link points to a nonexistent file) the properties of the link itself will be used.
When the -H or -L options are in effect, any symbolic links listed as the argument of -newer will be
dereferenced, and the timestamp will be taken from the file to which the symbolic link points. The same
consideration applies to -newerXY, -anewer and -cnewer.
The -follow option has a similar effect to -L, though it takes effect at the point where it appears (that
is, if -L is not used but -follow is, any symbolic links appearing after -follow on the command line will
be dereferenced, and those before it will not).
Print diagnostic information; this can be helpful to diagnose problems with why find is not doing
what you want. The list of debug options should be comma separated. Compatibility of the debug
options is not guaranteed between releases of findutils. For a complete list of valid debug
options, see the output of find -D help. Valid debug options include
Enables query optimisation. The find program reorders tests to speed up execution while
preserving the overall effect; that is, predicates with side effects are not reordered relative to
each other. The optimisations performed at each optimisation level are as follows.
Print a summary of the command-line usage of find and exit.
Normally, find will emit an error message when it fails to stat a file. If you give this option
and a file is deleted between the time find reads the name of the file from the directory and the
time it tries to stat the file, no error message will be issued. This also applies to files or
directories whose names are given on the command line. This option takes effect at the time the
command line is read, which means that you cannot search one part of the filesystem with this
option on and part of it with this option off (if you need to do that, you will need to issue two
find commands instead, one with the option and one without it).
Descend 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.
Do not apply any tests or actions at levels less than levels (a non-negative integer). -mindepth
1 means process all files except the command line arguments.
-mount Don't descend directories on other filesystems. An alternate name for -xdev, for compatibility
with some other versions of find.
Turns off the effect of -ignore_readdir_race.
Do not optimize by assuming that directories contain 2 fewer subdirectories than their hard link
count. This option is needed when searching filesystems that do not follow the Unix directory-
link convention, such as CD-ROM or MS-DOS filesystems or AFS volume mount points. Each directory
on a normal Unix filesystem has at least 2 hard links: its name and its `.' entry. Additionally,
its subdirectories (if any) each have a `..' entry linked to that directory. When find is
examining a directory, after it has statted 2 fewer subdirectories than the directory's link
count, it knows that the rest of the entries in the directory are non-directories (`leaf' files in
the directory tree). If only the files' names need to be examined, there is no need to stat them;
this gives a significant increase in search speed.
Changes the regular expression syntax understood by -regex and -iregex tests which occur later on
the command line. Currently-implemented types are emacs (this is the default), posix-awk, posix-
basic, posix-egrep and posix-extended.
Print the find version number and exit.
Like -regex, but the match is case insensitive.