home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / bsplit13.zip / BSPLIT.DOC < prev    next >
Text File  |  1994-06-13  |  5KB  |  124 lines
  1. Documentation of BSPLIT.EXE and BCOMB.EXE
  2.  
  3.    ╔════════════════════════════════╗ ╔════════════════════════════════╗
  4.    ║              BSPLIT            ║ ║              BCOMB             ║
  5.    ║       Binary File Splitter     ║ ║       Binary File Combiner     ║
  6.    ║                                ║ ║                                ║
  7.    ║       Version 1.3 for OS/2     ║ ║       Version 1.3 for OS/2     ║
  8.    ║      (c) 1994  Klaus Topole    ║ ║      (c) 1994  Klaus Topole    ║
  9.    ╚════════════════════════════════╝ ╚════════════════════════════════╝
  10.  
  11.    BSPLIT and BCOMB are two utilities to split and combine any binary
  12.    and ASCII files. I often had the problem to somehow save large ZIP,
  13.    GIF, WAV and other large binary files on diskettes to pass them to
  14.    other computers or simply for backup purposes. That's why I wrote my
  15.    own utilities to do just that in a very efficient way.
  16.    Both utilities support HPFS.
  17.  
  18.  
  19.    BSPLIT splits any binary file into any number of smaller files of any
  20.    desired size. You can tell BSPLIT the size for each split file.
  21.    BSPLIT then splits the original file - of course without erasing it -
  22.    into the appropriate number of smaller files. BCOMB combines the split
  23.    files back to the original file. BSPLIT basically offers three
  24.    different options:     1.   Target files have size of one diskette
  25.                           2.   Diskettes in A: or B: drive are filled
  26.                           3.   Target files have user specified sizes
  27.  
  28.    The options can be specified on the command line as follows:
  29.  
  30.            Usage:   BSPLIT filename [TargetSize]
  31.  
  32.            with: TargetSize = 1.4M    for 3.5"  HD Diskettes (default)
  33.                  TargetSize = 1.2M    for 5.25" HD diskettes
  34.                  TargetSize = .72M    for 3.5"  DD diskettes
  35.                  TargetSize = .36M    for 5.25" DD diskettes
  36.                  TargetSize = A:      fill disk in A: drive
  37.                  TargetSize = B:      fill disk in B: drive
  38.            or    TargetSize = Size of target file in KByte
  39.  
  40.  
  41.    BSPLIT uses the following file nomenclature:
  42.    The characters A,B,C,.. will be appended to the extension of all
  43.    split files in consecutive order. If the source file already has a
  44.    three character extension, the last character of the file extension
  45.    will be replaced with A,B,C,.. and so forth. If any target file name
  46.    would be identical with the name of the source file, the source file
  47.    will be renamed by truncating the last character of its extension.
  48.    The file size is handled in increments of 0.5 KByte (= 512 bytes).
  49.  
  50.  
  51. Example 1:
  52.  
  53.      Source file:     TEST.ZIP     size: 1643892
  54.  
  55.      Command:         BSPLIT TEST.ZIP
  56.  
  57.      Target files:    TEST.ZIA     size: 1457664  (fits on one 3.5" disk)
  58.                       TEST.ZIB     size:  186228
  59.  
  60.  
  61. Example 2:
  62.  
  63.      Source file:     TEST.DOC     size: 1643892
  64.  
  65.      Command:         BSPLIT TEST.DOC 400
  66.        1205.4 KBytes left, input size of target file # 2 in KByte:  120
  67.        1085.4 KBytes left, input size of target file # 3 in KByte:  678
  68.         407.4 KBytes left, input size of target file # 4 in KByte:  500
  69.  
  70.      Target files:    TEST.DOA     size:  409600
  71.                       TEST.DOB     size:  122880
  72.                       TEST.DOC     size:  694272
  73.                       TEST.DOD     size:  417140
  74.      (Source file TEST.DOC renamed to TEST.DO to avoid overwriting)
  75.  
  76.  
  77.  
  78.    BCOMB combines the files created with BSPLIT to its original file.
  79.    No matter how big or how many files must be combined, BCOMB
  80.    automatically locates all split files and combines them in the
  81.    correct order from one single command. The combined file will have
  82.    the name of the split files without the last character of the file
  83.    extension. Use BCOMB on the command line as follows:
  84.  
  85.            Usage:   BCOMB filename
  86.  
  87.            with: filename = name of any split file (including extension)
  88.  
  89.  
  90. Example 1:
  91.  
  92.      Split files:     TEST.ZIA     size: 1457664
  93.                       TEST.ZIB     size:  186228
  94.  
  95.      Command:         BCOMB TEST.ZIA
  96.  
  97.      Combined file:   TEST.ZI      size: 1643892
  98.  
  99.  
  100. Example 2:
  101.  
  102.      Split files:     TEST.DOA     size:  409600
  103.                       TEST.DOB     size:  122880
  104.                       TEST.DOC     size:  694272
  105.                       TEST.DOD     size:  417140
  106.  
  107.      Command:         BCOMB TEST.DOB
  108.  
  109.      Combined file:   TEST.DOC     size: 1643892
  110.  
  111.  
  112.    I also included two icons for the utilities for your desktop. Create
  113.    a program object with your fovourite parameters to invoke the programs
  114.    simply by dragging and dropping the source file onto the icons.
  115.  
  116.    I tossed these utilities out into the shareware world. Feel free
  117.    to make copies and pass them on to friends. Please keep the doc
  118.    with the programs. For any comments you can contact me @
  119.                         Klaus Topole
  120.                         Schultheißstr. 43
  121.                         85049 Ingolstadt
  122.                         Germany
  123.                                                                  Klausi
  124.