home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / directry / fff320 / fff.doc < prev    next >
Encoding:
Text File  |  1990-02-08  |  11.9 KB  |  228 lines
  1.                         FFF - Fast File Find
  2.  
  3. Version:   3.2.0                                                        |
  4. Date:      January 12, 1990                                             |
  5. Author:    Don A. Williams                                            
  6.  
  7. FastFileFind is a program that is functionally similar to the familiar 
  8. WHERE.  It will search on or more disks, looking for files whose names 
  9. match a specified pattern.  The major difference between FFF and other 
  10. programs of its type is that  FFF  can,  optionally,  look  for  files
  11. inside  of any of five of the more popular archive file formats,  .ARC
  12. (or &PKA),  .LZH,  .PAK,  .ZIP,  and .ZOO.  Also,  FFF is fully in the
  13. public  domain  -  no  copyrighted  code  and  all  of the source (for 
  14. Borland's Turbo C) is included.  By default,  FFF  searches  only  the 
  15. current disk and will search inside of any of the common archive files 
  16. that  it  finds.  The disk or disks to be searched can be specified on 
  17. the command line and there is a command line option  to  suppress  the 
  18. searching inside of archive files.  
  19.  
  20.        *********************  NOTICE  ************************
  21.        *  Contrary to the current trend in MS-DOS  software  *
  22.        *  this  program,  for whatever it is worth,  is NOT  *
  23.        *  copyrighted (with the exception  of  the  runtime  *
  24.        *  library  from  the C compiler)!  The program,  in  *
  25.        *  whole or in part,  may  be  used  freely  in  any  *
  26.        *  fashion or environment desired.  If you find this  *
  27.        *  program  to  be  useful  to you,  do NOT send any  *
  28.        *  contribution to the author;  in the words of Rick  *
  29.        *  Conn,   'Enjoy!'   However,   if   you  make  any  *
  30.        *  improvements,  I would enjoy receiving a copy  of  *
  31.        *  the  modified source.  I can be reached,  usually  *
  32.        *  within 24  hours,  by  messages  on  any  of  the  *
  33.        *  following Phoenix, AZ systems:                     *
  34.        *                                                     *
  35.        *     The Tool Shop BBS       [PCBOARD] [PC-Pursuit]  *
  36.        *         (602) 279-2673   1200/2400/9600 bps         *
  37.        *     Technoids Anonymous     [PCBOARD]               *
  38.        *         (602) 899-4876   300/1200/2400 bps          *
  39.        *         (602) 899-5233                              *
  40.        *         (602) 786-9131                              *
  41.        *     Inn On The Park         [PCBOARD]               *
  42.        *         (602) 957-0631   1200/2400/9600 bps         *
  43.        *     Pascalaholics Anonymous [WBBS]                  *
  44.        *         (602) 484-9356   1200/2400 bps              *
  45.        *                                                     *
  46.        *  or:                                                *
  47.        *     GEnie, mail address: DON-WILL                   *
  48.        *     CompuServ:           75410,543                  *
  49.        *                                                     *
  50.        *  Every  effort  has  been  made to avoid error and  *
  51.        *  moderately extensive testing has  been  performed  *
  52.        *  on  this  program,  however,  the author does not  *
  53.        *  warrant it to be fit for any  purpose  or  to  be  *
  54.        *  free  from  error and disclaims any liability for  *
  55.        *  actual or any other damage arising from  the  use  *
  56.        *  of this program.                                   *
  57.        *******************************************************
  58.  
  59.  
  60. USAGE:
  61.  
  62.         C:>FFF [disk_specifier(s):]pattern [pattern ....] [options]     |
  63.  
  64. The disk specifier(s) are  the  concatenation  of  the  drives  to  be 
  65. searched  and  the  pattern  are  standard  MS-DOS file name patterns, 
  66. optionally including "wild cards".  With version 3.2.0, FFF can search  |
  67. for multiple patterns in a single pass.  By default,  FFF will  search  |
  68. the "current disk" if no disks are specified on the Command line or in  |
  69. the  FFF  Environment Variable.  FFF offers one small enhancement over  |
  70. the MS-DOS pattern matching in that  it  will  allow  the  "match  any 
  71. number  of any characters" character,  "*",  to appear anywhere in the 
  72. pattern, not just at the end.  
  73.                                                                          
  74.                                                                          
  75. OPTIONS:                                                                 
  76.                                                                          
  77. FFF recognizes five options:                                            |
  78.                                                                          
  79.         -a·Reverses  the  default  setting  for  searching  inside  of  
  80.            archive files.  The FFF default is ON - to search inside of  
  81.            archive files - but may be modified by the  user  with  the  
  82.            "FFF" Environment Variable.                                  
  83.                                                                          
  84.         -v·Reverses  the  default  setting  for  the  verbose printing  
  85.            option.  The FFF default is OFF  -  do  NOT  print  verbose  
  86.            information  -  but  may  be  modified by the user with the  
  87.            "FFF" Environment Variable.                                  
  88.  
  89.         -f·Changes  the  date  format  for  the  verbose form form the  |
  90.            "military" form - DD Mon YY - to a form that can be  sorted  |
  91.            readily - YY/MM/DD.                                          |
  92.  
  93.         -p·Reverses the setting of  the  pagination  option.  The  FFF  
  94.            default  is  OFF - do not paginate every 23 lines - but may  
  95.            be  modified  by  the  user  with  the  "FFF"   Environment  
  96.            Variable.  before  continuing.  If the response is anything  
  97.            other  than  'N',  'n'  or  Ctl-C,  the  output  continues,  
  98.            otherwise the program terminates.                            
  99.  
  100.         -q·Suppresses  the  printing of the statistics on total files,  |
  101.            files matched, and archive files.                            |
  102.  
  103.  
  104. The case of the options is not significant and the  option(s)  may  be 
  105. specified either before or after the pattern specification.  
  106.  
  107.  
  108. "FFF" ENVIRONMENT VARIABLE:                                             
  109.                                                                         
  110. With  version  3.1.0,  FFF  will read an optional Environment Variable 
  111. "FFF" to establish its defaults.  The "FFF" Environment  Variable  can 
  112. set  the default disks to be searched and the default setting for each 
  113. of  the  command  line  options.   Any  disks  specified  in  the  FFF
  114. Environment Variable will override the hard-coded default of searching
  115. the  "current  disk".  Options  specified  on  the  command  line will
  116. override those set by the "FFF" Environment Variable.  
  117.                                                                         
  118.            
  119. EXAMPLES: 
  120.  
  121. On my current hard disk,  the following command will  find  all  files 
  122. whose  name  begins  with  "AC"  on the current disk,  including those 
  123. inside of ARCs,  LZHs,  PAKs,  ZIPs,  and/or ZOOs,  regardless of  the 
  124. extension: 
  125.  
  126.         C:>FFF AC*
  127.  
  128. FFF will respond with the following listing:
  129.  
  130.         FFF: FastFileFind - Version 3.2.0: January 12, 1990             |
  131.         C:\ACELST.LST
  132.         C:\ACELST
  133.         C:\ACELST.307
  134.         C:\ACELST.ZIP
  135.         C:\ACELST.ZIP--> (ACELST.301)
  136.         C:\ACELST.ZIP--> (ACELST.302)
  137.         C:\ACELST.ZIP--> (ACELST.303)
  138.         C:\ACELST.ZIP--> (ACELST.306)
  139.         C:\ACELST.ZIP--> (ACELST.307)
  140.         C:\ANYWHERE\ACANCEL.EXE
  141.         C:\ANYWHERE\ACHKSUM.EXE
  142.  
  143. The  files,  ACELST.301,  ACELST.302,  ACELST.303,   ACELST.306,   and 
  144. ACELST.307,  shown  in  parentheses  following the file ACELST.ZIP are 
  145. members of that ZIP archive file.  
  146.  
  147. To find all files on the current disk that begin with "AC" and have no  
  148. extension,  including those inside of ARCs,  LZHs,  PAKs, ZIPs, and/or  
  149. ZOOs, would require the following command:                              
  150.  
  151.         C:>FFF AC*.
  152.  
  153. which would produce the following listing:
  154.  
  155.         FFF: FastFileFind - Version 3.2.0: January 12, 1990             | 
  156.         C:\ACELST
  157.  
  158.  
  159. To search disks A and C for all files that  contain  the  letter  pair 
  160. "WH"  anywhere  if their name,  including those inside of ARCs,  LZHs,  
  161. PAKs, ZIPs, and/or ZOOs, would require the following command:           
  162.  
  163.         C:>FFF AC:*WH*
  164.  
  165. and would produce the following listing:
  166.  
  167.         FFF: FastFileFind - Version 3.2.0: January 12, 1990             | 
  168.         A:\ANYWHERE.ARC
  169.         A:\ANYWHERE.ARC--> (ANYWHERE.CNF)
  170.         A:\ANYWHERE.ARC--> (ANYWHERE.EXE)
  171.         A:\ANYWHERE.ARC--> (ANYWHERE.MNU)
  172.         A:\ANYWHERE.ARC--> (ANYWHERE.TRM)
  173.         C:\TC\UNIX\WHERE.OBJ
  174.         C:\TC\UNIX\WHERE.EXE
  175.         C:\TC\UNIX\WHERE.C
  176.         C:\DOWNLOAD\WHERE20.ARC
  177.         C:\DOWNLOAD\WHERE20.ARC--> (WHEREIS.DOC)
  178.         C:\DOWNLOAD\WHERE20.ARC--> (WHEREIS.EXE)
  179.         C:\DOWNLOAD\CONFIG20.ARC--> (WHATS.NEW)
  180.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (ISWHITE.SRC)
  181.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (SHOWHELP.SRC)
  182.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (STRIPWHT.SRC)
  183.         C:\UTIL\WH.EXE
  184.         C:\TASM\TASMSTUF.ZIP--> (IWHGLOBL.DEC)
  185.         C:\TASM\TASMSTUF.ZIP--> (WHEREIS.ARC)
  186.         C:\TASM\TASMSTUF.ZIP--> (WHUSAGE.INC)
  187.         C:\ANYWHERE\ANYWHERE.MNU
  188.         C:\ANYWHERE\ANYWHERE.TRM
  189.         C:\ANYWHERE\ANYWHERE.EXE
  190.         C:\ANYWHERE\ANYWHERE.CNF
  191.  
  192. If you wanted to search disk C:, D:, and E:  by default without having  
  193. to specify the "cde:" on the command line each time, you could set the  
  194. "FFF" Environment Variable:                                             
  195.                                                                         
  196.     SET FFF=CDE                                                         
  197.                                                                         
  198. in your AUTOEXEC.BAT.  The, if you issue the command:                   
  199.                                                                         
  200.     C:>FFF FFF*                                                         
  201.                                                                         
  202. FFF will search drives C:,  D:,  and E:  for all files beginning  with  
  203. "FFF"  regardless  of  the extension,  including those inside of ARCs,  
  204. LZHs,  PAKs,  ZIPs and/or ZOOs.  If you had set the "FFF"  Environment  
  205. Variable  as  shown  above and wanted to search only on drive C:,  for  
  206. example, you would have to enter the command:                           
  207.                                                                         
  208.     C:>FFF C:FFF*                                                       
  209.                                                                         
  210. The specification of  C:  on  the  command  line  would  override  the  
  211. defaults established by the "FFF" Environment Variable.                 
  212.                                                                         
  213. The "FFF" Environment Variable can also be used to  set  the  defaults  |
  214. for the '-a',  '-v',  '-f-,  '-p',  and 'q' command line options.  For  |
  215. example:                                                                |
  216.                                                                         
  217.     SET FFF=CDE -a                                                      
  218.                                                                         
  219. would set the default to NOT search inside of archive files.  Again, a  
  220. command line option would override the "FFF" Environment Variable.  If  
  221. you had set the  "FFF"  Environment  Variable  to  suppress  searching  
  222. inside of archives,  you could have FFF search inside of archive files  
  223. anyway with the command line:                                           
  224.                                                                         
  225.     C:>FFF FFF* -a                                                      
  226.  
  227.  
  228.