home *** CD-ROM | disk | FTP | other *** search
/ The Amiga Game Guide / AmigaGameGuide_CD.iso / PC / Tools / chunker / chunker.doc < prev    next >
Text File  |  1977-12-31  |  11KB  |  316 lines
  1.       ______________      ______________
  2.      /             /     /_/_/_/_/_/_/_/   Chunker 1.7 <--> DeChunk 1.7
  3.     /             /     /_/_/_/_/_/_/_/
  4.    /             /     /_/_/_/_/_/_/_/     A portable method of splitting
  5.   /             / <-> /_/_/_/_/_/_/_/      and joining files.
  6.  /             /     /_/_/_/_/_/_/_/
  7. /_____________/     /_/_/_/_/_/_/_/        Copyright ©1996 Lee Kindness.
  8.  
  9.  
  10. Chunker:
  11. Compiled           Thursday 18 April 1996 11:59:26
  12. Amiga Exe size     4432 bytes
  13. Amiga 1.3 size     9780 bytes
  14. MSDOS Exe size     13412 bytes
  15. Version            Chunker 1.7 (18/04/96)
  16.  
  17. DeChunk:
  18. Compiled           Thursday 18 April 1996 11:59:12
  19. Amiga Exe size     4308 bytes
  20. Amiga 1.3 size     9680 bytes
  21. MSDOS Exe size     13261 bytes
  22. Version            DeChunk 1.7 (18/04/96)
  23.  
  24. Distribution built Thursday 18 April 1996 12:13:57
  25.  
  26.  
  27.  LEGAL
  28. -=====-
  29.  
  30.  Disclaimer
  31.  ~~~~~~~~~~
  32.  I hereby reject any liability or responsibility for these or any
  33.  other consequences from the use of Chunker whatsoever. This includes,
  34.  but is not limited to, damage to your equipment, to your data,
  35.  personal injuries, financial loss or any other kinds of side effects.
  36.  Although Chunker has been tested thoroughly on several different
  37.  machines, I cannot rule out the possibility that Chunker:
  38.  
  39.      1. is somehow incompatible to your equipment
  40.      
  41.      2. has bugs that show up on your equipment
  42.      
  43.      3. does not do what it is supposed to do on your equipment
  44.      
  45.      4. May damage you equipment
  46.  
  47.  It is your responsibility to take any precautions necessary to
  48.  protect yourself from these or any other effects. I explicitly
  49.  reject any liability or responsibility from the consequences of you
  50.  using Chunker
  51.  
  52.  Distribution
  53.  ~~~~~~~~~~~~
  54.  
  55.  Chunker may be freely distributed and copied, as long as the following 
  56.  conditions are fulfilled:
  57.  
  58.      1. All parts of the program and the documentation must be complete.
  59.         The distribution of single parts or incomplete subsets of the
  60.         original distribution is forbidden.
  61.         
  62.      2. If Chunker is to be included in a commercial distribution (including
  63.         magazines!) then I must be sent a copy of the product (or if it is a 
  64.         mag that I am subscribed to then an increase in subscription). It 
  65.         would be better if you contacted me beforehand to ensure you have the 
  66.         latest version. In any case full credit must be given within the
  67.         magazine (ie mention my name).
  68.      
  69.      3. If the included source code is used in another program then credit 
  70.         must be given in the documentation.
  71.  
  72.  Note To Magazines
  73.  ~~~~~~~~~~~~~~~~~
  74.  
  75.  In the past I have had some of my programs included on magazine coverdisks
  76.  without my permission when in the documentation it was stated that this
  77.  was required... I want my programs on coverdisks but you _MUST_ read and
  78.  fufil the "Distribution" section above. If you disagree then contact me
  79.  or write a message in the AMIGA_MAGS echo...
  80.  
  81.  
  82.  COMPILATION
  83. -===========-
  84.  
  85.  This archive includes versions of Chunker and DeChunk for the Amiga (chunker
  86.  and dechunk for 2.0 and higher, chunker13 and dechunk13 for 1.2 and higher)
  87.  and MSDOS (CHUNKER.EXE and DECHUNK.EXE). The ANSI C source code is included
  88.  in the source drawer. This source should complile with all ANSI C compilers.
  89.  To compile the unix version simply type 'make' in the source directory. The 
  90.  makefile does the following:
  91.  
  92.    CC -O2 -o chunker chunker.c machine.c bfn.c
  93.    CC -O2 -o dechunk dechunk.c machine.c bfn.c
  94.       ### ##########
  95.        |      \
  96.  turns |       \ specifies the name of the compiled program
  97.  on level        to create.
  98.  2 optimisation
  99.  
  100.  By default the (Unix) makefile uses the "CC" compiler - you may wish to
  101.  change this to "gcc" for example, see the makefile for more info
  102.  
  103.  
  104.  USAGE
  105. -=====-
  106.  
  107.  Chunker is used to split a file up into smaller pieces. It expects the
  108.  following arguments:
  109.  
  110.    chunker <file> <basename> <size>
  111.  
  112.  file: Name of the file to split.
  113.  
  114.  basename: The created split files will have this as their base name. For
  115.     example if you had "ding" as basename then the created files would
  116.     be:
  117.         ding.000
  118.         ding.001
  119.         :
  120.         :
  121.         ding.XXX
  122.     Note that the XXX part is a 3 part hexadecimal number.
  123.  
  124.  size: Size (in bytes) of the created chunks.
  125.  
  126.  For example:
  127.  
  128.    chunker bigfile.gz bigfile 716800
  129.  
  130.  would split the file 'bigfile.gz' into 700k chunks with a basname of
  131.  'bigfile'.
  132.  
  133.  
  134.  DeChunk will reassemble the chunks output by Chunker into the original
  135.  file. It expects the following arguments:
  136.  
  137.    dechunk <outputfile> <basename>
  138.  
  139.  outputfile: Name of the file to create.
  140.  
  141.  basename: The basename of the split files. For example if the first of the 
  142.     split files is called "ding.000" then use "ding". This should be the
  143.     same as you passed as basename to Chunker.
  144.  
  145.  
  146.  NOTE the Amiga join or Unix cat commands could be used rather than dechunk,
  147.  if you're a masochist that is ;)
  148.  
  149.  NOTE that the amiga 2.0 version accepts arguments in the normal ReadArgs
  150.  format, just type 'chunker ?' and 'dechunk ?' for the template. The
  151.  Amiga versions are also pure and reentrant, and as such can be made
  152.  resident.
  153.  
  154.  
  155.  CONTACT
  156. -=======-
  157.  
  158. Means of contact, as of Thursday 18 April 1996
  159.  
  160. Mail:
  161.   Lee Kindness
  162.   8 Craigmarn Road
  163.   Portlethen Village
  164.   Aberdeen AB1 4QR
  165.   SCOTLAND
  166.  
  167. EMail:
  168.   cs2lk@scms.rgu.ac.uk
  169.   wangi@frost3.demon.co.uk
  170.   wangi@spuddy.mew.co.uk
  171.   wangi@fido.zetnet.co.uk
  172.   :
  173.   :
  174.   Please use cs2lk@scms.rgu.ac.uk
  175.  
  176. Fidonet:
  177.   2:259/15.46
  178.   2:250/366.34
  179.  
  180. Amiganet:
  181.   39:138/40.34
  182.  
  183. And why not have a look at my web page:
  184.  
  185.   http://www.scms.rgu.ac.uk/students/cs_yr94/lk
  186.  
  187. It has a wide range of Amiga and Fidonet links...
  188.  
  189. The initial concept and code for Chunker was by Evan Tuer. You can email
  190. Evan at alienz@freenet.hut.fi. Of course he also came up with the name...
  191.  
  192.  
  193.  LATEST VERSION
  194. -==============-
  195.  
  196.  The latest version of Chunker can always be found on:
  197.  
  198.        _____
  199.       /_____)
  200.      /(___________________________________
  201.     / _____________  ___________________  )
  202.    / /            / (_                  \/   +44-(0)1484-842341
  203.   (__) r o s t   / ___) r e e
  204. \               / /                         Fidonet --- 2:250/366
  205.  \              \/   A m i g a  B B S       Amiganet -- 39:138/40
  206.   \
  207.    \-> Sysop Dave Naylor
  208.     \-> Using Zeus BBS software!
  209.      \-> The biggest UK Amiga BBS
  210.       \-> Points welcome
  211.        \-> Email!
  212.         \-> 24 hours a day in sunny Yorkshire!
  213.  
  214. And the Chaos Engine BBS, 2:259/15 - 01346-510727
  215.  
  216.  
  217.  Chunker will be in the WANGI file area or you can freq it using the
  218.  magic filename CHUNKER.
  219.  
  220.  
  221.  VERSION HISTORY
  222. -===============-
  223.  
  224. 1.0  : 04.11.95
  225.      + Original version
  226.  
  227. 1.1  : 05.11.95
  228.      + Full documentation added.
  229.  
  230. 1.2  : 10.11.95
  231.      + Added lots of conditional coding... Amiga exe size is now 2.5k
  232.        compared to 12k !!
  233.      + Amiga version now accepts readarg arguments.
  234.      + Chunker and dechunk Amiga versions are now pure, they can
  235.        be made resident.
  236.      + Actually compiled the MSDOS versions... by heck they are
  237.        over 15k in size!
  238.  
  239. 1.2b
  240. 1.3  : 14.11.95
  241.      + Unix compilation would fail. A #endif was missing from version.h
  242.      + Improved and fixed Unix makefile.
  243.  
  244. 1.4  : 18.02.96
  245.      + Massive speed increase with the Amiga version! About 374% faster!!
  246.        Thanks to Asyncio!
  247.  
  248. 1.5  : 20.02.96
  249.      + Chunker and dechunk would crash if run with wb 1.2,1.3. Fixed this
  250.        and the 1.2 compatable Amiga versions are now also included in the
  251.        archive
  252.  
  253. 1.6  : 01.04.96
  254.      + Minor compilation changes.
  255.      + Fixed minor bug in Unix makefile
  256.      + Fixed problem with segmentation fault on Unix if no args are given
  257.        (Thnaks to Oliver Roberts for pointing out the 2 bugs above)
  258.  
  259. 1.7  : 18.04.96
  260.      + "\n" was missing from the usage information on the DOS/Unix/Ami1.3
  261.        version.
  262.      + Slight changes to code - m#?() changes to OS_#?() (machine.h)
  263.      + makefile had "gcc" as the default compiler rather than "CC"
  264.      + MSDOS versions compiled (first time since the last time ;)
  265.  
  266.  
  267.  OTHER PROGRAMS
  268. -==============-
  269.  
  270. List of programs by Lee Kindness. Note this is only the programs that i have
  271. done, it is not everything i have uploaded to Aminet. The version numbers,
  272. dates and archive sizes given below are, more than likely, out of date as
  273. you read this...
  274.  
  275. FindXXX.lha        comm/fido    9K   5+Comprehensive Nodelist searching utility
  276. FindXXXSrc.lha     comm/fido    9K   5+Source for nodelist searching utility
  277. GFindXXX.lha       comm/fido    9K   5+Comprehensive (Gotcha) Nodelist searchin
  278. GFindXXXSrc.lha    comm/fido    8K   5+Source for (Gotcha) nodelist searching u
  279. GMulti.lha         comm/fido   17K   1+1.0 Gives multiline node support (for po
  280. NLFind.lha         comm/fido   16K   1+1.4 Gives multiline node support (for po
  281. SFPatch.lha        dev/c        8K  36+How to SetFunction()/Patch library funct
  282. Umentiler.lha      dev/misc    28K   1+1.208 Document Compiler (plus SAS/C sour
  283. Jiggler.lha        game/gag     9K  47 Windows move toward mouse pointer.
  284. Acechan.lha        misc/math   11K  32+Makes random spread data??? Pascal sourc
  285. DQua.lha           misc/math   13K  59+1.2 Simple quadratic solver.
  286. MacCash.lha        misc/misc   15K  22+1.3 Gen. UK Lott. Forms. Also stat. Anal
  287. RARS_Ami_2lite.lha misc/sci    55K  41+RARS_Amiga for 020+ and no fpu
  288. DefDTIcon.lha      pix/icon    41K  59+1.7 Default icons, based on files dataty
  289. AmigaGuidePref.lha text/hyper  19K  59+36.144 Preferences for Amigaguide system
  290. RubbDump.lha       util/app   195K  52+V1.1 Replacement trashcan. With sound.
  291. WanDiArc_lsk.lha   util/arc     3K  47 Archive support for WangiPad 1.15
  292. NewEXT.lha         util/batch  10K  57+1.4 Change file extensions.. in batches.
  293. CaBoom.lha         util/boot    9K  22+Windows explode on opening/closing
  294. CaBoomSrc.lha      util/boot    8K  22+Source for CaBoom
  295. SlowBoot18.lha     util/boot    9K  13+1.18 If you HD dosen't boot from cold ge
  296. SlowBootSrc18.lha  util/boot    4K  13+Source for SlowBoot 1.18
  297. Startup-Menu.lha   util/boot  120K  57+V1.41 Cumstomisable startup menu and uti
  298. YourFault.lha      util/boot   20K  32+1.4 Replace system error strings - fun!,
  299. YourFaultSrc.lha   util/boot    6K  32+Source for YourFault 1.4
  300. YourFaultStr.lha   util/boot   17K  32+Error files for YourFault, Standard Loca
  301. Bush.lha           util/cli    10K  59+1.4 Shows directory tree structures.
  302. Erase.lha          util/cli     9K  22+1.1 Deletes a file so that it can't be r
  303. chunker.lha        util/misc   36K  10+1.2b Split+Join files! Ami/MSDOS/Unix (C
  304. DiceRoll.lha       util/misc    6K  53+Emmulates dice throws - generate rand nu
  305. naegrey_101.lha    util/misc    9K  40+Remove grey screen border. WB2+ OS frien
  306. Publican.lha       util/misc   11K  44+Public screen support utility.
  307. MidMoose.lha       util/mouse   3K  32+2.0  Emulates mid mouse button via a key
  308. shrub_114.lha      util/wb     21K  39+V1.14 Shows directory trees, WB GUI.
  309. WangiPad.lha       util/wb     53K  45+1.16 BEST Tool launcher, readme please
  310.  
  311.  
  312. -- Wangi!
  313.  Lee Kindness  cs2lk@scms.rgu.ac.uk wangi@frost3.demon.co.uk
  314.  Team TRUMPET! http://www.scms.rgu.ac.uk/students/cs_yr94/lk
  315.  
  316.