home *** CD-ROM | disk | FTP | other *** search
/ ftp.sunet.se/pub/OS2/ / 2014.11.ftp.sunet.se_pub_OS2.tar / ftp.sunet.se / pub / OS2 / hobbes / os2 / util / archiver / ldbkup1-02aa.exe / rar.txt < prev    next >
Text File  |  2004-05-28  |  61KB  |  1,562 lines
  1.                              User's Manual
  2.                              ~~~~~~~~~~~~~
  3.                      RAR 3.30 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.             All other characters are added to an archive name without
  560.             changes.
  561.  
  562.             Examples:
  563.  
  564.             1) use the default YYYYMMDDHHMMSS format
  565.  
  566.                rar a -ag backup
  567.  
  568.             2) use DD-MMM-YY format
  569.  
  570.                rar a -agDD-MMM-YY backup
  571.  
  572.             3) use YYYYMMDDHHMM format, place date before 'backup'
  573.  
  574.                rar a -ag+YYYYMMDDHHMM backup
  575.  
  576.             4) use YYYY-WW-A format
  577.  
  578.                rar a -agYYYY-WW-A backup
  579.  
  580.             5) use YYYYMMDD and the archive number. It allows to generate
  581.                unique names even when YYYYMMDD format mask used more than
  582.                once in the same day
  583.  
  584.                rar a -agYYYYMMDD-NN backup
  585.  
  586.  
  587.     -ao     Add files with Archive attribute set
  588.             (Windows version only).
  589.  
  590.             Example:
  591.  
  592.             add all disk C: files with Archive attribute set
  593.             to the 'f:backup' and clear files Archive attribute
  594.  
  595.             rar a -r -ac -ao f:backup c:\*.*
  596.  
  597.  
  598.     -ap     Set path inside archive. This path is merged to file
  599.             names when adding files to an archive and removed
  600.             from file names when extracting.
  601.  
  602.             For example, if you wish to add the file 'readme.txt'
  603.             to the directory 'DOCS\ENG' of archive 'release',
  604.             you may run:
  605.  
  606.             rar a -apDOCS\ENG release readme.txt
  607.  
  608.             or to extract 'ENG' to the current directory:
  609.  
  610.             rar x -apDOCS release DOCS\ENG\*.*
  611.  
  612.  
  613.     -as     Synchronize archive contents
  614.  
  615.             If this switch is used when archiving, those archived files
  616.             which are not present in the list of the currently added
  617.             files, will be deleted from archive. It is convenient to use
  618.             this switch in combination with -u (update) to synchronize
  619.             contents of an archive and an archiving directory.
  620.  
  621.             For example, after the command:
  622.  
  623.             rar a -u -as backup sources\*.cpp
  624.  
  625.             the archive 'backup.rar' will contain only *.cpp files
  626.             from directory 'sources', all other files will be deleted
  627.             from the archive. It looks similar to creating a new archive,
  628.             but with the one important exception: if no files are
  629.             modified since a last backup, the operation is performed
  630.             much faster than creation of a new archive.
  631.  
  632.  
  633.     -av     Put authenticity verification (registered versions only).
  634.             RAR will put, in every new and updated archive, information
  635.             concerning the creator, last update time and archive name.
  636.  
  637.             If an archive, containing authenticity verification, is being
  638.             modified and this switch is not specified, the authenticity
  639.             verification information will be removed.
  640.  
  641.             When extracting, testing, listing or updating and archive with
  642.             the '-av' switch, RAR will perform integrity validation and
  643.             display the message:
  644.  
  645.               Verifying authenticity information ...
  646.  
  647.             In the case of successful authenticity verification, the message
  648.             'Ok', creator name and last update information will be
  649.             displayed. In the case of authenticity verification failure, the
  650.             message 'FAILED' will be displayed.
  651.  
  652.             The Authenticity Verification feature, '-av,' is recommended for
  653.             use with archives in a software distribution environment.
  654.  
  655.             In order to enable the Authenticity verification feature, the
  656.             program MUST be registered. Please contact your local
  657.             distribution site or the world-wide distribution center.
  658.  
  659.  
  660.     -av-    Disable authenticity verification checking or adding.
  661.  
  662.  
  663.     -cfg-   Ignore configuration file and RAR environment variable.
  664.  
  665.  
  666.     -cl     Convert file names to lower case.
  667.  
  668.  
  669.     -cu     Convert file names to upper case.
  670.  
  671.  
  672.     -c-     Disable comments show.
  673.  
  674.  
  675.     -df     Delete files after archiving
  676.  
  677.             Move files to archive. This switch in combination with
  678.             the command "A" performs the same action as the command "M".
  679.            
  680.  
  681.     -dh     Open shared files
  682.  
  683.             Allows to process files opened by other applications
  684.             for writing.
  685.  
  686.             This switch helps if an application allowed read access
  687.             to file, but if all types of file access are prohibited,
  688.             file open operation still will fail.
  689.  
  690.             This option could be dangerous, because it allows
  691.             to archive a file, which at the same time is modifying
  692.             by an other application, so use it carefully.
  693.  
  694.  
  695.     -ds     Do not sort files while adding to a solid archive.
  696.  
  697.  
  698.     -ed     Do not add empty directories
  699.  
  700.             This switch indicates that directory records are not to be
  701.             stored in the created archive. When extracting such archive,
  702.             RAR creates non-empty directories basing on paths of files
  703.             contained in them. Information about empty directories is
  704.             lost. All attributes of non-empty directories except a name
  705.             (access rights, streams, etc.) will be lost as well, so use
  706.             this switch only if you do not need to preserve such information.
  707.  
  708.  
  709.     -ee     Do not process extended attributes
  710.  
  711.             Disables saving and restoring extended file attributes.
  712.             Only for OS/2 versions.
  713.  
  714.  
  715.     -en     Do not add "end of archive" block
  716.  
  717.             By default, RAR adds "end of archive" block to the end of new
  718.             or updated archive. It allows to skip external data like
  719.             digital signatures safely, but in some special cases it may be
  720.             useful to disable this feature. For example, if an archive
  721.             is transferred between two systems via a unreliable link and
  722.             at the same time a sender adds new files to it, it may be
  723.             important to be sure that the already received file part will
  724.             not be modified on the other end between transfer sessions.
  725.  
  726.             This switch cannot be used with volumes, because the end
  727.             of archive block contains information important for correct
  728.             volume processing. 
  729.  
  730.  
  731.     -ep     Exclude paths from names. This switch enables files to be added
  732.             to an archive without including the path information. This
  733.             could, of course, result in multiple files existing in the
  734.             archive with the same name.
  735.  
  736.  
  737.     -ep1    Exclude base dir from names. Do not store the path entered in
  738.             the command line.
  739.  
  740.             Example:
  741.  
  742.             all files and directories from the directory tmp will be added
  743.             to the archive 'test', but the path in archived names will not
  744.             include 'tmp\'
  745.  
  746.             rar a -ep1 -r test tmp\*
  747.  
  748.             This is equivalent to the commands:
  749.  
  750.             cd tmp
  751.             rar a -r ..\test
  752.             cd ..
  753.  
  754.  
  755.     -ep2    Expand paths to full. Store full file paths (except a drive
  756.             letter and leading path separator) when archiving.
  757.     
  758.  
  759.     -e<atr> Specifies file exclude attributes mask. <atr> is a number in
  760.             the decimal, octal (with leading '0') or hex (with leading '0x')
  761.             format. If result of bitwise AND between <atr> and file
  762.             attributes is nonzero, file would not be added to archive.
  763.  
  764.             In the Windows version also is possible to use symbols D, S, H,
  765.             A and R instead of digital mask to denote directories and files
  766.             with system, hidden, archive and read-only attributes.
  767.             The order in which the attributes are given is not significant.
  768.  
  769.  
  770.     -f      Freshen files. May be used with archive extraction or creation.
  771.             The command string "a -f" is equivalent to the command 'f', you
  772.             could also use the switch '-f' with the commands 'm' or 'mf'. If
  773.             the switch '-f' is used with the commands 'x' or 'e', then only
  774.             old files would be replaced with new versions extracted from the
  775.             archive.
  776.  
  777.  
  778.     -hp[p]  Encrypt both file data and headers.
  779.  
  780.             This switch is similar to -p[p], but switch -p encrypts
  781.             only file data and leaves other information like file names
  782.             visible. This switch encrypts all sensitive archive areas
  783.             include file data, file names, sizes, attributes, comments
  784.             and other blocks, so it provides a higher security level.
  785.             Without a password it is impossible to view even the list of
  786.             files in archive encrypted with -hp.
  787.  
  788.             Example:
  789.  
  790.             rar a -hpfGzq5yKw secret report.txt
  791.  
  792.             will add the file report.txt to the encrypted archive
  793.             secret.rar using the password 'fGzq5yKw'
  794.  
  795.  
  796.     -idp    Disable percentage indicator.
  797.  
  798.             May be useful when redirecting output to a file.
  799.  
  800.  
  801.     -ieml[.][addr]
  802.             Send archive by email. Win32 version only.
  803.  
  804.             Attach an archive created or updated by the add command
  805.             to email message. You need to have MAPI compliant email
  806.             client to use this switch (most modern email programs
  807.             support MAPI interface).
  808.  
  809.             You may enter a destination email address directly
  810.             in the switch or leave it blank. In the latter case it
  811.             will be asked by your email program. It is possible to
  812.             specify several addresses separated with commas or
  813.             semicolons.
  814.  
  815.             If you append a dot character to -ieml, an archive will be
  816.             deleted after it was successfully attached to email.
  817.             If the switch is used when creating a multivolume archive,
  818.             every volume is attached to separate email message.
  819.  
  820.  
  821.     -ierr   Send all messages to stderr.
  822.  
  823.  
  824.     -ilog[name]
  825.             Log errors to file (registered version only).
  826.  
  827.             Write error messages to the file rar.log created in RAR
  828.             directory. It is possible to specify another log file name
  829.             instead of the default rar.log in the switch, for example,
  830.             -ilogc:\log\backup.log. If the specifed name does not
  831.             include path, the log file will be created in RAR directory.
  832.  
  833.  
  834.     -inul   Disable all messages.
  835.  
  836.  
  837.     -ioff   Turn PC off after completing an operation. The hardware must
  838.             support the power off feature. Win32 version only.
  839.  
  840.  
  841.     -isnd   Enable sound.
  842.  
  843.  
  844.     -k      Lock archive. Any command which intends to change the archive
  845.             will be ignored.
  846.  
  847.  
  848.     -kb     Keep broken extracted files.
  849.  
  850.             RAR, by default, deletes files with CRC errors after
  851.             extraction. The switch -kb specifies that files with
  852.             CRC errors should not be deleted.
  853.  
  854.  
  855.     -m<n>   Set compression method:
  856.  
  857.        -m0   store     do not compress file when adding to archive
  858.        -m1   fastest   use fastest method (less compressive)
  859.        -m2   fast      use fast compression method
  860.        -m3   normal    use normal (default) compression method
  861.        -m4   good      use good compression method (more
  862.                        compressive, but slower)
  863.        -m5   best      use best compression method (slightly more
  864.                        compressive, but slowest)
  865.  
  866.             If this switch is not specified, RAR uses -m3 method
  867.             (normal compression).
  868.  
  869.             By default, RAR uses only the general compression
  870.             algorithm in -m1 and -m2 methods, advanced algorithms
  871.             like audio and true color processing are enabled
  872.             only in -m3..-m5 modes, the advanced text compression
  873.             is activated only in -m4..-m5. This default can be
  874.             overridden using -mc switch.
  875.  
  876.  
  877.     -mc<par>
  878.             Set advanced compression parameters.
  879.  
  880.             This switch is intended mainly for benchmarking and
  881.             experiments, in the real environment usually it is better
  882.             to allow RAR to select optimal parameters automatically.
  883.             Please note that improper use of this switch may lead
  884.             to very serious performance and compression loss, so use
  885.             it only if you clearly understand what you do.
  886.  
  887.             It has the following syntax:
  888.  
  889.             -mc[param1][:param2][module][+ or -]
  890.  
  891.             where <module> is the one character field denoting a part
  892.             of the compression algorithm, which has to be configured.
  893.  
  894.             It may have the following values:
  895.  
  896.               A       - audio compression;
  897.               C       - true color (RGB) data compression;
  898.               D       - delta compression;
  899.               E       - 32-bit x86 executables compression;
  900.               I       - 64-bit Intel Itanium executables compression;
  901.               T       - text compression.
  902.  
  903.             '+' sign at the end of switch applies the selected algorithm
  904.             module to all processed data, '-' disables the module at all.
  905.             If no sign is specified, RAR will choose modules automatically,
  906.             basing on data and the current compression method.
  907.  
  908.             Switch -mc- disables all optional modules and allows only
  909.             the general compression algorithm.
  910.  
  911.             <Param1> and <Param2> are module dependent parameters
  912.             described below.
  913.  
  914.             Audio compression, delta compression:
  915.  
  916.             <Param1> is a number of byte channels (can be 1 - 31).
  917.             RAR splits multibyte channels to bytes, for example,
  918.             two 16-bit audio channels are considered by RAR as four
  919.             channels one byte each.
  920.  
  921.             <Param2> is ignored.
  922.  
  923.  
  924.             32-bit x86 Intel executables compression,
  925.             64-bit Intel Itanium executables compression,
  926.             true color (RGB) data compression:
  927.  
  928.             <Param1> and <Param2> are ignored.
  929.  
  930.  
  931.             Text compression: 
  932.  
  933.             <Param1> is the order of PPM algorithm (can be 2 - 63).
  934.             Usually a higher value slightly increases the compression ratio
  935.             of redundant data, but only if enough memory is available
  936.             to PPM. In case of lack of memory the result may be negative.
  937.             Higher order values decrease both compression and decompression
  938.             speed.
  939.  
  940.             <Param2> is memory in megabytes allocated for PPM (1-128).
  941.             Higher values may increase the compression ratio, but note
  942.             that PPM uses the equal memory size both to compress and
  943.             decompress, so if you allocate too much memory when creating
  944.             an archive, other people may have problems when decompressing
  945.             it on a computer with less memory installed. Decompression
  946.             will be still possible using virtual memory, but it may
  947.             become very slow.
  948.  
  949.  
  950.             Examples:
  951.  
  952.             1) switch -mc1a+ forces use of 8-bit mono audio compression
  953.             for all data.
  954.  
  955.             2) switch -mc10:40t+ forces use of text compression
  956.             algorithm for all data, sets the compression order to 10
  957.             and allocates 40 MB memory.
  958.  
  959.             3) switch -mc12t sets the text compression order to 12,
  960.             when the text compression is used, but leaves to RAR to
  961.             decide when to use it.
  962.  
  963.             4) switches -mct- -mcd- disable text and delta compression.
  964.  
  965.  
  966.     -md<n>  Select dictionary size <n> in KB. Must be 64, 128, 256, 512,
  967.             1024, 2048 or 4096 or a letter 'a', 'b', 'c', 'd', 'e', 'f', 'g'
  968.             respectively.
  969.  
  970.             The sliding dictionary is a special memory area used by the
  971.             compression algorithm. If the size of the file being compressed
  972.             (or the total files size in the case of a solid archive) is
  973.             greater than the dictionary size, then increasing the dictionary
  974.             size will generally increase compression ratio, decrease packing
  975.             speed and increase memory requirements.
  976.  
  977.             RAR can reduce the dictionary size if it is significantly
  978.             larger than size of source data. It helps to reduce memory
  979.             requirements without decreasing compression.
  980.  
  981.             Default sliding dictionary size is 4096 KB.
  982.  
  983.             Example:
  984.  
  985.             RAR a -s -mdd sources *.asm
  986.                 or
  987.             RAR a -s -md512 sources *.asm
  988.  
  989.             Will create a solid archive using a 512 KB dictionary.
  990.  
  991.  
  992.     -ms[list]
  993.             Specify file types to store.
  994.  
  995.             Specify file types, which will be stored without compression.
  996.             This switch may be used to store already compressed files,
  997.             what helps to increase archiving speed without noticeable loss
  998.             in the compression ratio.
  999.  
  1000.             Optional <list> parameter defines the list of file extensions
  1001.             separated with a semicolon. For example, -msrar;zip;jpg will
  1002.             force RAR to store without compression all RAR and ZIP
  1003.             archives and JPG images. It is also allowed to specify wildcard
  1004.             file masks in the list, so -ms*.rar;*.zip;*.jpg will work too.
  1005.  
  1006.             If <list> is not specified, -ms switch will use the default
  1007.             set of extensions, which includes the following file types:
  1008.  
  1009.             ace, arj, bz2, cab, gz, jpeg, jpg, lha, lzh, mp3,
  1010.             rar, zip, taz, tgz, z
  1011.  
  1012.  
  1013.     -ol     Save symbolic links as the link instead of the file.
  1014.             Unix version only.
  1015.  
  1016.  
  1017.     -os     Save NTFS streams. Win32 version only.
  1018.  
  1019.             This switch has meaning only for NTFS file system under
  1020.             Windows NT and allows to save alternative data streams
  1021.             associated with a file. It is especially important under
  1022.             Windows 2000 and XP, which use streams to keep some file
  1023.             dependent information like file descriptions. If you use
  1024.             RAR to backup your NTFS disks, it is recommended to specify
  1025.             this switch.
  1026.  
  1027.  
  1028.     -ow     Use this switch when archiving to save file security
  1029.             information and when extracting to restore it.
  1030.  
  1031.             Unix RAR version saves file owner and group when using
  1032.             this switch.
  1033.  
  1034.             Win32 version stores owner, group, file permissions and
  1035.             audit information, but only if you have necessary privileges
  1036.             to read them. Note that only NTFS file system supports
  1037.             file based security under Windows.
  1038.  
  1039.     -o+     Overwrite existing files.
  1040.  
  1041.  
  1042.     -o-     Do not overwrite existing files.
  1043.  
  1044.  
  1045.     -p[p]   Encrypt files with the string <p> as password while archiving.
  1046.             The password is case-sensitive. If you omit the password on the
  1047.             command line, you will be prompted with message "Enter password".
  1048.  
  1049.             Example:
  1050.  
  1051.             rar a -pmyhoney secret1 *.txt
  1052.  
  1053.             add files *.txt and encrypt them with password "myhoney".
  1054.  
  1055.  
  1056.     -p-     Do not query password
  1057.  
  1058.  
  1059.     -r      Recurse subdirectories. May be used with commands:
  1060.             a, u, f, m, x, e, t, p, v, l, c, cf and s.
  1061.  
  1062.             When used with the commands 'a', 'u', 'f', 'm' will process
  1063.             files in all sub-directories as well as the current working
  1064.             directory.
  1065.  
  1066.             When used with the commands x, e, t, p, v, l, c, cf or s will
  1067.             process all archives in sub-directories as well as the current
  1068.             working directory.
  1069.  
  1070.  
  1071.     -r0     Similar to -r, but when used with the commands 'a', 'u', 'f',
  1072.             'm' will recurse subdirectories only for those names, which
  1073.             include wildcard characters '*' and '?'
  1074.  
  1075.  
  1076.     -ri<p>[:<s>]
  1077.             Set priority and sleep time. Available only in RAR for Windows.
  1078.             This switch is used to regulate system load by RAR in a
  1079.             multitasking environment. The possible task priority values are
  1080.             from 0 to 15. When <p> is equal to 0, the default task priority
  1081.             is used, 1 corresponding to the lowest task priority, 15 - to
  1082.             the highest. The sleep time <s> is a value from 0 to 1000
  1083.             (milliseconds). This is the period of time that RAR will give
  1084.             back to system after every read or write during the packing or
  1085.             unpacking operation. The sleep time setting is useful when
  1086.             several tasks with the same priority are running in the system.
  1087.  
  1088.             Example:
  1089.  
  1090.             execute RAR with default priority and 10 ms of sleep after
  1091.             each read or write
  1092.  
  1093.             rar a -r -sfx -ri0:10 backup *.*
  1094.  
  1095.  
  1096.     -rr[N]  Add a data recovery record. This switch is used when creating or
  1097.             modifying archive to add a data recovery record to the archive.
  1098.             See the 'rr[N]' command description for details.
  1099.  
  1100.  
  1101.     -rv[N]  Create recovery volumes. This switch is used when creating
  1102.             a multivolume archive to generate recovery volumes.
  1103.             See the 'rv[N]' command description for details.
  1104.  
  1105.  
  1106.     -s      Create solid archive. Solid is a special archive type. Please
  1107.             refer to the appendix "Glossary" for further information.
  1108.  
  1109.             Example:
  1110.  
  1111.             create solid archive sources.rar with 512 KB dictionary,
  1112.             recursing all directories, starting with the current directory.
  1113.             Add only .asm files:
  1114.  
  1115.             rar a -s -md512 sources.rar *.asm -r
  1116.  
  1117.  
  1118.     -s<N>   Create solid groups using file count
  1119.  
  1120.             Similar to -s, but reset solid statistics after compressing
  1121.             <N> files. Usually decreases compression, but also
  1122.             decreases losses in case of solid archive damages.
  1123.  
  1124.  
  1125.     -se     Create solid groups using extension
  1126.  
  1127.             Similar to -s, but reset solid statistics if file extension
  1128.             is changed. Usually decreases compression, but also
  1129.             decreases losses from solid archive damages.
  1130.  
  1131.  
  1132.     -sfx[name]
  1133.             Create SFX archives. If this switch is used when creating a new
  1134.             archive, a Self-Extracting archive (using a module in file
  1135.             default.sfx or specified in the switch) would be created.
  1136.             In the Windows version default.sfx should be placed in the
  1137.             same directory as the rar.exe, in Unix - in the user's
  1138.             home directory, in /usr/lib or /usr/local/lib.
  1139.  
  1140.             Example:
  1141.  
  1142.             rar a -sfxwincon.sfx myinst
  1143.  
  1144.             create SelF-eXtracting (SFX) archive using wincon.sfx
  1145.             SFX-module.
  1146.  
  1147.  
  1148.     -si[name]
  1149.             Read data from stdin (standard input), when creating
  1150.             an archive. Optional 'name' parameter allows to specify
  1151.             a file name of compressed stdin data in the created
  1152.             archive. If this parameter is missing, the name will be
  1153.             set to 'stdin'. This switch cannot be used with -v.
  1154.  
  1155.             Example:
  1156.  
  1157.             type Tree.Far | rar a -siTree.Far tree.rar
  1158.  
  1159.             will compress 'type Tree.Far' output as 'Tree.Far' file.
  1160.  
  1161.  
  1162.     -sv     Create independent solid volumes
  1163.  
  1164.             By default RAR tries to reset solid statistics as soon
  1165.             as possible when starting a new volume, but only 
  1166.             if a lot enough data was packed after a previous reset
  1167.             (at least a few megabytes).
  1168.  
  1169.             This switch forces RAR to ignore packed data size and attempt
  1170.             to reset statistics for volumes of any size. It decreases
  1171.             compression, but increases chances to extract a part of data 
  1172.             if one of solid volumes in volume set was lost or damaged.
  1173.  
  1174.             Note that sometimes RAR cannot reset statistics even
  1175.             using this switch. For example, it cannot be done when 
  1176.             compressing one large file split between several volumes.
  1177.             RAR is able to reset solid statistics only between separate 
  1178.             files, but not inside of single file.
  1179.  
  1180.             Ignored, if used to create non-volume archive.
  1181.  
  1182.  
  1183.     -sv-    Create dependent solid volumes
  1184.  
  1185.             Disables to reset solid statistics between volumes.
  1186.  
  1187.             It slightly increases compression, but significantly reduces 
  1188.             chances to extract a part of data if one of solid volumes 
  1189.             in volume set was lost or damaged.
  1190.  
  1191.             Ignored, if used to create non-volume archive.
  1192.  
  1193.  
  1194.     -s-     Disable solid archiving
  1195.  
  1196.  
  1197.     -t      Test files after archiving. This switch is especially
  1198.             useful in combination with the move command, so files will be
  1199.             deleted only if archive had been successfully tested.
  1200.  
  1201.  
  1202.     -ta<date>
  1203.             Process only files modified after the specified date.
  1204.  
  1205.             Format of the date string is YYYYMMDDHHMMSS.
  1206.             It is allowed to insert separators like '-' or ':' to
  1207.             the date string and omit trailing fields. For example,
  1208.             the following switch is correct: -ta2001-11-20
  1209.             Internally it will be expanded to -ta20011120000000
  1210.             and treated as "files modified after 0 hour 0 minutes
  1211.             0 seconds of 20 November 2001".
  1212.  
  1213.  
  1214.     -tb<date>
  1215.             Process only files modified before the specified date.
  1216.             Format of the switch is the same as -ta<date>.
  1217.  
  1218.  
  1219.     -tk     Keep original archive date. Prevents RAR from modifying the
  1220.             archive date when changing an archive.
  1221.  
  1222.  
  1223.     -tl     Set archive time to newest file. Forces RAR to set the date of a
  1224.             changed archive to the date of the newest file in the archive.
  1225.  
  1226.  
  1227.     -tn<time>
  1228.             Process files newer than the specified time period. Format
  1229.             of the time string is:
  1230.  
  1231.             [<ndays>d][<nhours>h][<nminutes>m][<nseconds>s]
  1232.  
  1233.             For example, use switch -tn15d to process files newer
  1234.             than 15 days and -tn2h30m to process files newer than
  1235.             2 hours 30 minutes.
  1236.  
  1237.  
  1238.     -to<time>
  1239.             Process files older than the specified time period. Format
  1240.             of the switch is the same as -tn<time>.
  1241.  
  1242.  
  1243.     -ts<m,c,a>[N]
  1244.             Save or restore file time (modification, creation, access).
  1245.  
  1246.             Switch -tsm instructs RAR to save file modification time,
  1247.             -tsc - creation time and tsa - last access time. Optional
  1248.             parameter after the switch is the number between 0 and 4
  1249.             controlling the file time precision. Value '1' enables
  1250.             1 second precision, 2 - 0.0065536 sec, 3 - 0.0000256 sec and
  1251.             4 or '+' enables the maximum NTFS time precision, which is
  1252.             equal to 0.0000001 sec. Value '0' or '-' means that creation
  1253.             and access time are not saved and low (two seconds) precision
  1254.             is used for modification time. Higher precision modes add
  1255.             more data to archive, up to 19 additional bytes per file
  1256.             in case of -tsm4 -tsa4 -tsc4 combination. If no precision
  1257.             is specified, RAR uses '4' (high) value.
  1258.  
  1259.             Default RAR mode is -tsm4 -tsc0 -tsa0, so modification time
  1260.             is stored with the high precision and other times are ignored.
  1261.  
  1262.             It is necessary to specify -tsc and -tsa switches to set
  1263.             creation and access time when unpacking files (precision
  1264.             is irrelevant, but must not be 0). By default RAR sets
  1265.             only the modification time, even if archive contains
  1266.             creation and last access time. Setting the modification
  1267.             time to unpacked files may be also disabled with -tsm-.
  1268.  
  1269.             It is possible to omit the time type letter if you need
  1270.             to apply the switch to all three times. For example,
  1271.             -tsm4 -tsa4 -tsc4 can be replaced by -ts4, -ts+ or -ts.
  1272.             Use -ts- to save only the low precision modification time
  1273.             or to ignore all three file times on unpacking.
  1274.  
  1275.             When creating an archive, RAR automatically reduces
  1276.             the precision if high mode is not supported by the file
  1277.             system. It is not more than 2 seconds on FAT and 1 second
  1278.             in Unix. NTFS time precision is 0.0000001 second.
  1279.  
  1280.             Operating systems limit which time can be set on unpacking.
  1281.             Windows allow to set all three times, Unix - modification
  1282.             and last access, but not creation, DOS supports only
  1283.             the modification time.
  1284.  
  1285.             Examples:
  1286.  
  1287.             1) rar a -ts backup
  1288.  
  1289.             Store all file times with the highest possible precision.
  1290.  
  1291.             2) rar x -tsa backup
  1292.  
  1293.             Restore modification and last access time. Switch -tsm
  1294.             is not required, because RAR uses it by default.
  1295.  
  1296.             3) rar a -tsm1 -tsc1 backup
  1297.  
  1298.             Store low precision modification and creation time.
  1299.             Without -tsm1 RAR would save the high precision modification
  1300.             time.
  1301.  
  1302.  
  1303.     -u      Update files. May be used with archive extraction or creation.
  1304.             The command string "a -u" is equivalent to the command 'u', you
  1305.             could also use the switch '-u' with the commands 'm' or 'mf'. If
  1306.             the switch '-u' is used with the commands 'x' or 'e', then files
  1307.             not present on the disk and files newer than their copies on the
  1308.             disk would extracted from the archive.
  1309.  
  1310.  
  1311.     -v      Create volumes with size autodetection or list all volumes
  1312.  
  1313.             This switch may be used when creating or listing volumes.
  1314.  
  1315.             In the first case it enables volume size autodetection,
  1316.             so new volumes will use all available space on the destination
  1317.             media. It is convenient when creating volumes on removable
  1318.             disks. You may read more about volumes in -v<size> description.
  1319.  
  1320.             In the second case, when this switch is used together with
  1321.             'V' or 'L' command, it forces RAR to list contents of all
  1322.             volumes starting from the specified in the command line.
  1323.             Without this switch RAR displays contents of only single
  1324.             specified volume.
  1325.  
  1326.  
  1327.     -v<size>[k|b|f|m|M|g|G]
  1328.             Create volumes with size=<size>*1000 [*1024 | *1].
  1329.             By default this switch uses <size> as thousands (1000) of bytes
  1330.             (not 1024 x bytes). You may also enter the size in kilobytes
  1331.             using the symbol 'k', in bytes using the symbol 'b',
  1332.             megabytes - 'm', millions of bytes - 'M', gigabytes - 'g',
  1333.             billions (milliards) of bytes - 'G' or select one of several
  1334.             predefined values using the symbol 'f' following the numerical
  1335.             value. Predefined values can be 360, 720, 1200, 1440 or 2880
  1336.             and replaced with corresponding floppy disk size.
  1337.  
  1338.             If the size is omitted, autodetection will be used.
  1339.  
  1340.             You may specify several -v switches to set different sizes
  1341.             for different volumes. For example:
  1342.  
  1343.               rar a -v100k -v200k -v300k arcname
  1344.  
  1345.             sets 100 KB size for first volume, 200 KB for second
  1346.             and 300 KB for all following volumes.
  1347.  
  1348.             If volumes are created on removable media, then after
  1349.             the first volume has been created, user will be prompted
  1350.             with:
  1351.  
  1352.               Create next volume: Yes/No/All
  1353.  
  1354.             At this moment in time, you should change the disks. Answering
  1355.             'A' will cause all volumes to be created without a pause.
  1356.  
  1357.             By default RAR volumes have names like 'volname.partNNN.rar',
  1358.             where NNN is the volume number. Using -vn switch it is 
  1359.             possible to switch to another, extension based naming scheme,
  1360.             where the first volume file in a multi-volume set has
  1361.             the extension .rar, following volumes are numbered from .r00
  1362.             to .r99.
  1363.  
  1364.             When extracting or testing a multi-volume archive you must use
  1365.             only the first volume name. If there is no next volume
  1366.             on the drive and the disk is removable, the user will be
  1367.             prompted with:
  1368.  
  1369.              Insert disk with <next volume name>
  1370.  
  1371.             Insert the disk with the correct volume and press any key.
  1372.  
  1373.             If while extracting, the next volume is not found and volumes
  1374.             are placed on the non-removable disk, RAR will abort with
  1375.             the error message:
  1376.  
  1377.              Cannot find <volume name>
  1378.  
  1379.             Archive volumes may not be modified. The commands 'd', 'f', 'u',
  1380.             's' cannot be used with Multi-volume sets. The command 'a' may
  1381.             be used only for the creation of a new multi-volume sequence.
  1382.  
  1383.             It is possible, although unlikely, that the file size, of a file
  1384.             in a multi-volume set, could be greater than it's uncompressed
  1385.             size. This is due to the fact that 'storing' (no compression if
  1386.             size increases) cannot be enabled for multi-volume sets.
  1387.  
  1388.             Archive volumes may be Self-Extracting (SFX). Such an archive
  1389.             should be created using both the '-v' and '-sfx' switches.
  1390.  
  1391.             Example:
  1392.  
  1393.             create archive in volumes of fixed size:
  1394.  
  1395.             rar a -s -v1440 floparch.rar *.*
  1396.  
  1397.             will create solid volumes of size 1440000 bytes.
  1398.  
  1399.  
  1400.     -vd     Erase disk contents before creating volume
  1401.  
  1402.             All files and directories on the target disk will be erased
  1403.             when '-vd' is used.  The switch applies only to removable
  1404.             media, the hard disk cannot be erased using this switch.
  1405.  
  1406.  
  1407.     -ver[n] File version control
  1408.  
  1409.             Forces RAR to keep previous file versions when updating
  1410.             files in the already existing archive. Old versions are
  1411.             renamed to 'filename;n', where 'n' is the version number.
  1412.  
  1413.             By default, when unpacking an archive without the switch
  1414.             -ver, RAR extracts only the last added file version, which
  1415.             name does not include a numeric suffix. But if you specify
  1416.             a file name exactly, including a version, it will be also
  1417.             unpacked. For example, 'rar x arcname' will unpack only
  1418.             last versions, when 'rar x arcname file.txt;5' will unpack
  1419.             'file.txt;5', if it is present in the archive.
  1420.  
  1421.             If you specify -ver switch without a parameter when unpacking,
  1422.             RAR will extract all versions of all files matched to entered
  1423.             file mask. In this case a version number is not removed from
  1424.             unpacked file names. You may also extract a concrete file
  1425.             version specifying its number as -ver parameter. It will tell
  1426.             RAR to unpack only this version and remove a version number
  1427.             from file names. For example, 'rar x -ver5 arcname' will
  1428.             unpack only 5th file versions.
  1429.  
  1430.  
  1431.     -vn     Use the old style volume naming scheme
  1432.  
  1433.             By default RAR volumes have names like 'volname.partNNN.rar',
  1434.             where NNN is the volume number. Using -vn switch it is 
  1435.             possible to switch to another, extension based naming scheme,
  1436.             where the first volume file in a multi-volume set has
  1437.             the extension .rar, following volumes are numbered from .r00
  1438.             to .r99. It may have sense, if you are going to unpack
  1439.             an archive under the plain MS DOS, which does not allow
  1440.             more than one dot in a file name.
  1441.  
  1442.  
  1443.     -vp     Pause before each volume
  1444.  
  1445.             By default RAR asks for confirmation before creating or 
  1446.             unpacking next volume only for removable drives.
  1447.             This switch forces RAR to ask such confirmation always.
  1448.             It can be useful if disk space is limited and you wish
  1449.             to copy each volume to another media immediately after
  1450.             creating.
  1451.  
  1452.  
  1453.     -w<p>   Assign work directory as <p>. This switch may be used to assign
  1454.             the directory for temporary files.
  1455.  
  1456.  
  1457.     -x<f>   Exclude specified file <f>, wildcards may be used both
  1458.             in the name and file parts of file mask. You may specify
  1459.             the switch '-x' several times:
  1460.  
  1461.             Examples:
  1462.  
  1463.             1) rar a -r -x*.bak -x*.rar rawfiles
  1464.  
  1465.             *.bak and *.rar files will not be added to rawfiles
  1466.  
  1467.             2) rar a -r -x*\temp\* savec c:\*
  1468.  
  1469.             compress all files on the disk c: except those in temp folders
  1470.  
  1471.  
  1472.     -x@<lf> Exclude files using specified list file.
  1473.  
  1474.             Example:
  1475.  
  1476.             rar a -x@exlist.txt arch *.exe
  1477.  
  1478.  
  1479.     -y      Assume Yes on all queries.
  1480.  
  1481.  
  1482.     -z<f>   Read archive comment from file <f>.
  1483.  
  1484.  
  1485.  Limitations
  1486.  ~~~~~~~~~~~
  1487.  
  1488.     Pathname is limited to 259 symbols.
  1489.  
  1490.     Maximum archive comment length is 62000 bytes.
  1491.  
  1492.     Command limitations:
  1493.  
  1494.     The commands 'd','u','f','c','cf' will not operate with archive
  1495.     volumes.
  1496.  
  1497.     The command 'a' cannot be used to update an archive volume, only to
  1498.     create one.
  1499.  
  1500.  
  1501.  Exit values
  1502.  ~~~~~~~~~~~
  1503.  
  1504.     RAR exits with a zero code (0) in case of successful operation. The exit
  1505.     code of non-zero means the operation is cancelled due to error:
  1506.  
  1507.      255   USER BREAK       User stopped the process
  1508.  
  1509.        9   CREATE ERROR     Create file error
  1510.  
  1511.        8   MEMORY ERROR     Not enough memory for operation
  1512.  
  1513.        7   USER ERROR       Command line option error
  1514.  
  1515.        6   OPEN ERROR       Open file error
  1516.  
  1517.        5   WRITE ERROR      Write to disk error
  1518.  
  1519.        4   LOCKED ARCHIVE   Attempt to modify an archive previously locked
  1520.                             by the 'k' command
  1521.  
  1522.        3   CRC ERROR        A CRC error occurred when unpacking
  1523.  
  1524.        2   FATAL ERROR      A fatal error occurred
  1525.  
  1526.        1   WARNING          Non fatal error(s) occurred
  1527.  
  1528.        0   SUCCESS          Successful operation (User exit)
  1529.  
  1530.  
  1531.  Glossary
  1532.  ~~~~~~~~
  1533.  
  1534.     Archive      Special file containing one or more files optionally
  1535.                  compressed and/or encrypted.
  1536.  
  1537.     Compression  A method of encoding data to reduce it's size.
  1538.  
  1539.     CRC          Cyclic Redundancy Check. Mathematical method calculating
  1540.                  special checking information for data validity.
  1541.  
  1542.     SFX          Archive module used to extract files from when executed.
  1543.                  (SelF-eXtracting module), usually in the form of a .EXE
  1544.                  file.
  1545.  
  1546.     Solid        An archive packed using a special compression method which
  1547.                  sees all files as one continuous data stream. Particularly
  1548.                  advantageous when packing a large number of small files.
  1549.  
  1550.     Volume       Part of a split archive. Splitting an archive to volumes
  1551.                  allows storing them on diskettes. Solid volumes must be
  1552.                  extracted starting from first in sequence.
  1553.  
  1554.  
  1555.  
  1556.  Copyrights
  1557.  
  1558.     (c) 1993-2004 Eugene Roshal
  1559.  
  1560.  
  1561.  
  1562.