home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DISK / FFIT14.ZIP / FFIT.DOC next >
Encoding:
Text File  |  1992-05-21  |  7.4 KB  |  175 lines
  1.  
  2.  
  3.                   FFIT ver 1.4, May 21 1992 by Kai Risku
  4.                   ======================================
  5.  
  6.  
  7. This program was made to help you copy files to disks, without
  8. having to think about how to group the files so they will take up
  9. the least number of disks. FFIT checks the size of the disks you are
  10. going to copy to, and then groups the files so they will take up the
  11. least number of disks. After this, the program will copy the files
  12. to the disks prompting you for each disk.
  13.  
  14. Several options are available to modify the way FFIT works. You can
  15. specify alphabetical sorting, no grouping (sequential copying), test
  16. mode (just print the filenames, do not copy) and more...
  17.  
  18. Please note that the sorting may take a while, so be patient when
  19. using this program. Also note that since this program copies
  20. everything to the root of the target disks, there is a limit to how
  21. many files can be placed there. As an example can be said that on a
  22. 1.44 meg diskette you can have 224 files in the root directory.
  23.  
  24.  
  25. Ok, how do I use this wonderful program..
  26. =========================================
  27.  
  28. Syntax:     FFIT [options] [filespecs..] [@listfile] drive:
  29.  
  30. The target drive must always be the last argument and it must be a:
  31. or b:, all other arguments may appear in any order. An argument
  32. starting with '-' or '/' is interpreted as an option. The filespecs
  33. can be a directory or filenames with or without wildcards.
  34. You can also put all desired filespecs (each on a separate line)
  35. in a special listfile and specify '@filename' as the filespec.
  36.  
  37. The following options can be used:
  38.  
  39.     -a          add; use the space available on the disk. If this
  40.                 option is NOT specified, the program will use the
  41.                 whole capacity of the disk, and thus require totally
  42.                 empty disks (non-empty disks will be erased after
  43.                 prompting). If the -a option is given, the program
  44.                 cannot say how many disks will be required, as this
  45.                 depends on the space available. Without this option
  46.                 the program will say how many disks is needed before
  47.                 the copying begins.
  48.  
  49.     -c          copy only files with the archive bits set. The archive
  50.                 bit will be reset after copying.
  51.  
  52.     -f          force; no prompting for permission will be done.
  53.                 Normally the program will ask when you are about
  54.                 to erase a disk or if there are read-only files that
  55.                 are about to be erased, but with this option given
  56.                 yes will be assumed without asking.
  57.  
  58.     -m          move; after a disk has been successfully copied, the
  59.                 source files will be deleted. Read-only files must be
  60.                 confirmed unless -f is given.
  61.  
  62.     -n          no grouping; the files will be copied in the same order
  63.                 as specified, changing disk when the next file won't fit.
  64.  
  65.     -s          sort alphabetical; the files will be copied in
  66.                 alphabetical order on the disks.
  67.  
  68.     -t          test; do not write or delete anything, just simulate
  69.                 and print all texts as it would normally appear.
  70.  
  71.     -u           uppercase; print all filenames in uppercase.
  72.  
  73.     -v size     fit files to the specified volume size. The numeric
  74.                 argument can be suffixed with 'k' or 'M', meaning
  75.                 kilo (times 1024) or Mega (times 1024*1024).
  76.                 If the specified size is negative, that much free
  77.                 space will be left on the disks.
  78.  
  79. Options can be combined, and several options can also be specified
  80. after the same '-' or '/', e.g. /musa is totally legal.
  81.  
  82. You can specify as many filenames you wish, and they may contain
  83. wildcards. If you want to copy a whole directory, you can simply
  84. specify the name of the directory (no wildcards allowed if
  85. specifying only a directory name). Files that are larger than the
  86. target disk, as well as non-existent files, will be skipped.
  87.  
  88.  
  89. Some useful examples:
  90. =====================
  91.  
  92. FFIT -t \misc\texts \temp\*.doc b:
  93.  
  94.         This test-fits all files in the directory \misc\texts and all
  95.         files matching \temp\*.doc to the drive b:. Nothing will be
  96.         copied, but the program will tell you how many disks you are
  97.         going to need as well as which files are put on which disks.
  98.  
  99. FFIT -fms . a:
  100.  
  101.         All files in the current directory will be fitted to a:.
  102.         The files will be copied in alphabetical order (-s), and after
  103.         each disk has been successfully copied, the source files will
  104.         be deleted (-m) without asking for permission even if some
  105.         files are read-only (-f).
  106.         NOTE! Because the option -a was NOT specified, the target disks
  107.         must be empty, and FFIT will ask you for permission to do so
  108.         if it finds anything on the disks.
  109.  
  110. FFIT -a -n -u c:\foo\*.arj b:
  111.  
  112.         The matching files are added (-a) to the disk(s) in drive b:.
  113.         No files already existing on the disks will be removed!
  114.         Because of this, FFIT cannot know in advance how many disks
  115.         will be needed to copy all files. You can use the test option
  116.         (-t) to achieve this. Files are copied in the same order as
  117.         specified (-n) and all filenames are printed in uppercase (-u).
  118.  
  119. FFIT -cv 720k c:\backups\*.zip a:
  120.  
  121.         The matching files whose archive bits are set (-c) will be fitted
  122.         to a: copying no more than 720 Kb to each disk (-v 720k).
  123.         After each file has been copied, its archive bit will be reset.
  124.  
  125. FFIT -a -v -10000 foo.* a:
  126.  
  127.         The matching files will be added to the disk(s) in drive a:
  128.         leaving at least 10000 bytes of free space on each disk.
  129.  
  130.  
  131. As you may have noticed, there are many options and they can be freely
  132. combined to obtain the desired result. If you think you need yet another
  133. option which I haven't so far implemented, please tell me about it!
  134.  
  135.  
  136. Revision history
  137. ================
  138.  
  139. Version 1.4:    Possibility to shell to dos. Listfiles implemented.
  140.                 Added progress indicators while copying files.
  141.                 Added options 'c' and 'v'. Name changed from
  142.                 'fit' to 'ffit' because there already existed a
  143.                 program named 'fit'.
  144. Version 1.3:    Possibility to break (cont, accept or quit) during
  145.                 fit. Fixed 'bytes left'-bug. Added code selfcheck.
  146. Version 1.2:    Added add and move option and printing of bytes
  147.                 left on each diskette after copying. Increased stack
  148.                 size, because the program could sometimes crash
  149.                 when the algorithm recursed deep enough.
  150. Version 1.1:    Added alphabetical sorting.
  151. Version 1.0:    Initial release of program.
  152.  
  153.  
  154.  
  155. #include <std_disclaimer.h>:
  156. ============================
  157.  
  158. This program is freely distributable. You can share it with all your
  159. friends as long as you don't request money for it, or modify this
  160. program in any way without permission from the author. The author
  161. of this program will under no circumstances be held responsible for
  162. whatever may happen when you use this program.
  163.  
  164. If you have any questions, ideas, suggestions for improvements or if
  165. you are interested in the source then feel free to contact me...
  166.  
  167. A nice postcard would be appreciated!
  168.  
  169.  
  170. Snailmail:      Kai Risku         Email (internet):  Kai.Risku@hut.fi
  171.                 Kronvik
  172.                 65410 Sundom
  173.                 Finland
  174.  
  175.