cvsimport
[findutils.git] / README
blobbe967a22248ee0064b2604b857395969db9d7d49
1 This package contains the GNU find, xargs, and locate programs.  find
2 and xargs comply with POSIX 1003.2, as far as I know (with the
3 exception of the "+" modifier for the "-exec" action, which isn't
4 implemented yet).  They also support a large number of additional
5 options, some borrowed from Unix and some unique to GNU.
7 See the file NEWS for a list of major changes in the current release.
9 See the file INSTALL for compilation and installation instructions.
11 To verify the GPG signature of the release, you will need the public
12 key of the findutils maintainer.  You can download this from
13 ftp://ftp.gnu.org/gnu/gnu-keyring.gpg.  Alternatively, you could query
14 a PGP keyserver, but you will need to use one that can cope with
15 subkeys containing photos.  Many older key servers cannot do this.  I
16 use subkeys.pgp.net.  I think that one works.  See also the
17 "Downloading" section of http://www.gnu.org/software/findutils/.
19 Special configure options:
21 --with-afs
22   Make find support "-fstype afs".  Requires /afs, /usr/afsws/lib, and
23 /usr/afsws/include.  configure doesn't add AFS support
24 automatically because it adds considerably to find's size, and the
25 AFS libraries need -lucb on Solaris, which breaks find.
27 --enable-id-cache
28   Make tables of used UIDs and GIDs at startup instead of using
29 getpwuid or getgrgid when needed.  Speeds up -nouser and -nogroup
30 unless you are running NIS or Hesiod, which make password and group
31 calls very expensive.
33 --enable-debug
34   Produce output on the standard error output indicating what find is
35 doing.  This information includes details about how the command line
36 has been parsed and what files have been stat()ed.  This output is
37 normally interesting only to the maintainer, and so is off by default.
40 To gain speed, GNU find avoids statting files whenever possible.
41 It does this by:
42 1. Checking the number of links to directories and not statting files
43 that it knows aren't directories until it encounters a test or action
44 that needs the stat info.
45 2.  Rearranging the command line, where possible, so that it can do tests
46 that don't require a stat before tests that do, in hopes that the
47 latter will be skipped because of an OR or AND.  (But it only does
48 this where it will leave the output unchanged.)
50 The locate program and its helper programs are derived (heavily
51 modified) from James Woods' public domain fast-find code, which is
52 also distributed with the 4.3BSD find.  Because POSIX.2 requires `find
53 foo' to have the same effect as `find foo -print', the fast-find
54 searching has been moved to a separate program, `locate'; the same
55 thing has been done in 4.4BSD.  If you use locate, you should run the
56 included `updatedb' script from cron periodically (typically nightly).
58 Mail suggestions and bug reports for these programs to
59 bug-findutils@gnu.org.