home *** CD-ROM | disk | FTP | other *** search
/ The UNIX CD Bookshelf / OREILLY_TUCB_UNIX_CD.iso / upt / examples / INSTINFO / FIND. < prev    next >
Encoding:
Text File  |  1998-07-24  |  3.8 KB  |  130 lines
  1. # Automatically generated decoration file for /archive/contents/find
  2. #
  3. # This file and any information not otherwise attributed is
  4. # Copyright 1994 by Ready-to-Run Software, Inc.
  5. #
  6. # All Rights Reserved
  7. #
  8. *DESCRIPTION*
  9. GNU find utilities - version 4.1
  10.  
  11. GNU find and xargs comply with POSIX 1003.2 draft 11.1. They also have
  12. some additional options.
  13.  
  14. GNU find has among other enhancements:
  15.  
  16.    option to measure times (for -amin, -atime, -cmin, -ctime, -mmin,
  17.    and -mtime) from the beginning of today rather than from 24 hours ago.
  18.  
  19.    process each directory's contents before the directory itself.
  20.  
  21.    user settable maximum search depth.
  22.  
  23.    option to not apply any tests or actions at levels less than a user
  24.    specified level.
  25.  
  26.    option to not descend directories on other filesystems.
  27.  
  28.    test for filesystem type.
  29.  
  30. ******************************************************************************
  31. GNU xargs build and execute command lines from standard input,
  32. an alternative to the standard xargs, it adds features, including:
  33.  
  34.         If the standard input does not contain any nonblanks, do not
  35.         run the command.  Normally, the command is run once even if
  36.         there is no input.
  37.  
  38.         Run more than one process at a time (up to a user specified
  39.         limit).
  40.  
  41. ******************************************************************************
  42. GNU locate - list files in a database that match a pattern
  43.  
  44. For each given pattern, which can contain shell-style metacharacters,
  45. locate searches a database of file pathnames and displays the
  46. pathnames that contain the pattern.
  47.  
  48. The database contains a list of the files that were on the system
  49. whenever the database was last updated.  The frequency with which the
  50. database is updated and the directories for which it contains entries
  51. are configurable by the system administrator.
  52. .
  53. *LICENSE*
  54. GNU find is free software; you can redistribute it and/or modify
  55. it under the terms of the GNU General Public License as published by
  56. the Free Software Foundation; either version 2, or (at your option)
  57. any later version.
  58.  
  59. GNU find is distributed in the hope that it will be useful,
  60. but WITHOUT ANY WARRANTY; without even the implied warranty of
  61. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  62. GNU General Public License for more details.
  63.  
  64. The locate utility is based on James Woods' public domain fast-find
  65. code, which is also distributed with the 4.3BSD find.  
  66.  
  67. .
  68. *APPNOTES*
  69. In order for locate to do its job, the shell script "updatedb" must be
  70. run first (updatedb is stored in the "lib/locate" subdirectory of the
  71. install tree.  You may tailor the scope of the locate by tailoring the
  72. variables in the script.
  73.  
  74. You may also want to add a crontab entry to have locate run automatically
  75. at off hours.  Here at Ready-to-Run Software, we use the following
  76. crontab entries:
  77.  
  78. # Entry in /usr/spool/cron/crontabs/root on most machines
  79. # This entry runs updatedb every morning at 1:15
  80. 15 1 * * * /usr/local/bin/updatedb
  81.  
  82. # Entry in /usr/lib/crontab on DECstation
  83. # This entry runs updatedb every morning at 1:15
  84. 15 1 * * * /usr/local/bin/updatedb
  85. .
  86.  
  87. *FILEGROUP*    Grouping:Shared: Heading:Unformatted Man pages:
  88. man/man1/find.1
  89. man/man1/locate.1
  90. man/man1/updatedb.1
  91. man/man1/xargs.1
  92. man/man5/locatedb.5
  93. .
  94.  
  95. *FILEGROUP*    Grouping:Shared: Heading:Formatted Man pages:
  96. man/cat1/find.1
  97. man/cat1/locate.1
  98. man/cat1/updatedb.1
  99. man/cat1/xargs.1
  100. man/cat5/locatedb.5
  101. .
  102.  
  103. *FILEGROUP*    Grouping:Shared: Heading:Info files:
  104. slib/emacs/info/find.info
  105. slib/emacs/info/find.info-1
  106. slib/emacs/info/find.info-2
  107. .
  108.  
  109. *FILEGROUP*    Grouping:Shared: Heading:Texinfo files:
  110. texinfo/find.texi
  111. .
  112.  
  113. *FILEGROUP*    Grouping:Shared: Heading:PostScript Format Documentation:
  114. doc/find/find.ps
  115. .
  116.  
  117. *FILEGROUP*    Grouping:Shared: Heading:DVI Format Documentation:
  118. doc/find/find.dvi
  119. .
  120.  
  121. *FILEGROUP*    Required
  122. bin/find
  123. bin/locate
  124. bin/updatedb
  125. bin/xargs
  126. lib/exec/bigram
  127. lib/exec/code
  128. lib/exec/frcode
  129. .
  130.