home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / archiver / lhachnkr.arj / LC.DOC < prev    next >
Encoding:
Text File  |  1992-07-17  |  20.9 KB  |  567 lines
  1.  
  2.   +----------------------------------------------------+
  3.   |  LHA Chunker, (C) Copyright 1991-92, Scott Jibben  |
  4.   |                 Version 1.00                       |
  5.   +----------------------------------------------------+
  6.  
  7.  
  8. This is a list of the files that should accompany this software
  9. package:
  10.  
  11. LC.DOC       - LHA Chunker Documentation.
  12. LC.EXE       - LHA Chunker executable.
  13. DISTSAMP.DOC - Sample of a distribution license.
  14. SITESAMP.DOC - Sample of a site license.
  15. SITEINFO.DOC - Information and applications of licensing.
  16. LICENSE.DOC  - License for LHA Chunker software.
  17. PRICE.DOC    - Pricing guidelines for site/distribution licenses.
  18. ORDERFRM.DOC - The order form.
  19. CC-ORDER.DOC - Information to register by credit card.
  20. CATALOG.JSW  - Information on Jibben Software Products.
  21. WHATSNEW.TXT - The Version History of LHA Chunker.
  22.  
  23.  
  24.                      What this software does
  25.  
  26. This software is a file splitting utility.  It supports two modes of
  27. operation.
  28.  
  29. 1. It can split ANY type of file to a desired size creating multiple
  30.    files with the AS file extension.  These file will be exactly the
  31.    size requested except for the last file created.  Using this mode of
  32.    operation you will be able to split any file to your requirements.
  33.    The only disadvantage of using this method is that you will have to
  34.    use LHA Chunker ( or Archive Sizer ) to "reassemble" the files back
  35.    to the original file.
  36.  
  37. 2. It can split files created by the LHA software to your desired
  38.    size.  This will create multiple files that retain compatibility
  39.    with the LHA software.  The only disadvantage to using this method
  40.    is if the internal compressed files are larger than the requested
  41.    size.  LHA Chunker can't force the files to be smaller and retain
  42.    compatibility.  In this case it is recommended to use method 1.
  43.  
  44.    The only compression software files that LHA Chunker supports is:
  45.  
  46.    LHA created by Haruyasu Yoshizaki's LHA software.
  47.  
  48.  
  49.  
  50.                 Requirements for LHA Chunker
  51.  
  52. LHA Chunker allocates memory as needed when processing.  However, I
  53. suggest that you have at least 200KB of free memory to run it.
  54. If you are going to process large LHA files (with a lot of files, not
  55. total size), I suggest that you have 400KB of free memory to run LHA
  56. Chunker.
  57.  
  58.  
  59.                     Installation Instructions
  60.  
  61. It is relatively simple to install LHA Chunker.  All you have to do
  62. is copy the files to a subdirectory that is listed in your PATH
  63. statement in your AUTOEXEC.BAT file.  You could also just create a
  64. new subdirectory, copy the files there, and then add the new sub-
  65. directory to the PATH statement.  I won't go into the details of making
  66. subdirectories and modifying your path as you should have good examples
  67. of this in your DOS manual.
  68.  
  69.  
  70.  
  71.  
  72.                     The concept of Shareware
  73.  
  74. LHA Chunker is being released as a Shareware product.  Shareware is
  75. a marketing concept, in which you get to try out a software package
  76. for a period of time.  If you find that the software is useful
  77. to you (you are still using it), you are obligated to send in a
  78. registration fee for that software to the author.
  79.  
  80. LHA Chunker's trial period is 21 days.  That means, once you start
  81. using LHA Chunker, you have 21 days to decide whether or not it is
  82. useful to you.  If it is useful to you, please promptly send in the
  83. requested registration fee.  If it is not useful to you, you are
  84. expected to delete it and stop using it.
  85.  
  86. LHA Chunker is fully functional.  However, it has a message that will
  87. appear every time it is used to size or reassemble files.
  88.  
  89. Here's what you get when you register (Please use ORDER.FRM to order
  90. this software):
  91.  
  92. 1.  Support.  You can call and leave e-mail to me on any of the BBS'
  93.     listed in the Technical Support section of this document or
  94.     CompuServe and get a response from me.  I will more than likely
  95.     answer all questions, but the registered individuals will
  96.     definitely get top priority.  You will also receive unlimited
  97.     telephone support for the program.  Registered users will get a
  98.     phone number that they will be able to use to receive support
  99.     between the hours of 6:00 pm - 10:00 pm (Central Standard Time)
  100.     Monday-Friday.
  101.  
  102. 2.  You will receive a disk with the most recent version of LHA
  103.     Chunker.  The software will also have the registration reminder
  104.     screen removed.  Your name and serial number will also be displayed
  105.     when the software is run.
  106.  
  107. 3.  Special access to new products.  You will be allowed access to
  108.     beta test any software package that I'm in the process of creating.
  109.     The beta software will be available on the Warehouse BBS and
  110.     CompuServe.  Also, you must make arrangements with Jibben Software
  111.     to get access to the new software.  (see Technical Support section
  112.     of this document for details).
  113.  
  114. 4.  You will also have low cost upgrades of this software.
  115.  
  116.  
  117.  
  118.                 Advantages of Using LHA Chunker
  119.  
  120. I've designed LHA Chunker to make the least demands on your
  121. hardware.  It is the fastest file splitting utility available (not
  122. counting other Jibben Software products).
  123.  
  124. One other benefit from using LHA Chunker is the amount of disk
  125. space it requires to process an archive file.  It uses the absolute
  126. minimum disk space that is required to process a file.  LHA Chunker
  127. automatically determines the disk space required and will tell you if
  128. you don't have enough BEFORE you create the files.
  129.  
  130. The algorithm in which I calculate the amount of files to put in a
  131. archive file is highly optimized.  LHA Chunker will sometimes have
  132. one less file than other software packages of this type and the files
  133. will be closer to the requested size.
  134.  
  135. LHA Chunker can handle any file created using LHA.  One of my beta
  136. testers ran LC on a 170 Megabyte LHA file and LC processed it without
  137. problems.
  138.  
  139. Archive Sizer and LHA Chunker are the only software packages that I
  140. know of that supports the LHA file format as well as any file sizing.
  141.  
  142.  
  143.  
  144.                        Using LHA Chunker
  145.  
  146. The software is fairly straight-forward and easy to use.  In fact,
  147. I doubt that you will need to read this document in order to be
  148. able to use the software.  LHA Chunker will always display all of
  149. your options when you just type in LC and press Enter.  The
  150. following is a list of the options with their descriptions.  Since
  151. there are two modes of operating LC, I've listed the examples for
  152. these modes separately following the parameter descriptions.
  153.  
  154.  
  155.                     +------------------------+
  156.                     | Parameter Descriptions |
  157.                     +------------------------+
  158.  
  159. [/L]       - This option causes LHA Chunker to display its license
  160.              information and information about contacting the author
  161.              for support.
  162.  
  163. [file]     - This parameter is to be replaced with the name of the file
  164.              that you wish to size.  If there is an LHA file in the
  165.              location that you've specified, LC will be able to detect
  166.              the file by the files extension.  Therefore, you would be
  167.              able to just type in ARCFILE instead of ARCFILE.LZH.  If
  168.              you specify a file that doesn't have LZH for the file
  169.              extension, LC will default to the AS file format.  You can
  170.              also 'force' this method of sizing with the /A option.
  171.              Also, if you specify just an AS file, (no other
  172.              parameters), LC will report information on the AS file.
  173.  
  174. [max size] - This is option is used for specifying the maximum size of
  175.              the files that you wish to create.  LC will use this
  176.              value in attempting to keep your files a certain size or
  177.              smaller.  There are several ways to specify this size.
  178.              The first is to just specify a size in bytes, like 200000.
  179.              Note that there are NO commas in this number.  The other
  180.              two methods are 'preset' values for floppy disk sizes.
  181.              The old Zip Chunker presets are available, /5L, /5H, /3L,
  182.              and /3H.  There is also a new one called /3E for the new
  183.              2.88MB floppy disks.  The last method is using the /S:
  184.              option.  After /S: you specify the size of the floppy that
  185.              you wish to size to.  The list of different options is
  186.              listed on the info screen.  For example, to size for a
  187.              3.5" high density floppy, the option would be /S:1.44.
  188.              The default [max size] is 1.44MB.
  189.  
  190. [/E]       - Using this option will cause LHA Chunker to erase the
  191.              original LHA file.  This only works for LHA files.
  192.              NOTE: It has been disabled for AS files.
  193.  
  194.  
  195.                     +------------------------+
  196.                     | Parameter Descriptions |
  197.                     +------------------------+
  198.  
  199. [/F]       - This option is only valid for LHA files, NOT AS files.  It
  200.              is used to make LC size the resulting files so that when
  201.              the new files are uncompressed they will fit on the [max
  202.              size] that you specified using a floppy size.  Note:  this
  203.              only works when using a valid floppy disk preset (see the
  204.              [max size] option).
  205.  
  206. [/D:path]  - This option is used to tell LC where to put the files that
  207.              it creates.  This is how you tell LC to put the new files
  208.              on a floppy disk.  LC will prompt you to put in a new
  209.              floppy disk when it is needed.  You can also use this
  210.              option to put the files on another hard disk or
  211.              sub-directory.  It will work as long as you provide a
  212.              valid destination.  Note: when using this option with a
  213.              floppy disk size preset (see [max size] option), the disk
  214.              must be able to support the size you requested.  Also,
  215.              when sizing to a floppy drive, make sure you have enough
  216.              blank, formatted disks available for the process.
  217.  
  218. [/A]       - This option is used for 'force' sizing the file into an AS
  219.              file.  This is helpful if you want to size an LHA file to
  220.              fit on a floppy when there are internal files that are
  221.              larger than the disk size you are attempting to size for.
  222.  
  223. [/R]       - This option is used to reassemble AS files back to the
  224.              original file.  It is simple to use.  Just supply one of
  225.              the AS filenames and this option and LC will reassemble it
  226.              back together.
  227.  
  228. [/M]       - This option will report the smallest allowable value for
  229.              [max size].  It is useful for determining the value that
  230.              you can use for [max size] before making the attempt to
  231.              size a file.
  232.  
  233. [/N]       - This option will report the number of new files that will
  234.              be created without actually creating them.
  235.  
  236. [/T]       - This option will allow LHA Chunker to use the current
  237.              date and time for the new files that are created.
  238.  
  239.  
  240.                            +----------+
  241.                            | Examples |
  242.                            +----------+
  243.  
  244. For All Types of Files
  245. ----------------------
  246.  
  247. C:\WORK>LC
  248.  
  249. The example above will display LHA Chunker's Information screen.  This
  250. displays all the available command line options.
  251.  
  252.  
  253. C:\WORK>LC \L
  254.  
  255. The example above will display LHA Chunker's license information.  It
  256. also displays information about support BBS and the authors CompuServe
  257. ID.
  258.  
  259.  
  260. C:\WORK>LC workdata /m
  261.  
  262. The example above will display the smallest allowable size for the [max
  263. size] parameter for sizing.
  264.  
  265.  
  266. C:\WORK>LC file 500000 /n
  267.  
  268. The example above will display the number of new files that will be
  269. created when sizing the file.  It doesn't actually size the file.
  270.  
  271.  
  272. C:\WORK>LC myfile 500000 /t
  273.  
  274. The example above will size myfile to be 500,000 bytes and will use the
  275. current system date and time on the files.
  276.  
  277.  
  278.                            +----------+
  279.                            | Examples |
  280.                            +----------+
  281.  
  282. For LHA Files
  283. -------------
  284.  
  285. Here are some examples on the use of LC for archive files:
  286.  
  287. C:\WORK>LC workdata
  288.  
  289. The above example will break out files from WORKDATA.LZH that will
  290. be equal to or smaller than the size of a file that would fit on a
  291. 3.5" HD disk.  It will also save the original file.
  292.  
  293.  
  294. C:\WORK>LC 123data.LZH /5L /E
  295.  
  296. The above example will break out files from 123DATA.LZH and these
  297. files will be equal to or smaller than what would fit on a 5.25"
  298. low density disk.  It will delete 123DATA.LZH when it is done.
  299.  
  300.  
  301. C:\WORK>as 123data.LZH /S:360 /E
  302.  
  303. The above example will work exactly as the previous example.  The only
  304. difference is the use of the /S: parameter instead of /5l.
  305.  
  306.  
  307. C:\TELIX\UL>LC e:\games\biggame.LZH 200000
  308.  
  309. The above example will break out files from E:\GAMES\BIGGAME.LZH
  310. and these files will be equal to or smaller than 200,000 bytes.
  311. The original file, E:\GAMES\BIGGAME.LZH, will be saved as well.
  312. Also, the new LHA files will be created in C:\TELIX\UL.
  313.  
  314.  
  315. C:\EXCEL\XLS>LC XLSHEETS.LZH /s:1.44 /d:a:
  316.  
  317. The above example will break out files from XLSHEETS.LZH.  The new
  318. files will fit on a 1.44MB floppy.  The files will be created on
  319. drive A:.  When the floppy is filled with a file, LHA Chunker will
  320. prompt for a formatted blank disk for the next file.  The original
  321. file will be saved.  This process requires NO hard disk space, only
  322. formatted blank floppy disks.  Also, LC will check to determine if the
  323. size you specified matches type of floppy hardware is available.  At
  324. any prompt you can press Esc to abort the process.
  325.  
  326.  
  327.                            +----------+
  328.                            | Examples |
  329.                            +----------+
  330.  
  331. C:\CLIPART\PICS>LC CA-PICS.LZH /s:1.44 /f
  332.  
  333. The above example will break out files from CAP-PICS.LZH.  The new LHA
  334. files when uncompressed will fit on a 1.44MB floppy disk.  The original
  335. file will be saved.  This process requires NO hard disk space, only
  336. formatted blank floppy disks.  Also, LC will check to determine if the
  337. size you specified matches type of floppy hardware is available.  At
  338. any prompt you can press Esc to abort the process.
  339.  
  340.  
  341.  
  342.  
  343. For AS Files
  344. ------------
  345.  
  346. C:\WORK>as bigdb-1
  347.  
  348. The above example will display the AS file information for the
  349. BIGDB-1.AS file.  Note: the file extension is optional.
  350.  
  351.  
  352. C:\WORK>as bigdata.db
  353.  
  354. The above example will size the BIGDATA.DB file into AS files.  The new
  355. AS files will be created in the C:\WORK directory.  BIGDATA.DB will not
  356. be erased when processing is completed.
  357.  
  358.  
  359. C:\WORK>as data.LZH /a
  360.  
  361. The above example will size the DATA.LZH file into AS files.  The new
  362. AS files will be created in the C:\WORK directory.  Note: the /A option
  363. over-rides the normal LHA file sizing.  DATA.LZH will not be erased
  364. when processing is completed.
  365.  
  366.  
  367. C:\WORK>as bigdata.db /d:a: /s:1.44
  368.  
  369. The above example will size the BIGDATA.DB file into AS files.  The new
  370. AS files will be created on the A: drive (if A: is a 1.44MB drive).
  371. LHA Chunker will prompt for new disks.  This option requires NO hard
  372. disk space for processing.  BIGDATA.DB will not be erased when
  373. processing is completed.
  374.  
  375.  
  376.                            +----------+
  377.                            | Examples |
  378.                            +----------+
  379.  
  380. C:\WORK>as bigdb-1 /r
  381.  
  382. The above example will reassemble the AS files in the BIGDB-#.AS series
  383. of file names.
  384.  
  385.  
  386. C:\WORK>as bigdb-3 /r
  387.  
  388. The above example will reassemble the AS files in the BIGDB-?.AS series
  389. of file names.  Note: LHA Chunker will start at the first file name
  390. in the series even though the file above is not the first file.
  391.  
  392.  
  393. C:\WORK>as bigdb-1 /r /d:d:\access
  394.  
  395. The above example will reassemble the AS files in the BIGDB-?.AS series
  396. of file names.  The created file will be placed in the D:\ACCESS
  397. directory.
  398.  
  399.  
  400. C:\WORK>as a:bigdb-1 /r
  401.  
  402. The above example will reassemble the AS files in the BIGDB-?.AS series
  403. of file names from the A: floppy drive.  LC will prompt for each
  404. disk in the series to reassemble the file.  The created file will be
  405. placed in the C:\WORK directory.
  406.  
  407.  
  408.  
  409.  
  410.  
  411.                           Miscellaneous
  412.  
  413. LHA Chunker will not allow you to process a file if there isn't
  414. enough free disk space available.
  415.  
  416. If LHA Chunker finds a file in the original archive file that is
  417. larger than the maximum size specified, it will give you the option of
  418. continuing to process the archive file.  The result of this type of
  419. operation is that there will be some files that have only one file in
  420. them but they will still be larger than the maximum size.
  421.  
  422. If the original file is already smaller than the maximum size then
  423. LHA Chunker will tell you and not process the file.
  424.  
  425. LHA Chunker will in most cases be able to detect that a file passed
  426. to it is a valid LHA file or not.  It will not be able to detect if
  427. the internal files have been corrupted, though.
  428.  
  429.  
  430.                   +--------------------------------+
  431.                   |  LHA Chunker Programming Info  |
  432.                   +--------------------------------+
  433.  
  434.  
  435. LHA Chunker will return the following DOS Error Levels when it
  436. aborts in an error state:
  437.  
  438. 1.  Out of memory.
  439. 2.  Incorrect [max size] for floppy drive specified.
  440. 3.  Can't open file.
  441. 4.  Reserved.
  442. 5.  Reserved.
  443. 6.  File version isn't compatible.
  444. 7.  File is already an *.AS file.
  445. 8.  The requested max size will create too many files.
  446. 9.  File is not an *.AS file.
  447. 10. Process aborted.
  448. 11. There isn't enough disk space available to process file(s).
  449. 12. The internal data of this *.AS is corrupt/invalid.
  450. 13. Reserved.
  451. 14. Lzh file is corrupt/invalid.
  452. 15. A file exists that AS wanted to create.
  453. 16. Couldn't find the requested file.
  454. 17. The file name given isn't specific enough.
  455. 18. The [max size] value is invalid.
  456. 19. Reserved.
  457. 20. Reserved.
  458. 21. Reserved.
  459. 22. Reserved.
  460. 23. Unknown/All other errors.
  461.  
  462.  
  463. This is the format of AS files (in C notation):
  464.  
  465. struct as_header {
  466.   unsigned long  signature;         // always 0x10af5341
  467.   unsigned int   version;
  468.   char           file_name[13];
  469.   struct   ftime file_date_time;    // Borland C++ ftime struct
  470.   int            file_attributes;
  471.   unsigned long  this_file_size;
  472.   unsigned long  total_file_size;
  473.   unsigned long  this_file_num;
  474.   unsigned long  total_file_num;
  475.   unsigned long  crc32;
  476.   unsigned long  original_crc32;
  477. };
  478.  
  479. This header will always be present at the beginning of an AS file.
  480.  
  481.  
  482.  
  483.                         Technical Data
  484.  
  485. LHA Chunker was written entirely in C/C++ using Borland C++ 3.1.
  486. This is a partial explanation of LC's speed and size.  The other main
  487. reason for LC's speed and size is that I access the LHA file directly
  488. vs. making calls to the LHA software.
  489.  
  490.  
  491.                        Technical Support
  492.  
  493. For technical support I (Scott Jibben) can be reached at the following
  494. on-line systems:
  495.  
  496. The Warehouse BBS:  612-379-8272  1200-57600 baud V.32bis/HST 16.8K
  497. (N81) - 6 Lines.  The Warehouse is my first (main) line of support.
  498. Since I am a co-sysop of this BBS, I usually log on several times a day
  499. to check for email.  This BBS is a subscription BBS, however anyone
  500. logging on will receive access rights to the file area where my
  501. software can be downloaded for FREE and a message area that is
  502. dedicated to my software.
  503.  
  504. Terrapin Station BBS:  612-623-0152  1200-9600 V.32 (N81)
  505. Terrapin Station is the second home for LHA Chunker.  This BBS is
  506. used by many professional computer people.  One of it's focal points is
  507. programming, but there are several other topics that are discussed on
  508. this BBS.  I usually check into this BBS at least once a day.
  509.  
  510. Painters Workshop BBS:  414-722-0242  1200-14400 V.32bis/HST (N81)
  511. Painters Workshop is Distribution Site #00 3 for Jibben Software.  If
  512. you need help with Jibben Software products the sysop, Duane Heller
  513. will be able to help you.  I log onto this BBS once every two weeks.
  514. Duane contacts me at least once a week.
  515.  
  516. CompuServe:
  517. My CompuServe ID is 72657,3303.  Feel free to send me an E-Mail any
  518. time.  I usually log on to CompuServe at least once a day.
  519.  
  520.  
  521.  
  522.                         Acknowledgments
  523.  
  524.  
  525. I would like to thank those people that have assisted me in the
  526. development of this software:
  527.  
  528. Travis Carter, sysop of the Warehouse BBS, for testing the software
  529. and providing a message forum for supporting software written by
  530. me.
  531.  
  532. Howard Ekman, sysop of Terrapin Station DBBS, for providing a second
  533. home for LHA Chunker.
  534.  
  535. Keith Ledbetter, author of the BEST file finding utility money can
  536. buy; Supersonic Search Tool (SST), for providing valuable information
  537. about the internal file formats of several archiving software
  538. packages.  This saved me valuable time and effort.
  539.  
  540. Kenjirou Okubo and Haruyasu Yoshizaki (Author of LHA) for testing LC to
  541. ensure it works properly with LHA archive files.
  542.  
  543. My wife, for the patient support and active involvement in getting
  544. this business rolling.
  545.  
  546. Finally, all of the people who've registered my software.  I really
  547. appreciate it!
  548.  
  549.  
  550.  
  551.  
  552.                     Disclaimers, etc.
  553.  
  554.  
  555. Jibben Software specifically disclaims all other warranties, expressed
  556. or implied, including but not limited to implied warranties of
  557. merchantability and fitness for a particular purpose, functionality or
  558. data integrity.  In no event shall Jibben Software be liable for any
  559. loss of profit or any other commercial damage, including but not
  560. limited to special, incidental, consequential or other damages.
  561.  
  562.  
  563.  
  564. Borland is a registered trademark of Borland International, Inc.
  565.  
  566.  
  567.