home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / UNARJ.LZH / UNARJ.DOC < prev    next >
Text File  |  1991-05-24  |  7KB  |  197 lines
  1.  
  2.      UNARJ.DOC, UNARJ 2.10                  May 1991
  3.  
  4.  
  5.     UNARJ software and manual copyright (c) 1991 by Robert K Jung.
  6.     All rights reserved.
  7.  
  8.     UNARJ version 2.10 release
  9.  
  10.  
  11.      This documents new or updated information since UNARJ 2.00.
  12.  
  13.  
  14.      ** IMPORTANT NEWS ****************************************************
  15.  
  16.      There is an extended header bug in older versions of ARJ, AV.C and
  17.      UNARJ.C.  The extended header processing in read_header() should
  18.      skip 4 bytes for the extended header CRC and not 2 bytes.    This is
  19.      NOT a current problem as no versions of ARJ use the extended
  20.      header.
  21.  
  22.      The following source line in DECODE.C is AMBIGUOUS and has been
  23.      corrected.
  24.  
  25.     weight[i++] = 1 << (16 - i);
  26.  
  27.      **********************************************************************
  28.  
  29.      Now included is the C source code for a simple UNARJ extractor
  30.      program.  It has been portabilized courtesy of Mark Adler for
  31.      platforms that do not support ANSI C.  This UNARJ is NOT meant for use
  32.      as a production quality ARJ extractor.  It is meant for the use of 3rd
  33.      party developers who want to build file readers, etc, for ARJ.  The
  34.      UNARJ source code has been built and tested under Turbo C++ 1.0 and
  35.      Quick C 2.5.
  36.  
  37.      It has none of the program protection and other fancy features of
  38.      ARJ 2.10.    It is also VERY SLOW compared to ARJ!!!  In ARJ, all of
  39.      the critical routines are written in assembly language.
  40.  
  41.  
  42.      COMMAND SYNTAX:
  43.  
  44.      UNARJ has been modified to support the four commands: "e", "l", "t",
  45.      and "x".  These are equivalent to the ARJ version of these commands.
  46.      However, UNARJ does not create directories when using the "x" command.
  47.  
  48.      Usage:  UNARJ archive[.arj]    (list archive)
  49.          UNARJ e archive        (extract archive)
  50.          UNARJ l archive        (list archive)
  51.          UNARJ t archive        (test archive)
  52.          UNARJ x archive        (extract with pathnames)
  53.  
  54.      UNARJ does not accept any other commands or options.  You cannot
  55.      specify a base directory or select individual files to extract.  UNARJ
  56.      does not support empty directories or volume labels.  UNARJ is much
  57.      slower than ARJ because ARJ is highly optimized using assembly
  58.      language.
  59.  
  60.  
  61.      "e" extract command
  62.  
  63.      This command extracts the contents of the ARJ archive to the current
  64.      directory.  Files in the archive that already exist in the current
  65.      directory will not be extracted.
  66.  
  67.  
  68.      "l" list command
  69.  
  70.      This command lists the contents of the archive to the screen.  The
  71.      UNARJ l command replaces the old AV.EXE program.
  72.  
  73.      The last field on the display TPMGVX stands for:
  74.      T -> text/binary/directory/volume label type
  75.      P -> path information available in "V" listing
  76.      M -> compression method used
  77.      G -> file has been garbled (encrypted)
  78.      V -> archive has been continued to another volume
  79.      X -> this file is an extended portion of a larger file
  80.  
  81.  
  82.      "t" test command
  83.  
  84.      This command tests the contents of the archive by extracting the files
  85.      to the NUL device (no data will be written to disk).  If the contents
  86.      of a file is corrupted, UNARJ will display "CRC error!".  If the
  87.      contents are valid, UNARJ will display "CRC OK".
  88.  
  89.  
  90.      "x" extract with pathnames command
  91.  
  92.      This command extracts the contents of the ARJ archive to the pathnames
  93.      stored in the archive.  If only filespecs are stored in the archive,
  94.      then the files will be extracted to the current directory.  UNARJ will
  95.      not create missing directories in the pathnames.  You must create them
  96.      manually.    Use the UNARJ t command to see the full pathnames stored in
  97.      the archive.
  98.  
  99.  
  100.      PROGRESS INDICATOR
  101.  
  102.      UNARJ uses a small spinning bar to indicate extraction/testing
  103.      progress.
  104.  
  105.  
  106.      BUILDING THE UNARJ PROGRAM
  107.  
  108.      Source files:  UNARJ.C, DECODE.C, ENVIRON.C, UNARJ.H, UNARJ.DEF,
  109.             TCCUNARJ.MAK, QCLUNARJ.MAK, OS2UNARJ.MAK.
  110.  
  111.      For Turbo C/C++, type MAKE -ftccunarj.mak
  112.  
  113.      For QuickC,      type NMAKE /F qclunarj.mak
  114.  
  115.      For OS/2,          type NMAKE /F os2unarj.mak
  116.  
  117.      If you use a compiler other than listed above, the resulting UNARJ.EXE
  118.      will not support restoring file date-time stamps or file attributes.
  119.      You can modify the ENVIRON.C file to add these functions for your
  120.      particular implementation environment.
  121.  
  122.      For UNIX,          type cc unarj.c decode.c environ.c
  123.  
  124.      Send me your implementations and I will try to incorporate them into
  125.      the next version of UNARJ.
  126.  
  127.  
  128.      UNARJ LICENSE POLICY FOR ALL USERS:
  129.  
  130.      You may freely use the UNARJ C source code provided the end product is
  131.      NOT a file archiver (compress and extract).  If you wish to distribute
  132.      a modified version of this program, you MUST include the source code
  133.      and indicate that it is a modified version both in the program and
  134.      source code.
  135.  
  136.      If you modify this program, I would appreciate a copy of the new source
  137.      code.  I am holding the copyright on the source code, so please do not
  138.      delete my name from the program files or the documentation.
  139.  
  140.      The UNARJ.EXE program is built from this source using Turbo C++ 1.0.
  141.  
  142.      You may freely use, copy, and distribute this program, provided that
  143.      no fee is charged for such use, copying or distribution, and it is
  144.      distributed ONLY in its original unmodified state.
  145.  
  146.  
  147.      TECHNICAL SUPPORT:
  148.  
  149.      Please report any bugs.  I will TRY to fix them.  If you have
  150.      portability improvements, I would appreciate receiving a copy of them.
  151.  
  152.      If you find UNARJ of value, a gift of 10 dollars or any amount would be
  153.      greatly appreciated.
  154.  
  155.      I can be reached at:
  156.  
  157.      Robert Jung at Wonderland BBS           (508) 663-6220
  158.  
  159.      Robert Jung at Dimensional Crossroads BBS (508) 427-5379
  160.  
  161.      Robert Jung at Bay State BBS           (617) 598-6646
  162.  
  163.      Robert Jung at FIDONET address:  1:16/390.7
  164.  
  165.      Robert Jung in the COMPRESS (ILINK), LHARC / COMPRESSIONS
  166.      (SMARTNET), SHARE (RIME) or ARCHIVERS (RELAYNET) echo conferences.
  167.  
  168.      2606 Village Road West
  169.      Norwood, Massachusetts 02062
  170.      USA
  171.  
  172.      Internet address:    robjung@world.std.com  (Checked daily)
  173.  
  174.      Compuserve users can enter   >INTERNET: robjung@world.std.com
  175.      at the "Send to" prompt.  I prefer CompuServe users to send mail
  176.      to this address as opposed to my CompuServe userid below.
  177.  
  178.      CompuServe userid: 72077,445  (Checked infrequently)
  179.  
  180.  
  181.      DISCLAIMER:
  182.  
  183.      This software UNARJ is provided on an "as is" basis without warranty
  184.      of any kind, expressed or implied, including but not limited to the
  185.      implied warranties of merchantability and fitness for a particular
  186.      purpose.  The person using the software bears all risk as to the
  187.      quality and performance of the software. Should the software prove
  188.      defective, the user assumes the entire cost of all necessary repair,
  189.      servicing, or correction.    The author will not be liable for any
  190.      special, incidental, consequential, indirect or similar damages due to
  191.      loss of data or any other reason, even if the author or an agent of
  192.      the author has been advised of the possibility of such damages.
  193.  
  194.  
  195.    end document
  196.  
  197.