home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / arc_lbr / larc22.arc / LARC22.DOC < prev    next >
Text File  |  1989-03-09  |  8KB  |  189 lines
  1.  
  2.   LARC Utility                                            Version 2.2
  3.   ------------                                           Mar 8,  1989
  4.  
  5.   Purpose:
  6.  
  7.         To create the smallest possible archive files.
  8.  
  9.   Usage:
  10.         LARC d:[\inpath\]filespec  [d:\outpath]
  11. |                                  [/A] [/C] [/G] [/K] [/P] [/Z]
  12.                                    [/L] [/R]
  13.  
  14.         The input drive and/or path is required and specifies the
  15.         location of file(s) to be processed.  The inpath name is
  16.         optional.  You may include wildcards.  The extension defaults
  17.         to ARC.
  18.  
  19.         The output drive and path are optional. If omitted, the
  20.         original ARC files are replaced with any smaller versions
  21.         created by the LARC process. If supplied, all archive files
  22.         are newly created in the output directory. This is handy
  23.         for insuring that you get the archive file in the format
  24.         that you want, e.g. in SEA ARC format only.
  25.  
  26.         At least two disk directories are required.  The first (from
  27.         d:\inpath) contains the original files.  The second (the
  28.         current drive and path) is used for temporary storage where
  29.         all  files are extracted and re-created.  A large RAM disk
  30.         is recommended.  Optionally, a third directory (from
  31.         d:\outpath) is used as the destination for all new files.
  32.  
  33.         You MUST not have the d:\inpath the same as the current drive
  34.         and path.  The current drive (and directory) is used for
  35.         temporary work space. You can have the inpath and outpath the
  36.         same to force replacement of all existing ARC files. The smallest
  37.         files - in terms of bytes,  not clusters - is used.
  38.  
  39.         Use one or more of the option switches to specify the program(s)
  40.         to be used for creating archive files:
  41.  
  42.           /A for ARCA
  43.           /C for SEA's ARC
  44.           /G for GSARC or PAK
  45.           /K for PKARC
  46.           /P for PKPAK
  47.           /Z for PKZIP
  48.  
  49.         If none is supplied, the default is to use ARCA only.
  50.  LARC Utility                                                       Page 2
  51.  
  52.  
  53.         If an LBR library file is encountered, it is converted to
  54.         an ARC file. You must have LUE.COM available in the DOS path.
  55.         If you plan to just convert LBR files, use an input file
  56.         specification of "*.LBR" to avoid unnecessary processing.
  57.         The LBR file is not deleted unless the /L option is supplied.
  58.         This gives you complete control of the process.
  59.  
  60.         A summary report is produced at the end of the program. It
  61.         is normally displayed on the screen, but you can have a
  62.         duplicate written to the file LARC.RPT by supplying the /R
  63.         option on the command line.
  64.  
  65.         You should have ARCA, PKXARC, PKARC, PKPAK, PKZIP, PAK, LUE
  66.         and ARC.EXE accessible from the DOS path, preferably in a RAM
  67.         disk, depending on the options supplied pn the command line. Of
  68.         course, you may substitute BAT files for any of those programs.
  69.  
  70.  
  71.                         Operation
  72.                         ---------
  73.  
  74.         Each ARC file is individually unpacked by PKXARC (so that
  75.         squashed files can be processed), and then ARCed using ARC,
  76.         PKARC, PKPAK and/or ARCA. If any of the resulting ARC files is
  77.         smaller than the original, the original is immediately
  78.         replaced. The original ARC file's date and time are preserved.
  79.  
  80.         Each PAK file is unpacked by the GSARC/PAK program. If /G is
  81.         specified, a PAK file is created in place of the original
  82.         ARC file.
  83.  
  84.         Each ZIP file is unpacked with PKUNZIP. If /Z is specified,
  85.         a new ZIP file is created in place of the original ARC, LBR,
  86.         or PAK file if the ZIP file is smaller.
  87.  
  88.         It takes a long time to process several archive files. Figure
  89.         an hour for 10 megs of files on an AT.  LARC beeps when
  90.         it is finished, and displays a summary of the files processed.
  91.  
  92.         You can eliminate squashed files by using an early version
  93.         of PKARC, or by patching PKARC to disable squashing.
  94.  
  95.         I use LARC to process newly uploaded files. It is a brute
  96.         force method of testing the integrity of the files, and
  97.         results in saving disk space.
  98.  
  99.  
  100.  LARC Utility                                                          Page 3
  101.  
  102.  
  103.                         Examples
  104.                         --------
  105.  
  106.      o  There are several ARC files in the directory C:\TEST; drive
  107.         D: is an 800K RAM disk. Any smaller ARC files replace the
  108.         existing files. Only ARC is used.
  109.  
  110.              d:|cd \
  111.              larc c:\test\*
  112.  
  113.      o  All ARC files in the directory C:\UPLOADS are copied to a
  114.         new directory, C:\TEST, in their smallest versions. The disk
  115.         directory C:\WORK is the current directory and is used for
  116.         temporarily extracting ARC files. All files in C:\WORK are
  117.         deleted. Both ARCA and PKARC are used.
  118.  
  119.              c:|cd \work
  120.              larc c:\uploads\* c:\test /A/P
  121.  
  122.      o  Convert all library LBR files on C:\TEST to ARC files, and
  123.         delete the original library files. Drive d: is used for
  124.         temporary storage.
  125.  
  126.              d:
  127.              larc c:\test\*.lbr /l
  128.  
  129.      o  Replace existing ARC file on B:\ with the smallest ARC
  130.         files. Drive C: is used for temporary storage.
  131.  
  132.              c:
  133.              larc b:\* b:\ /a/p/c
  134.  
  135.  
  136.  LARC Utility                                                          Page 4
  137.  
  138.                         Version History
  139.                         ---------------
  140.  
  141.    3/15/87
  142.         Version 1.5 corrects an overflow (error 6) problem, and adds
  143.         another check to be sure that the temporary directory is
  144.         different from the input and output directories. Remember,
  145.         all files in the temporary directory are deleted.
  146.  
  147.         Also, DOS 3.1 or later is required for proper operation.
  148.         There's no guarentee of anything, anyway.
  149.  
  150.  
  151.    4/15/87
  152.         Version 1.6 adds more checks to insure that the temporary
  153.         directory is empty. Also, you may now press ESCape while
  154.         LARC is running to cancel it. A check was added to stop
  155.         processing if an error occurred creating a new ARC file
  156.  
  157. |  2/24/89
  158. |       Version 2.1 adds internal tables for specifying the various
  159. |       programs to be used. The defaults include ARCA, ARC, PAK,
  160. |       PKARC, PKPAK, and PKZIP.
  161. |  3/08/89
  162. |       Version 2.2 corrects a problem deleting original ARC files
  163.  
  164. |       Approximately 256k of memory is required.
  165.  
  166.         Use LARC at your own risk. There is no warranty or guarentee
  167.         that the program will work as expected.
  168.  
  169.  
  170.                         Notes
  171.                         -----
  172.  
  173.         (c) Copyright Vernon D. Buerg 1987-89. All rights reserved.
  174.                       139 White Oak Circle
  175.                       Petaluma, CA  94952
  176.                       VOR BBS: (707) 778-8944
  177.                       Compuserve: 70007,1212 (Go IBMSYS)
  178.  
  179.         Written in MS Quick Basic, version 2.01, using the ADVBAS
  180.         object library by Thomas Hanlin III, 6812 Sydenstricker
  181.         Rd., Springfield, VA 22152.
  182.  
  183.         The LARC program and materials may be distributed and copied
  184.         with these restrictions:
  185.  
  186.                 - no fee is charged,
  187.                 - the material is not modified.
  188.  
  189.