home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 August / CHIP_CD_2004-08.iso / service / winrar / wrar34b1.exe / Rar.txt < prev    next >
Encoding:
Text File  |  2004-05-08  |  61.3 KB  |  1,606 lines

  1.                              User's Manual
  2.                              ~~~~~~~~~~~~~
  3.                      RAR 3.40 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 allowing you to manage and control archive
  14.   files. Console RAR supports archives only in RAR format, which names
  15.   usually have a ".rar" extension. ZIP and other formats are not supported.
  16.   Windows users may install GUI RAR version - WinRAR, which is able to
  17.   process much more archive types.
  18.  
  19.   RAR features include:
  20.  
  21.     *  Highly sophisticated, original compression algorithm
  22.     *  Special compression algorithms optimized for text, audio,
  23.        graphics data, 32 and 64-bit Intel executables
  24.     *  Better compression than similar tools, using 'solid' archiving
  25.     *  Authenticity verification (registered version only)
  26.     *  Self-extracting archives and volumes (SFX)
  27.     *  Ability to recover physically damaged archives
  28.     *  Locking, password, file order list, file security & more ...
  29.  
  30.  
  31.  Configuration file
  32.  ~~~~~~~~~~~~~~~~~~
  33.  
  34.   RAR for Unix reads configuration information from the file .rarrc
  35.   in the user's home directory (stored in HOME environment variable)
  36.   or in /etc directory.
  37.  
  38.   RAR for Windows reads configuration information from the file rar.ini,
  39.   placed in the same directory as the rar.exe file.
  40.  
  41.   This file may contain the following string:
  42.  
  43.   switches=<any RAR switches, separated with a space>
  44.  
  45.  
  46.  Environment variable
  47.  ~~~~~~~~~~~~~~~~~~~~
  48.  
  49.     Default parameters may be added to the RAR command line by establishing
  50.     an environment variable "RAR".
  51.  
  52.     For instance, in UNIX following lines may be added to your profile:
  53.  
  54.       RAR='-s -md1024'
  55.       export RAR
  56.  
  57.     RAR will use this string as default parameters in the command line and
  58.     will create "solid" archives with 1024 KB sliding dictionary size.
  59.  
  60.     RAR handles options with priority as following:
  61.  
  62.        command line switches                   highest priority
  63.        switches in the RAR variable            lower priority
  64.        switches saved in configuration file    lowest priority
  65.  
  66.  
  67.  Log file
  68.  ~~~~~~~~
  69.  
  70.   If the switch -ilog is specified in the command line or configuration
  71.   file, RAR will write informational messages, concerning errors
  72.   encountered while processing archives, to a log file. In Unix
  73.   this file is named .rarlog and placed in the user's home directory.
  74.   In Windows it is named rar.log and placed in the same directory as
  75.   the rar.exe file. Switch -ilog allows to override the default log name.
  76.  
  77.  
  78.  The file order list for solid archiving - rarfiles.lst
  79.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80.  
  81.   rarfiles.lst contains user-defined file list which tells RAR
  82.   the order to add files to a solid archive. It may contain file
  83.   names, wildcards and special entry - $default. The default
  84.   entry defines the place in order list for files not matched
  85.   with other entries in this file. The comment character is ';'.
  86.  
  87.   In Windows this file should be placed in the same directory as RAR,
  88.   in Unix - to the user's home directory or to /etc.
  89.  
  90.   Tips to provide improved compression and speed of operation:
  91.  
  92.   - similar files should be grouped together in the archive;
  93.   - frequently accessed files should be placed at the beginning.
  94.  
  95.   Normally masks placed nearer to the top of list have higher priority,
  96.   but there is an exception from this rule. If rarfiles.lst contains such
  97.   two masks that all files matched by one mask are also matched by other,
  98.   that mask which matches a smaller subset of file names will have higher
  99.   priority regardless of its position in the list. For example, in case of
  100.   *.cpp and f*.cpp masks, f*.cpp has higher priority, so position of
  101.   'filename.cpp' will be chosen according to 'f*.cpp', not '*.cpp'.
  102.  
  103.  
  104.  RAR command line syntax
  105.  ~~~~~~~~~~~~~~~~~~~~~~~
  106.  
  107.  Syntax
  108.  
  109.     RAR <command>  [ -<switches> ]  <archive>  [ <@listfiles...> ]
  110.         [ <files...> ]  [ <path_to_extract\> ]
  111.  
  112.  Description
  113.  
  114.     Command line options (commands and switches) provides control of
  115.     creating and managing archives with RAR. The command is a string (or a
  116.     single letter) which commands RAR to perform a corresponding action.
  117.     Switches are designed to modify the way RAR performs the action. Other
  118.     parameters are archive name and files to be archived into or extracted
  119.     from the archive.
  120.  
  121.     Listfiles are plain text files contained names of files to process.
  122.     File names should start at the first column. It is possible to
  123.     put comments to the listfile after // characters. For example,
  124.     you may create backup.lst containing the following strings:
  125.  
  126.     c:\work\doc\*.txt         //backup text documents
  127.     c:\work\image\*.bmp       //backup pictures
  128.     c:\work\misc
  129.  
  130.     and then run:
  131.  
  132.        rar a backup @backup.lst
  133.  
  134.     If you wish to read file names from stdin (standard input),
  135.     specify the empty listfile name (just @).
  136.  
  137.     Win32 console RAR uses OEM (DOS) encoding in list files.
  138.  
  139.     You may specify both usual file names and list files in the same
  140.     command line. If neither files nor listfiles are specified,
  141.     then *.* is implied and RAR will process all files
  142.  
  143.     In a UNIX environment you need to quote wildcards to avoid them
  144.     being expanded by shell. For example, this command will extract
  145.     *.asm files from RAR archives in current path:
  146.  
  147.        rar e '*.rar' '*.asm'
  148.  
  149.  
  150.     Command could be any of the following:
  151.  
  152.     a       Add files to archive.
  153.  
  154.             Example:
  155.  
  156.             create or update existent archive myarch, adding all files
  157.             in the current directory
  158.  
  159.             rar a myarch
  160.  
  161.  
  162.     c       Add archive comment. Comments are displayed while the archive is
  163.             being processed. Comment length is limited to 62000 bytes
  164.  
  165.             Examples:
  166.  
  167.             rar c distrib.rar
  168.  
  169.             Also comments may be added from a file:
  170.  
  171.             rar c -zinfo.txt dummy
  172.  
  173.  
  174.     cf      Add files comment. File comments are displayed when the 'v'
  175.             command is given. File comment length is limited to 32767 bytes.
  176.  
  177.             Example:
  178.  
  179.             rar cf bigarch *.txt
  180.  
  181.  
  182.     cw      Write archive comment to specified file.
  183.  
  184.             Example:
  185.  
  186.             rar cw oldarch comment.txt
  187.  
  188.  
  189.     d       Delete files from archive. Note, if the processing of this
  190.             command resulted in removing all the files from the archive, the
  191.             empty archive would removed.
  192.  
  193.  
  194.     e       Extract files to current directory.
  195.  
  196.  
  197.     f       Freshen files in archive. Updates those files changed since they
  198.             were packed to the archive. This command will not add new files
  199.             to the archive.
  200.  
  201.  
  202.     i[i|c|h|t]=<string>
  203.             Find string in archives.
  204.  
  205.             Supports following optional parameters:
  206.  
  207.               i - case insensitive search (default);
  208.  
  209.               c - case sensitive search;
  210.  
  211.               h - hexadecimal search;
  212.  
  213.               t - use ANSI, Unicode and OEM character tables (Win32 only);
  214.  
  215.             If no parameters are specified, it is possible to use
  216.             the simplified command syntax i<string> instead of i=<string>
  217.  
  218.             It is allowed to specify 't' modifier with other parameters,
  219.             for example, ict=string performs case sensitive search
  220.             using all mentioned above character tables.
  221.  
  222.             Examples:
  223.  
  224.             1) rar "ic=first level" -r c:\*.rar *.txt
  225.  
  226.             Perform case sensitive search of "first level" string
  227.             in *.txt files in *.rar archives on the disk c:
  228.  
  229.             2) rar ih=f0e0aeaeab2d83e3a9 -r e:\texts
  230.  
  231.             Search for hex string f0 e0 ae ae ab 2d 83 e3 a9
  232.             in rar archives in e:\texts directory.
  233.  
  234.  
  235.     k       Lock archive. Any command which intends to change the archive
  236.             will be ignored.
  237.  
  238.             Example:
  239.  
  240.             rar k final.rar
  241.  
  242.  
  243.     l[t,b]  List contents of archive [technical]. Files are listed as with
  244.             the 'v' command with the exception of the file path. i.e. only
  245.             the file name is displayed. Optional technical information
  246.             (host OS, solid flag and old version flag) is displayed
  247.             when 't' modifier is used. Modifier 'b' forces RAR to output
  248.             only bare file names without any additional information.
  249.  
  250.  
  251.     m[f]    Move to archive [files only]. Moving files and directories
  252.             results in the files and directories being erased upon
  253.             successful completion of the packing operation. Directories will
  254.             not be removed if 'f' modifier is used and/or '-ed' switch is
  255.             applied.
  256.  
  257.  
  258.     p       Print file to stdout.
  259.  
  260.             You may use this command together with -inul switch to disable
  261.             all RAR messages and print only file data. It may be important,
  262.             when you need to send a file to stdout for use in pipes.
  263.  
  264.  
  265.     r       Repair archive. Archive repairing is performed in two stages.
  266.             First, the damaged archive is searched for a recovery record
  267.             (see 'rr' command). If the archive contains a recovery record
  268.             and if the portion of the damaged data is continuous and less
  269.             than N*512 bytes, where N is number of recovery sectors placed
  270.             into the archive, the chance of successful archive
  271.             reconstruction is very high. When this stage has completed,
  272.             a new archive will be created, called fixed.arcname.rar,
  273.             where 'arcname' is the original (damaged) archive name.
  274.  
  275.             If a broken archive does not contain a recovery record or if
  276.             the archive is not completely recovered due to major damage, a
  277.             second stage is performed. During this stage only the archive
  278.             structure is reconstructed and it is impossible to recover
  279.             files which fail the CRC validation, it is still possible to
  280.             recover undamaged files which were inaccessible due to the
  281.             broken archive structure. Mostly this is useful for non-solid
  282.             archives.
  283.  
  284.             When the second stage is completed, the reconstructed archive
  285.             will be saved as rebuilt.arcname.rar, where 'arcname' is
  286.             the original archive name.
  287.  
  288.             RAR/DOS32 version uses _recover.rar and _reconst.rar instead
  289.             of names mentioned aboves.
  290.  
  291.             While the recovery is in progress, RAR may prompt the user for
  292.             assistance when a suspicious file is detected.
  293.  
  294.                       Suspicious entry
  295.  
  296.               Name:  <possibly filename>
  297.               Size:  <size>    Packed: <compressed size>
  298.  
  299.                       Add it: Yes/No/All
  300.  
  301.             Answer 'y' to add this entry to the file fixed.arcname.rar.
  302.  
  303.             Example:
  304.  
  305.             rar r buggy.rar
  306.  
  307.  
  308.     rc      Reconstruct missing and damaged volumes using recovery volumes
  309.             (.rev files). You need to specify any existing volume
  310.             as the archive name, for example, 'rar rc backup.part03.rar'
  311.  
  312.             Read 'rv' command description for information about
  313.             recovery volumes.
  314.  
  315.  
  316.     rn      Rename archived files.
  317.  
  318.             The command syntax is:
  319.  
  320.             rar rn <arcname> <srcname1> <destname1> ... <srcnameN> <destnameN>
  321.  
  322.             For example, the following command:
  323.  
  324.             rar rn data.rar readme.txt readme.bak info.txt info.bak
  325.  
  326.             will rename readme.txt to readme.bak and info.txt to info.bak
  327.             in the archive data.rar.
  328.  
  329.             It is allowed to use wildcards in the source and destination
  330.             names for simple name transformations like changing file
  331.             extensions. For example:
  332.  
  333.             rar rn data.rar *.txt *.bak
  334.  
  335.             will rename all *.txt files to *.bak.
  336.  
  337.             RAR does not check if the destination file name is already
  338.             present in the archive, so you need to be careful to avoid
  339.             duplicated names. It is especially important when using
  340.             wildcards. Such command is potentially dangerous, because
  341.             a wrong wildcard may corrupt all archived names.
  342.  
  343.  
  344.     rr[N]   Add data recovery record. Optionally, redundant information
  345.             (recovery record) may be added to an archive.  This will cause
  346.             a small increase of the archive size and helps to recover
  347.             archived files in case of floppy disk failure or data losses of
  348.             any other kind. A recovery record contains up to 524288 recovery
  349.             sectors. The number of sectors may be specified directly in the
  350.             'rr' command (N = 1, 2 .. 524288) or if it is not specified by
  351.             the user it will be selected automatically according to the
  352.             archive size: a size of the recovery information will be about
  353.             1% of the total archive size, usually allowing the recovery of
  354.             up to 0.6% of the total archive size of continuously damaged data.
  355.  
  356.             It is also possible to specify the recovery record size in
  357.             percent to the archive size. Just append the percent character
  358.             to the command parameter. For example:
  359.  
  360.             rar rr3% arcname
  361.  
  362.             Note that if you run this command from .bat or .cmd file,
  363.             you need to use rr3%% instead of rr3%, because the command
  364.             processor treats the single '%' character as start of
  365.             batch file parameter. You may also use 'p' instead of '%',
  366.             so 'rr3p' will work too.
  367.  
  368.             If data are damaged continuously then each rr-sector helps to
  369.             recover 512 bytes of damaged information. This value may be
  370.             lower in cases of multiple damage.
  371.  
  372.             The size of the recovery record may be approximately determined
  373.             by the formula <archive size>/256 + <number of recovery
  374.             sectors>*512 bytes.
  375.  
  376.  
  377.     rv[N]   Create recovery volumes (.rev files), which can be later
  378.             used to reconstruct missing and damaged files in a volume
  379.             set. This command has sense only for multivolume archives
  380.             and you need to specify a name of the first volume
  381.             in the set as the archive name. For example:
  382.  
  383.             rar rv3 data.part01.rar
  384.  
  385.             This feature may be useful for backups or, for example,
  386.             when you posted a multivolume archive to a newsgroup
  387.             and a part of subscribers did not receive some files.
  388.             Reposting recovery volumes instead of usual volumes
  389.             may reduce a total number of files to repost.
  390.  
  391.             Each recovery volume is able to reconstruct one missing
  392.             or damaged RAR volume. For example, if you have 30 volumes
  393.             and 3 recovery volumes, you are able to reconstruct any
  394.             3 missing volumes. If number of .rev files is less than
  395.             number of missing volumes, reconstructing is impossible.
  396.             Total number of usual and recovery volumes must not
  397.             exceed 255.
  398.  
  399.             The optional <N> parameter specifies a number of recovery
  400.             volumes to create and must be less than the total number
  401.             of RAR volumes in the set. You may also append a percent
  402.             character to this parameter, in such case the number of
  403.             creating .rev files will be equal to this percent taken
  404.             from the total number of RAR volumes. For example:
  405.  
  406.             rar rv15% data.part01.rar
  407.  
  408.             RAR reconstructs missing and damaged volumes either when
  409.             using 'rc' command or automatically, if it cannot locate
  410.             the next volume and finds the required number of .rev files
  411.             when unpacking.
  412.  
  413.             Original copies of damaged volumes are renamed to *.bad
  414.             before reconstruction. For example, volname.part03.rar
  415.             will be renamed to volname.part03.rar.bad.
  416.             
  417.  
  418.     s[name] Convert archive to SFX. The archive is merged with SFX-module
  419.             (using a module in file default.sfx or specified in the switch).
  420.             In the Windows version default.sfx should be placed in the
  421.             same directory as the rar.exe, in Unix - in the user's
  422.             home directory, in /usr/lib or /usr/local/lib.
  423.  
  424.     s-      Remove SFX module from the already existing SFX archive.
  425.             RAR creates a new archive without SFX module, the original
  426.             SFX archive is not deleted.
  427.  
  428.     t       Test archive files. This command performs a dummy file
  429.             extraction, writing nothing to the output stream, in order to
  430.             validate the specified file(s).
  431.  
  432.             Examples:
  433.  
  434.             Test archives in current directory:
  435.  
  436.             rar t *
  437.  
  438.             or for Unix:
  439.  
  440.             rar t '*'
  441.  
  442.             User may test archives in all sub-directories, starting
  443.             with the current path:
  444.  
  445.             rar t -r *
  446.  
  447.             or for Unix:
  448.  
  449.             rar t -r '*'
  450.  
  451.  
  452.     u       Update files in archive. Adds files not already in the archive
  453.             and updates files changed since they were packed to the archive.
  454.  
  455.  
  456.     v[t,b]  Verbosely list the contents of archive [technical].
  457.             Files are listed using the format: full pathname, file comment,
  458.             original and compressed size, compression ratio, last update
  459.             date and time, attributes, CRC, compression method and minimum
  460.             RAR version required to extract. Optional technical information
  461.             (host OS, solid flag and old file version flag) is displayed
  462.             when 't' modifier is used. Modifier 'b' forces RAR to output
  463.             only bare file names without any additional information.
  464.  
  465.             To list the contents of all archive volumes, use an asterisk
  466.             ('*') in place of the archive file extension or use the '-v'
  467.             switch.
  468.  
  469.             Example:
  470.  
  471.             1) list contents of system.rar archive (technical mode)
  472.                and redirect output to file techlist.lst
  473.  
  474.                rar vt system >techlist.lst
  475.  
  476.             2) list contents of tutorial.rar archive (bare file names mode)
  477.  
  478.                rar vb tutorial
  479.  
  480.  
  481.     x       Extract files with full path.
  482.  
  483.             Example:
  484.  
  485.             rar x -av- -c- dime 10cents.txt
  486.  
  487.             extract specified file to current path. AV check and comment
  488.             show are disabled.
  489.  
  490.  
  491.     Switches (used in conjunction with a command):
  492.  
  493.  
  494.     -?      Display help on commands and switches. The same as when none
  495.             or an illegal command line option is entered.
  496.  
  497.  
  498.     --      Stop switches scanning
  499.  
  500.             This switch tells to RAR that there is no more switches
  501.             in the command line. It could be useful, if either archive
  502.             or file name starts from '-' character. Without '--' switch
  503.             such name would be treated as switch.
  504.  
  505.             Example:
  506.  
  507.             add all files from the current directory to the solid archive
  508.             '-StrangeName'
  509.  
  510.             RAR a -s -- -StrangeName
  511.  
  512.     -ac     Clear Archive attribute after compression or extraction
  513.             (Windows version only).
  514.  
  515.  
  516.     -ad     Append archive name to destination path.
  517.  
  518.             This option may be useful when unpacking a group of archives.
  519.             By default RAR places files from all archives to the same
  520.             directory, but this switch creates a separate directory
  521.             for files unpacked from each archive.
  522.  
  523.             Example:
  524.  
  525.             rar x -ad *.rar data\
  526.  
  527.             RAR will create subdirectories below 'data' for every unpacking
  528.             archive.
  529.  
  530.  
  531.     -ag[format]
  532.             Generate archive name using the current date and time.
  533.  
  534.             Appends the current date string to an archive name when
  535.             creating an archive. Useful for daily backups.
  536.  
  537.             Format of the appending string is defined by the optional
  538.             "format" parameter or by "YYYYMMDDHHMMSS" if this parameter
  539.             is absent. Format string may include the following characters:
  540.  
  541.             Y   - year
  542.             M   - month
  543.             MMM - month name as text string (Jan, Feb, etc.)
  544.             W   - a week number (a week starts with Monday)
  545.             A   - day of week number (Monday is 1, Sunday - 7)
  546.             D   - day of month
  547.             E   - day of year
  548.             H   - hours
  549.             M   - minutes (treated as minutes if encountered after hours)
  550.             S   - seconds
  551.             N   - archive number. RAR searches for already existing archive
  552.                   with generated name and if found, increments the archive
  553.                   number until generating a unique name.
  554.  
  555.             If the first character in the format string is '+', positions
  556.             of the date string and base archive name are exchanged,
  557.             so date will precede an archive name.
  558.  
  559.             Format string may contain optional text enclosed in '{' and '}'
  560.             characters. This text is inserted into archive name.
  561.  
  562.             All other characters are added to an archive name without
  563.             changes.
  564.  
  565.             Examples:
  566.  
  567.             1) use the default YYYYMMDDHHMMSS format
  568.  
  569.                rar a -ag backup
  570.  
  571.             2) use DD-MMM-YY format
  572.  
  573.                rar a -agDD-MMM-YY backup
  574.  
  575.             3) use YYYYMMDDHHMM format, place date before 'backup'
  576.  
  577.                rar a -ag+YYYYMMDDHHMM backup
  578.  
  579.             4) use YYYY-WW-A format, include fields description
  580.  
  581.                rar a -agYYYY{year}-WW{week}-A{wday} backup
  582.  
  583.             5) use YYYYMMDD and the archive number. It allows to generate
  584.                unique names even when YYYYMMDD format mask used more than
  585.                once in the same day
  586.  
  587.                rar a -agYYYYMMDD-NN backup
  588.  
  589.  
  590.     -ao     Add files with Archive attribute set
  591.             (Windows version only).
  592.  
  593.             Example:
  594.  
  595.             add all disk C: files with Archive attribute set
  596.             to the 'f:backup' and clear files Archive attribute
  597.  
  598.             rar a -r -ac -ao f:backup c:\*.*
  599.  
  600.  
  601.     -ap     Set path inside archive. This path is merged to file
  602.             names when adding files to an archive and removed
  603.             from file names when extracting.
  604.  
  605.             For example, if you wish to add the file 'readme.txt'
  606.             to the directory 'DOCS\ENG' of archive 'release',
  607.             you may run:
  608.  
  609.             rar a -apDOCS\ENG release readme.txt
  610.  
  611.             or to extract 'ENG' to the current directory:
  612.  
  613.             rar x -apDOCS release DOCS\ENG\*.*
  614.  
  615.  
  616.     -as     Synchronize archive contents
  617.  
  618.             If this switch is used when archiving, those archived files
  619.             which are not present in the list of the currently added
  620.             files, will be deleted from archive. It is convenient to use
  621.             this switch in combination with -u (update) to synchronize
  622.             contents of an archive and an archiving directory.
  623.  
  624.             For example, after the command:
  625.  
  626.             rar a -u -as backup sources\*.cpp
  627.  
  628.             the archive 'backup.rar' will contain only *.cpp files
  629.             from directory 'sources', all other files will be deleted
  630.             from the archive. It looks similar to creating a new archive,
  631.             but with the one important exception: if no files are
  632.             modified since a last backup, the operation is performed
  633.             much faster than creation of a new archive.
  634.  
  635.  
  636.     -av     Put authenticity verification (registered versions only).
  637.             RAR will put, in every new and updated archive, information
  638.             concerning the creator, last update time and archive name.
  639.  
  640.             If an archive, containing authenticity verification, is being
  641.             modified and this switch is not specified, the authenticity
  642.             verification information will be removed.
  643.  
  644.             When extracting, testing, listing or updating and archive with
  645.             the '-av' switch, RAR will perform integrity validation and
  646.             display the message:
  647.  
  648.               Verifying authenticity information ...
  649.  
  650.             In the case of successful authenticity verification, the message
  651.             'Ok', creator name and last update information will be
  652.             displayed. In the case of authenticity verification failure, the
  653.             message 'FAILED' will be displayed.
  654.  
  655.             The Authenticity Verification feature, '-av,' is recommended for
  656.             use with archives in a software distribution environment.
  657.  
  658.             In order to enable the Authenticity verification feature, the
  659.             program MUST be registered. Please contact your local
  660.             distribution site or the world-wide distribution center.
  661.  
  662.  
  663.     -av-    Disable authenticity verification checking or adding.
  664.  
  665.  
  666.     -cfg-   Ignore configuration file and RAR environment variable.
  667.  
  668.  
  669.     -cl     Convert file names to lower case.
  670.  
  671.  
  672.     -cu     Convert file names to upper case.
  673.  
  674.  
  675.     -c-     Disable comments show.
  676.  
  677.  
  678.     -df     Delete files after archiving
  679.  
  680.             Move files to archive. This switch in combination with
  681.             the command "A" performs the same action as the command "M".
  682.            
  683.  
  684.     -dh     Open shared files
  685.  
  686.             Allows to process files opened by other applications
  687.             for writing.
  688.  
  689.             This switch helps if an application allowed read access
  690.             to file, but if all types of file access are prohibited,
  691.             file open operation still will fail.
  692.  
  693.             This option could be dangerous, because it allows
  694.             to archive a file, which at the same time is modifying
  695.             by an other application, so use it carefully.
  696.  
  697.  
  698.     -ds     Do not sort files while adding to a solid archive.
  699.  
  700.  
  701.     -ed     Do not add empty directories
  702.  
  703.             This switch indicates that directory records are not to be
  704.             stored in the created archive. When extracting such archive,
  705.             RAR creates non-empty directories basing on paths of files
  706.             contained in them. Information about empty directories is
  707.             lost. All attributes of non-empty directories except a name
  708.             (access rights, streams, etc.) will be lost as well, so use
  709.             this switch only if you do not need to preserve such information.
  710.  
  711.  
  712.     -ee     Do not process extended attributes
  713.  
  714.             Disables saving and restoring extended file attributes.
  715.             Only for OS/2 versions.
  716.  
  717.  
  718.     -en     Do not add "end of archive" block
  719.  
  720.             By default, RAR adds "end of archive" block to the end of new
  721.             or updated archive. It allows to skip external data like
  722.             digital signatures safely, but in some special cases it may be
  723.             useful to disable this feature. For example, if an archive
  724.             is transferred between two systems via a unreliable link and
  725.             at the same time a sender adds new files to it, it may be
  726.             important to be sure that the already received file part will
  727.             not be modified on the other end between transfer sessions.
  728.  
  729.             This switch cannot be used with volumes, because the end
  730.             of archive block contains information important for correct
  731.             volume processing. 
  732.  
  733.  
  734.     -ep     Exclude paths from names. This switch enables files to be added
  735.             to an archive without including the path information. This
  736.             could, of course, result in multiple files existing in the
  737.             archive with the same name.
  738.  
  739.  
  740.     -ep1    Exclude base dir from names. Do not store the path entered in
  741.             the command line.
  742.  
  743.             Example:
  744.  
  745.             all files and directories from the directory tmp will be added
  746.             to the archive 'test', but the path in archived names will not
  747.             include 'tmp\'
  748.  
  749.             rar a -ep1 -r test tmp\*
  750.  
  751.             This is equivalent to the commands:
  752.  
  753.             cd tmp
  754.             rar a -r ..\test
  755.             cd ..
  756.  
  757.  
  758.     -ep2    Expand paths to full. Store full file paths (except a drive
  759.             letter and leading path separator) when archiving.
  760.     
  761.  
  762.     -ep3    Expand paths to full including the drive letter.
  763.             Win32 version only.
  764.  
  765.             This switch stores full file paths including the drive
  766.             letter if used when archiving. Drive separators (colons)
  767.             are replaced by underscore characters.
  768.  
  769.             If you use -ep3 when extracting, it will change
  770.             underscores back to colons and create unpacked files
  771.             in their original directories and disks. If user also
  772.             specified a destination path, it will be ignored.
  773.  
  774.             This switch can help to backup several disks to same archive.
  775.             For example, you may run:
  776.  
  777.             rar a -ep3 -r backup.rar c:\ d:\ e:\
  778.  
  779.             to create backup and:
  780.  
  781.             rar x -ep3 backup.rar
  782.  
  783.             to restore it.
  784.  
  785.             But be cautious and use -ep3 only if are sure that
  786.             extracting archive does not contain any malicious files.
  787.             In other words, use it if you created an archive yourself
  788.             or completely trust to its author. This switch allows
  789.             to overwrite any file in any location on your computer
  790.             including important system files and normally should be
  791.             used only for backup and restore purpose.
  792.  
  793.  
  794.     -e<atr> Specifies file exclude attributes mask. <atr> is a number in
  795.             the decimal, octal (with leading '0') or hex (with leading '0x')
  796.             format. If result of bitwise AND between <atr> and file
  797.             attributes is nonzero, file would not be added to archive.
  798.  
  799.             In the Windows version also is possible to use symbols D, S, H,
  800.             A and R instead of digital mask to denote directories and files
  801.             with system, hidden, archive and read-only attributes.
  802.             The order in which the attributes are given is not significant.
  803.  
  804.  
  805.     -f      Freshen files. May be used with archive extraction or creation.
  806.             The command string "a -f" is equivalent to the command 'f', you
  807.             could also use the switch '-f' with the commands 'm' or 'mf'. If
  808.             the switch '-f' is used with the commands 'x' or 'e', then only
  809.             old files would be replaced with new versions extracted from the
  810.             archive.
  811.  
  812.  
  813.     -hp[p]  Encrypt both file data and headers.
  814.  
  815.             This switch is similar to -p[p], but switch -p encrypts
  816.             only file data and leaves other information like file names
  817.             visible. This switch encrypts all sensitive archive areas
  818.             include file data, file names, sizes, attributes, comments
  819.             and other blocks, so it provides a higher security level.
  820.             Without a password it is impossible to view even the list of
  821.             files in archive encrypted with -hp.
  822.  
  823.             Example:
  824.  
  825.             rar a -hpfGzq5yKw secret report.txt
  826.  
  827.             will add the file report.txt to the encrypted archive
  828.             secret.rar using the password 'fGzq5yKw'
  829.  
  830.  
  831.     -idp    Disable percentage indicator.
  832.  
  833.             May be useful when redirecting output to a file.
  834.  
  835.  
  836.     -ieml[.][addr]
  837.             Send archive by email. Win32 version only.
  838.  
  839.             Attach an archive created or updated by the add command
  840.             to email message. You need to have MAPI compliant email
  841.             client to use this switch (most modern email programs
  842.             support MAPI interface).
  843.  
  844.             You may enter a destination email address directly
  845.             in the switch or leave it blank. In the latter case it
  846.             will be asked by your email program. It is possible to
  847.             specify several addresses separated with commas or
  848.             semicolons.
  849.  
  850.             If you append a dot character to -ieml, an archive will be
  851.             deleted after it was successfully attached to email.
  852.             If the switch is used when creating a multivolume archive,
  853.             every volume is attached to separate email message.
  854.  
  855.  
  856.     -ierr   Send all messages to stderr.
  857.  
  858.  
  859.     -ilog[name]
  860.             Log errors to file (registered version only).
  861.  
  862.             Write error messages to the file rar.log created in RAR
  863.             directory. It is possible to specify another log file name
  864.             instead of the default rar.log in the switch, for example,
  865.             -ilogc:\log\backup.log. If the specifed name does not
  866.             include path, the log file will be created in RAR directory.
  867.  
  868.  
  869.     -inul   Disable all messages.
  870.  
  871.  
  872.     -ioff   Turn PC off after completing an operation. The hardware must
  873.             support the power off feature. Win32 version only.
  874.  
  875.  
  876.     -isnd   Enable sound.
  877.  
  878.  
  879.     -k      Lock archive. Any command which intends to change the archive
  880.             will be ignored.
  881.  
  882.  
  883.     -kb     Keep broken extracted files.
  884.  
  885.             RAR, by default, deletes files with CRC errors after
  886.             extraction. The switch -kb specifies that files with
  887.             CRC errors should not be deleted.
  888.  
  889.  
  890.     -m<n>   Set compression method:
  891.  
  892.        -m0   store     do not compress file when adding to archive
  893.        -m1   fastest   use fastest method (less compressive)
  894.        -m2   fast      use fast compression method
  895.        -m3   normal    use normal (default) compression method
  896.        -m4   good      use good compression method (more
  897.                        compressive, but slower)
  898.        -m5   best      use best compression method (slightly more
  899.                        compressive, but slowest)
  900.  
  901.             If this switch is not specified, RAR uses -m3 method
  902.             (normal compression).
  903.  
  904.             By default, RAR uses only the general compression
  905.             algorithm in -m1 and -m2 methods, advanced algorithms
  906.             like audio and true color processing are enabled
  907.             only in -m3..-m5 modes, the advanced text compression
  908.             is activated only in -m4..-m5. This default can be
  909.             overridden using -mc switch.
  910.  
  911.  
  912.     -mc<par>
  913.             Set advanced compression parameters.
  914.  
  915.             This switch is intended mainly for benchmarking and
  916.             experiments, in the real environment usually it is better
  917.             to allow RAR to select optimal parameters automatically.
  918.             Please note that improper use of this switch may lead
  919.             to very serious performance and compression loss, so use
  920.             it only if you clearly understand what you do.
  921.  
  922.             It has the following syntax:
  923.  
  924.             -mc[param1][:param2][module][+ or -]
  925.  
  926.             where <module> is the one character field denoting a part
  927.             of the compression algorithm, which has to be configured.
  928.  
  929.             It may have the following values:
  930.  
  931.               A       - audio compression;
  932.               C       - true color (RGB) data compression;
  933.               D       - delta compression;
  934.               E       - 32-bit x86 executables compression;
  935.               I       - 64-bit Intel Itanium executables compression;
  936.               T       - text compression.
  937.  
  938.             '+' sign at the end of switch applies the selected algorithm
  939.             module to all processed data, '-' disables the module at all.
  940.             If no sign is specified, RAR will choose modules automatically,
  941.             basing on data and the current compression method.
  942.  
  943.             Switch -mc- disables all optional modules and allows only
  944.             the general compression algorithm.
  945.  
  946.             <Param1> and <Param2> are module dependent parameters
  947.             described below.
  948.  
  949.             Audio compression, delta compression:
  950.  
  951.             <Param1> is a number of byte channels (can be 1 - 31).
  952.             RAR splits multibyte channels to bytes, for example,
  953.             two 16-bit audio channels are considered by RAR as four
  954.             channels one byte each.
  955.  
  956.             <Param2> is ignored.
  957.  
  958.  
  959.             32-bit x86 Intel executables compression,
  960.             64-bit Intel Itanium executables compression,
  961.             true color (RGB) data compression:
  962.  
  963.             <Param1> and <Param2> are ignored.
  964.  
  965.  
  966.             Text compression: 
  967.  
  968.             <Param1> is the order of PPM algorithm (can be 2 - 63).
  969.             Usually a higher value slightly increases the compression ratio
  970.             of redundant data, but only if enough memory is available
  971.             to PPM. In case of lack of memory the result may be negative.
  972.             Higher order values decrease both compression and decompression
  973.             speed.
  974.  
  975.             <Param2> is memory in megabytes allocated for PPM (1-128).
  976.             Higher values may increase the compression ratio, but note
  977.             that PPM uses the equal memory size both to compress and
  978.             decompress, so if you allocate too much memory when creating
  979.             an archive, other people may have problems when decompressing
  980.             it on a computer with less memory installed. Decompression
  981.             will be still possible using virtual memory, but it may
  982.             become very slow.
  983.  
  984.  
  985.             Examples:
  986.  
  987.             1) switch -mc1a+ forces use of 8-bit mono audio compression
  988.             for all data.
  989.  
  990.             2) switch -mc10:40t+ forces use of text compression
  991.             algorithm for all data, sets the compression order to 10
  992.             and allocates 40 MB memory.
  993.  
  994.             3) switch -mc12t sets the text compression order to 12,
  995.             when the text compression is used, but leaves to RAR to
  996.             decide when to use it.
  997.  
  998.             4) switches -mct- -mcd- disable text and delta compression.
  999.  
  1000.  
  1001.     -md<n>  Select dictionary size <n> in KB. Must be 64, 128, 256, 512,
  1002.             1024, 2048 or 4096 or a letter 'a', 'b', 'c', 'd', 'e', 'f', 'g'
  1003.             respectively.
  1004.  
  1005.             The sliding dictionary is a special memory area used by the
  1006.             compression algorithm. If the size of the file being compressed
  1007.             (or the total files size in the case of a solid archive) is
  1008.             greater than the dictionary size, then increasing the dictionary
  1009.             size will generally increase compression ratio, decrease packing
  1010.             speed and increase memory requirements.
  1011.  
  1012.             RAR can reduce the dictionary size if it is significantly
  1013.             larger than size of source data. It helps to reduce memory
  1014.             requirements without decreasing compression.
  1015.  
  1016.             Default sliding dictionary size is 4096 KB.
  1017.  
  1018.             Example:
  1019.  
  1020.             RAR a -s -mdd sources *.asm
  1021.                 or
  1022.             RAR a -s -md512 sources *.asm
  1023.  
  1024.             Will create a solid archive using a 512 KB dictionary.
  1025.  
  1026.  
  1027.     -ms[list]
  1028.             Specify file types to store.
  1029.  
  1030.             Specify file types, which will be stored without compression.
  1031.             This switch may be used to store already compressed files,
  1032.             what helps to increase archiving speed without noticeable loss
  1033.             in the compression ratio.
  1034.  
  1035.             Optional <list> parameter defines the list of file extensions
  1036.             separated with a semicolon. For example, -msrar;zip;jpg will
  1037.             force RAR to store without compression all RAR and ZIP
  1038.             archives and JPG images. It is also allowed to specify wildcard
  1039.             file masks in the list, so -ms*.rar;*.zip;*.jpg will work too.
  1040.  
  1041.             If <list> is not specified, -ms switch will use the default
  1042.             set of extensions, which includes the following file types:
  1043.  
  1044.             ace, arj, bz2, cab, gz, jpeg, jpg, lha, lzh, mp3,
  1045.             rar, zip, taz, tgz, z
  1046.  
  1047.  
  1048.     -oc     Set NTFS Compressed attribute. Win32 version only.
  1049.  
  1050.             This switch allows to restore NTFS Compressed attribute
  1051.             when extracting files. RAR saves Compressed file attributes
  1052.             when creating an archive, but does not restore them unless
  1053.             -oc switch is specified.
  1054.  
  1055.  
  1056.     -ol     Save symbolic links as the link instead of the file.
  1057.             Unix version only.
  1058.  
  1059.  
  1060.     -os     Save NTFS streams. Win32 version only.
  1061.  
  1062.             This switch has meaning only for NTFS file system under
  1063.             Windows NT and allows to save alternative data streams
  1064.             associated with a file. It is especially important under
  1065.             Windows 2000 and XP, which use streams to keep some file
  1066.             dependent information like file descriptions. If you use
  1067.             RAR to backup your NTFS disks, it is recommended to specify
  1068.             this switch.
  1069.  
  1070.  
  1071.     -ow     Use this switch when archiving to save file security
  1072.             information and when extracting to restore it.
  1073.  
  1074.             Unix RAR version saves file owner and group when using
  1075.             this switch.
  1076.  
  1077.             Win32 version stores owner, group, file permissions and
  1078.             audit information, but only if you have necessary privileges
  1079.             to read them. Note that only NTFS file system supports
  1080.             file based security under Windows.
  1081.  
  1082.     -o+     Overwrite existing files.
  1083.  
  1084.  
  1085.     -o-     Do not overwrite existing files.
  1086.  
  1087.  
  1088.     -p[p]   Encrypt files with the string <p> as password while archiving.
  1089.             The password is case-sensitive. If you omit the password on the
  1090.             command line, you will be prompted with message "Enter password".
  1091.  
  1092.             Example:
  1093.  
  1094.             rar a -pmyhoney secret1 *.txt
  1095.  
  1096.             add files *.txt and encrypt them with password "myhoney".
  1097.  
  1098.  
  1099.     -p-     Do not query password
  1100.  
  1101.  
  1102.     -r      Recurse subdirectories. May be used with commands:
  1103.             a, u, f, m, x, e, t, p, v, l, c, cf and s.
  1104.  
  1105.             When used with the commands 'a', 'u', 'f', 'm' will process
  1106.             files in all sub-directories as well as the current working
  1107.             directory.
  1108.  
  1109.             When used with the commands x, e, t, p, v, l, c, cf or s will
  1110.             process all archives in sub-directories as well as the current
  1111.             working directory.
  1112.  
  1113.  
  1114.     -r0     Similar to -r, but when used with the commands 'a', 'u', 'f',
  1115.             'm' will recurse subdirectories only for those names, which
  1116.             include wildcard characters '*' and '?'
  1117.  
  1118.  
  1119.     -ri<p>[:<s>]
  1120.             Set priority and sleep time. Available only in RAR for Windows.
  1121.             This switch is used to regulate system load by RAR in a
  1122.             multitasking environment. The possible task priority values are
  1123.             from 0 to 15. When <p> is equal to 0, the default task priority
  1124.             is used, 1 corresponding to the lowest task priority, 15 - to
  1125.             the highest. The sleep time <s> is a value from 0 to 1000
  1126.             (milliseconds). This is the period of time that RAR will give
  1127.             back to system after every read or write during the packing or
  1128.             unpacking operation. The sleep time setting is useful when
  1129.             several tasks with the same priority are running in the system.
  1130.  
  1131.             Example:
  1132.  
  1133.             execute RAR with default priority and 10 ms of sleep after
  1134.             each read or write
  1135.  
  1136.             rar a -r -sfx -ri0:10 backup *.*
  1137.  
  1138.  
  1139.     -rr[N]  Add a data recovery record. This switch is used when creating or
  1140.             modifying archive to add a data recovery record to the archive.
  1141.             See the 'rr[N]' command description for details.
  1142.  
  1143.  
  1144.     -rv[N]  Create recovery volumes. This switch is used when creating
  1145.             a multivolume archive to generate recovery volumes.
  1146.             See the 'rv[N]' command description for details.
  1147.  
  1148.  
  1149.     -s      Create solid archive. Solid is a special archive type. Please
  1150.             refer to the appendix "Glossary" for further information.
  1151.  
  1152.             Example:
  1153.  
  1154.             create solid archive sources.rar with 512 KB dictionary,
  1155.             recursing all directories, starting with the current directory.
  1156.             Add only .asm files:
  1157.  
  1158.             rar a -s -md512 sources.rar *.asm -r
  1159.  
  1160.  
  1161.     -s<N>   Create solid groups using file count
  1162.  
  1163.             Similar to -s, but reset solid statistics after compressing
  1164.             <N> files. Usually decreases compression, but also
  1165.             decreases losses in case of solid archive damages.
  1166.  
  1167.  
  1168.     -se     Create solid groups using extension
  1169.  
  1170.             Similar to -s, but reset solid statistics if file extension
  1171.             is changed. Usually decreases compression, but also
  1172.             decreases losses from solid archive damages.
  1173.  
  1174.  
  1175.     -sfx[name]
  1176.             Create SFX archives. If this switch is used when creating a new
  1177.             archive, a Self-Extracting archive (using a module in file
  1178.             default.sfx or specified in the switch) would be created.
  1179.             In the Windows version default.sfx should be placed in the
  1180.             same directory as the rar.exe, in Unix - in the user's
  1181.             home directory, in /usr/lib or /usr/local/lib.
  1182.  
  1183.             Example:
  1184.  
  1185.             rar a -sfxwincon.sfx myinst
  1186.  
  1187.             create SelF-eXtracting (SFX) archive using wincon.sfx
  1188.             SFX-module.
  1189.  
  1190.  
  1191.     -si[name]
  1192.             Read data from stdin (standard input), when creating
  1193.             an archive. Optional 'name' parameter allows to specify
  1194.             a file name of compressed stdin data in the created
  1195.             archive. If this parameter is missing, the name will be
  1196.             set to 'stdin'. This switch cannot be used with -v.
  1197.  
  1198.             Example:
  1199.  
  1200.             type Tree.Far | rar a -siTree.Far tree.rar
  1201.  
  1202.             will compress 'type Tree.Far' output as 'Tree.Far' file.
  1203.  
  1204.  
  1205.     -sv     Create independent solid volumes
  1206.  
  1207.             By default RAR tries to reset solid statistics as soon
  1208.             as possible when starting a new volume, but only 
  1209.             if a lot enough data was packed after a previous reset
  1210.             (at least a few megabytes).
  1211.  
  1212.             This switch forces RAR to ignore packed data size and attempt
  1213.             to reset statistics for volumes of any size. It decreases
  1214.             compression, but increases chances to extract a part of data 
  1215.             if one of solid volumes in volume set was lost or damaged.
  1216.  
  1217.             Note that sometimes RAR cannot reset statistics even
  1218.             using this switch. For example, it cannot be done when 
  1219.             compressing one large file split between several volumes.
  1220.             RAR is able to reset solid statistics only between separate 
  1221.             files, but not inside of single file.
  1222.  
  1223.             Ignored, if used to create non-volume archive.
  1224.  
  1225.  
  1226.     -sv-    Create dependent solid volumes
  1227.  
  1228.             Disables to reset solid statistics between volumes.
  1229.  
  1230.             It slightly increases compression, but significantly reduces 
  1231.             chances to extract a part of data if one of solid volumes 
  1232.             in volume set was lost or damaged.
  1233.  
  1234.             Ignored, if used to create non-volume archive.
  1235.  
  1236.  
  1237.     -s-     Disable solid archiving
  1238.  
  1239.  
  1240.     -t      Test files after archiving. This switch is especially
  1241.             useful in combination with the move command, so files will be
  1242.             deleted only if archive had been successfully tested.
  1243.  
  1244.  
  1245.     -ta<date>
  1246.             Process only files modified after the specified date.
  1247.  
  1248.             Format of the date string is YYYYMMDDHHMMSS.
  1249.             It is allowed to insert separators like '-' or ':' to
  1250.             the date string and omit trailing fields. For example,
  1251.             the following switch is correct: -ta2001-11-20
  1252.             Internally it will be expanded to -ta20011120000000
  1253.             and treated as "files modified after 0 hour 0 minutes
  1254.             0 seconds of 20 November 2001".
  1255.  
  1256.  
  1257.     -tb<date>
  1258.             Process only files modified before the specified date.
  1259.             Format of the switch is the same as -ta<date>.
  1260.  
  1261.  
  1262.     -tk     Keep original archive date. Prevents RAR from modifying the
  1263.             archive date when changing an archive.
  1264.  
  1265.  
  1266.     -tl     Set archive time to newest file. Forces RAR to set the date of a
  1267.             changed archive to the date of the newest file in the archive.
  1268.  
  1269.  
  1270.     -tn<time>
  1271.             Process files newer than the specified time period. Format
  1272.             of the time string is:
  1273.  
  1274.             [<ndays>d][<nhours>h][<nminutes>m][<nseconds>s]
  1275.  
  1276.             For example, use switch -tn15d to process files newer
  1277.             than 15 days and -tn2h30m to process files newer than
  1278.             2 hours 30 minutes.
  1279.  
  1280.  
  1281.     -to<time>
  1282.             Process files older than the specified time period. Format
  1283.             of the switch is the same as -tn<time>.
  1284.  
  1285.  
  1286.     -ts<m,c,a>[N]
  1287.             Save or restore file time (modification, creation, access).
  1288.  
  1289.             Switch -tsm instructs RAR to save file modification time,
  1290.             -tsc - creation time and tsa - last access time. Optional
  1291.             parameter after the switch is the number between 0 and 4
  1292.             controlling the file time precision. Value '1' enables
  1293.             1 second precision, 2 - 0.0065536 sec, 3 - 0.0000256 sec and
  1294.             4 or '+' enables the maximum NTFS time precision, which is
  1295.             equal to 0.0000001 sec. Value '0' or '-' means that creation
  1296.             and access time are not saved and low (two seconds) precision
  1297.             is used for modification time. Higher precision modes add
  1298.             more data to archive, up to 19 additional bytes per file
  1299.             in case of -tsm4 -tsa4 -tsc4 combination. If no precision
  1300.             is specified, RAR uses '4' (high) value.
  1301.  
  1302.             Default RAR mode is -tsm4 -tsc0 -tsa0, so modification time
  1303.             is stored with the high precision and other times are ignored.
  1304.  
  1305.             It is necessary to specify -tsc and -tsa switches to set
  1306.             creation and access time when unpacking files (precision
  1307.             is irrelevant, but must not be 0). By default RAR sets
  1308.             only the modification time, even if archive contains
  1309.             creation and last access time. Setting the modification
  1310.             time to unpacked files may be also disabled with -tsm-.
  1311.  
  1312.             It is possible to omit the time type letter if you need
  1313.             to apply the switch to all three times. For example,
  1314.             -tsm4 -tsa4 -tsc4 can be replaced by -ts4, -ts+ or -ts.
  1315.             Use -ts- to save only the low precision modification time
  1316.             or to ignore all three file times on unpacking.
  1317.  
  1318.             When creating an archive, RAR automatically reduces
  1319.             the precision if high mode is not supported by the file
  1320.             system. It is not more than 2 seconds on FAT and 1 second
  1321.             in Unix. NTFS time precision is 0.0000001 second.
  1322.  
  1323.             Operating systems limit which time can be set on unpacking.
  1324.             Windows allow to set all three times, Unix - modification
  1325.             and last access, but not creation, DOS supports only
  1326.             the modification time.
  1327.  
  1328.             Examples:
  1329.  
  1330.             1) rar a -ts backup
  1331.  
  1332.             Store all file times with the highest possible precision.
  1333.  
  1334.             2) rar x -tsa backup
  1335.  
  1336.             Restore modification and last access time. Switch -tsm
  1337.             is not required, because RAR uses it by default.
  1338.  
  1339.             3) rar a -tsm1 -tsc1 backup
  1340.  
  1341.             Store low precision modification and creation time.
  1342.             Without -tsm1 RAR would save the high precision modification
  1343.             time.
  1344.  
  1345.  
  1346.     -u      Update files. May be used with archive extraction or creation.
  1347.             The command string "a -u" is equivalent to the command 'u', you
  1348.             could also use the switch '-u' with the commands 'm' or 'mf'. If
  1349.             the switch '-u' is used with the commands 'x' or 'e', then files
  1350.             not present on the disk and files newer than their copies on the
  1351.             disk would extracted from the archive.
  1352.  
  1353.  
  1354.     -v      Create volumes with size autodetection or list all volumes
  1355.  
  1356.             This switch may be used when creating or listing volumes.
  1357.  
  1358.             In the first case it enables volume size autodetection,
  1359.             so new volumes will use all available space on the destination
  1360.             media. It is convenient when creating volumes on removable
  1361.             disks. You may read more about volumes in -v<size> description.
  1362.  
  1363.             In the second case, when this switch is used together with
  1364.             'V' or 'L' command, it forces RAR to list contents of all
  1365.             volumes starting from the specified in the command line.
  1366.             Without this switch RAR displays contents of only single
  1367.             specified volume.
  1368.  
  1369.  
  1370.     -v<size>[k|b|f|m|M|g|G]
  1371.             Create volumes with size=<size>*1000 [*1024 | *1].
  1372.             By default this switch uses <size> as thousands (1000) of bytes
  1373.             (not 1024 x bytes). You may also enter the size in kilobytes
  1374.             using the symbol 'k', in bytes using the symbol 'b',
  1375.             megabytes - 'm', millions of bytes - 'M', gigabytes - 'g',
  1376.             billions (milliards) of bytes - 'G' or select one of several
  1377.             predefined values using the symbol 'f' following the numerical
  1378.             value. Predefined values can be 360, 720, 1200, 1440 or 2880
  1379.             and replaced with corresponding floppy disk size.
  1380.  
  1381.             If the size is omitted, autodetection will be used.
  1382.  
  1383.             You may specify several -v switches to set different sizes
  1384.             for different volumes. For example:
  1385.  
  1386.               rar a -v100k -v200k -v300k arcname
  1387.  
  1388.             sets 100 KB size for first volume, 200 KB for second
  1389.             and 300 KB for all following volumes.
  1390.  
  1391.             If volumes are created on removable media, then after
  1392.             the first volume has been created, user will be prompted
  1393.             with:
  1394.  
  1395.               Create next volume: Yes/No/All
  1396.  
  1397.             At this moment in time, you should change the disks. Answering
  1398.             'A' will cause all volumes to be created without a pause.
  1399.  
  1400.             By default RAR volumes have names like 'volname.partNNN.rar',
  1401.             where NNN is the volume number. Using -vn switch it is 
  1402.             possible to switch to another, extension based naming scheme,
  1403.             where the first volume file in a multi-volume set has
  1404.             the extension .rar, following volumes are numbered from .r00
  1405.             to .r99.
  1406.  
  1407.             When extracting or testing a multi-volume archive you must use
  1408.             only the first volume name. If there is no next volume
  1409.             on the drive and the disk is removable, the user will be
  1410.             prompted with:
  1411.  
  1412.              Insert disk with <next volume name>
  1413.  
  1414.             Insert the disk with the correct volume and press any key.
  1415.  
  1416.             If while extracting, the next volume is not found and volumes
  1417.             are placed on the non-removable disk, RAR will abort with
  1418.             the error message:
  1419.  
  1420.              Cannot find <volume name>
  1421.  
  1422.             Archive volumes may not be modified. The commands 'd', 'f', 'u',
  1423.             's' cannot be used with Multi-volume sets. The command 'a' may
  1424.             be used only for the creation of a new multi-volume sequence.
  1425.  
  1426.             It is possible, although unlikely, that the file size, of a file
  1427.             in a multi-volume set, could be greater than it's uncompressed
  1428.             size. This is due to the fact that 'storing' (no compression if
  1429.             size increases) cannot be enabled for multi-volume sets.
  1430.  
  1431.             Archive volumes may be Self-Extracting (SFX). Such an archive
  1432.             should be created using both the '-v' and '-sfx' switches.
  1433.  
  1434.             Example:
  1435.  
  1436.             create archive in volumes of fixed size:
  1437.  
  1438.             rar a -s -v1440 floparch.rar *.*
  1439.  
  1440.             will create solid volumes of size 1440000 bytes.
  1441.  
  1442.  
  1443.     -vd     Erase disk contents before creating volume
  1444.  
  1445.             All files and directories on the target disk will be erased
  1446.             when '-vd' is used.  The switch applies only to removable
  1447.             media, the hard disk cannot be erased using this switch.
  1448.  
  1449.  
  1450.     -ver[n] File version control
  1451.  
  1452.             Forces RAR to keep previous file versions when updating
  1453.             files in the already existing archive. Old versions are
  1454.             renamed to 'filename;n', where 'n' is the version number.
  1455.  
  1456.             By default, when unpacking an archive without the switch
  1457.             -ver, RAR extracts only the last added file version, which
  1458.             name does not include a numeric suffix. But if you specify
  1459.             a file name exactly, including a version, it will be also
  1460.             unpacked. For example, 'rar x arcname' will unpack only
  1461.             last versions, when 'rar x arcname file.txt;5' will unpack
  1462.             'file.txt;5', if it is present in the archive.
  1463.  
  1464.             If you specify -ver switch without a parameter when unpacking,
  1465.             RAR will extract all versions of all files matched to entered
  1466.             file mask. In this case a version number is not removed from
  1467.             unpacked file names. You may also extract a concrete file
  1468.             version specifying its number as -ver parameter. It will tell
  1469.             RAR to unpack only this version and remove a version number
  1470.             from file names. For example, 'rar x -ver5 arcname' will
  1471.             unpack only 5th file versions.
  1472.  
  1473.  
  1474.     -vn     Use the old style volume naming scheme
  1475.  
  1476.             By default RAR volumes have names like 'volname.partNNN.rar',
  1477.             where NNN is the volume number. Using -vn switch it is 
  1478.             possible to switch to another, extension based naming scheme,
  1479.             where the first volume file in a multi-volume set has
  1480.             the extension .rar, following volumes are numbered from .r00
  1481.             to .r99. It may have sense, if you are going to unpack
  1482.             an archive under the plain MS DOS, which does not allow
  1483.             more than one dot in a file name.
  1484.  
  1485.  
  1486.     -vp     Pause before each volume
  1487.  
  1488.             By default RAR asks for confirmation before creating or 
  1489.             unpacking next volume only for removable drives.
  1490.             This switch forces RAR to ask such confirmation always.
  1491.             It can be useful if disk space is limited and you wish
  1492.             to copy each volume to another media immediately after
  1493.             creating.
  1494.  
  1495.  
  1496.     -w<p>   Assign work directory as <p>. This switch may be used to assign
  1497.             the directory for temporary files.
  1498.  
  1499.  
  1500.     -x<f>   Exclude specified file <f>, wildcards may be used both
  1501.             in the name and file parts of file mask. You may specify
  1502.             the switch '-x' several times:
  1503.  
  1504.             Examples:
  1505.  
  1506.             1) rar a -r -x*.bak -x*.rar rawfiles
  1507.  
  1508.             *.bak and *.rar files will not be added to rawfiles
  1509.  
  1510.             2) rar a -r -x*\temp\* savec c:\*
  1511.  
  1512.             compress all files on the disk c: except those in temp
  1513.             directories.
  1514.  
  1515.  
  1516.     -x@<lf> Exclude files using specified list file.
  1517.  
  1518.             Example:
  1519.  
  1520.             rar a -x@exlist.txt arch *.exe
  1521.  
  1522.  
  1523.     -y      Assume Yes on all queries.
  1524.  
  1525.  
  1526.     -z<f>   Read archive comment from file <f>.
  1527.  
  1528.  
  1529.  Limitations
  1530.  ~~~~~~~~~~~
  1531.  
  1532.     Pathname is limited to 259 symbols.
  1533.  
  1534.     Maximum archive comment length is 62000 bytes.
  1535.  
  1536.     Command limitations:
  1537.  
  1538.     The commands 'd','u','f','c','cf' will not operate with archive
  1539.     volumes.
  1540.  
  1541.     The command 'a' cannot be used to update an archive volume, only to
  1542.     create one.
  1543.  
  1544.  
  1545.  Exit values
  1546.  ~~~~~~~~~~~
  1547.  
  1548.     RAR exits with a zero code (0) in case of successful operation. The exit
  1549.     code of non-zero means the operation is cancelled due to error:
  1550.  
  1551.      255   USER BREAK       User stopped the process
  1552.  
  1553.        9   CREATE ERROR     Create file error
  1554.  
  1555.        8   MEMORY ERROR     Not enough memory for operation
  1556.  
  1557.        7   USER ERROR       Command line option error
  1558.  
  1559.        6   OPEN ERROR       Open file error
  1560.  
  1561.        5   WRITE ERROR      Write to disk error
  1562.  
  1563.        4   LOCKED ARCHIVE   Attempt to modify an archive previously locked
  1564.                             by the 'k' command
  1565.  
  1566.        3   CRC ERROR        A CRC error occurred when unpacking
  1567.  
  1568.        2   FATAL ERROR      A fatal error occurred
  1569.  
  1570.        1   WARNING          Non fatal error(s) occurred
  1571.  
  1572.        0   SUCCESS          Successful operation (User exit)
  1573.  
  1574.  
  1575.  Glossary
  1576.  ~~~~~~~~
  1577.  
  1578.     Archive      Special file containing one or more files optionally
  1579.                  compressed and/or encrypted.
  1580.  
  1581.     Compression  A method of encoding data to reduce it's size.
  1582.  
  1583.     CRC          Cyclic Redundancy Check. Mathematical method calculating
  1584.                  special checking information for data validity.
  1585.  
  1586.     SFX          Archive module used to extract files from when executed.
  1587.                  (SelF-eXtracting module), usually in the form of a .EXE
  1588.                  file.
  1589.  
  1590.     Solid        An archive packed using a special compression method which
  1591.                  sees all files as one continuous data stream. Particularly
  1592.                  advantageous when packing a large number of small files.
  1593.  
  1594.     Volume       Part of a split archive. Splitting an archive to volumes
  1595.                  allows storing them on diskettes. Solid volumes must be
  1596.                  extracted starting from first in sequence.
  1597.  
  1598.  
  1599.  
  1600.  Copyrights
  1601.  
  1602.     (c) 1993-2004 Alexander Roshal
  1603.  
  1604.  
  1605.  
  1606.