home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / ssplit-1.3.lha / SSplit / SSplit.doc < prev    next >
Text File  |  1994-02-14  |  4KB  |  121 lines
  1.  
  2.  
  3.                                 ssplit 1.3
  4.  
  5.                     Copyright © 1992-1994 Stefan Sticht
  6.  
  7.                             All rights reserved
  8.  
  9.  
  10.  
  11.  
  12.                             ssplit is freeware
  13.  
  14.   Permission is granted to make and  distribute  verbatim  copies  of  this
  15. program's executable and documentation as you receive it,  in  any  medium,
  16. provided  that  you  conspicuously  and  appropriately  publish  only   the
  17. original, unmodified program, with all copyright notices and disclaimers of
  18. warranty intact and including all the accompanying  documentation,  example
  19. files and anything else that came with the original.
  20.  
  21.  
  22.                                 NO WARRANTY
  23.  
  24.   There is no warranty for this software package. Although the  author  has
  25. tried to prevent errors, he  can't  guarantee  that  the  software  package
  26. described in this document is 100% reliable. You are therefore  using  this
  27. material at your own risk. The author cannot be made  responsible  for  any
  28. damage which is caused by using this software package.
  29.  
  30.  
  31.                               What is ssplit?
  32.  
  33. The purpose of this small utility is to split one  big  file  into  several
  34. small files. This is helpfull if you want to copy  a  big  file  to  floppy
  35. disks, which normally wouldn't fit on one disk. ssplit splits the big  file
  36. in several smaller files, which will fit on a disk.
  37.  
  38. The small can be put together using the AmigaDOS Join programm or something
  39. similiar.
  40.  
  41. ssplit's template:
  42.  
  43.     FROM/A,TO/A,SIZE/K/N,BUFFER/K/N,DDOFS/S,DDMSDOS/S,HDFFS/S,HDMSDOS/S
  44.  
  45.  
  46. FROM: the file you want to split; no wildcards allowed
  47.  
  48. TO:   the destination directory, where the splitted files should go to;
  49.       the files are named <from-filename>.1 to <from-filename>.x;
  50.       the <from-filename> gets shortened, if the resulting filename
  51.       would be longer than 30 chars
  52.  
  53. SIZE: the size in _blocks_ of the splitted files; default is 1730 blocks,
  54.       such a file just fits on double density disk using the fastfilesystem
  55.  
  56. BUFFER: ssplit needs a buffer to read a part of the <from-file>;
  57.       the size of this buffer can be limited by BUFFER (in bytes!);
  58.       normally ssplit uses the maximum size of a splitted file or
  59.       half of the largest available memory block.
  60.  
  61. DDOFS: use 1648 blocks for the splitted files; these files will fit
  62.       on a double density "old"-filesystem disk
  63.  
  64. DDMSDOS: use 1425 blocks for the splitted files; these files will fit
  65.       on a double density MS-DOS disk
  66.  
  67. HDFFS: use 3566 blocks for the splitted files; these files will fit
  68.       on a high density disk formatted with ffs
  69.  
  70. HDMSDOS: use 3566 blocks for the splitted files; these files will fit
  71.       on a MS-DOS high density disk
  72.  
  73. The options SIZE, DDOFS, DDMSDOS, HDFFS and HDMSDOS are mutually
  74. exclusive.
  75.  
  76. some examples:
  77.  
  78. ssplit dh0:bigfile dh0: size 1000
  79.     splits the file dh0:bigfile in dh0:bigfile.1, bigfile.2, etc.;
  80.     each part of bigfile shall be 1000 blocks (= 500kB);
  81.     the size of the buffer used by ssplit will be 500kB or half of the
  82.     largest memory block available, if a continuous memory block of
  83.     500kB isn't available
  84.  
  85. ssplit dh0:bigfile dh0: size 1000 buffer 1024
  86.     same as above, but uses a buffer of 1024 bytes
  87.  
  88. ssplit dh0:bigfile dh1:
  89.     splits dh0:bigfile into dh1:bigfile.1, dh1:bigfile.2, etc.;
  90.     each dh1:bigfile.? will be 1730 blocks long (this file will
  91.     just fit on an fastfilesystem double-density-disk)
  92.  
  93. ssplit dh0:bigfile dh1: HDFFS
  94.     splits dh0:bigfile into dh1:bigfile.1, dh1:bigfile.2, etc.;
  95.     each dh1:bigfile.? will be 3566 blocks long (this file will
  96.     just fit on an fastfilesystem high-density-disk)
  97.  
  98. Join dh1:bigfile.1 dh1:bigfile.2 dh1:bigfile.3 AS dh1:bigfile
  99.     this puts the splitted files together to the old big file,
  100.     but you must put them together in the _right order_!
  101.  
  102.  
  103.                                   History
  104.  
  105. V1.1    first public version
  106. V1.2    Oh no! I forgot to initialize a variable and so
  107.         the command line options coulnd't be parsed right.
  108. V1.3    reompiled with SAS/C 6.51
  109.  
  110.  
  111.   The author can be reached at the following addresses:
  112.  
  113.     Stefan Sticht
  114.     Biberecker Weg 40a
  115.     D-94036 Passau
  116.     Germany
  117.  
  118.     EMail: sticht@edith.deg.sub.org     (Internet)
  119.            Stefan Sticht 2:2494/22.4    (Fido)
  120.  
  121.