home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / SF47.ZIP / SF.DOC next >
Text File  |  1993-08-24  |  9KB  |  297 lines
  1.  
  2.  
  3.   SuperFind v4.7 (SF) utility (c) David L. Dight, 1993.
  4.                   All Rights Reserved.
  5.  
  6.                    _______
  7.               ____|__     |                (R)
  8.            --|       |    |-------------------
  9.              |   ____|__  |  Association of
  10.              |  |       |_|  Shareware
  11.              |__|   o   |    Professionals
  12.            -----|   |   |---------------------
  13.                 |___|___|    MEMBER
  14.  
  15.  
  16.  
  17. *********************************************************
  18.  
  19.   Additional copies and licences can be obtained from:
  20.  
  21.    P.O. Box 280,  Kings Cross, N.S.W.  2010  AUSTRALIA
  22.      Phone: +61 2 331 4521,  CompuServe: 100033,2563
  23.  
  24.   Please enclose US $9.50 for p/h.
  25.  
  26.  
  27.  
  28. *********************************************************
  29.  
  30. 1.                 What is SuperFind ?
  31.  
  32.  
  33. SF is an  improved file find utility.   Most file finders
  34. require the search  specification to be  passed with each
  35. invocation.  As  each directory  is  scanned,  files  are
  36. matched  with your file spec.   SF scans one, more or all
  37. drives  once only,  after  which,  you  simply  enter the
  38. file spec interactively and SF locates those files. Since
  39. SF  is   interactive,   successive   finds  can  be  made
  40. instantly and without time penalty.
  41.  
  42. File specs can  be in the form of a familiar file name or
  43. wildcard, or  alternatively,  a  filesize,  attribute(s),
  44. a date or even a date range.
  45.  
  46. Often when searching for files,  you wish to perform some
  47. operation  on them.   Usually  you'll  have to record the
  48. results of a  find,   create a  batch  file  or some such
  49. list  and  perform  those  operations.   With  SF you can
  50. specify a command string to execute on each found file.
  51.  
  52. SF substitutes the  '$'  in  your command string with the
  53. found file name and then executes the statement. This can
  54. be useful  in  situations like  removing all *.BAK files;
  55. copying all files in  a  date range to a diskette;  start
  56. applications  and so on.   When  SF executes a statement,
  57. it firstly swaps itself out of memory,   releasing memory
  58. for the executing statement.
  59.  
  60. Output  from  SF can be redirected to a file,  printer or
  61. COM  port  from  within   the  program,   permitting  the
  62. creation of file lists.
  63.  
  64.  
  65.  
  66. *********************************************************
  67.  
  68. 2.                  Running SuperFind
  69.  
  70.  
  71. usage: SF [-h?apldq] [[d:][directory]...]
  72.  
  73. When  SF is  run from the DOS prompt with  no parameters,
  74. all  logical  drives are  scanned  by  default.   You may
  75. alternatively  specify one  or more drives to limit those
  76. drives scanned, for example:
  77.  
  78.                         sf c: a:
  79.  
  80. this may be  useful when   running SF  on a network where
  81. scanning all drives may not be desirable.
  82.  
  83. SF  automatically  detects  a  drive  not ready condition
  84. avoiding the annoying DOS error message.
  85.  
  86. You  may  specify  a  specific  directory  to  scan,  for
  87. example:
  88.  
  89.                    sf \c700 d:\source
  90.  
  91. Any number of drives or directories can be specified.
  92.  
  93. SF  accepts  a  number  of  other switchable  parameters,
  94. described below...
  95.  
  96. -h      Prints the usage and switch summary.
  97.  
  98. -?      Prints the usage message only.
  99.  
  100. -a      Specifies to search all drives (default).
  101.  
  102. -p      When  SF executes a file spec, a pause message is
  103.         generated.  The  -p  switch  suppresses the pause
  104.         message.  This is useful on multi-file operations
  105.         like copy or delete.
  106.  
  107. -l<n>   Specifes  'n'  lines  per page when listing files
  108.         (default 24 lines). For example:
  109.  
  110.                        sf c: -l43
  111.  
  112.         scans the c: drive;  when  listing SF will use 43
  113.         lines per page.
  114.  
  115. -d<n>   Specifes  'n'  entries  per   directory  scanned.
  116.         (default 1024 entries).
  117.  
  118.                         sf -n256
  119.  
  120.         SF  will   limit   itself  to  256   entries  per
  121.         directory (useful to save memory).
  122.  
  123.  
  124. -q      Suppress verbose drive scan display.
  125.  
  126.  
  127.  
  128. *********************************************************
  129.  
  130. 3.                 SuperFind Commands
  131.  
  132. Commands  are  entered at the  ':' prompt after startup.
  133. These are as follows...
  134.  
  135.  
  136. N   -   Search   for    a    file   name   or    wildcard
  137.         specification.    Any  valid   DOS  file name  or
  138.         wildcard is acceptable, for example:
  139.  
  140.                        :fd??mu?.*
  141.  
  142.  
  143. A   -   Specify one or more attributes to search for.
  144.         These are:
  145.  
  146.             Token   Attribute          Value
  147.  
  148.             A       Archive             0x20
  149.             D       sub directory       0x10
  150.             S       System              0x04
  151.             H       Hidden              0x02
  152.             R       Read Only           0x01
  153.  
  154.         for example (lower case OK):
  155.  
  156.                           :ash
  157.  
  158.         will search for files having the bits  'ASH' set,
  159.         so that a file with  'ASHR' would also be matched
  160.         and 'ASR' would not.
  161.  
  162.  
  163. D   -   Specify a a date and or time, or a date range.
  164.         SF will respond with:
  165.  
  166.                  Select <,=,> or R)ange:
  167.  
  168.         where...
  169.  
  170.             <       match  files  with   datestamps  less
  171.                     than or equal to a specified date.
  172.  
  173.             >       match files with  datestamps  greater
  174.                     than or equal to a specified date.
  175.  
  176.             =       match files with an exact datestamp.
  177.  
  178.             R       matches  file   within  an  inclusive
  179.                     date range.
  180.  
  181.         SF will then prompt you to  enter a  date or date
  182.         range.   You may  also specify a time value which
  183.         will  cause   SF  to  look  at file timestamps as
  184.         well.
  185.  
  186.  
  187. S   -   Specify a file size to search for.
  188.  
  189.  
  190. E   -   Execute a  command string for matching files.  SF
  191.         will prompt:
  192.  
  193.            Enter command to execute ($=substituted file):
  194.  
  195.         Enter  a DOS command line.  You should insert the
  196.         '$'  character  in  the  position  you  want  the
  197.         matched file to be substituted. For example:
  198.  
  199.                     xcopy $ a:\backup
  200.  
  201.         SF will then prompt you to enter...
  202.  
  203.             N)ame S)ize A)ttribute D)ate:
  204.  
  205.         which are  described above.  If  you  entered the
  206.         above command,  with the file spec set to D*.EXE,
  207.         SF would execute  the  following commands on each
  208.         find, for example:
  209.  
  210.            xcopy c:\dos\DEBUG.EXE a:\backup
  211.            xcopy c:\dos\DEFRAG.EXE a:\backup
  212.            xcopy c:\dos\DELTREE.EXE a:\backup
  213.            xcopy c:\dos\DOSSWAP.EXE a:\backup
  214.            .
  215.            .
  216.            .
  217.  
  218.         After each command  is executed,  SF  will pause,
  219.         allowing  you  to view output (press any key)  or
  220.         terminate successive executions (press 'q').
  221.  
  222.  
  223. L   -   Causes  SF  to  list  every  file  that has  been
  224.         scanned. SF will pause between each page.
  225.  
  226.  
  227. O   -   Specify  the  default output stream for  printing
  228.         matched file names or listings. Valid devices are
  229.         CON, PRN, COM.   You may also specify a file name
  230.         to redirect output to.   With no parameters, this
  231.         command  resets the  default  output to CON.   SF
  232.         will still pause between pages.   To  force SF to
  233.         list  files  continuously,   set  the page length
  234.         switch to 0, e.g.:
  235.  
  236.                          sf -l0
  237.  
  238.  
  239. Q   -   Quit.
  240.  
  241.  
  242. R   -   Force  SF  to  rescan  all  directories.   This is
  243.         useful if you have  already executed commands that
  244.         have altered  the  contents  of directory(s). e.g.
  245.         deletion or creation of files.
  246.  
  247. *   -   Print  a   brief   message  giving   details   on
  248.         distribution, site licences and donations.
  249.  
  250.  
  251. !   -   Invoke a DOS shell.   SF will swap itself  out of
  252.         memory to free all system memory to the shell.
  253.  
  254.  
  255. ?   -   Get Help on commands
  256.  
  257.  
  258.  
  259. *********************************************************
  260.  
  261. 4.                    Entry listings
  262.  
  263. When  SF  locates  file(s)  it produces a directory style
  264. listing in the following format:
  265.  
  266.  
  267.     C:\BIN
  268.         SF.EXE            77902 A       22-05-93 18:41:20
  269.  
  270. The directory in which the  file is located is printed on
  271. a  separate  line.   The  next  line consists of the full
  272. filename;  the  file  size in bytes;  the file attribute,
  273. where   A=archive,   S=system,   H=hidden,   D=directory,
  274. R=read-only; the date and time of last write.
  275.  
  276. Sub-directory  entries  will show the total size in bytes
  277. of all entries in the directory.
  278.  
  279.  
  280.  
  281. *********************************************************
  282.  
  283. 5.                     Disclaimer
  284.  
  285. SF  v4.7  IS SUPPLIED  AS IS.    THE AUTHOR DISCLAIMS ALL
  286. WARRANTIES,  EXPRESSED  OR  IMPLIED,  INCLUDING,  WITHOUT
  287. LIMITATION, THE  WARRANTIES  OF  MERCHANTABILITY  AND  OF
  288. FITNESS FOR  ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY
  289. FOR DAMAGES,  DIRECT OR  CONSEQUENTIAL, WHICH  MAY RESULT
  290. FROM THE USE OF SF v4.7.
  291.  
  292. GOOD DATA  PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM
  293. BE  THOROUGHLY   TESTED  WITH  NON-CRITICAL  DATA  BEFORE
  294. RELYING ON  IT. THE  USER MUST  ASSUME THE ENTIRE RISK OF
  295. USING THE  PROGRAM.
  296.  
  297.