uharc_readme.doc

beat版 一看就懂

                 2. If data stream size is smaller than <n>, UHARC will use
                    the smallest dictionary size which is greater than the
                    data stream.
                 3. If there is not enough memory for current selection,
                    UHARC will use the largest dictionary size which is
                    possible with available memory.

               DEFAULT: -md4096


  -md[-,+]     Disable/enable dictionary-based compression.
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
               This has effect only with modes "-m1", "-m2", "-m3" and "-mx".

                 -md[+]  Enable dictionary-based compression.
                 -md-    Disable dictionary-based compression.

               Generally, it's NOT RECOMMENDED to disable dictionary-based
               compression. Without dictionary, the compression ratio is
               almost always worse. But for some data types (e.g. waveform
               sounds or photographic true-color pictures), the compression
               isn't affected much by dictionary. Using "-md-" in such cases
               will speed up the compression process considerably.
               If dictionary-based compression is disabled, there are nearly
               no differences between the three modes "-m1", "-m2" and "-m3".

               DEFAULT: -md+


  -mm[-,+]     Disable/enable built-in multimedia detection/compression.
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                 -mm[+]  Enable multimedia detection/compression.
                 -mm-    Disable multimedia detection/compression.

               UHARC multimedia detection/compression supports many data
               types (8/16-bit mono/stereo waveforms, 24-bit true color
               pictures and many other types using 8/16/24/32-bit record
               sizes). It's also possible to detect multimedia-like data
               in other file types (e.g. in executables). Therefore it's
               NOT RECOMMENDED to disable multimedia detection/compression
               unless the user knows, that there is absolutely no chance
               to use multimedia compression (e.g. compressing text only).

               DEFAULT: -mm+


  -o[-,+,p]    Set overwrite mode.
               ~~~~~~~~~~~~~~~~~~~
                 -op     Prompt user before overwriting files.
                 -o[+]   Always overwrite files without asking.
                 -o-     Never overwrite existing files.

               Using -op with -y has the same effect as -o[+].
               If UHARC shows an overwrite query, the user can select one of
               the following options:
                 "Y"     Yes, overwrite current file.
                 "N"     No, don't overwrite current file.
                 "A"     Always Yes, overwrite current file and auto-answer
                         all following overwrite queries with "Y".
                 "C"     Cancel, don't overwrite and quit process.

               DEFAULT: -op


  -p<-,r,f,e>  Set path mode.
               ~~~~~~~~~~~~~~
                 -p-     Store no paths (exclude paths from names).
                 -pr     Store relative paths.
                 -pf     Store full paths including drive letter.
                 -pe     Store relative paths but exclude all paths
                         specified in commandline or in list file.

               Using option "-pr", paths are stored in relation with the
               current directory of each drive (drive letter isn't stored).
               With option "-pf" it's possible to backup data from different
               drives into one archive and restore all data correctly.
               Option "-pe" is the same as "-pr" but any path specified in
               commandline or list file is excluded from the path stored in
               archive.

               DEFAULT: -pr


  -ph[-,+]     Archive header encryption
               ~~~~~~~~~~~~~~~~~~~~~~~~~
                 -ph[+]  Encyrpt archive header.
                 -ph-    Don't encyrpt archive header.

               The archive header contains folder and file names, sizes etc.
               of the complete archive. If this header is encrypted then the
               correct password is needed even to read the archive content.

               DEFAULT: -ph+


  -pw[passwd]  Set encryption password
               ~~~~~~~~~~~~~~~~~~~~~~~
                 -pw     Request user to enter password.
                 -pw<s>  Use "s" as password.

               With switch "-pw" the user is requested to enter the password
               twice for safety reasons (input will not be echoed on screen).

               DEFAULT: not specified


  -px          Pause before program exit
               ~~~~~~~~~~~~~~~~~~~~~~~~~
               This switch tells UHARC to wait for a key stroke before exit.
               It could be useful if the console window will be closed
               automatically after program finish.


  -r[-,+]      Set subdir recursion mode.
               ~~~~~~~~~~~~~~~~~~~~~~~~~~
                 -r[+]   Recurse subdirectories.
                 -r-     Don't recurse subdirectories.

               If recursion is enabled, matching files are also searched
               in all subdirectories (regardless of directory names and
               attributes) of all specified directories (commandline and
               list files).

               DEFAULT: -r-


  -sfx[stub]   Create self-extracting archive (Win32 version ONLY !).
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
               With this option UHARC will create a self-extracting archive
               (SFX). A self-extracting archive is a Win32 executable with
               appended UHARC archive. Running a SFX archive without any
               options will extract ("x" command) the archive content to
               current directory. The SFX program supports "x", "e" and "t"
               commands for any UHARC archive (self-extracting and normal
               ones) with same command-line options as UHARC program. Other
               commands are not supported.

               [stub] is an optional parameter specifying the stub program
               used to create the SFX archive. By default stub UHARCSFX.EXE
               is used which must be located in current directory or in the
               directory where UHARC.EXE is running from.

               The SFX option is applicable only if new archive is created.
               The following DOS command can be used in order to transform
               an existing UHARC archive into SFX:
                 COPY /B UHARCSFX.EXE+"archive.uha" "archive.exe"


  -t<dir>      Set extract target directory.
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
               UHARC will store all extracted files in directory <dir>.
               If <dir> doesn't already exist, UHARC will create it.

               Using this option with the "e" command, <dir> will be the
               'current directory' for extracting. Using this option with
               the "x" command, <dir> will be the root-directory for all
               extracted dirs/files.

               DEFAULT: not specified


  -vm[-,+]     Set virtual memory usage
               ~~~~~~~~~~~~~~~~~~~~~~~~
                 -vm[+]  Use virtual memory.
                 -vm-    Don't use virtual memory.

               With virtual memory usage disabled UHARC checks free physical
               memory at program start and will not use compression modes
               that require more memory. Proper work of this option is not
               guaranteed if it is used in multitasking systems.

               DEFAULT: -vm-


  -y[-,+]      Set auto-answer mode.
               ~~~~~~~~~~~~~~~~~~~~~
                 -y[+]   Assume YES on all queries.
                 -y-     Don't auto-answer queries.

               Using the option -y[+], all queries, except critical error
               messages, don't appear on screen and are auto-answered
               with "Y".

               DEFAULT: -y-



 ---< 2.3. Environment variable >----------------------------------------------


  It's possible to define default options in the environment variable
  "UHARC_OPT". Whenever UHARC is executed, it first looks for this
  environment variable and parses the values of this variable like
  commandline switches. Any arguments in the environment variable
  can be overridden on the commandline.

  Example:
  ~~~~~~~~
    SET UHARC_OPT=-d2 -p- -lgc:\uharc.log

    When UHARC is next executed, it will use verbose display mode,
    store no paths and log all outputs to file "C:\UHARC.LOG" by default.

  Note:  If the environment variable contains a log file switch, it's
         not possible to disable log file directly. Use instead the switch
         "-lgNUL" on commandline. This overrides the default log file and
         write all log outputs to the NUL file (effective no output).



 ===< 3. Examples >============================================================


  1.    UHARC a archive *.dll @c:\list *.exe

    This will compress all "*.DLL", "*.EXE" and the files listed in the file
    "C:\LIST" to the archive file "ARCHIVE.UHA" using the default compression
    mode.


  2.    UHARC a -m3 -r -pf -o backup.arc c:\*.ini d:\*.ini c:\*.cfg d:\*.cfg

    This will compress all "*.INI" and "*.CFG" files on drives "C:" and "D:"
    to the archive file "BACKUP.ARC" using the ALZ:3 compression mode. UHARC
    will store full paths including drive letter, so it will be possible
    to restore all files on correct drives. If a file named "BACKUP.ARC"
    already exists, UHARC will overwrite this file without asking.


  3.    UHARC m -mz -md64 -mm- -r text c:\text\*.txt

    This will move all "*.TXT" files in "C:\TEXT\" and its subdirectories
    to archive file "TEXT.UHA" using LZP mode with max 64K dictionary and
    without multimedia detection/compression.


  4.    UHARC l -d2 -lguharc.lst archive a*.doc b*.doc

    This will verbosely list all "*.DOC" files with a first character of
    "A" or "B" in archive file "ARCHIVE.UHA" and log the output to file
    "UHARC.LST".


  5.    UHARC x -y arc.uha

    This will extract all files in archive "ARC.UHA" with full paths. All
    queries, except critical error messages, will be auto-answered with YES,
    so if one of the files already exists, UHARC will overwrite this file
    without asking the user.


  6.    UHARC e -td:\temp archive readme.txt

    This will extract the file "README.TXT" from archive "ARCHIVE.UHA" to
    the directory "D:\TEMP\". If this directory doesn't already exist,
    UHARC will create it.


  7.    UHARC e -o- sounds @mysounds.lst

    This will extract all files listed in "MYSOUNDS.LST" from archive
    "SOUNDS.UHA" to the current directory. UHARC will not overwrite
    existing files.


  8.    UHARC t -d2 -lglog archive

    This will test the integrity of all files in archive "ARCHIVE.UHA" and
    log the verbose output to file "LOG".


  9.    UHARC a -m3 -r -sfx MyGame "Games\My Favourite Game\*.*"

    This will compress the complete content of "Games\My Favourite Game\"
    folder (including all subfolders) to the self-extracting archive file
    "MyGame.exe" using the ALZ:3 compression mode.
    Note: SFX and long file names are supported in Win32 version only!



 ===< 4. History >=============================================================


  Date       Version
  ~~~~       ~~~~~~~
  01.10.2005   0.6b  See chapter "Introduction".

  06.02.2005   0.6a  What's new in version 0.6a ?
                       - supports self-extracting archives (SFX / Win32 only)
                       - using again PMODE/W DOS Extender

  19.12.2004   0.6   What's new in version 0.6 ?
                       - slightly improved compression (for PPM, ALZ and LZP)
                       - several bug fixes

  15.10.2002   0.5   Intermediate non-public version.

  28.12.2001   0.4   What's new in version 0.4 ?
                       - improved compression and new modes (PPM,LZP)
                       - improved built-in detection of multimedia data types
                       - support for long filenames (Win32 only)
                       - encryption of archives
                       - more archiver options (e.g. attribute filters or
                         exclusion masks)
                       - display output is written to stdout for better file
                         manager integration
                       - several bug fixes

  05.03.2000   0.3   Intermediate non-public version.

  21.12.1997   0.2   Initial public release.

  26.06.1997   0.1   First working archiver version (still non-public).



 ===< 5. Legal info / Registration >===========================================


  Disclaimer:
  ~~~~~~~~~~~
  Uwe Herklotz, the author of UHARC, disclaims any liability for any damage
  caused by using or misusing this software. The author cannot be held
  responsible for data loss or other damages and any consequences from this
  loss or damages.

  !!  U S E   T H I S   P R O G R A M   A T   Y O U R   O W N   R I S K  !!

  ----------------------------------------------------------------------------
  This software is Copyright(c) 1997-2005 by Uwe Herklotz. All rights reserved
  ----------------------------------------------------------------------------

  UHARC is freeware for non-commercial use. UnUHARC programs can be freely
  distributed without any restriction. See License.doc for details.
  The current beta version is mainly intended for testing and evaluation,
  so please ensure that the archiver can correctly extract if it is used
  for any important data.

  If you have any problems or questions then please feel free to contact
  me at the e-mail address below.



 ===< 6. Contact info >========================================================


  If you have any advice, comments, bug reports or requests for info,
  you can send e-mail to:

                   [e-mail]

  or mail to:      Uwe Herklotz
                   Irkutsker Str. 111
                   09119 Chemnitz
                   Germany



 ##############################################################################
 UHARC Copyright(c) 1997-2005 by Uwe Herklotz               All rights reserved