source: trunk/third/findutils/README @ 18890

Revision 18890, 2.1 KB checked in by zacheiss, 22 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r18889, which included commits to RCS files with non-trunk default branches.
Line 
1This package contains the GNU find, xargs, and locate programs.  find
2and xargs comply with POSIX 1003.2, as far as I know.  They also
3support some additional options, some borrowed from Unix and some
4unique to GNU.
5
6See the file NEWS for a list of major changes in the current release.
7
8See the file INSTALL for compilation and installation instructions.
9
10Special configure options:
11
12--with-afs
13  Make find support "-fstype afs".  Requires /afs, /usr/afsws/lib, and
14/usr/afsws/include.  configure doesn't add AFS support
15automatically because it adds considerably to find's size, and the
16AFS libraries need -lucb on Solaris, which breaks find.
17
18--enable-id-cache
19  Make tables of used UIDs and GIDs at startup instead of using
20getpwuid or getgrgid when needed.  Speeds up -nouser and -nogroup
21unless you are running NIS or Hesiod, which make password and group
22calls very expensive.
23
24To gain speed, GNU find avoids statting files whenever possible.
25It does this by:
261. Checking the number of links to directories and not statting files
27that it knows aren't directories until it encounters a test or action
28that needs the stat info.
292.  Rearranging the command line, where possible, so that it can do tests
30that don't require a stat before tests that do, in hopes that the
31latter will be skipped because of an OR or AND.  (But it only does
32this where it will leave the output unchanged.)
33
34The locate program and its helper programs are derived (heavily
35modified) from James Woods' public domain fast-find code, which is
36also distributed with the 4.3BSD find.  Because POSIX.2 requires `find
37foo' to have the same effect as `find foo -print', the fast-find
38searching has been moved to a separate program, `locate'; the same
39thing has been done in 4.4BSD.  If you use locate, you should run the
40included `updatedb' script from cron periodically (typically nightly).
41
42The `Makefile.am' files are used by an experimental program called
43AutoMake that is under development.  It's not ready for general use
44yet, so don't worry about them.
45
46Mail suggestions and bug reports for these programs to
47bug-findutils@gnu.org.
Note: See TracBrowser for help on using the repository browser.