home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource3 / 188_01 / arc500.doc < prev    next >
Text File  |  1987-10-01  |  59KB  |  1,921 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                        ARC
  22.  
  23.                               File Archive Utility
  24.                                    Version 5.0
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.      (C) COPYRIGHT 1985, 1986 by System Enhancement Associates;
  43.          ALL RIGHTS RESERVED
  44.  
  45.  
  46.  
  47.  
  48.  
  49.      This document describes the ARC file utility, version 5.0, which was
  50.      created by System Enhancement Associates in January of 1986.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                 Table of Contents                                Table of Contents
  63.  
  64.  
  65.  
  66.      Introduction  ....................................................   1
  67.      Using ARC  .......................................................   3
  68.      ARC commands  ....................................................   4
  69.          Adding files  ................................................   4
  70.          Extracting files  ............................................   6
  71.          Deleting files  ..............................................   6
  72.          Listing archive entries  .....................................   7
  73.          Printing files  ..............................................   9
  74.          Running files  ...............................................   9
  75.          Testing an archive  ..........................................  10
  76.          Converting an archive  .......................................  10
  77.      ARC options  .....................................................  11
  78.          Suppressing compression  .....................................  11
  79.          Backup retention  ............................................  12
  80.          Message suppression  .........................................  13
  81.          Encryption/decryption  .......................................  14
  82.      RAMdisk support  .................................................  15
  83.      MARC  ............................................................  16
  84.      XARC  ............................................................  17
  85.      Version numbers  .................................................  18
  86.      Program update service  ..........................................  19
  87.      Common questions and answers  ....................................  20
  88.      Revision history  ................................................  22
  89.          Changes in version 3  ........................................  22
  90.          Changes in version 4  ........................................  22
  91.          Changes in version 4.1  ......................................  23
  92.          Changes in version 4.3  ......................................  23
  93.          Changes in version 4.4  ......................................  24
  94.          Changes in version 4.5  ......................................  24
  95.          Changes in version 5.0  ......................................  25
  96.      Program history and credits  .....................................  27
  97.      Site license  ....................................................  28
  98.      Order form  ......................................................  30
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                   INTRODUCTION                                  INTRODUCTION
  123.  
  124.  
  125.  
  126.      ARC is the copyrighted property of System Enhancement Associates.  You
  127.      are granted a limited license to use ARC, and to copy it and
  128.      distribute it, provided that the following conditions are met:
  129.  
  130.      1) No fee may be charged for such copying and distribution.
  131.  
  132.      2) ARC may ONLY be distributed in its original, unmodified state.
  133.  
  134.  
  135.      Any voluntary contributions for the use of this program will be
  136.      appreciated, and should be sent to:
  137.  
  138.                           System Enhancement Associates
  139.                                   21 New Street
  140.                                 Wayne, NJ   07470
  141.  
  142.      You may not use this product in a commercial environment or a
  143.      governmental organization without paying a license fee of $35.  Site
  144.      licenses and commercial distribution licenses are available.  A
  145.      program disk and printed documentation are available for $50.  See the
  146.      order form in the back of this manual for more details.
  147.  
  148.  
  149.  
  150.      A word about user supported software:
  151.  
  152.                                                                  freeware     The user supported software concept (usually referred to as freeware)
  153.      is an attempt to provide software at low cost.  The cost of offering a
  154.      new product by conventional means is staggering, and hence dissuades
  155.      many independent authors and small companies from developing and
  156.      promoting their ideas.  User supported software is an attempt to
  157.      develop a new marketing channel, where products can be introduced at
  158.      low cost.
  159.  
  160.      If user supported software works, then everyone will benefit.  The
  161.      user will benefit by receiving quality products at low cost, and by
  162.      being able to "test drive" software thoroughly before purchasing it.
  163.      The author benefits by being able to enter the commercial software
  164.      arena without first needing large sources of venture capital.
  165.  
  166.      But it can only work with your support.  We're not just talking about
  167.      ARC here, but about all user supported software.  If you find that you
  168.      are still using a program after a couple of weeks, then pretty
  169.      obviously it is worth something to you, and you should send in a
  170.      contribution.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      ARC                                                           Page   1
  181.      And now, back to ARC:
  182.  
  183.      ARC is used to create and maintain file archives.  An archive is a
  184.      group of files collected together into one file in such a way that the
  185.      individual files may be recovered intact.
  186.  
  187.      ARC is different from other archive and library utilities in that it
  188.      automatically compresses the files being archived, so that the
  189.      resulting archive takes up a minimum amount of space.
  190.  
  191.      When ARC is used to add a file to an archive it analyzes the file to
  192.      determine which of four storage methods will result in the greatest
  193.      savings.  These four methods are:
  194.  
  195.      1) No compression; the file is stored as is.
  196.  
  197.      2) Repeated-character compression; repeated sequences of the same byte
  198.         value are collapsed into a three-byte code sequence.
  199.  
  200.      3) Huffman squeezing; the file is compressed into variable length bit
  201.         strings, similar to the method used by the SQ programs.
  202.  
  203.      4) Dynamic Lempel-Zev compression;  the file is stored as a series of
  204.         variable size bit codes which represent character strings, and
  205.         which are created "on the fly".
  206.  
  207.      Note that since one of the four methods involves no compression at
  208.      all, the resulting archive entry will never be larger than the
  209.      original file.
  210.  
  211.  
  212.      An interesting note:  It has been brought to our attention that BASIC
  213.                                                        not     programs compress to a smaller size when they are not tokenized.  If
  214.      you are more concerned with space than speed, you may wish to convert
  215.      your BASIC programs to ASCII form before adding them to an archive.
  216.      Your BASIC manual should give instructions on how to do this.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.      ARC                                                           Page   2
  241.  
  242.                                     USING ARC                                    USING ARC
  243.  
  244.  
  245.  
  246.      ARC is invoked with a command of the following format:
  247.  
  248.          ARC <x> <arcname> [<template> . . .]
  249.  
  250.      Where:
  251.  
  252.          <x> is an ARC command letter (see below), in either upper or lower
  253.          case.
  254.  
  255.          <arcname> is the name of the archive to act on, with or without an
  256.          extension.  If no extension is supplied, then ".ARC" is assumed.
  257.          The archive name may include path and drive specifiers.
  258.  
  259.          <template> is one or more file name templates.  The "wildcard"
  260.          characters "*" and "?" may be used.  A file name template ma