home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 32 / hot34.iso / ficheros / DUTI / SPLITV12.ZIP / README.1ST next >
Text File  |  1998-03-27  |  5KB  |  150 lines
  1. ***************************** Pro Splitter v1.2***************************
  2.  
  3. This little piece of software, yet simple but powerful, will allow 
  4. you to move large files from one computer to the next by splitting
  5. them into smaller pieces.
  6.  
  7.  
  8. FILES
  9. -----
  10. splitv12.exe      -  MSDOS executable
  11. splitv12.c        -  The source code in C.
  12. readme.1st        -  This file your reading.
  13.  
  14.  
  15. DESCRIPTION
  16. -----------
  17. This is a command line based piece of software where all commands
  18. are entered within the shell after the name of the program.
  19. This program will allow you split large files into desired sized
  20. parts. This program will also rejoin the pieces and perform a
  21. checksum to verify that the original file has been created
  22. successfully.
  23.  
  24. The pieces will be named with numbers starting with 001,002,003 ....
  25. and so on. An additional file called 000.CHK will be created containing
  26. vital information for checksum and rejoining purposes.
  27.  
  28. Once the pieces are joined successfully, it will create the original 
  29. file with the original filename.
  30.  
  31. So for example;
  32. If we need to split a file called ANONYMOUS.ZIP, which is 4.5 Mb,into
  33. 1MB pieces the Splitter will make the following files;
  34.  
  35. 001.CHK        - Checksum info about file (5-9 bytes in size)
  36. 001            - 1st piece (1Mb in size)
  37. 002            - 2nd piece (1Mb in size)
  38. 003            - 3rd piece (1Mb in size)
  39. 004            - 4th piece (1Mb in size)
  40. 005            - 5th piece (0.5Mb in size)
  41.  
  42. Total size = 4.5 Mb
  43.  
  44.  
  45. Once the Splitter is used to join the pieces it will reconstruct
  46. the original program from the pieces and name it ANONYMOUS.ZIP
  47.  
  48.  
  49. USAGE
  50. -----
  51. NOTE : You must firstly compile the source code in a decent compiler
  52. before you will be able to use it.
  53.  
  54. splitv12 -[s/m/h] [size] [filename] [Number of 1st piece (Default is 001)]
  55.  
  56.    -s         Used to specify that the splitter is going to be used to
  57.               split a file.
  58.  
  59.    -m         Used to specify that the splitter is going to be used to
  60.               construct a file from the pieces.
  61.  
  62.    -h         Help on usage.
  63.  
  64.    [size]     Size of pieces (in bytes).For convenience commonly used
  65.               values can be specified with one digit, these values are;
  66.               1 - 1.2Mb
  67.               2 - 700Kb
  68.               3 - 320Kb
  69.               4 - 60Kb
  70.  
  71.    [filename] Name of file to split.
  72.  
  73.    [Number of 1st piece (Default is 001)] To be able to split more than one file
  74.                       in the same directory you can specify 
  75.                       the number to start splitting from. So
  76.                       is you specify 8 it will create;
  77.                          008.CHK, 008 , 009, and so on.
  78.  
  79. Examples;
  80. Splitting a file into 1.2Mb pieces
  81.  
  82.  splitv12 -s 1200000 anyfile.doc
  83. or
  84.  splitv12 -s 1 anyfile.doc    (the value 1 is used to specify 1.2Mb as
  85.                                a common value. SEE ABOVE)
  86. or
  87.  splitv12 -s 1200000 anyfile.doc 1
  88.  
  89.  
  90. Joining the file
  91.  
  92.  splitv12 -m[number of 1st piece]
  93.  
  94. so in the above example
  95.  splitv12 -m (if no value entered 1 is taken as default!!)
  96. or
  97.  splitv12 -m 1
  98.  
  99.  
  100. Getting help
  101.  
  102.  splitv12 -h
  103.  
  104.  
  105. IMPROVEMENTS FROM PREVIOUS v1.1
  106. -------------------------------
  107. * Better and faster code used.
  108. * Better algorithyms used for splitting files.
  109. * Recreates files with the same name as they had at the begining.
  110. * The ability to split various files in the same directory without
  111.   ovewriting exiting parts.
  112. * More features introduced to trap errors and user mistakes.
  113.  
  114. KNOWN BUGS
  115. ----------
  116. No bugs at the present moment reported but feel free to e-mail me if you find 
  117. any.
  118.  
  119. Works perfectly splitting and rejoining files in all other platforms, e.g. Unix,
  120. Linux, Mac, etc......
  121.  
  122.  
  123.  
  124. ACKNOWLEDGEMENT and all the rest.....
  125. ------------------------------------
  126. This program was written by me, Oscar Agra, using Turbo C and GCC
  127. compilers so should compile properly in any of these.
  128.  
  129. This software can be freely distributed with the condition that
  130. it is not modified in any way and MUST be accompanied by this
  131. text file.
  132.  
  133. I have decided to publish this software as POSTCARDWARE which
  134. means(for all of you who do not know!) that if you use it you
  135. must send me a postcard acknowledging that you have used it to
  136. the following address.
  137.  
  138. Oscar Agra
  139. 92 Palermo Road
  140. London NW10 5YN
  141.  
  142. Feel free to send an e-mail (o.agra@cs.ucl.ac.uk) telling me what you 
  143. think or any suggestions which might improve this program.
  144.  
  145. Get upgrades and support from my web-page;
  146. http://www.cs.ucl.ac.uk/students/o.agra
  147.  
  148.  
  149.                 ()sc/\r        :-)
  150. 27/03/98