home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / zipchunk.zip / ZC.DOC < prev    next >
Text File  |  1991-03-17  |  13KB  |  302 lines
  1.           ┌───────────────────────────────────────────────┐
  2.           │ Zip Chunker, (C) Copyright 1991, Scott Jibben │
  3.           │                Version 1.01                   │
  4.           └───────────────────────────────────────────────┘
  5.  
  6.  
  7.     This is a list of the files that should accompany this software
  8.     package:
  9.  
  10.     ZC.EXE         14629  03-17-91  1:01am
  11.     ZC.DOC         12832  03-17-91  1:01am
  12.     ORDER.FRM       1907  03-17-91  1:01am
  13.     VER-HIST.TXT    2448  03-17-91  1:01am
  14.  
  15.  
  16.     This software has been compressed using PKLite Professional.
  17.  
  18.  
  19.  
  20.                          What this software does
  21.  
  22.     This software will take an existing ZIP (tm) file that was created
  23.     using PKWare's PKZIP (tm) software and create subsets of the file
  24.     according to a users specified size.  These subsets can be
  25.     uncompressed as normal using PKUNZIP (tm).
  26.  
  27.  
  28.                       Requirements for Zip Chunker
  29.  
  30.     Zip Chunker allocates memory as needed when processing.  However, I
  31.     suggest that you have at least 200KB of free memory to run Zip Chunker.
  32.     If you are going to process large Zip files (with a lot of files, not
  33.     total size), I suggest that you have 350KB of free memory to run
  34.     Zip Chunker.
  35.  
  36.  
  37.                         Installation Instructions
  38.  
  39.     It is relatively simple to install Zip Chunker.  If you already have
  40.     the PKZip software installed and PKZip's location in your path statement,
  41.     all you have to do is add the Zip Chunker files into the same subdirectory
  42.     as the PKZip software.
  43.  
  44.     If you don't wish to have the Zip Chunker software in the same
  45.     subdirectory as the PKZip software, all you have to do is set up a new
  46.     subdirectory for the Zip Chunker software, copy the Zip Chunker files
  47.     into that subdirectory, and then add that subdirectory to your path.
  48.     I won't go into the details of making subdirectories and modifying
  49.     your path as you should have good examples of this in your DOS manual.
  50.  
  51.  
  52.                          The concept of Shareware
  53.  
  54.     Zip Chunker is being released as a Shareware product.  Shareware is
  55.     a marketing concept, in which you get to try out a software package
  56.     for a period of time.  If you find that the software is useful
  57.     to you (you are still using it), you are obligated to send in a
  58.     registration fee for that software to the author.
  59.  
  60.     Zip Chunker's trial period is three weeks.  That means, once you
  61.     start using Zip Chunker, you have three weeks to decide whether or
  62.     not it is useful to you.  If it is useful to you, please promptly
  63.     send in the requested registration fee.  If it is not useful to you,
  64.     you are expected to delete it and stop using it.
  65.  
  66.     Zip Chunker is fully functional.  That means I haven't put in any
  67.     code into this software to cripple it or in any way make it
  68.     annoying to use.  It simply does the job that you request it to.
  69.     There are a number of things that I could have put in this software
  70.     to make it annoying use and then promise that those aspects would
  71.     be removed upon receipt of a registered version.  However, I'm
  72.     relying on the integrity of the people that use my software to
  73.     register it.
  74.  
  75.     Here's what you get when you register my software:
  76.  
  77.     1.  Support.  You can call and leave e-mail to me on any of the BBS'
  78.         listed in the Technical Support section of this document or
  79.         CompuServe and get a response from me.  I will more than likely
  80.         answer all questions, but the registered individuals will
  81.         definitely get top priority.
  82.  
  83.     2.  Advance notice of my upcoming software products/upgrades.  This
  84.         also includes the little fixes.  It has always annoyed me when
  85.         I register Shareware software and then find out three months
  86.         later that there is a slightly newer version, that I never got
  87.         a copy of.  Keep in mind that the extra auto-upgrade fee only
  88.         applies to major versions (1.x to 2.0, 2.x to 3.x, etc.)
  89.  
  90.     3.  Special access to new products.  You will be allowed access to
  91.         beta test any software package that I'm in the process of creating.
  92.         The beta software will be available only on the Warehouse BBS
  93.         (see Technical Support section of this document for details).
  94.  
  95.                      Advantages of Using Zip Chunker
  96.  
  97.  
  98.  
  99.     I've designed Zip Chunker to make the least demands on your
  100.     hardware.  Zip Chunker is at least 2 times faster than any other
  101.     software package of this type.  In some instances, I've found it to
  102.     be up to 10 times faster.
  103.  
  104.     One other benefit from using Zip Chunker is the amount of disk
  105.     space it requires to process a ZIP file.  My closest competitor
  106.     requires 2-3 times the disk space of the original ZIP file, ie, if
  107.     you had a 2MB ZIP file you would have to have up to 6MB of free
  108.     disk space in order to break it up!  Zip Chunker requires the
  109.     amount of the original ZIP file plus 16KB for free space, ie, if
  110.     you had a 2MB file you would only need 2MB + 16KB free in order to
  111.     use Zip Chunker.
  112.  
  113.     The algorithm in which I calculate the amount of files to put in a
  114.     ZIP chunk is highly optimized.  Zip Chunker will sometimes have one
  115.     less chunk than other software packages of this type and the chunks
  116.     will be closer to the requested size.
  117.  
  118.     Zip Chunker can handle any file created using PKZIP (tm).  All other
  119.     software packages of this type that I've seen, have the tendency to
  120.     crash if the ZIP file is too large or there are too many files in
  121.     the ZIP file.  One of my beta testers ran ZC on a 170 Megabyte Zip
  122.     file and ZC processed it without problems.
  123.  
  124.  
  125.  
  126.  
  127.     Sysops,
  128.  
  129.     If you would like to be a distribution point for this software, I
  130.     would be happy to talk to you about the best way to get it to you.
  131.     Please send a letter or e-mail to me with your phone/BBS number on
  132.     one of the computer systems I have listed in the license screen (ZC
  133.     /L).  These systems are also listed in the Technical Support section
  134.     of this document.
  135.  
  136.                             Using Zip Chunker
  137.  
  138.  
  139.  
  140.     The software is fairly straight-forward and easy to use.  In fact,
  141.     I doubt that you will need to read this document in order to be
  142.     able to use the software.  Zip Chunker will always display all of
  143.     your options when you just type in ZC and press Enter.  Below is an
  144.     example of what you will see when you do this:
  145.  
  146.     ■───────────────────────────────────────────────────────────────■
  147.  
  148.     Zip Chunker 1.01.  Released: 03-17-91
  149.     Copyright 1991, Scott Jibben.  All Rights Reserved.
  150.  
  151.     Syntax:  ZC [/L] | [zipfile [# | /5L | /5H | /3L | /3H] [/S]]
  152.  
  153.     [/L]      - License information.
  154.     [zipfile] - Name of Zip file to be sized.
  155.  
  156.     [#]       - Maximum size of the produced Zip files in bytes.
  157.     [/5L]     - Maximum size = 5.25" Low Density Floppy Disk (360KB).
  158.     [/5H]     - Maximum size = 5.25" High Density Floppy Disk (1.2MB).
  159.     [/3L]     - Maximum size = 3.5" Low Density Floppy Disk (720KB).
  160.     [/3H]     - Maximum size = 3.5" High Density Floppy Disk (1.44MB).
  161.  
  162.     [/S]      - Don't delete [zipfile].
  163.  
  164.     ■───────────────────────────────────────────────────────────────■
  165.  
  166.     The important line to note is the Syntax line.  It contains the
  167.     basic information on what parameters can be used and in what order
  168.     they should appear.  First of all, every parameter that is enclosed
  169.     in brackets [] is an optional item.  The "|" character means OR.
  170.      The best way to explain how it works is to give some examples, so
  171.     here goes:
  172.  
  173.     C:\WORK\>ZC \L
  174.  
  175.     The example above will display Zip Chunkers license information.
  176.  
  177.  
  178.     C:\WORK\>ZC workdata /s
  179.  
  180.     The above example will break out chunks from WORKDATA.ZIP that will
  181.     be equal to or smaller than the size of a file that would fit on a
  182.     3.5" HD disk.  It will also save the original file, WORKDATA.ZIP.
  183.  
  184.  
  185.     C:\WORK\>ZC 123data /5L
  186.  
  187.     The above example will break out chunks from 123DATA.ZIP and these
  188.     chunks will be equal to or smaller than what would fit on a 5.25"
  189.     low density disk.  It will delete 123DATA.ZIP when it is done.
  190.  
  191.  
  192.     C:\TELIX\UL\>ZC e:\games\biggame 200000 /s
  193.  
  194.     The above example will break out chunks from E:\GAMES\BIGGAME.ZIP
  195.     and these chunks will be equal to or smaller than 200,000 bytes.
  196.     The original file, E:\GAMES\BIGGAME.ZIP, will be saved as well.
  197.     Also, the new ZIP chunks will be created in C:\TELIX\UL.
  198.  
  199.  
  200.  
  201.                               Miscellaneous
  202.  
  203.     Zip Chunker will not allow you to process a ZIP file if there isn't
  204.     enough free disk space available.
  205.  
  206.     If Zip Chunker finds a file in the original ZIP file that is larger
  207.     than the maximum size specified, it will give you the option of
  208.     continuing to process the ZIP file.  The result of this type of
  209.     operation is that there will be some ZIP chunks that have only one
  210.     file in them but they will still be larger than the maximum size.
  211.  
  212.     If the original ZIP file is already smaller than the maximum size
  213.     then Zip Chunker will tell you and not process the ZIP file.
  214.  
  215.     Zip Chunker will in most cases be able to detect that a file passed
  216.     to it is a valid ZIP file or not.  It will not be able to detect if
  217.     the internal files have been corrupted, though.  I plan to add an
  218.     option in a future version that also does CRC-32 checking as it
  219.     processes the Zip file.
  220.  
  221.     Zip Chunker CAN handle password encrypted files and retain the
  222.     password in the ZIP chunks.
  223.                              Technical Data
  224.  
  225.     Zip Chunker was written entirely in C using Borland C++ 2.0.  This
  226.     is a partial explanation of ZC's speed and size.  The other main
  227.     reason for ZC's speed and size is that I have made great use of
  228.     dynamically allocated memory routines.
  229.  
  230.  
  231.                            Technical Support
  232.  
  233.     For technical support I can be reached at the following on-line
  234.     systems:
  235.  
  236.     The Warehouse BBS:  612-729-0160  1200-38400 baud V.32bis/HST (N81)
  237.     The Warehouse is my first (main) line of support.  Since I am a
  238.     co-sysop of this BBS, I usually log on several times a day to check it
  239.     out.  This BBS is a subscription BBS, however anyone logging on
  240.     will receive access rights to the file area where my utilities can
  241.     be downloaded and a message area that is dedicated to my software.
  242.  
  243.  
  244.     CompuServe:
  245.     My CompuServe ID is 72657,3303.  Feel free to send me an E-Mail any
  246.     time.  I usually log on to CompuServe at least once a day.
  247.  
  248.  
  249.     Nick's Nest BBS:  612-490-1187  1200-2400 baud  (N81)
  250.                       612-490-0341  9600 baud only (HST) (N81)
  251.     Nick's Nest is run locally to me and the Sysop is a good friend of
  252.     mine.  This is also a subscription BBS (a mere $10 a year), however
  253.     you will have access to send me messages via E-Mail (message area 1).
  254.  
  255.  
  256.     Painter's Workshop BBS: 414-722-2069  1200-19200 baud (V.32) (N81)
  257.     Painter's Workshop is my Wisconsin connection.  It is another board
  258.     that is operated by a friend of mine.  Painter's Workshop is an
  259.     open BBS, you will have access to downloading and messages immediately.
  260.     I usually log on to this BBS 2-3 times a week.
  261.  
  262.                              Gratuities
  263.  
  264.  
  265.     I would like to thank those people that have assisted me in the
  266.     development of this software:
  267.  
  268.     Chris Edmonson, who gave me some valuable insight on various
  269.     methods of designing the dynamic memory allocation code.
  270.  
  271.     Travis Carter, sysop of the Warehouse BBS, for testing the software
  272.     and providing a message forum for supporting software written by
  273.     me.
  274.  
  275.     Chris Reagan (Painter), sysop of Painter's Workshop, for distributing
  276.     my software all over eastern Wisconsin.
  277.  
  278.     Tom Black of McHenry IL, for finding a bug in version 1.0.  See
  279.     VER-HIST.TXT for details.
  280.  
  281.     My wife, for the patient support.
  282.  
  283.  
  284.  
  285.  
  286.                          Disclaimers, etc.
  287.  
  288.  
  289.     Scott Jibben specifically disclaims all other warranties, expressed
  290.     or implied, including but not limited to implied warranties of
  291.     merchantability and fitness for a particular purpose, functionality
  292.     or data integrity.  In no event shall Scott Jibben be liable for any
  293.     loss of profit or any other commercial damage, including but not
  294.     limited to special, incidental, consequential or other damages.
  295.  
  296.  
  297.  
  298.     Borland is a registered trademark of Borland International, Inc.
  299.  
  300.     PKWARE, PKLITE, PKZIP and PKUNZIP are registered trademarks of PKWare
  301.     Incorporated.
  302.