home *** CD-ROM | disk | FTP | other *** search
/ Cool Page Magazine 16 / CoolPage_16.iso / tools / ffit.doc < prev    next >
Text File  |  1992-12-06  |  18KB  |  427 lines
  1.  
  2.  
  3.               FFIT ver 1.62, December 1992 by Kai Risku
  4.               =========================================
  5.  
  6. This program was made to help you copy files to disks, without having to
  7. think about how to group the files so they will take up the least number
  8. of disks. This problem is often referred to as the 'The Knapsack
  9. Problem'. FFIT checks the size of the disks you are going to copy to and
  10. then combines the files so they will fill the disks optimally. After
  11. this, the program will copy the files to the disks prompting you for
  12. each disk.
  13.  
  14. Several options are available to modify the way FFIT works. You can
  15. specify alphabetical sorting, no grouping (sequential copying), wanted
  16. volume size, how much space you want to leave free on the disks, only
  17. use files with archive bit set, test mode (just print the filenames, do
  18. not copy), and much more. 4DOS/NDOS file descriptions are also handled.
  19.  
  20. Please note that the sorting may take a while, so be patient when using
  21. this program. Also note that since this program copies everything to the
  22. root of the target disks, there is a limit to how many files can be
  23. placed there. As an example can be said that on a 1.44 Mb diskette you
  24. can have 224 files in the root directory. This program will not check
  25. the maximum number of files that may be placed in the root directory.
  26. Therefore you might get an 'Error copying file' if the program tries to
  27. copy too many files to one disk.
  28.  
  29.  
  30. Ok, how do I use this wonderful program..
  31. =========================================
  32.  
  33. Syntax:     FFIT [options] [filespecs..] [@listfile] target:
  34.  
  35. The target drive must be a removable medium. Arguments may appear in any
  36. order. An argument starting with '-' or '/' is interpreted as an option.
  37. The filespec can be one or more directories or filenames with or without
  38. wildcards. You can also put all desired directories or filenames (each
  39. on a separate line) in an ordinary textfile and specify '@filename' as
  40. the filespec.
  41.  
  42. FFIT is fully compatible with 4DOS/NDOS file descriptions.
  43. When using FFIT all descriptions will be dealt with automagically.
  44.  
  45. The following options can be used:
  46.  
  47.  
  48. -a          add
  49. ===============
  50.  
  51.     Use the space available on the disk. If this option is NOT
  52.     specified, the program will use the whole capacity of the disk, and
  53.     thus require totally empty disks (non-empty disks will be erased
  54.     after prompting the user for permission).
  55.  
  56.     You MUST use this option if you want to to add files to a disk where
  57.     there are already some files! If the -a option is given, the program
  58.     cannot say how many disks will be required, as this depends on the
  59.     space available. Without this option the program will say how many
  60.     disks is needed before the copying begins.
  61.  
  62.  
  63. -b          sort big files first
  64. ================================
  65.  
  66.     If you specify this option all files will be sorted according to
  67.     size, biggest first. By using this option, the disks can get a
  68.     little bit better filled. If you are fitting to many disks, the
  69.     difference between using this option or not, usually means that the
  70.     second last disk might not be perfectly filled.
  71.  
  72.     The drawback of using this option is that because all big files are
  73.     sorted first, the last disks are filled with lots of small files. Do
  74.     not use this option if you want your files evenly spread among the
  75.     disks.
  76.  
  77.  
  78. -c          archive bits
  79. ========================
  80.  
  81.     Copy only files with the archive bit set. The archive bit will be
  82.     reset after the file has been copied. This could be useful if you
  83.     have lots of files but only a limited number of disks and you are
  84.     not able to copy all files at once. Set the archive bit on all files
  85.     and then use this option. At a later time you can restart FFIT and
  86.     copy the files that has not already been copied.
  87.  
  88.  
  89. -d n        start with disk number n
  90. ====================================
  91.  
  92.     This is useful if you have aborted the program and wish to continue
  93.     from a given disk. The space between d and the number can be left
  94.     out. This option cannot be used together with option -a.
  95.  
  96.  
  97. -f          force
  98. =================
  99.  
  100.     No prompting for permission will be done. Normally the program will
  101.     ask when you are about to erase a disk, overwrite files or if there
  102.     are read-only files that are about to be erased, but with this
  103.     option given no questions will be asked. Could be dangerous!
  104.  
  105.  
  106. -m          move
  107. ================
  108.  
  109.     After a disk has been successfully copied, the source files will be
  110.     deleted. You will be asked to confirm every read-only file unless
  111.     option -f is given.
  112.  
  113.  
  114. -n          no grouping
  115. =======================
  116.  
  117.     The files will be copied in the same order as specified, one at a
  118.     time and requesting a new disk when the next file won't fit.
  119.  
  120.  
  121. -q          quiet
  122. =================
  123.  
  124.     Just a silly little option to generate absolutely quiet beeps.
  125.  
  126.  
  127. -s          sort alphabetical
  128. =============================
  129.  
  130.     The files will be copied in alphabetical order to the disks.
  131.     Normally this will just result in a nicer directory listing, but if
  132.     used together with the option -n, all filenames will be globally
  133.     sorted.
  134.  
  135.  
  136. -t [size]   test mode
  137. =====================
  138.  
  139.     Do not write or delete anything, just simulate and print all texts
  140.     as they would otherwise appear. This is very useful if you want to
  141.     know in advance which files will go on which disks.
  142.  
  143.     You may also specify an optional argument. This argument must then
  144.     be one of the following: 160, 180, 320, 360, 720, 120, 144. Normally
  145.     FFIT will always examine the target disk to see what capacity it is,
  146.     but by using this argument you can set a disksize to use. In this
  147.     case you do not need to have a disk in the target drive, which could
  148.     come in handy when you just want to test. In this case the target
  149.     drive can be omitted from the command line.
  150.  
  151.  
  152. -u          uppercase
  153. =====================
  154.  
  155.     Print all filenames in UPPERCASE. This has only aesthetical value
  156.     and will make very loud filenames.
  157.  
  158.  
  159. -v size     volume size
  160. =======================
  161.  
  162.     Fit files to the specified volume size. The numeric argument can be
  163.     suffixed with 'k' or 'M', meaning kilo (times 1024) or Mega (times
  164.     1024*1024). You can also use a decimal point, as in 1.2M which then
  165.     means 1.2*1024*1024 bytes.
  166.  
  167.     If the specified size is negative, that much free space will be left
  168.     on each disks. The space between v and size can be left out.
  169.  
  170.  
  171. Options can be combined, and several options can also be specified after
  172. the same '-' or '/'. The only exception is that no more options can be
  173. combined after a numeric argument. In that case you must start with a
  174. new '-' or '/'.
  175.  
  176. Example: If you want to give the options add, sort, start with
  177.          disk number 3 and test mode, all the following is legal:
  178.                  -a -s -d3 -t
  179.                  /astd3
  180.                  -as -d 3 -t
  181.         But you cannot use: -asd3t   since you cannot place any
  182.         option characters immediately after the '3'.
  183.  
  184.  
  185. You can specify as many filenames you wish, and they may contain
  186. wildcards. If you want to copy a whole directory, you can simply
  187. specify the name of the directory. Files that are larger than the
  188. target disk, as well as non-existent files, will be skipped.
  189.  
  190.  
  191. Run-time options and what is happening
  192. ======================================
  193.  
  194. When FFIT is started, all given filenames must first be processed. This
  195. involves getting the name, size and eventuelly a 4DOS/NDOS description.
  196. While this is happening, an indicator will indicate (what else should an
  197. indicator do?) that the program is doing some work. Depending on the
  198. number of files and the speed of the computer, this can take some time.
  199.  
  200. After this is done, you will se how the fitting proceeds. Starting with
  201. disk number one, the program will display a number of bytes which should
  202. be rapidly decreasing. This indicates how many bytes from the target
  203. siz