home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 June / PCWorld_2002-06_cd.bin / Software / Topware / winrar / wrar290.exe / Rar.txt < prev    next >
Encoding:
Text File  |  2001-08-02  |  38.5 KB  |  1,067 lines

  1.                              User's Manual
  2.                              ~~~~~~~~~~~~~
  3.                      RAR 2.90 32-bit console version
  4.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.                        =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  7.                        Welcome to the RAR Archiver!
  8.                        -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  9.  
  10.  Introduction
  11.  ~~~~~~~~~~~~
  12.  
  13.     RAR is a powerful tool which allows you to manage and control archive
  14.   files. The archive is usually a regular file, which name has a ".rar"
  15.   suffix.
  16.  
  17.   RAR features include:-
  18.  
  19.     *  Highly sophisticated, original compression algorithm
  20.     *  Special compression algorithm optimized for multimedia data
  21.     *  Better compression than similar tools, using 'solid' archiving
  22.     *  Authenticity verification (registered version only)
  23.     *  Self-extracting archives and volumes (SFX)
  24.     *  Ability to recover physically damaged archives
  25.     *  Locking, password, file order list, file security & more ...
  26.  
  27.  
  28.  Configuration file
  29.  ~~~~~~~~~~~~~~~~~~
  30.  
  31.   RAR for Unix and BeOS read configuration information from the file
  32.   .rarrc in the user's home directory (stored in HOME environment variable)
  33.   or in /etc directory.
  34.  
  35.   RAR for Windows reads configuration information from the file rar.ini,
  36.   placed in the same directory as the rar.exe file.
  37.  
  38.   This file may contain the following string:
  39.  
  40.   switches=<any RAR switches, separated with a space>
  41.  
  42.  
  43.  Environment variable
  44.  ~~~~~~~~~~~~~~~~~~~~
  45.  
  46.     Default parameters may be added to the RAR command line by establishing
  47.     an environment variable "RAR".
  48.  
  49.     For instance, in UNIX following lines may be added to your profile:
  50.  
  51.       RAR='-s -md1024'
  52.       export RAR
  53.  
  54.     RAR will use this string as default parameters in the command line and
  55.     will create "solid" archives with 1024 KB sliding dictionary size.
  56.  
  57.     RAR handles options with priority as following:
  58.  
  59.        command line switches                   highest priority
  60.        switches in the RAR variable            lower priority
  61.        switches saved in configuration file    lowest priority
  62.  
  63.  
  64.  Log file
  65.  ~~~~~~~~
  66.  
  67.   If the switch -ilog is specified in the command line or configuration
  68.   file, RAR will write informational messages, concerning errors
  69.   encountered while processing archives, to a log file.  In Unix and BeOS
  70.   this file is named .rarlog and placed in the user's home directory.
  71.   In Windows it is named rar.log and placed in the same directory as
  72.   the rar.exe file.
  73.  
  74.  
  75.  The file order list for solid archiving - rarfiles.lst
  76.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  77.  
  78.   rarfiles.lst contains user-defined file list which tells RAR
  79.   the order to add files to a solid archive. It may contain file
  80.   names, wildcards and special entry - $default. The default
  81.   entry defines the place in order list for files not matched
  82.   with other entries in this file. The comment character is ';'.
  83.  
  84.   In Windows this file should be placed in the same directory as RAR,
  85.   in Unix and BeOS - to the user's home directory or to /etc.
  86.  
  87.   Tips to provide improved compression and speed of operation:
  88.  
  89.   - similar files should be grouped together in the archive;
  90.   - frequently accessed files should be placed at the beginning.
  91.  
  92.  
  93.  RAR command line syntax
  94.  ~~~~~~~~~~~~~~~~~~~~~~~
  95.  
  96.  Syntax
  97.  
  98.     RAR <command>  [ -<switches> ]  <archive>  [ <@listfiles...> ]
  99.         [ <files...> ]  [ <path_to_extract\> ]
  100.  
  101.  Description
  102.  
  103.     Command line options (commands and switches) provides control of
  104.     creating and managing archives with RAR. The command is a string (or a
  105.     single letter) which commands RAR to perform a corresponding action.
  106.     Switches are designed to modify the way RAR performs the action. Other
  107.     parameters are archive name and files to be archived into or extracted
  108.     from the archive.
  109.  
  110.     Listfiles are plain text files contained names of files to process.
  111.     File names should start at the first column. It is possible to
  112.     put comments to the listfile after // characters. For example,
  113.     you may create backup.lst containing the following strings:
  114.  
  115.     c:\work\doc\*.txt         //backup text documents
  116.     c:\work\image\*.bmp       //backup pictures
  117.     c:\work\misc
  118.  
  119.     and then run:
  120.  
  121.        rar a backup @backup.lst
  122.  
  123.     If you wish to read file names from stdin (standard input),
  124.     specify the empty listfile name (just @).
  125.  
  126.     You may specify both usual file names and list files in the same
  127.     command line. If neither files nor listfiles are specified,
  128.     then *.* is implied and RAR will process all files
  129.  
  130.     In a UNIX environment you need to quote wildcards to avoid them being
  131.     processed by RAR itself. For example, this command will extract
  132.     *.asm files from RAR archives in current path:
  133.  
  134.        rar e '*.rar' '*.asm'
  135.  
  136.  
  137.     Command could be any of the following:
  138.  
  139.     a       Add files to archive.
  140.  
  141.             Example:
  142.  
  143.             create or update existent archive myarch, adding all files
  144.             in the current directory
  145.  
  146.             rar a myarch
  147.  
  148.  
  149.     c       Add archive comment. Comments are displayed while the archive is
  150.             being processed. Comment length is limited to 62000 bytes
  151.  
  152.             Examples:
  153.  
  154.             rar c distrib.rar
  155.  
  156.             Also comments may be added from a file:
  157.  
  158.             rar c -zinfo.txt dummy
  159.  
  160.  
  161.     cf      Add files comment. File comments are displayed when the 'v'
  162.             command is given. File comment length is limited to 32767 bytes.
  163.  
  164.             Example:
  165.  
  166.             rar cf bigarch *.txt
  167.  
  168.  
  169.     cw      Write archive comment to specified file.
  170.  
  171.             Example:
  172.  
  173.             rar cw oldarch comment.txt
  174.  
  175.  
  176.     d       Delete files from archive. Note, if the processing of this
  177.             command resulted in removing all the files from the archive, the
  178.             empty archive would removed.
  179.  
  180.  
  181.     e       Extract files to current directory.
  182.  
  183.  
  184.     f       Freshen files in archive. Updates those files changed since they
  185.             were packed to the archive. This command will not add new files
  186.             to the archive.
  187.  
  188.  
  189.     k       Lock archive. Any command which intends to change the archive
  190.             will be ignored.
  191.  
  192.             Example:
  193.  
  194.             rar k final.rar
  195.  
  196.  
  197.     l[t]    List contents of archive [technical]. Files are listed as with
  198.             the 'v' command with the exception of the file path. i.e. only
  199.             the file name is displayed. Optional technical information is
  200.             displayed when 't' modifier is used.
  201.  
  202.  
  203.     m[f]    Move to archive [files only]. Moving files and directories
  204.             results in the files and directories being erased upon
  205.             successful completion of the packing operation. Directories will
  206.             not be removed if 'f' modifier is used and/or '-ed' switch is
  207.             applied.
  208.  
  209.  
  210.     p       Print file to stdout.
  211.  
  212.  
  213.     r       Repair archive. Archive repairing is performed in two stages.
  214.             First, the damaged archive is searched for a recovery record
  215.             (see 'rr' command). If the archive contains a recovery record
  216.             and if the portion of the damaged data is continuous and less
  217.             than N*512 bytes, where N is number of recovery sectors placed
  218.             into the archive, the chance of successful archive
  219.             reconstruction is very high. When this stage has completed, a
  220.             new archive will be created, called _RECOVER.RAR.
  221.  
  222.             If a broken archive does not contain a recovery record or if
  223.             the archive is not completely recovered due to major damage, a
  224.             second stage is performed. During this stage only the archive
  225.             structure is reconstructed and it is impossible to recover
  226.             files which fail the CRC validation, it is still possible to
  227.             recover undamaged files which were inaccessible due to the
  228.             broken archive structure. Mostly this is useful for non-solid
  229.             archives.
  230.  
  231.             When the second stage is completed, the reconstructed archive
  232.             will be saved as _RECONST.RAR.
  233.  
  234.             While the recovery is in progress, RAR may prompt the user for
  235.             assistance when a suspicious file is detected.
  236.  
  237.                       Suspicious entry
  238.  
  239.               Name:  <possibly filename>
  240.               Size:  <size>    Packed: <compressed size>
  241.  
  242.                       Add it: Yes/No/All
  243.  
  244.             Answer 'y' to add this entry to the file _RECOVER.RAR.
  245.  
  246.             Example:
  247.  
  248.             rar r buggy.rar
  249.  
  250.  
  251.     rr[N]   Add data recovery record. Optionally, redundant information
  252.             (recovery record) may be added to an archive.  This will cause
  253.             a small increase of the archive size and helps to recover
  254.             archived files in case of floppy disk failure or data losses of
  255.             any other kind. A recovery record contains up to 32768 recovery
  256.             sectors. The number of sectors may be specified directly in the
  257.             'rr' command (N = 1, 2 .. 32768) or if it is not specified by the
  258.             user it will be selected automatically according to the archive
  259.             size: a size of the recovery information will be about 1%
  260.             of the total archive size, usually allowing the recovery of
  261.             up to 0.6% of the total archive size of continuously damaged data.
  262.  
  263.             It is also possible to specify the recovery record size in
  264.             percents to the archive size. Just append the percent character
  265.             to the command parameter. For example:
  266.  
  267.             rar rr3% arcname
  268.  
  269.             If data are damaged continuously then each rr-sector helps to
  270.             recover 512 bytes of damaged information. This value may be
  271.             lower in cases of multiple damage.
  272.  
  273.             The size of the recovery record may be approximately determined
  274.             by the formula <archive size>/256 + <number of recovery
  275.             sectors>*512 bytes.
  276.  
  277.  
  278.     s[name] Convert archive to SFX. The archive is merged with SFX-module
  279.             (using a module in file default.sfx or specified in the switch).
  280.             In the Windows version default.sfx should be placed in the
  281.             same directory as the rar.exe, in Unix and BeOS - in the user's
  282.             home directory, in /usr/lib or /usr/local/lib.
  283.  
  284.     s-      Remove SFX module from the already existing SFX archive.
  285.             RAR creates a new archive without SFX module, the original
  286.             SFX archive is not deleted.
  287.  
  288.     t       Test archive files. This command performs a dummy file
  289.             extraction, writing nothing to the output stream, in order to
  290.             validate the specified file(s).
  291.  
  292.             Examples:
  293.  
  294.             Test archives in current directory:
  295.  
  296.             rar t *
  297.  
  298.             or for Unix:
  299.  
  300.             rar t '*'
  301.  
  302.             User may test archives in all sub-directories, starting
  303.             with the current path:
  304.  
  305.             rar t -r *
  306.  
  307.             or for Unix:
  308.  
  309.             rar t -r '*'
  310.  
  311.  
  312.     u       Update files in archive. Adds files not already in the archive
  313.             and updates files changed since they were packed to the archive.
  314.  
  315.  
  316.     v[t]    Verbosely list the contents of archive [technical].
  317.             Files are listed using the format: full pathname, file comment,
  318.             original and compressed size, compression ratio, last update
  319.             date and time, attributes, CRC, compression method and minimum
  320.             RAR version required to extract. Optional technical information
  321.             is displayed when 't' modifier is used.
  322.  
  323.             To list the contents of all archive volumes, use an asterisk
  324.             ('*') in place of the archive file extension or use the '-v'
  325.             switch.
  326.  
  327.             Example:
  328.  
  329.             direct archive content list (technical) to a file
  330.  
  331.             rar vt bambam >bambam.lst
  332.  
  333.  
  334.     x       Extract files with full path.
  335.  
  336.             Example:
  337.  
  338.             rar x -av- -c- dime 10cents.txt
  339.  
  340.             extract specified file to current path. AV check and comment
  341.             show are disabled.
  342.  
  343.  
  344.     Switches (used in conjunction with a command):
  345.  
  346.  
  347.     -?      Display help on commands and switches. The same as when none
  348.             or an illegal command line option is entered.
  349.  
  350.  
  351.     --      Stop switches scanning
  352.  
  353.             This switch tells to RAR that there is no more switches
  354.             in the command line. It could be useful, if either archive
  355.             or file name starts from '-' character. Without '--' switch
  356.             such name would be treated as switch.
  357.  
  358.             Example:
  359.  
  360.             add all files from the current directory to the solid archive
  361.             '-StrangeName'
  362.  
  363.             RAR a -s -- -StrangeName
  364.  
  365.     -ac     Clear Archive attribute after compression or extraction
  366.             (Windows version only).
  367.  
  368.  
  369.     -ag[format]
  370.             Generate archive name using the current date and time.
  371.  
  372.             Appends the current date string to an archive name when
  373.             creating an archive. Useful for daily backups.
  374.  
  375.             Format of the appending string is defined by the optional
  376.             "format" parameter or by "YYYYMMDDHHMMSS" if this parameter
  377.             is absent. Format string may include the following characters:
  378.  
  379.             Y   - year
  380.             M   - month
  381.             MMM - month name as text string (Jan, Feb, etc.)
  382.             W   - a week number (a week starts with Monday)
  383.             A   - day of week number (Monday is 1, Sunday - 7)
  384.             D   - day of month
  385.             E   - day of year
  386.             H   - hours
  387.             M   - minutes (treated as minutes if encountered after hours)
  388.             S   - seconds
  389.  
  390.             All other characters are added to an archive name without
  391.             changes.
  392.  
  393.             Examples:
  394.  
  395.             1) use the default YYYYMMDDHHMMSS format
  396.  
  397.                rar a -ag backup
  398.  
  399.             2) use DD-MMM-YY format
  400.  
  401.                rar a -agDD-MMM-YY backup
  402.  
  403.             3) use YYYYMMDDHHMM format
  404.  
  405.                rar a -agYYYYMMDDHHMM backup
  406.  
  407.             4) use YYYY-WW-A format
  408.  
  409.                rar a -agYYYY-WW-A backup
  410.  
  411.  
  412.     -ao     Add files with Archive attribute set
  413.             (Windows version only).
  414.  
  415.             Example:
  416.  
  417.             add all disk C: files with Archive attribute set
  418.             to the 'f:backup' and clear files Archive attribute
  419.  
  420.             rar a -r -ac -ao f:backup c:\*.*
  421.  
  422.  
  423.     -ap     Set path inside archive. This path is merged to file
  424.             names when adding files to an archive and removed
  425.             from file names when extracting.
  426.  
  427.             For example, if you wish to add the file 'readme.txt'
  428.             to the directory 'DOCS\ENG' of archive 'release',
  429.             you may run:
  430.  
  431.             rar a -apDOCS\ENG release readme.txt
  432.  
  433.             or to extract 'ENG' to the current directory:
  434.  
  435.             rar x -apDOCS release DOCS\ENG\*.*
  436.  
  437.  
  438.     -as     Synchronize archive contents
  439.  
  440.             If this switch is used when archiving, those archived files
  441.             which are not present in the list of the currently added
  442.             files, will be deleted from archive. It is convenient to use
  443.             this switch in combination with -u (update) to synchronize
  444.             contents of an archive and an archiving directory.
  445.  
  446.             For example, after the command:
  447.  
  448.             rar a -u -as backup sources\*.cpp
  449.  
  450.             the archive 'backup.rar' will contain only *.cpp files
  451.             from directory 'sources', all other files will be deleted
  452.             from the archive. It looks similar to creating a new archive,
  453.             but with the one important exception: if no files are
  454.             modified since a last backup, the operation is performed
  455.             much faster than creation of a new archive.
  456.  
  457.  
  458.     -av     Put authenticity verification (registered versions only).
  459.             RAR will put, in every new and updated archive, information
  460.             concerning the creator, last update time and archive name.
  461.  
  462.             If an archive, containing authenticity verification, is being
  463.             modified and this switch is not specified, the authenticity
  464.             verification information will be removed.
  465.  
  466.             When extracting, testing, listing or updating and archive with
  467.             the '-av' switch, RAR will perform integrity validation and
  468.             display the message:
  469.  
  470.               Verifying authenticity information ...
  471.  
  472.             In the case of successful authenticity verification, the message
  473.             'Ok', creator name and last update information will be
  474.             displayed. In the case of authenticity verification failure, the
  475.             message 'FAILED' will be displayed.
  476.  
  477.             The Authenticity Verification feature, '-av,' is recommended for
  478.             use with archives in a software distribution environment.
  479.  
  480.             In order to enable the Authenticity verification feature, the
  481.             program MUST be registered. Please contact your local
  482.             distribution site or the world-wide distribution center.
  483.  
  484.  
  485.     -av-    Disable authenticity verification checking or adding.
  486.  
  487.  
  488.     -cfg-   Disable read configuration and environment.
  489.  
  490.  
  491.     -cl     Convert file names to lower case.
  492.  
  493.  
  494.     -cu     Convert file names to upper case.
  495.  
  496.  
  497.     -c-     Disable comments show.
  498.  
  499.  
  500.     -df     Delete files after archiving
  501.  
  502.             Move files to archive. This switch in combination with
  503.             the command "A" performs the same action as the command "M".
  504.            
  505.  
  506.     -dh     Open shared files
  507.  
  508.             Allows to process files opened by other applications
  509.             for writing.
  510.  
  511.             This option could be dangerous, because it allows
  512.             to archive a file, which at the same time is modifying
  513.             by an other application, so use it carefully.
  514.  
  515.  
  516.     -ds     Do not sort files while adding to a solid archive.
  517.  
  518.  
  519.     -ed     Do not add empty directories
  520.  
  521.             This switch indicates that empty directories are not to be
  522.             stored in the created archive.
  523.  
  524.  
  525.     -ee     Do not process extended attributes
  526.  
  527.             Disables saving and restoring extended file attributes.
  528.             Only for OS/2 and BeOS versions.
  529.  
  530.  
  531.     -ep     Exclude paths from names. This switch enables files to be added
  532.             to an archive without including the path information. This
  533.             could, of course, result in multiple files existing in the
  534.             archive with the same name.
  535.  
  536.  
  537.     -ep1    Exclude base dir from names. Do not store the path entered in
  538.             the command line.
  539.  
  540.             Example:
  541.  
  542.             all files and directories from the directory tmp will be added
  543.             to the archive 'test', but the path in archived names will not
  544.             include 'tmp\'
  545.  
  546.             rar a -ep1 -r test tmp\*
  547.  
  548.             This is equivalent to the commands:
  549.  
  550.             cd tmp
  551.             rar a -r ..\test
  552.             cd ..
  553.  
  554.  
  555.     -ep2    Expand paths to full. Store full file paths (except a drive
  556.             letter and leading path separator) when archiving.
  557.     
  558.  
  559.     -e<atr> Specifies file exclude attributes mask. <atr> is a number in the
  560.             decimal, octal (with leading '0') or hex (with leading '0x')
  561.             format. If result of bitwise AND between <atr> and file
  562.             attributes is nonzero, then file would not be added to archive.
  563.  
  564.             In the Windows version also is possible to use instead of
  565.             digital mask symbols D, S, H, A and R to denote directories
  566.             and files with system, hidden, archive and read-only attributes.
  567.             The order in which the attributes are given is not significant.
  568.  
  569.  
  570.     -f      Freshen files. May be used with archive extraction or creation.
  571.             The command string "a -f" is equivalent to the command 'f', you
  572.             could also use the switch '-f' with the commands 'm' or 'mf'. If
  573.             the switch '-f' is used with the commands 'x' or 'e', then only
  574.             old files would be replaced with new versions extracted from the
  575.             archive.
  576.  
  577.  
  578.     -idp    Disable percentage indicator.
  579.  
  580.             May be useful when redirecting output to a file.
  581.  
  582.  
  583.     -ierr   Send all messages to stderr.
  584.  
  585.  
  586.     -ilog   Log errors to file (registered version only).
  587.  
  588.  
  589.     -inul   Disable all messages.
  590.  
  591.  
  592.     -isnd   Enable sound.
  593.  
  594.  
  595.     -k      Lock archive. Any command which intends to change the archive
  596.             will be ignored.
  597.  
  598.  
  599.     -kb     Keep broken extracted files.
  600.  
  601.             RAR, by default, deletes files with CRC errors after
  602.             extraction. The switch -kb specifies that files with
  603.             CRC errors should not be deleted.
  604.  
  605.  
  606.     -m<n>   Set compression method:
  607.  
  608.        -m0   store     do not compress file when adding to archive
  609.        -m1   fastest   use fastest method (less compressive)
  610.        -m2   fast      use fast compression method
  611.        -m3   normal    use normal (default) compression method
  612.        -m4   good      use good compression method (more
  613.                        compressive, but slower)
  614.        -m5   best      use best compression method (slightly more
  615.                        compressive, but slowest)
  616.  
  617.             By default RAR uses -m3 method (Normal compression).
  618.  
  619.  
  620.     -md<n>  Select dictionary size <n> in KB. Must be 64, 128, 256, 512 or
  621.             1024 or a letter 'a', 'b', 'c', 'd' or 'e' respectively.
  622.  
  623.             The sliding dictionary is a special memory area used by the
  624.             compression algorithm. If the size of the file being compressed
  625.             (or the total files size in the case of a solid archive) is
  626.             greater than the dictionary size, then increasing the dictionary
  627.             size will generally increase compression ratio, decrease packing
  628.             speed and increase memory requirements.
  629.  
  630.             Default sliding dictionary size in 32-bit versions of RAR is 1024
  631.             KB. In RAR versions for Unix, Windows and other 32-bit platforms
  632.             it is possible to select five different sizes: 64, 128, 256, 512
  633.             or 1024 KB. Besides, speed of extraction in these versions does
  634.             not depend upon dictionary size. In 16-bit version RAR for DOS
  635.             the sliding dictionary size is fixed and equal to 64 KB.
  636.             Though RAR for DOS provides extracting files from large
  637.             dictionary archives.
  638.  
  639.             The amount of memory required to create large dictionary
  640.             archives is determined as 5*<dictionary size>+2560KB. About 1 Mb
  641.             is required for extraction and 5*<dictionary size>+3584KB to
  642.             update solid archives.
  643.  
  644.             RAR for DOS can extract from large dictionary archives using
  645.             conventional, EMS and disk memory. If no EMS or disk
  646.             cache is available, the operation may slow down significantly. RAR
  647.             for DOS cannot convert large dictionary archives to SFX with the
  648.             default SFX module and cannot update such solid archives.
  649.  
  650.             Example:
  651.  
  652.             RAR a -s -mdd sources *.asm
  653.                 or
  654.             RAR a -s -md512 sources *.asm
  655.  
  656.             Will create a solid archive using a 512 KB dictionary.
  657.  
  658.     -mm[f]  Multimedia compression [force]. Enables a special multimedia
  659.             compression algorithm. It is intended to compress digital audio
  660.             data containing up to four 8-bit or two 16-bit channels. It
  661.             works well with  true color (24-bit) bitmaps as well.
  662.             Improvement in the compression ratio up to 30% over the normal
  663.             compression may be achieved.
  664.  
  665.             When archiving file in the multimedia mode RAR performs
  666.             intelligent data analysis and may use, for different parts of
  667.             the file, general or multimedia compression depending on which
  668.             is more suitable. Such analysis allows optimum performance when
  669.             different data types are merged in the same file. The 'f'
  670.             modifier forces the multimedia compression to be used for the
  671.             whole file; it may help when certain multimedia files are to be
  672.             compressed, but in most cases only increases archive size.
  673.  
  674.             Both the -m<N> "Set compression method" and -s "Create solid
  675.             archive" switches can be used with multimedia compression,
  676.             but they are in effect for those file parts where the general
  677.             algorithm applies.
  678.  
  679.             If -mm is used with non-multimedia data, the compression ratio
  680.             is usually unchanged in comparison with the general method, but
  681.             due to multimedia analysis overhead, the packing speed is always
  682.             slower. The usage of -mm is not recommended with normal data
  683.             files.
  684.  
  685.             Example:
  686.  
  687.             rar a -m5 -s -mm All_My_Songs.rar *.wav
  688.  
  689.             Use the tightest compression method, solid archiving and
  690.             multimedia compression with smart analysis, which method
  691.             should be applied for particular data.
  692.  
  693.  
  694.     -ol     Save symbolic links as the link instead of the file.
  695.             Unix and BeOS versions only.
  696.  
  697.  
  698.     -os     Save NTFS streams. Win32 version only.
  699.  
  700.             This switch has meaning only for NTFS file system under
  701.             Windows NT and allows to save alternative data streams
  702.             associated with a file. It is especially important under
  703.             Windows 2000, which uses streams to keep some file dependent
  704.             information like file descriptions. If you use RAR to backup
  705.             your NTFS disks, it is recommended to specify this switch.
  706.  
  707.  
  708.     -ow     Use this switch when archiving to save file security
  709.             information and when extracting to restore it.
  710.  
  711.             Unix and BeOS RAR versions save file owner and group
  712.             when using this switch.
  713.  
  714.             Win32 version stores owner, group, file permissions and
  715.             audit information, but only if you have necessary privileges
  716.             to read them. Note that only NTFS file system supports
  717.             file based security under Windows.
  718.  
  719.     -o+     Overwrite existing files.
  720.  
  721.  
  722.     -o-     Do not overwrite existing files.
  723.  
  724.  
  725.     -p<p>   Encrypt files with the string <p> as password while archiving.
  726.             The password is case-sensitive. If you omit the password on the
  727.             command line, you will be prompted with message "Enter password".
  728.  
  729.             Example:
  730.  
  731.             rar a -pmyhoney secret1 *.txt
  732.  
  733.             add files *.txt and encrypt them with password "myhoney".
  734.  
  735.  
  736.     -p-     Do not query password
  737.  
  738.  
  739.     -r      Recurse subdirectories. May be used with commands:
  740.             a, u, f, m, x, e, t, p, v, l, c, cf and s.
  741.  
  742.             When used with the commands 'a', 'u', 'f', 'm' will process
  743.             files in all sub-directories as well as the current working
  744.             directory.
  745.  
  746.             When used with the commands x, e, t, p, v, l, c, cf or s will
  747.             process all archives in sub-directories as well as the current
  748.             working directory.
  749.  
  750.  
  751.     -r0     Similar to -r, but when used with the commands 'a', 'u', 'f',
  752.             'm' will recurse subdirectories only for those names, which
  753.             include wildcard characters '*' and '?'
  754.  
  755.  
  756.     -ri<p>[:<s>]
  757.             Set priority and sleep time. Available only in RAR for Windows.
  758.             This switch is used to regulate system load by RAR in a
  759.             multitasking environment. The possible task priority values are
  760.             from 0 to 15. When <p> is equal to 0, the default task priority
  761.             is used, 1 corresponding to the lowest task priority, 15 - to
  762.             the highest. The sleep time <s> is a value from 0 to 1000
  763.             (milliseconds). This is the period of time that RAR will give
  764.             back to system after every read or write during the packing or
  765.             unpacking operation. The sleep time setting is useful when
  766.             several tasks with the same priority are running in the system.
  767.  
  768.             Example:
  769.  
  770.             execute RAR with default priority and 10 ms of sleep after
  771.             each read or write
  772.  
  773.             rar a -r -sfx -ri0:10 backup *.*
  774.  
  775.  
  776.     -rr[N]  Add a data recovery record. This switch is used when creating or
  777.             modifying archive to add a data recovery record to the archive.
  778.             See the 'rr[N]' command description for details.
  779.  
  780.  
  781.     -s      Create solid archive. Solid is a special archive type. Please
  782.             refer to the appendix "Glossary" for further information.
  783.  
  784.             Example:
  785.  
  786.             create solid archive sources.rar with 512 KB dictionary,
  787.             recursing all directories, starting with the current directory.
  788.             Add only .asm files:
  789.  
  790.             rar a -s -md512 sources.rar *.asm -r
  791.  
  792.  
  793.     -s<N>   Create solid groups using file count
  794.  
  795.             Similar to -s, but reset solid statistics after compressing
  796.             <N> files. Usually decreases compression, but also
  797.             decreases losses in case of solid archive damages.
  798.  
  799.  
  800.     -se     Create solid groups using extension
  801.  
  802.             Similar to -s, but reset solid statistics if file extension
  803.             is changed. Usually decreases compression, but also
  804.             decreases losses from solid archive damages.
  805.  
  806.  
  807.     -sv     Create independent solid volumes
  808.  
  809.             By default RAR tries to reset solid statistics as soon
  810.             as possible when starting a new volume, but only 
  811.             if a lot enough data was packed after a previous reset
  812.             (at least a few megabytes).
  813.  
  814.             This switch forces RAR to ignore packed data size and attempt
  815.             to reset statistics for volumes of any size. It decreases
  816.             compression, but increases chances to extract a part of data 
  817.             if one of solid volumes in volume set was lost or damaged.
  818.  
  819.             Note that sometimes RAR cannot reset statistics even
  820.             using this switch. For example, it cannot be done when 
  821.             compressing one large file split between several volumes.
  822.             RAR is able to reset solid statistics only between separate 
  823.             files, but not inside of single file.
  824.  
  825.             Ignored, if used to create non-volume archive.
  826.  
  827.  
  828.     -sv-    Create dependent solid volumes
  829.  
  830.             Disables to reset solid statistics between volumes.
  831.  
  832.             It slightly increases compression, but significantly reduces 
  833.             chances to extract a part of data if one of solid volumes 
  834.             in volume set was lost or damaged.
  835.  
  836.             Ignored, if used to create non-volume archive.
  837.  
  838.  
  839.     -s-     Disable solid archiving
  840.  
  841.  
  842.     -sfx[name]
  843.             Create SFX archives. If this switch is used when creating a new
  844.             archive, a Self-Extracting archive (using a module in file
  845.             default.sfx or specified in the switch) would be created.
  846.             In the Windows version default.sfx should be placed in the
  847.             same directory as the rar.exe, in Unix and BeOS - in the user's
  848.             home directory, in /usr/lib or /usr/local/lib.
  849.  
  850.             Example:
  851.  
  852.             rar a -sfxwincon.sfx myinst
  853.  
  854.             create SelF-eXtracting (SFX) archive using wincon.sfx
  855.             SFX-module.
  856.  
  857.  
  858.     -tk     Keep original archive date. Prevents RAR from modifying the
  859.             archive date when changing an archive.
  860.  
  861.  
  862.     -tl     Set archive time to newest file. Forces RAR to set the date of a
  863.             changed archive to the date of the newest file in the archive.
  864.  
  865.  
  866.     -tn<time>
  867.             Process files newer than the specified time period. Format
  868.             of the time string is:
  869.  
  870.             [<ndays>d][<nhours>h][<nminutes>m][<nseconds>s]
  871.  
  872.             For example, use switch -tn15d to process files newer
  873.             than 15 days and -tn2h30m to process files newer than
  874.             2 hours 30 minutes.
  875.  
  876.  
  877.     -to<time>
  878.             Process files older than the specified time period. Format
  879.             of the switch is the same as -tn<time>.
  880.  
  881.  
  882.     -u      Update files. May be used with archive extraction or creation.
  883.             The command string "a -u" is equivalent to the command 'u', you
  884.             could also use the switch '-u' with the commands 'm' or 'mf'. If
  885.             the switch '-u' is used with the commands 'x' or 'e', then files
  886.             not present on the disk and files newer than their copies on the
  887.             disk would extracted from the archive.
  888.  
  889.  
  890.     -v<size>[k|b|f|m|M]
  891.             Create volumes with size=<size>*1000 [*1024 | *1].
  892.             By default this switch uses <size> as thousands (1000) of bytes
  893.             (not 1024 x bytes). You may also enter the size in kilobytes
  894.             using the symbol 'k', in bytes using the symbol 'b',
  895.             in megabytes - 'm', in millions of bytes - 'M' or select
  896.             one of several predefined values using the symbol 'f'
  897.             following the numerical value. Predefined values can be
  898.             360, 720, 1200, 1440 or 2880 and replaced with corresponding
  899.             floppy disk size.
  900.  
  901.             If the size is omitted, autodetection will be used.
  902.  
  903.             If volumes are created on removable media, then after
  904.             the first volume has been created, user will be prompted
  905.             with:
  906.  
  907.               Create next volume: Yes/No/All
  908.  
  909.             At this moment in time, you should change the disks. Answering
  910.             'A' will cause all volumes to be created without a pause.
  911.  
  912.             The first volume file in a multi-volume set has the extension
  913.             .RAR, following volumes are numbered from .R00 to .R99.
  914.  
  915.             When extracting or testing a multi-volume archive you must use
  916.             only the first volume name (*.RAR). If there is no next volume
  917.             on the drive and the disk is removable, the user will be
  918.             prompted with:
  919.  
  920.              Insert disk with <next volume name>
  921.  
  922.             Insert the disk with the correct volume and press any key.
  923.  
  924.             If while extracting, the next volume is not found and volumes
  925.             are placed on the non-removable disk, RAR will abort with
  926.             the error message:
  927.  
  928.              Cannot find <volume name>
  929.  
  930.             Archive volumes may not be modified. The commands 'd', 'f', 'u',
  931.             's' can not be used with Multi-volume sets. The command 'a' may
  932.             be used only for the creation of a new multi-volume sequence.
  933.  
  934.             It is possible, although unlikely, that the file size, of a file
  935.             in a multi-volume set, could be greater than it's uncompressed
  936.             size. This is due to the fact that 'storing' (no compression if
  937.             size increases) cannot be enabled for multi-volume sets.
  938.  
  939.             Archive volumes may be Self-Extracting (SFX). Such an archive
  940.             should be created using both the '-v' and '-sfx' switches.
  941.  
  942.             Example:
  943.  
  944.             create archive in volumes of fixed size:
  945.  
  946.             rar a -s -v1440 floparch.rar *.*
  947.  
  948.             will create solid volumes of size 1440000 bytes.
  949.  
  950.     -vd     Erase disk contents before creating volume
  951.  
  952.             All files and directories on the target disk will be erased
  953.             when '-vd' is used.  The switch applies only to removable
  954.             media, the hard disk cannot be erased using this switch.
  955.  
  956.     -vp     Pause before each volume
  957.  
  958.             By default RAR asks for confirmation before creating or 
  959.             unpacking next volume only for removable drives.
  960.             This switch forces RAR to ask such confirmation always.
  961.             It can be useful if disk space is limited and you wish
  962.             to copy each volume to another media immediately after
  963.             creating.
  964.  
  965.     -w<p>   Assign work directory as <p>. This switch may be used to assign
  966.             the directory for temporary files.
  967.  
  968.  
  969.     -x<f>   Exclude specified file <f>, wildcards may be used. You may
  970.             specify the switch '-x' several times:
  971.  
  972.             Example:
  973.  
  974.             rar a -r -x*.bak -x*.rar rawfiles
  975.  
  976.             *.bak and *.rar files will not be added to rawfiles
  977.  
  978.  
  979.     -x@<lf> Exclude files using specified list file.
  980.  
  981.             Example:
  982.  
  983.             rar a -x@exlist.txt arch *.exe
  984.  
  985.  
  986.     -y      Assume Yes on all queries.
  987.  
  988.  
  989.     -z<f>   Read archive comment from file <f>.
  990.  
  991.  
  992.  Limitations
  993.  ~~~~~~~~~~~
  994.  
  995.     Pathname is limited to 259 symbols.
  996.  
  997.     Maximum archive comment length is 62000 bytes.
  998.  
  999.     Command limitations:
  1000.  
  1001.     The commands 'd','u','f','c','cf' will not operate with archive
  1002.     volumes.
  1003.  
  1004.     The command 'a' cannot be used to update an archive volume, only to
  1005.     create one.
  1006.  
  1007.  
  1008.  Exit values
  1009.  ~~~~~~~~~~~
  1010.  
  1011.     RAR exits with a zero code (0) in case of successful operation. The exit
  1012.     code of non-zero means the operation is cancelled due to error:
  1013.  
  1014.      255   USER BREAK       User stopped the process
  1015.  
  1016.        8   MEMORY ERROR     Not enough memory for operation
  1017.  
  1018.        7   USER ERROR       Command line option error
  1019.  
  1020.        6   OPEN ERROR       Open file error
  1021.  
  1022.        5   WRITE ERROR      Write to disk error
  1023.  
  1024.        4   LOCKED ARCHIVE   Attempt to modify an archive previously locked
  1025.                             by the 'k' command
  1026.  
  1027.        3   CRC ERROR        A CRC error occurred when unpacking
  1028.  
  1029.        2   FATAL ERROR      A fatal error occurred
  1030.  
  1031.        1   WARNING          Non fatal error(s) occurred
  1032.  
  1033.        0   SUCCESS          Successful operation (User exit)
  1034.  
  1035.  
  1036.  Glossary
  1037.  ~~~~~~~~
  1038.  
  1039.     Archive      Special file containing one or more files optionally
  1040.                  compressed and/or encrypted.
  1041.  
  1042.     Compression  A method of encoding data to reduce it's size.
  1043.  
  1044.     CRC          Cyclic Redundancy Check. Mathematical method calculating
  1045.                  special checking information for data validity.
  1046.  
  1047.     SFX          Archive module used to extract files from when executed.
  1048.                  (SelF-eXtracting module), usually in the form of a .EXE
  1049.                  file.
  1050.  
  1051.     Solid        An archive packed using a special compression method which
  1052.                  sees all files as one continuous data stream. Particularly
  1053.                  advantageous when packing a large number of small files.
  1054.  
  1055.     Volume       Part of a split archive. Splitting an archive to volumes
  1056.                  allows storing them on diskettes. Solid volumes must be
  1057.                  extracted starting from first in sequence.
  1058.  
  1059.  
  1060.  
  1061.  Copyrights
  1062.  
  1063.     (c) 1993-2001 Eugene Roshal
  1064.  
  1065.  
  1066.  
  1067.