home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c019 / 1.ddi / ARC521_C / ARC.DOC < prev    next >
Encoding:
Text File  |  1988-08-01  |  10.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      AAARRRCCC(((111LLL)))                LLLooocccaaalll (((111222 JJJuuunnn 111999888888)))                AAARRRCCC(((111LLL)))
  5.  
  6.  
  7.  
  8.      NNNAAAMMMEEE
  9.           arc - pc archive utility
  10.  
  11.      SSSYYYNNNOOOPPPSSSIIISSS
  12.           aaaarrrrcccc a|m|u|f|d|x|e|r|p|l|v|t|c [ biswnoq ] [ g_p_a_s_s_w_o_r_d ]
  13.           _a_r_c_h_i_v_e [ _f_i_l_e_n_a_m_e ...]
  14.  
  15.      DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  16.           _A_r_c is a general archive and file compression utility, used
  17.           to maintain a compressed archive of files.  An _a_r_c_h_i_v_e is a
  18.           single file that combines many files, reducing storage space
  19.           and allowing multiple files to be handled as one.  _A_r_c uses
  20.           one of several compression methods for each file within the
  21.           _a_r_c_h_i_v_e, based on whichever method yields the smallest
  22.           result.
  23.  
  24.      IIINNNSSSTTTRRRUUUCCCTTTIIIOOONNNSSS
  25.           Execute _a_r_c with no arguments for fairly verbose, usable
  26.           instructions.
  27.  
  28.      CCCOOOMMMMMMAAANNNDDD SSSWWWIIITTTCCCHHHEEESSS
  29.           a  add files to archive.  Copies the indicated files to the
  30.              archive.
  31.  
  32.           m  move files to archive.  Same as 'a' switch except that
  33.              the files are deleted from the directory as they are
  34.              moved to the archive.
  35.  
  36.           u  update files in archive.  This switch will replace
  37.              archived files when the named file is newer than the
  38.              archived copy.  New files will be added automatically.
  39.  
  40.           f  freshen files in archive.  Same as 'u' except that new
  41.              files will not be added.
  42.  
  43.           d  delete files in archive.  The named files are removed
  44.              from the archive.
  45.  
  46.           x,e
  47.              extract files from archive.  The named files are
  48.              extracted from the archive and created in the current
  49.              directory in an uncompressed state.
  50.  
  51.           r  run one file with arguments from archive.  Any program
  52.              may be executed directly from the archive.  The
  53.              parameters given after the program name are passed to the
  54.              program without modification.
  55.  
  56.           p  copy files from archive to standard output.  Useful with
  57.              I/O redirection. A form-feed is appended after each file,
  58.              to ease use with printers.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 8/1/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAARRRCCC(((111LLL)))                LLLooocccaaalll (((111222 JJJuuunnn 111999888888)))                AAARRRCCC(((111LLL)))
  71.  
  72.  
  73.  
  74.           l  list files in archive.  Limited information listing of
  75.              files contained in an archive.  Displays the filename,
  76.              original length, and date last modified.  If the 'n'
  77.              option (see below) is used, only the filename is
  78.              displayed.
  79.  
  80.           v  verbose listing of files in archive.  Complete
  81.              information listing of files contained in an archive.
  82.              Displays the filename, original length, storage method,
  83.              storage factor (% savings), compressed size, date, time,
  84.              and CRC.
  85.  
  86.           t  test archive integrity.  Computes CRC values for each
  87.              member of the archive and compares against the previously
  88.              saved value.
  89.  
  90.           c  convert entry to new packing method.  Convert files
  91.              stored with older methods to newer methods that are more
  92.              efficient. Also useful for files previously archived with
  93.              the 's' option.
  94.  
  95.      OOOPPPTTTIIIOOONNNSSS
  96.           b  retain backup copy of archive.  Keep the original archive
  97.              file and rename to .BAK.  This switch may be used with
  98.              the following commands:  a, m, u, f, d, c.
  99.  
  100.           i  suppress image mode.  This switch causes files to be
  101.              treated as text files, and will translate their end-of-
  102.              line sequence. (Unix's '\n' vs. '\r\n' used on many other
  103.              systems.)  The default is to perform no translation when
  104.              compressing or extracting files.  This option makes
  105.              dealing with text files much nicer, though the 'tr'
  106.              command can also be used. ('\r' in makefiles and C source
  107.              code is such a nuisance...)
  108.  
  109.           s  suppress compression.  This forces new files to be saved
  110.              using Method 2 (no compression).  This switch may be used
  111.              with the following commands:  a, m, u, f, c.
  112.  
  113.           w  suppress warning messages.  This switch will keep warning
  114.              messages from being displayed which is the default.  Most
  115.              warnings concern the deletion or existence of files with
  116.              the same name.
  117.  
  118.           n  suppress notes and comments.  This switch will keep
  119.              useful notes from being displayed which is the default.
  120.              Most notes indicate what stage of compression is being
  121.              run (analyze, compaction, storage).
  122.  
  123.           o  overwrite existing files when extracting.  This switch
  124.              will make existing files silently get overwritten,
  125.              instead of asking for confirmation, which is the default.
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 8/1/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      AAARRRCCC(((111LLL)))                LLLooocccaaalll (((111222 JJJuuunnn 111999888888)))                AAARRRCCC(((111LLL)))
  137.  
  138.  
  139.  
  140.           q  force Squash compression method.  This switch causes the
  141.              Squash compression method to be used, instead of Crunch,
  142.              which is the default.
  143.  
  144.           g  encrypt/decrypt archive entry.  This is used to encode
  145.              files so that others may not read them.  BE CAREFUL!
  146.              This must be the last parameter in the switches because
  147.              everything following is part of the password.
  148.  
  149.      PPPRRROOOGGGRRRAAAMMMMMMIIINNNGGG NNNOOOTTTEEESSS
  150.           _A_r_c Version 2 differs from version 1 in that archive entries
  151.           are automatically compressed when they are added to the
  152.           archive, making a separate compression step unecessary.  The
  153.           nature of the compression is indicated by the header version
  154.           number placed in each archive entry, as follows:
  155.                    1 = Old style, no compression
  156.                    2 = New style, no compression
  157.                    3 = Compression of repeated characters only
  158.                    4 = Compression of repeated characters plus Huffman SQueezing
  159.                    5 = Lempel-Zev packing of repeated strings (old style)
  160.                    6 = Lempel-Zev packing of repeated strings (new style)
  161.                    7 = Lempel-Zev Williams packing with improved hash function
  162.                    8 = Dynamic Lempel-Zev packing with adaptive reset
  163.                    9 = Squashing
  164.  
  165.           Type 5, Lempel-Zev packing, was added as of version 4.0
  166.  
  167.           Type 6 is Lempel-Zev packing where runs of repeated
  168.           characters have been collapsed, and was added as of version
  169.           4.1
  170.  
  171.           Type 7 is a variation of Lempel-Zev using a different hash
  172.           function which yields speed improvements of 20-25%, and was
  173.           added as of version 4.6
  174.  
  175.           Type 8 is a different implementation of Lempel-Zev, using a
  176.           variable code size and an adaptive block reset, and was
  177.           added as of version 5.0
  178.  
  179.           Type 9 is another variation of Lempel-Zev, using a larger
  180.           hash table. This method was developed by Phil Katz, and is
  181.           not supported by the "official" AAAARRRRCCCC programs.
  182.  
  183.           _A_r_c will look for environment variables named _A_R_C_T_E_M_P or
  184.           _T_M_P_D_I_R, which, if present, indicates the pathname where
  185.           temporary files should be created. This is typically the
  186.           location of a RAMdisk on a microcomputer, "/tmp/" or left
  187.           unset.
  188.  
  189.           See the included documentation file for more details.
  190.  
  191.      HHHIIISSSTTTOOORRRYYY
  192.  
  193.  
  194.  
  195.      PPPaaagggeee 333                                           (((ppprrriiinnnttteeeddd 888///111///888888)))
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      AAARRRCCC(((111LLL)))                LLLooocccaaalll (((111222 JJJuuunnn 111999888888)))                AAARRRCCC(((111LLL)))
  203.  
  204.  
  205.  
  206.           _A_r_c has been in use in the CP/M and MSDOS world for many
  207.           years.  Thom Henderson developed the original version, but
  208.           it is important to note that _a_r_c is based on the file
  209.           compression theories developed by Huffman, Welch, Knott,
  210.           Knuth, and many other scientists. This implementation is
  211.           based on version 5.21 of the MSDOS program.
  212.  
  213.      BBBUUUGGGSSS
  214.           _A_r_c behaves just like the PC version of the program; all
  215.           functions of the "usage" display are working.  Full
  216.           compatibility with PC ARC files is maintained, the price for
  217.           which is that _a_r_c doesn't like long filenames, and can only
  218.           archive files with names of up to 12 characters.  It will
  219.           *sometimes* do The Right Thing with them, but I suggest you
  220.           put long-winded filenames in a "shar" before _a_r_cing them.
  221.  
  222.           There shouldn't be any problems, (hah!) but if you find any,
  223.           please send them to me at:
  224.  
  225.                hyc@umix.cc.umich.edu      {rutgers, uunet}!umix!hyc
  226.  
  227.  
  228.      AAAUUUTTTHHHOOORRRSSS
  229.           Original MSDOS program by Thom Henderson
  230.           COPYRIGHT(C) 1985-87 by System Enhancement Associates; ALL
  231.           RIGHTS RESERVED
  232.  
  233.           Original Lempel-Zev code derived from compress 4.0.
  234.           Modified to support Squashing by Dan Lanciani
  235.           (ddl@harvard.edu) Ported from MSDOS by Howard Chu
  236.           (umix!hyc), with help from John Gilmore (hoptoad!gnu), James
  237.           Turner (daisy!turner) and others.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 8/1/88)
  262.  
  263.  
  264.  
  265.