README 4.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  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.
  6. See the file NEWS for a list of major changes in the current release.
  7. See the file INSTALL for compilation and installation instructions.
  8. If there is no file INSTALL, you must be looking at the checked-out
  9. source code instead of at an unpacked source tarball ("release"). In
  10. that case, you should first please read and follow the instructions in
  11. the file README-hacking. Those instructions explain how to generate
  12. the auto-generated files needed to build findutils, and this includes
  13. generating the INSTALL file.
  14. To verify the GPG signature of the release, you will need the public
  15. key of the findutils maintainer. You can download this from
  16. ftp://ftp.gnu.org/gnu/gnu-keyring.gpg. Alternatively, you could query
  17. a PGP keyserver, but you will need to use one that can cope with
  18. subkeys containing photos. Many older key servers cannot do this. I
  19. use subkeys.pgp.net. I think that one works. See also the
  20. "Downloading" section of https://www.gnu.org/software/findutils/.
  21. Special configure options:
  22. --with-afs
  23. Make find support "-fstype afs". Requires /afs, /usr/afsws/lib, and
  24. /usr/afsws/include. configure doesn't add AFS support
  25. automatically because it adds considerably to find's size, and the
  26. AFS libraries need -lucb on Solaris, which breaks find.
  27. DEFAULT_ARG_SIZE=<value>
  28. If this environment variable is defined to a numeric expression
  29. during configure, it determines the default argument size limits used
  30. by xargs without -s, and by find, when spawning child processes.
  31. Otherwise, the default is set at 128 kibibytes. If the system cannot
  32. support the default limit, the system's limit will be used instead.
  33. To gain speed, GNU find avoids statting files whenever possible.
  34. It does this by:
  35. 1. Checking the number of links to directories and not statting files
  36. that it knows aren't directories until it encounters a test or action
  37. that needs the stat info.
  38. 2. Rearranging the command line, where possible, so that it can do
  39. tests that don't require a stat before tests that do, in hopes that
  40. the latter will be skipped because of a -o/-a conjunction. (But it
  41. only does this where it will leave the output unchanged.)
  42. The locate program and its helper programs are derived (heavily
  43. modified) from James Woods' public domain fast-find code, which is
  44. also distributed with the 4.3BSD find. Because POSIX.2 requires `find
  45. foo' to have the same effect as `find foo -print', the fast-find
  46. searching has been moved to a separate program, `locate'; the same
  47. thing has been done in 4.4BSD. If you use locate, you should run the
  48. included `updatedb' script from cron periodically (typically nightly).
  49. The latest full release is available at
  50. ftp://ftp.gnu.org/gnu/findutils.
  51. The latest test release (if any) is available at
  52. ftp://alpha.gnu.org/gnu/findutils
  53. Discussion of the findutils package and ways to improve it takes place
  54. on the "bug-findutils" mailing list, which you can join by sending
  55. mail to bug-findutils-request@gnu.org. An archive of patches to the
  56. bug-findutils mailing list is available at
  57. https://lists.gnu.org/r/bug-findutils/.
  58. Bug reports, suggested patches and enhancement requests for findutils
  59. should be logged at https://savannah.gnu.org/bugs/?group=findutils.
  60. Changes to the findutils code are sent to the findutils-patches
  61. mailing list. To join, please send email to
  62. findutils-patches@gnu.org. You are also welcome to send patches to
  63. that list, but unless you are a list subscriber, you won't be able to
  64. follow any resulting discussion. An archive of posts to the
  65. findutils-patches mailing list is available at
  66. https://lists.gnu.org/r/findutils-patches/.
  67. See https://savannah.gnu.org/git/?group=findutils for instructions on
  68. how to use git to access the findutils source code.
  69. Mail suggestions and bug reports for these programs to
  70. bug-findutils@gnu.org.
  71. ========================================================================
  72. Copyright (C) 1996-2021 Free Software Foundation, Inc.
  73. Permission is granted to copy, distribute and/or modify this document
  74. under the terms of the GNU Free Documentation License, Version 1.3 or
  75. any later version published by the Free Software Foundation; with no
  76. Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  77. Texts. A copy of the license is included in the "GNU Free
  78. Documentation License" file as part of this distribution.