mirror of
https://https.git.savannah.gnu.org/git/findutils.git
synced 2026-01-26 15:39:06 +00:00
As of findutils-4.6, this package is stable. * README-alpha: Remove file, moving the useful content of it to ... * README: ... here. * doc/find-maint.texi: Remove README-alpha here, too. Reported by Steve in http://lists.gnu.org/archive/html/bug-findutils/2016-10/msg00000.html
90 lines
4.1 KiB
Plaintext
90 lines
4.1 KiB
Plaintext
This package contains the GNU find, xargs, and locate programs. find
|
|
and xargs comply with POSIX 1003.2, as far as I know (with the
|
|
exception of the "+" modifier for the "-exec" action, which isn't
|
|
implemented yet). They also support a large number of additional
|
|
options, some borrowed from Unix and some unique to GNU.
|
|
|
|
See the file NEWS for a list of major changes in the current release.
|
|
|
|
See the file INSTALL for compilation and installation instructions.
|
|
|
|
To verify the GPG signature of the release, you will need the public
|
|
key of the findutils maintainer. You can download this from
|
|
ftp://ftp.gnu.org/gnu/gnu-keyring.gpg. Alternatively, you could query
|
|
a PGP keyserver, but you will need to use one that can cope with
|
|
subkeys containing photos. Many older key servers cannot do this. I
|
|
use subkeys.pgp.net. I think that one works. See also the
|
|
"Downloading" section of http://www.gnu.org/software/findutils/.
|
|
|
|
Special configure options:
|
|
|
|
--with-afs
|
|
Make find support "-fstype afs". Requires /afs, /usr/afsws/lib, and
|
|
/usr/afsws/include. configure doesn't add AFS support
|
|
automatically because it adds considerably to find's size, and the
|
|
AFS libraries need -lucb on Solaris, which breaks find.
|
|
|
|
--enable-id-cache
|
|
Make tables of used UIDs and GIDs at startup instead of using
|
|
getpwuid or getgrgid when needed. Speeds up -nouser and -nogroup
|
|
unless you are running NIS or Hesiod, which make password and group
|
|
calls very expensive.
|
|
|
|
--enable-debug
|
|
Produce output on the standard error output indicating what find is
|
|
doing. This information includes details about how the command line
|
|
has been parsed and what files have been stat()ed. This output is
|
|
normally interesting only to the maintainer, and so is off by default.
|
|
|
|
DEFAULT_ARG_SIZE=<value>
|
|
If this environment variable is defined to a numeric expression
|
|
during configure, it determines the default argument size limits used
|
|
by xargs without -s, and by find, when spawning child processes.
|
|
Otherwise, the default is set at 128 kibibytes. If the system cannot
|
|
support the default limit, the system's limit will be used instead.
|
|
|
|
|
|
To gain speed, GNU find avoids statting files whenever possible.
|
|
It does this by:
|
|
1. Checking the number of links to directories and not statting files
|
|
that it knows aren't directories until it encounters a test or action
|
|
that needs the stat info.
|
|
2. Rearranging the command line, where possible, so that it can do
|
|
tests that don't require a stat before tests that do, in hopes that
|
|
the latter will be skipped because of a -o/-a conjunction. (But it
|
|
only does this where it will leave the output unchanged.)
|
|
|
|
The locate program and its helper programs are derived (heavily
|
|
modified) from James Woods' public domain fast-find code, which is
|
|
also distributed with the 4.3BSD find. Because POSIX.2 requires `find
|
|
foo' to have the same effect as `find foo -print', the fast-find
|
|
searching has been moved to a separate program, `locate'; the same
|
|
thing has been done in 4.4BSD. If you use locate, you should run the
|
|
included `updatedb' script from cron periodically (typically nightly).
|
|
|
|
The latest full release is available at
|
|
ftp://ftp.gnu.org/gnu/findutils.
|
|
|
|
The latest test release (if any) is available at
|
|
ftp://alpha.gnu.org/gnu/findutils
|
|
|
|
Discussion of the findutils package and ways to improve it takes place
|
|
on the "bug-findutils" mailing list, which you can join by sending
|
|
mail to bug-findutils-request@gnu.org. An archive of patches to the
|
|
bug-findutils mailing list is available at
|
|
http://lists.gnu.org/archive/html/bug-findutils/.
|
|
|
|
Bug reports, suggested patches and enhancement requests for findutils
|
|
should be logged at http://savannah.gnu.org/bugs/?group=findutils.
|
|
|
|
Changes to the findutils code are sent to the findutils-patches
|
|
mailing list. To join, please send email to
|
|
findutils-patches@gnu.org. You are also welcome to send patches to
|
|
that list, but unless you are a list subscriber, you won't be able to
|
|
follow any resulting discussion. An archive of posts to the
|
|
findutils-patches mailing list is available at
|
|
http://lists.gnu.org/archive/html/findutils-patches/.
|
|
|
|
Mail suggestions and bug reports for these programs to
|
|
bug-findutils@gnu.org.
|