home *** CD-ROM | disk | FTP | other *** search
/ Micro R&D 1 / MicroRD-CD-ROM-Vol1-1994.iso / disktools / misc / reducer10.lha / Reducer.doc < prev    next >
Text File  |  1993-02-21  |  6KB  |  158 lines
  1.                   ||=\   /== ||=\  || ||  /==  /== ||=\
  2.                   || || ||__ || || || || ||   ||__ || ||
  3.                   ||=<  ||   || || || || ||   ||   ||=<
  4.                   || ||  \== ||=/   \=/   \==  \== || || v1.0
  5.  
  6.  
  7. 0. Copyright
  8. ------------
  9.  
  10.    Reducer is placed in the Public Domain for the Amiga.  No fee is
  11. requested for its use, nor can anyone ask anything for it (except for the
  12. media).  Feel free to use it, but AT YOUR OWN RISK. I cannot be held
  13. responsible for any damage caused to your system.
  14.  
  15.  
  16. 1. Introduction
  17. ---------------
  18.  
  19.    Reducer is a program which helps you transfer files from a harddrive to
  20. floppy disks with a minimum of free blocks. Currently, there are 2 other
  21. similar program in the Public Domain: Dred and ECopy, but these programs have
  22. several shortcommings. For example, files cannot be copied via the RAD:
  23. device (Copy File to RAD:, then make a 'DiskCopy RAD: to DF0:').  With
  24. Reducer, you have the possibility to configure what will be writen in the
  25. script (that can optionally be executed) for each phase of a 'diskfill'.
  26. (see the WITH option in section 3)
  27.  
  28.  
  29. 2. Efficiency
  30. -------------
  31.  
  32. +----------+--------------+-----------+------------------+-----------------+
  33. | Nb files | Reducer Time | Copy Time |   Blocks Free    | % of block free |
  34. +----------+--------------+-----------+------------------+-----------------+
  35. |  4345    |   1h 10 min  |    28h    | 837 disks with 0 |      0.003 %    |
  36. |          |              |           |   1 disk with 33 |                 |
  37. |          |              |           |   1 disk with 10 |                 |
  38. |          |              |           |   1 disk with 1  |                 |
  39. |          |              |           |                  |                 |
  40. |   696    |     53 sec   |     4h    | 122 disks with 0 |      0.001 %    |
  41. |          |              |           |   1 disk with 3  |                 |
  42. |          |              |           |                  |                 |
  43. |   127    |      1 sec   |   44 min  |  21 disks with 0 |      0.021 %    |
  44. |          |              |           |   1 disk with 8  |                 |
  45. +----------+--------------+-----------+------------------+-----------------+
  46.  
  47. File sizes varied from 50K to 300K.
  48. All tests were made on a 68000 equiped Amiga.
  49.  
  50.  
  51. 3. How to use
  52. -------------
  53.  
  54. Usage:  Reducer [-options] [WITH <Config>] [SCRIPT <destination script>]
  55.                            FROM <directory> TO <drive> [<drive> ...]
  56.  
  57. The option are:
  58. ~~~~~~~~~~~~~~
  59.                 -m<number>  = Sets the maximum number of disks to be created
  60.                               to <number>.
  61.                               ex. -m10 -> only 10 disks will be created.
  62.                 -b<number> =  Sets the maximum accceptable number of blocks
  63.                               free on a disk.
  64.                               ex. -b5  -> only the disk with less then 6
  65.                                           blocks free will be created.
  66.                 -f<nb Block>,<nb Bytes>
  67.                             = Sets the number of blocks and the number of
  68.                               Bytes on a disk.  By default, this number
  69.                               will be set by checking the info of the first
  70.                               destination disk.
  71.                               ex. -f1756,512 -> force a full FFS disk.
  72.  
  73.                               NB.  If the number of bytes is equal to 512,
  74.                                    then the number of blocks will be
  75.                                    automaticaly reduced by one.  Because a
  76.                                    FFS disk needs 1 block free...
  77.                 -e          = Executes the script when it is finished.
  78.                               ex. -e -> Send a 'execute "<script>"'.
  79.  
  80. WITH <Config>
  81. ~~~~~~~~~~~~~
  82.    By default, Reducer searches in the current directory for 'Reducer.cfg'.
  83. If no config file is specified, the DEFAULTS are used (see below). This file
  84. tells Reducer which DOS commands to write in its script to accomplish the
  85. reducing process. It has the following format:
  86.  
  87. # Comment (Begin)
  88. # You must have at least one comment line.
  89. # ex1. Resident move
  90. # ex2. Mount RAD:
  91. # DEFAULT: 'Failat 1'
  92. <DOS command(s) to be put at the Beginning of the script>
  93.  
  94. # Comment (Before a Disk)
  95. # You can use %d for the current destination disk.
  96. # ex1. Format %d  ->  Format df0:
  97. # DEFAULT: ''
  98. <DOS command(s) to be put Before each Disk>
  99.  
  100. # Comment (Copy of a File)
  101. # You can use the %d (see above), %f (source file) or the %p (source file
  102. # without path).
  103. # ex1. Move "%f" TO "%d%p"          -> Move "dh0:file" TO "df0:file"
  104. # ex2. Copy "%f" TO "%d%p"          -> Copy "dh0:file" TO "df0:file"
  105. #      Move "%f" TO "dh0:backup/%p" -> Move "dh0:file" TO "dh0:backup/file"
  106. # DEFAULT: 'Move FROM "%s" TO "%d%p" ALL'
  107. <DOS command(s) to be put for each File to be copied>
  108.  
  109. # Comment (After a Disk)
  110. # You can use the %d.
  111. # ex. DiskCopy RAD: to %d -> DiskCopy RAD: TO df0:
  112. # DEFAULT: ''
  113. <DOS command(s) to be put After each Disk>
  114.  
  115. # Comment (After a Group of Disk)
  116. # ex. echo "Put new disk in the drives... Then click a mouse button"
  117. #     mouse -> wait until a button is pressed.
  118. # DEFAULT: 'echo "Press mouse Button"<RETURN>mouse'
  119. <DOS command(s) to be put each time you have filled all the destination Disk>
  120.  
  121. # Comment (End)
  122. # ex. Resident Move REMOVE
  123. # DEFAULT: ''
  124. <DOS commands to be put at the End of the script>
  125.  
  126. SCRIPT <destination script>
  127. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  128.    By default, Reducer will create the script in 'T:Reducer_Script'.
  129.  
  130. FROM <directory>
  131. ~~~~~~~~~~~~~~~~
  132.    Scans the directory to catch all the files and directories you want to put
  133. on disk.  If you have sub-directories, you have to use 'Move "%f" TO "%d%p
  134. ALL"' because all the file of the sub-directory will not be copied if you
  135. use 'Move "%f" TO %d%p".  ex.  'FROM dh0:File_to_put_on_disk/'
  136.  
  137. TO <drive> [<drive> ...]
  138. ~~~~~~~~~~~~~~~~~~~~~~~~
  139.    Set all the destination disk.  The maximum is 5 destinations disks.
  140. This has to be the last Arguments of the command line.
  141. ex1. 'TO df0: df1: df2:'
  142. ex2. 'TO dh0:disk1/ dh0:disk2/ dh0:disk3/'
  143.  
  144.  
  145. 4. How to contact me
  146. --------------------
  147.  
  148.    You can reach me throught standard mail post to:
  149.  
  150.                               Christian Warren
  151.                               2201, Edouard-MontPetit #11
  152.                               Montreal, Quebec, Canada
  153.                               H3T 1J3
  154.  
  155.    or by e-mail
  156.  
  157.          FIDO     1:167/151.0 Christian Warren
  158.