UHARC 0.4 high compression multimedia archiver BETA version ============================================================================== #### #### #### #### ######## ########### ########## #### #### #### #### ########## ############ ############ #### #### #### #### #### #### #### #### #### #### #### ############ ############ ########### #### #### #### ############ ############ ########### #### #### #### #### #### #### #### #### #### #### ############ #### #### #### #### #### #### ############ ########## #### #### #### #### #### #### ########## ============================================================================== Copyright(c) 1997-2001 by Uwe Herklotz All rights reserved 28 Dec 2001 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!! THIS IS A BETA VERSION AND MAY CONTAIN BUGS. USE THIS !!!!!! !!!!!! ARCHIVER AT YOUR OWN RISK. UWE HERKLOTZ, THE AUTHOR OF !!!!!! !!!!!! UHARC, WILL NOT TAKE ANY RESPONSIBILITY FOR ANY DAMAGE !!!!!! !!!!!! CAUSED BY USING OR MISUSING THIS SOFTWARE. !!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ===< 0. Contents >============================================================ 1. Introduction 2. Usage 2.1. Commands 2.2. Switches 2.3. Environment variable 3. Examples 4. Legal info / Registration 5. Contact info ===< 1. Introduction >======================================================== UHARC is a high performance file archiver. This package contains 3 files: UHARC.EXE program version for Win32 systems UHARCD.EXE program version for Dos32 systems UHARC.DOC this documentation file What's new in version 0.4 ? - improved compression and new modes (e.g. try "-mx" for PPM mode) - improved built-in detection/compression 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 Note: UHARC 0.4 archives are NOT compatible with previous versions ! This program will run on any 386 or better computer. Memory requirements depend on selected compression mode. The number of files in one operation is only limited by available memory, however current version can't handle archives with more than 2 GB total unpacked size. ===< 2. Usage >=============================================================== Usage: UHARC command [-switch..] archive[.uha] [file..@listfile..!exclude..] Commands: ~~~~~~~~~ a Create archive/Add files e Extract files to current dir m Create archive/Move files x Extract files with full path l List files in archive t Test files in archive Switches: ~~~~~~~~~ ac[-,+] Clear file archive attr ae<attr> Set attr exclusion mask b<n> Set max filebuffer size bpb[-,+] bpb instead of % ratio d<0..2> Set display mode ed[-,+] Store empty directories idle Set idle process priority lg<file> Log output to <file> m<0..3,x,z> Set compression mode md<n> Set dictionary size mm[-,+] MM-detection on/off o[-,+,p] Set overwrite mode pw[passwd] Set password p<-,r,f> Set path handling r[-,+] Recurse subdirectories t<dir> Set extract target dir vm[-,+] Set virtual memory usage y[-,+] Assume yes on all queries * For commandline help type "UHARC" without any parameter. * The command character must be placed immediately after "UHARC". * The switches, if any, must follow the command character. UHARC supports the use of either "-" or "/" as the switch option character. * The UHARC archive name must be the first filename on the commandline. If there is no archive file extension specified, UHARC will add the default (".UHA") extension. * After the archive filename come the list of files for the given operation. One or more files containing a list of files to process can also be used by prefixing the list's filename with "@". It's possible to mix filenames and list files in any order. If a filename on commandline or in a list file has prefix "!", this means it will be excluded in processing. Allowed delimiters for filenames in list files are space, tab and newline. Long filenames with spaces must be enclosed in double-quotes. The line size in list file must not exceed 4095 characters. * Filename wildcards are allowed in commandline and in list files, but not for archive filename. The use of wildcards follow MS-DOS convention. "*.*" means all files. "*.txt" means all files with an extension of ".TXT". "?B*.*" means all files with a second character of "B". * If there are no files specified at all, all files ("*.*") will be processed (use "-r" to recurse subdirectories). ---< 2.1. Commands >---------------------------------------------------------- a Create archive and add matching files. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If a file with the archive name already exists, UHARC will ask before overwriting this file, unless you change the default overwrite mode or use "-y". Following switches have effect: ac ae b bpb d ed lg m md mm o p pw r y e Extract matching files to current directory. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Stored pathnames will be ignored. Using the switch "-t", you can change the current directory for extracting. Following switches have effect: b d lg o pw t y l List matching files in archive. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Using switch "-y", UHARC will not pause after one page, else you can use the following keys: ESCAPE = Cancel (quit program) TAB = Disable pause RETURN = Next line other keys = Next page Using switch "-d2", filenames are not shortened and more information are displayed. Following switches have effect: b bpb d lg pw y m Create archive and move matching files. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If a file with the archive name already exists, UHARC will ask before overwriting this file, unless you change the default overwrite mode or use "-y". If compression was successful, UHARC will delete matching files on disk (but no directories). Following switches have effect: ae b bpb d ed lg m md mm o p pw r y t Test integrity of ALL files in archive. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Following switches have effect: b d lg pw y x Extract matching files with full pathnames. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UHARC will use the pathnames stored in archive for extraction (if the archive was created with option "-pf", this also includes drive letters). Using the switch "-t", you can select the root-directory for all extracted dirs/files. Following switches have effect: b d lg o pw t y Note: During all operations it's possible to terminate the process by pressing ESCAPE and answering the following question with "Y" (when listing files, there is no additional query). ---< 2.2. Switches >---------------------------------------------------------- -ac[-,+] Clear file archive attribute ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -ac[+] Clear archive attribute of files store in archive. -ac- Don't clear archive attribute. If this option is enabled and compression was successful, UHARC will clear the archive attribute of all files which are stored in archive (directories are not affected). This option has effect with add command only. DEFAULT: -ac- -ae<attr> Set attribute exclusion filter ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Defines the filter for exclusion based on file attributes. Files are excluded if specified attributes are set "+" or cleared "-". File attributes are: "A" archive attribute "H" hidden file attribute "R" read-only attribute "S" system file attribute Example: switch "-aeA-H+" means that files with archive attribute cleared or hidden attribute set are not included in the processing list. This option has effect with add or move commands only. DEFAULT: not specified -b<n> Set maximum file buffer size (in KB). ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ After allocating all structures for (de)compression the remaining memory is used for file buffers, but never more than <n>. The minimum buffer size is 50 KB. DEFAULT: -b1024 -bpb[-,+] Show bpb in...
tu22