home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / filechop-1.0.lha / FileChop-1.0 / FileChop.doc < prev    next >
Encoding:
Text File  |  1994-02-27  |  3.0 KB  |  74 lines
  1.                               FileChop
  2.                           by Charles Pham
  3.  
  4.   A while back I ran into a "large" problem. This problem consisted
  5. of a 1.5 meg file taking up space on my hard drive. I didn't want to
  6. delete it, but I wanted to get it off of the hard drive because it
  7. was so big. Unfortunately, even after using a file compressor, it
  8. still wouldn't fit on a floppy disk.
  9.   It occurred to me that if this file could be split in two, each
  10. half would easily fit on a floppy, compressed or not. It should be a
  11. mind-bendingly simple task to write a program that could do this.
  12. So...
  13.   Using FileChop is easy.  Just type "filechop <filename>
  14. [>savepath]". The program's default mode is to automatically split
  15. the file into two chunks (named "CHUNK01.<filename>" and
  16. "CHUNK02.<filename>") and store them in the savepath (or the current
  17. directory, if no savepath is specified).
  18.   Typing "filechop -sY <filename> [>savepath]" will create chunks
  19. that are Y bytes long or shorter. This is useful for a
  20. multi-megabyte file that needs to be fit onto floppies; using a
  21. value of 840000 should do the trick.  The number of chunk files
  22. created will be determined by the given size divided by the main
  23. file's size. If the number of chunks would be more than 32, you will
  24. have to give a larger value for Y.
  25.  
  26. Example: FileChop -s6000 dh1:cfiles/MyFile.c >ram:
  27.  
  28.   If you want more than two chunks, type "filechop -nX <filename>
  29. [>savepath]", where X is the number of chunks to create. The maximum
  30. value for X is 32.
  31.  
  32. Example: FileChop -n16 dh0:mystuff/MyFile.txt >dh1:t
  33.  
  34.   To glue the chunks back together again, put them all in the
  35. same directory and type "filechop -g <filename> [>savepath]".
  36.  
  37. ex: FileChop -g MyFile
  38.  
  39.   FileChop stores information about the number of chunks and their
  40. length in the chunk files themselves.  You'll be warned if the chunk
  41. files appear to be too long or too short.
  42.  
  43. CAVEATS: The ">" is required if you want to specify a save path.
  44.          Do not include the file name with the save path. The file name
  45.          is the same for the main file and chunk files and cannot be
  46.          different. If you want to change the file names, use the DOS
  47.          command Rename.
  48.  
  49.          When gluing a file back together again, DO NOT put "CHUNKxx." in
  50.          front of the file name. Just give the file name after the
  51.          "CHUNKxx."
  52.  
  53.          Try not to use very long file names as DOS will truncate file
  54.          names at 30 characters.
  55.  
  56. Technical information: chunk file header format (20 bytes):
  57.  
  58. LONG "FILE","CHOP"        ;identification tags
  59. WORD chunk #              ;this is chunk #: 1 - 32
  60. WORD total chunks         ;how many chunks were created? 2 - 32
  61. LONG this chunk's size    ;how big was this chunk?
  62. LONG original file's size ;total bytes in main file
  63.  
  64.  
  65.  
  66.   Comments? Questions? DONATIONS?  ;)
  67.  
  68.   Leave "Psyche-borg" a message at
  69.   Tycho's Computer Express: (310) 493-6402 in La Mirada, CA
  70.  
  71.   OR Write to -->  Charles Pham
  72.                    5947 Noumea
  73.                    Cypress, CA, 90630
  74.