home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / s / support / ReadMe
Text File  |  1995-02-05  |  9KB  |  210 lines
  1.  
  2.                            ==========================
  3.                            Splitf/Joinf  Version 1.13
  4.                            ==========================
  5.  
  6.  ****************************** Copyright Notice ******************************
  7.  *                                                                            *
  8.  *   This software is copyright Adam Hamilton.                                *
  9.  *   Permission to use, copy, and distribute splitf, joinf and the source     *
  10.  *   code, for non-commercial purposes, is hereby granted, provided:-         *
  11.  *                                                                            *
  12.  *     • No charge is made other than to cover the cost of the medium.        *
  13.  *                                                                            *
  14.  *     • All files and documents are included in the distribution unaltered.  *
  15.  *                                                                            *
  16.  *   You may upload this software to a Bulletin Board, or include it in       *
  17.  *   your Public Domain library. If you do this, please try and let me        *
  18.  *   know, so I can keep you up to date with any future changes.              *
  19.  *   The authors permission must be obtained before this software is          *
  20.  *   included on any magazine disk, or with any other software.               *
  21.  *                                                                            *
  22.  *   You may not sell this software, or use it otherwise for personal gain.   *
  23.  *                                                                            *
  24.  *   If you change any part of this software, you must obtain permission      *
  25.  *   from the author, before distribution.                                    *
  26.  *                                                                            *
  27.  *   This program is supplied 'as is' with no guarantee of its suitability    *
  28.  *   for any purpose. I will not be held responsible for any damage arising   *
  29.  *   from the use or misuse of this software.                                 *
  30.  *                                                                            *
  31.  *   I reserve the right to change these terms and conditions at any time.    *
  32.  *                                                                            *
  33.  ******************************************************************************
  34.  
  35.  
  36. Contacting The Author
  37. ~~~~~~~~~~~~~~~~~~~~~
  38.  
  39.    Bug reports, comments and any donations may be sent to me, the author,
  40.    at this address :-
  41.  
  42.              Adam Hamilton,
  43.              23 Northmeadow Road,
  44.              Cricklade,
  45.              Swindon,
  46.              Wiltshire,  SN6 6LT,
  47.              England.
  48.  
  49.    I may also be contacted by E-Mail:    aph@swindon.gpsemi.com
  50.  
  51.  
  52. ================================================================================
  53.  
  54. 1  Introduction
  55.  
  56.    Splitf and Joinf were written to support the Acorn desktop application
  57.    !Split. The purpose of these programs is to ease the transportation of large
  58.    files from one computer to another. No attempt to compress the file is made,
  59.    as it is assumed this has already been done. Splitf will split a file into a
  60.    number of smaller files, and Joinf will join them again when required.
  61.  
  62.  
  63.  
  64. 2  How To Use Splitf
  65.  
  66.    Usage : Splitf [options] <filename>
  67.  
  68.    Options supported are outlined below (they may be abbreviated):-
  69.  
  70.    -filesize n          Where n is the maximum size of each part in K (1024
  71.                         bytes).
  72.  
  73.    -buffersize n        Where n is the buffer size in K (1024 bytes)¹.
  74.  
  75.    -path p              Where p is the path (absolute or relative) to put the
  76.                         parts.
  77.  
  78.    -interactive         This option allows you to specify a different
  79.                         destination for each part. This is useful if saving
  80.                         directly to several floppy disks.
  81.  
  82.    For example, if we have a file called 'Picture' 2 Mbytes long and we want
  83.    to split it up to fit on two 1.44 Mb DOS formatted floppy disks. We would
  84.    use the following command:-
  85.  
  86.    Splitf -f 1423 -b 1024 -i Picture
  87.  
  88.    This uses 1 Mb of RAM for a buffer¹, and would prompt you for each path,
  89.    allowing you to change floppy disks in between.
  90.  
  91.  ¹ This option is not available on the PC version.
  92.  
  93.  
  94.  
  95. 3  How To Use Joinf
  96.  
  97.    Usage : Joinf [options] <filename>
  98.  
  99.    -buffersize n        Where n is the buffer size in K (1024 bytes)¹.
  100.  
  101.    -filename f          Where f is the new name of the file.
  102.  
  103.    -interactive         This option allows you to specify a different location
  104.                         of each part.
  105.  
  106.    -info                This option just provides you with information about the
  107.                         files without actually joining them.
  108.  
  109.    For example, if we want to join the two files in the above example, we would
  110.    use the command:-
  111.  
  112.    Joinf -b 512 -i A:Picture01
  113.  
  114.    Note that A:Picture01 is the filename of the first part.
  115.  
  116.  ¹ This option is not available on the PC version.
  117.  
  118.  
  119.  
  120. 4  Compiling The Source Code
  121.  
  122.    To compile the source code, you'll need an ANSI C compiler. You must copy the
  123.    config file to suit your machine, to 'config.h'. There are four supplied, if
  124.    none of these match your machine, take a look inside them, it shouldn't be
  125.    too hard to work out what the bits mean. If you have any problems just ask.
  126.  
  127.    I have provided executable files for a number of machines, just in case you
  128.    don't have access to a compiler.
  129.  
  130.  
  131.  
  132. 5  History
  133.  
  134.    • Version 1.00-1.08  These were the original command line versions compiled
  135.                         on several different computers.
  136.  
  137.    • Version 1.10       This version has a new file format, a header is put at
  138.                         the beginning of each part, and is used to join files in
  139.                         the correct order. This version is compatible with the
  140.                         desktop version (2.00 and greater).
  141.  
  142.    • Version 1.11       Slightly increased memory allocation for filenames, and
  143.                         added a small check needed for DEC Ultrix compilers.
  144.  
  145.    • Version 1.12       Added -interactive option to allow direct reading and
  146.                         writing of floppy disks. This option enables different
  147.                         paths to be given for each part, removing the need, for
  148.                         example, to load all the parts onto the hard disk before
  149.                         joining.
  150.  
  151.    • Version 1.12c      Supports official Acorn filetype.
  152.  
  153.    • Version 1.13       Modified the Acorn specific bits to speed up file
  154.                         access. Also tidied and commented the code a lot more.
  155.                         NOTE: The only executables changed from version 1.12
  156.                         are the Acorn ones, therefore I have only compiled
  157.                         this version for these machines.
  158.  
  159.  
  160.  
  161. 6  Files supplied
  162.  
  163.    The following files are supplied:-
  164.  
  165.    Source (directory)   Contains...
  166.      Splitf.c           Source for Splitf.
  167.      Joinf.c            Source for Joinf.
  168.      acorn.h            Config file for Acorn machines.
  169.      pc.h               Config file for PCs.
  170.      unix.h             Config file for UNIX platforms.
  171.      vax.h              Config file for VAX/VMS machines.
  172.  
  173.    ACORN   (directory)  Contains executables for Acorn machines.
  174.    ALPHA   (directory)  Contains executables for DEC Alpha machines.
  175.    HP-UX   (directory)  Contains executables for HP PA-Risc workstation.
  176.    LINUX   (directory)  Contains executables for LINUX.
  177.    NeXT    (directory)  Contains executables for NeXT machines.
  178.    OS9     (directory)  Contains executables for OS9.
  179.    PC      (directory)  Contains executables for DOS.
  180.    RS6000  (directory)  Contains executables for AIX on IBM RS6000 machines.
  181.    SGI     (directory)  Contains executables for Silicon Graphics machines.
  182.    SUN     (directory)  Contains executables for SunOS.
  183.    ULTRIX  (directory)  Contains executables for DEC ultrix machines.
  184.    VAX     (directory)  Contains executables for VAX/VMS.
  185.  
  186.  
  187.  
  188. 7  Acknowledgments
  189.  
  190.    Thanks to the following people for compiling Splitf and Joinf on machines I
  191.    don't have access to:-
  192.  
  193.      Graham Jones (graham@robots.ox.ac.uk