home *** CD-ROM | disk | FTP | other *** search
/ Freesoft 1999 February / Freesoft_1999-02_cd.bin / Recenz / Kompres / rar250.exe / rar / RAR.TXT < prev    next >
Text File  |  1999-03-15  |  64KB  |  1,722 lines
  1.  
  2.  ██████╗   █████╗  ██████╗      User's Manual
  3.  ██╔══██╗ ██╔══██╗ ██╔══██╗     ~~~~~~~~~~~~~
  4.  ██████╔╝ ███████║ ██████╔╝     RAR 2.50 DOS and OS/2 versions
  5.  ██╔══██╗ ██╔══██║ ██╔══██╗     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.  ██║  ██║ ██║  ██║ ██║  ██║     Multifunctional Integrated Archive Manager
  7.  ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.  
  9.                        =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  10.                        Welcome to the RAR Archiver!
  11.                        -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  12.  
  13.  
  14.  ╔════════════════════════════════════════════════════════════════════════╗
  15.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Introduction  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  16.  ╚════════════════════════════════════════════════════════════════════════╝
  17.  
  18.  
  19.   RAR is an extremely powerful tool which allows you to manage and
  20.   control archive files.
  21.  
  22.   RAR features include:-
  23.  
  24.     *  Full-screen interactive interface (Optional)
  25.     *  Mouse support and menus
  26.     *  Non-RAR archive support
  27.     *  Common 'standard' command-line interface
  28.     *  Highly sophisticated, original compression algorithm
  29.     *  Special compression algorithm optimized for multimedia data
  30.     *  Better compression than other PC tools using 'solid' archiving
  31.     *  Authenticity verification (registered version only)
  32.     *  Self-extracting archives and volumes (SFX)
  33.     *  Ability to recover physically damaged archives
  34.     *  Programmable installation SFX archives
  35.     *  locking, password, file order list, disk volume labels & more ...
  36.  
  37.  
  38.  ╔════════════════════════════════════════════════════════════════════════╗
  39.  ║▒▒▒▒▒▒▒▒▒▒▒▒ Chapter 1.    Installation and Configuration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  40.  ╚════════════════════════════════════════════════════════════════════════╝
  41.  
  42.    This chapter describes how to install and configure RAR, as well as
  43.    giving information on technical requirements.
  44.  
  45.    1.1. Installation procedure
  46.  
  47.    RAR is distributed as a self-extracting (SFX) archive named
  48.    RAR???.EXE for DOS version or RAR???P.EXE for OS/2 version where
  49.    '???' is the version number.
  50.  
  51.    Local language versions may also be available in the format
  52.    RARnnnxx.exe where "nnn" is the version number and "xx" is the
  53.    country code.
  54.  
  55.    1.1.1. RAR for DOS installation
  56.  
  57.    RAR for DOS installation consists of three basic steps:-
  58.  
  59.    ..  Start the RAR Self-Extracting archive
  60.  
  61.    ..  Choose a directory for the RAR files
  62.  
  63.    ..  Initiate the RAR installation
  64.  
  65.    For example, on floppy disk A: you have the file RAR200.EXE, this
  66.    will be RAR version 2.00.  You may install it to your C: disk by
  67.    typing, at the DOS prompt, the following command (executing the RAR
  68.    self-extracting archive):
  69.  
  70.    C:\> A:RAR200
  71.  
  72.    You will be prompted with the RAR archive comment.  Press any key to
  73.    continue, or press ESC to cancel the extraction.
  74.  
  75.    Then you will enter the RAR installation menu.
  76.  
  77.    Choose "Read license" to view the RAR license for usage and
  78.    distribution.  Pressing <Esc> to return to the installation menu.
  79.  
  80.    Choose "Destination directory" to enter the path for installation.
  81.  
  82.    Choose "Install" to extract the RAR files to the destination
  83.    directory.
  84.  
  85.    When the extraction is successfully completed, a number of files
  86.    will be placed in the destination directory and RAR will be ready
  87.    for use.
  88.  
  89.    1.1.2. RAR for OS/2 installation
  90.  
  91.    RAR for OS/2 installation consists of three basic steps:-
  92.  
  93.    ..  Create a directory for the RAR files
  94.  
  95.    ..  Make this directory the current working directory
  96.  
  97.    ..  Execute the RAR Self-Extracting archive
  98.  
  99.  
  100.    For example, on floppy disk A: you have the file RAR200P.EXE, this
  101.    will be RAR version 2.00 for OS/2.  You may install it to your C:
  102.    disk by typing, at the OS prompt, the following commands:
  103.  
  104.    [C:\] mkdir RAR
  105.    [C:\] cd RAR
  106.    [C:\RAR]
  107.  
  108.    You have now created a new directory, C:\RAR, and it is the current
  109.    working directory.
  110.  
  111.    Then execute the RAR self-extracting archive:
  112.  
  113.    [C:\RAR] A:RAR200P
  114.  
  115.    You will be prompted with the RAR archive comment.  Press any key to
  116.    continue, or press ESC to cancel the extraction.
  117.  
  118.    When the extraction is successfully completed, a number of files
  119.    will be placed in the current directory and RAR will be ready for
  120.    use.
  121.  
  122.    1.1.3. Installation hints
  123.  
  124.    The archiver program itself is named RAR.EXE. This module contains
  125.    all of the archiver's functionality, packing, unpacking, repairing,
  126.    SFX creation etc.
  127.  
  128.    It is recommended that the name of the directory, containing the RAR
  129.    files, be added to the PATH environment variable. This will enable
  130.    RAR to be used from any directory. Alternatively the critical
  131.    modules of RAR may be copied to your "Utilities" directory.  These
  132.    modules are RAR.EXE and RAR.CFG (RAR.EXE, RAR2.CFG and RARARC2.CFG
  133.    for OS/2 version), although it is not essential, you may copy
  134.    UNRAR.EXE as well.
  135.  
  136.  
  137.    1.2. Option menu
  138.  
  139.    A number of RAR options may be configured and saved to be used as
  140.    default options.  To access this menu, start RAR without any
  141.    parameters and then press Function key 9 (F9) to bring up the
  142.    Options menu:
  143.  
  144.  
  145.    C:\RAR> RAR
  146.  
  147.    When RAR has been started, press F9 - the following menu will
  148.    appear:
  149.  
  150.           ┌─────────────────────────────────┐
  151.           │ Configuration...                │
  152.           │ Set password              ALT-P │
  153.           │ Work directory            ALT-W │
  154.           │ Default comment file            │
  155.           │ External viewer                 │
  156.           │ Change disk               ALT-D │
  157.           │ Registration                    │
  158.           │ Save options              ALT-S │
  159.           └─────────────────────────────────┘
  160.  
  161.    Press <Enter> for the sub-menu "Configuration".  The configuration
  162.    menu offers a number of basic options which may be changed.
  163.  
  164.    In the configuration menu, use the arrow keys to move from item to
  165.    item.  An item value may be changed by hitting the <space> key.
  166.    When all items are set as desired, move to the "Ok" field and hit
  167.    <Enter> to save the chosen values. To discard any changes, move to
  168.    the "Cancel" field and hit <Enter>.
  169.  
  170.    If you have a mouse attached, this process is even easier.  Simply
  171.    move the mouse cursor to the desired item and click the left mouse
  172.    key. When you have completed the configuration, move the mouse
  173.    cursor to the field " Ok " and click on the left mouse key. To
  174.    discard changes click the left mouse key on the " Cancel " field.
  175.  
  176.  
  177.    "Configuration/Interface options"
  178.  
  179.      Color                  Selects/Deselects color in
  180.                             full-screen mode
  181.  
  182.      Sound                  Enables RAR's sound effects
  183.  
  184.      Stdout mode            Forces RAR to run in console
  185.                             (stdout) mode while processing
  186.                             commands from the command line
  187.  
  188.      Mouse                  Enables the use of mouse-support
  189.                             in full-screen mode
  190.  
  191.  
  192.    "Configuration/Archiving options"
  193.  
  194.      Always solid           Forces RAR to create solid archives which
  195.      archiving              are often very much smaller than "normal"
  196.                             archives.  See RAR_FAQ.TXT for more details.
  197.                             Default is ON and all created archives will
  198.                             be made in 'solid' mode.  If you are making
  199.                             archives which will be frequently updated,
  200.                             the speed of update will be increased by
  201.                             changing this option, at the expense of
  202.                             compression ratio.
  203.  
  204.      Multimedia             Enables special compression .a
  205.      compression            designed for digital audio and some
  206.                             types of graphic. See '-mm' description
  207.                             for details.
  208.  
  209.      Put recovery record    If this option is selected RAR will
  210.                             add recovery record to any new or modified
  211.                             archive. See 'rr' command description
  212.                             for details.
  213.  
  214.  {+} Put Authenticity       Forces RAR to place -AV (Authenticity
  215.      verification           Verification) into archives when they are
  216.                             created. (This feature is only available in
  217.                             the registered version)
  218.  
  219.  
  220.    "Configuration/Compression"
  221.  
  222.    Choose the default compression level from one of the following:
  223.  
  224.       Store ...... Do not compress file when adding to archive
  225.       Fastest .... Use fastest method (least compressive)
  226.       Fast ....... Use fast compression method
  227.       Normal ..... Use normal (default) compression method
  228.       Good ....... Use good compression method (more compressive)
  229.       Best ....... Use best compression method (most compressive)
  230.  
  231.    Default is 'Normal' and is chosen as the best compromise between
  232.    time taken and compression ratio achieved.  Marginally higher (0.1%
  233.    - 1.5%) compression may be achieved with 'Good' or 'Best', at the
  234.    expense of 10% - 100% longer processing time.
  235.  
  236.  
  237.    "Configuration/Include file mask"
  238.  
  239.    Choose the categories of files to be included when adding to an
  240.    archive from the following:
  241.  
  242.        Read only files ..... Add files with 'Read-only' attribute
  243.        System files ........ Add files with 'System' attribute
  244.        Archive files ....... Add files with 'Archive' attribute
  245.        Hidden files ........ Add files with 'Hidden' attribute
  246.  
  247.    Default is 'Read-Only, System, Archive or Hidden' and is used such
  248.    that ALL files in a directory will be archived if the general
  249.    wildcard (*.*) is used.
  250.  
  251.    For more information on file attributes, please refer to your DOS
  252.    manual.
  253.  
  254.  
  255.    "Configuration/Sort order"
  256.  
  257.    Choose the sort mode for viewing the archive contents in full-screen
  258.    mode from one of the following:
  259.  
  260.         Unsorted ......... Do not sort files
  261.         By name .......... Sort files by name
  262.         By extension ..... Sort files by extension
  263.         By size .......... Sort files by size
  264.  
  265.    Default is 'Sort files by names'.
  266.  
  267.  
  268.    "Configuration/Other options"
  269.  
  270.      Use 386 instructions   Forces RAR to detect the CPU type and use
  271.                             386 CPU 32-bit instructions if an
  272.                             appropriate processor (386 or higher) is
  273.                             available. This option is present only in
  274.                             the DOS version as RAR for OS/2 always uses
  275.                             32-bit instructions.
  276.  
  277.      Use expanded memory    Allows the use of expanded memory (EMS 4.0).
  278.                             Present only in the DOS version.
  279.  
  280.  
  281.      Save extended          Enables the saving of OS/2 extended
  282.      attributes             attributes. Present only in OS/2 version.
  283.  
  284.  {+} Log errors to file     Enables the logging of critical errors
  285.                             to a file RAR.LOG. (This feature is only
  286.                             available in the registered version)
  287.  
  288.  
  289.    "Set password"
  290.  
  291.    Assign a password which will used when you add/extract files to/from
  292.    an archive.  You may define the password using <Alt-P>. Note, the
  293.    password will not be saved to the configuration file.
  294.  
  295.  
  296.    "Work directory"
  297.  
  298.    The path where RAR will place temporary files.  This may be changed
  299.    at any time by pressing <Alt-W>.
  300.  
  301.  
  302.    "Default comment file"
  303.  
  304.    If you would like a common comment added to every archive you are
  305.    creating, enter the full path and name here.
  306.  
  307.  
  308.    "External viewer"
  309.  
  310.    You may assign an external viewer program to run for viewing file in
  311.    archives (by pressing <F3>).
  312.  
  313.    While viewing a file of the archive in full-screen mode RAR uses the
  314.    internal viewer if an external viewer has not been configured.
  315.  
  316.    The internal viewer provides for dynamic extraction of the file.
  317.    This means the viewer extracts only those parts which are currently
  318.    needed for viewing.  As more is needed, more is read, etc.
  319.  
  320.    While using the external viewer the entire file is extracted before
  321.    actual view.
  322.  
  323.    "Change disk"
  324.  
  325.    You may change the current disk displayed in the work window.
  326.  
  327.  
  328.    "Registration"
  329.  
  330.    To register RAR you must have a registration code.  This code may be
  331.    obtained by sending the completed registration form to your local
  332.    registration site or the world-wide distribution center.
  333.  
  334.    You will receive the latest version of RAR along with your
  335.    registration key and will then be able to create archives containing
  336.    Authenticity verification.
  337.  
  338.  
  339.    "Save setup"
  340.  
  341.    Pressing <Enter> or clicking the left mouse key on this item will
  342.    pop up a small confirmation window in which the user is invited to "
  343.    Save " or " Cancel " the saving of the new configuration for future
  344.    default usage in RAR.
  345.  
  346.    RAR stores the default configuration in the file RAR.CFG, which is
  347.    held in the same directory as RAR.EXE.
  348.  
  349.    The configuration may also be saved by pressing ALT-S keys,
  350.    (pressing the "S" key while simultaneously holding down the "ALT"
  351.    key).
  352.  
  353.    These options may also be set by using the left mouse key in the
  354.    window "Settings":
  355.  
  356.  
  357.    DOS version:    ┌────────────── Settings ─────────────┐
  358.                    │   Password                 Absent   │
  359.                    │   Compression level        Normal   │
  360.                    │   Multimedia compression   Disabled │
  361.                    │   Add recovery record      Disabled │
  362.                    │   Add AV to archives       Disabled │
  363.                    │   Make solid archives      Optional │
  364.                    │   Log errors to file       Enabled  │
  365.                    │   Default comment file     Absent   │
  366.                    └─────────────────────────────────────┘
  367.  
  368.    OS/2 version:   ┌────────────── Settings ─────────────┐
  369.                    │   Priority and sleep time 0  : 0    │
  370.                    │   Save extended attrib.   Enabled   │
  371.                    │   Password                Absent    │
  372.                    │   Compression level       Normal    │
  373.                    │   Dictionary size         256 Kb    │
  374.                    │   Multimedia compression  Disabled  │
  375.                    │   Add recovery record     Disabled  │
  376.                    │   Add AV to archives      Disabled  │
  377.                    │   Make solid archives     Always    │
  378.                    │   Log errors to file      Disabled  │
  379.                    │   Default comment file    Absent    │
  380.                    └─────────────────────────────────────┘
  381.  
  382.    For example, click the left mouse key on the word 'Absent' in the
  383.    setting 'Password', you will be prompted to enter a new password.
  384.    Clicking the left mouse key on the word 'Optional' in the setting
  385.    'Make solid archives' would cause toggle to 'Always' - that will
  386.    force RAR to create solid archives.
  387.  
  388.  
  389.    1.3. RAR environment variable
  390.  
  391.    Default parameters may be added to the RAR command line by
  392.    establishing an environment variable, using the DOS "SET" command.
  393.  
  394.    Examples:
  395.  
  396.    C:\> SET RAR=-std -s
  397.  
  398.    RAR will use this string as default parameters in the command
  399.    line.
  400.  
  401.    RAR handles options with the following priority:
  402.  
  403.        command line switches              highest priority
  404.        switches in the RAR variable       lower priority
  405.        options saved in RAR.CFG           lowest priority
  406.  
  407.    The switches -sfx, -v, -s and -std from the RAR variable have no
  408.    effect in full-screen mode.
  409.  
  410.  
  411.    1.4. Technical requirements (DOS version only)
  412.  
  413.    Minimum DOS version to run RAR: 3.0
  414.  
  415.    Minimum memory requirements to perform commands and corresponding
  416.    operations (in Kbytes) are:-
  417.  
  418.     Commands:   ╔══════════════════╤══════════════════╗
  419.     A,F,M,U     ║Command line mode │ Full-screen mode ║
  420.                 ╟─────────┬────────┼─────────┬────────╢
  421.                 ║Not solid│ Update │Not solid│ Update ║
  422.                 ║or adding│ solid  │or adding│ solid  ║
  423.                 ║to solid │ archive│to solid │ archive║
  424.    ╔════════════╫─────────┼────────┼─────────┼────────╢
  425.    ║EMS enabled ║   337   │  409   │  409    │  481   ║
  426.    ║EMS disabled║   401   │  473   │  473    │  545   ║
  427.    ╚════════════╩═════════╧════════╧═════════╧════════╝
  428.  
  429.     Commands: CW,E,P,T,X       Command: C
  430.    ╔════════════╦═════════╗   ╔════════════╦═════════╗
  431.    ║EMS enabled ║   217   ║   ║EMS enabled ║   409   ║
  432.    ║EMS disabled║   281   ║   ║EMS disabled║   473   ║
  433.    ╚════════════╩═════════╝   ╚════════════╩═════════╝
  434.  
  435.     Command: D  ╔══════════╦══════════════════════════╗
  436.                 ║ Not solid║       Solid archive      ║
  437.                 ║ archive  ╟────────────┬─────────────╢
  438.                 ║          ║Command line│ Full-screen ║
  439.    ╔════════════╫──────────╫────────────┼─────────────╢
  440.    ║EMS enabled ║    217   ║     409    │     481     ║
  441.    ║EMS disabled║    217   ║     473    │     545     ║
  442.    ╚════════════╩══════════╩════════════╧═════════════╝
  443.    Update AV to non-solid archive will require some extra memory.
  444.  
  445.     Commands:
  446.     CF,EN,K,L,  ╔═════════╤════════╗
  447.     R,RR,S,V    ║  No AV  │ Add AV ║
  448.    ╔════════════╫─────────┼────────╢
  449.    ║EMS enabled ║   217   │  409   ║
  450.    ║EMS disabled║   217   │  473   ║
  451.    ╚════════════╩═════════╧════════╝
  452.  
  453.    If available memory is increased, by 32 Kb or more, over the minimum
  454.    requirements, compression speed will increase. Compression ratio may
  455.    also slightly increase.
  456.  
  457.    Generally the use of wildcards ('*' and '?') in an archive name or
  458.    argument list from an external file (also with '-x' feature) will
  459.    require extra memory.
  460.  
  461.    For extracting from and updating non-RAR archives add the memory
  462.    requirements of the external archiver.
  463.  
  464.  
  465.    1.5. The external archiver configuration file - RARARC2.CFG
  466.         (OS/2 version only)
  467.  
  468.    The configuration file RARARC2.CFG is intended to define external
  469.    programs which RAR should call to process ZIP, ARJ and LZH archives.
  470.    Actually it contains three sections for these archivers. This file
  471.    is fully explained with comment line.
  472.  
  473.  
  474.    1.6. Errorlevels
  475.  
  476.    When RAR.EXE quits to DOS it sets the environment variable
  477.    ERRORLEVEL to a value representing the termination status (last
  478.    operation status and reason for exit).
  479.  
  480.      255   USER BREAK       Ctrl/Break pressed by user
  481.  
  482.        8   MEMORY ERROR     Not enough memory for operation
  483.  
  484.        7   USER ERROR       Command line option error
  485.  
  486.        6   OPEN ERROR       Open file error
  487.  
  488.        5   WRITE ERROR      Write to disk error
  489.  
  490.        4   LOCKED ARCHIVE   Attempt to modify an archive previously
  491.                             locked by the 'k' command
  492.  
  493.        3   CRC ERROR        A CRC error occurred when unpacking
  494.  
  495.        2   FATAL ERROR      A fatal error occurred
  496.  
  497.        1   WARNING          Non fatal error(s) occurred
  498.  
  499.        0   SUCCESS          Successful operation (User exit)
  500.  
  501.  
  502.     The self-extracting (SFX) module quits with following codes:
  503.  
  504.        1   PROBLEMS         Error(s) occurred during extraction
  505.  
  506.        0   SUCCESS          Successful operation
  507.  
  508.  
  509.  ╔════════════════════════════════════════════════════════════════════════╗
  510.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Chapter 2.     Using RAR Interactively ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  511.  ╚════════════════════════════════════════════════════════════════════════╝
  512.  
  513.  
  514.    When you execute the command "RAR" at the Dos prompt, you are
  515.    presented with the full-screen interface - this is known as RAR's
  516.    interactive full-screen mode.
  517.  
  518.    For example, you enter:
  519.  
  520.    C:\> RAR
  521.  
  522.    On the right hand side of the opening screen, you will be presented
  523.    with a dialogue box containing the memory status and settings
  524.    window.  This information includes: current compression method,
  525.    password status (present or absent), multimedia compression
  526.    (enabled/disabled), add recovery record (enabled/disabled),
  527.    authenticity verification status (enabled/disabled), default comment
  528.    file .. present or not. OS/2 version settings also include priority
  529.    and sleep time, save extended attributes (enabled/disabled) and
  530.    dictionary size.
  531.  
  532.    On the left-hand side of the screen you are presented with a list of
  533.    files in the current directory. You can move the cursor through the
  534.    files on the screen by using cursor keys or clicking the left mouse
  535.    button.
  536.  
  537.    Pressing <Enter> when the cursor is positioned on a directory, up-
  538.    directory ("..") or archive file name, will cause entry to be made
  539.    to that item.
  540.  
  541.    The following archive types are recognized by RAR: .RAR, .ARJ, .ZIP
  542.    and .LZH.
  543.  
  544.    Entering an archive, causes the files within the archive to be
  545.    displayed in a similar manner to a directory listing.
  546.  
  547.    It is therefore possible to "walk through" directories and archive
  548.    files, managing files both in archives and normal directories.
  549.  
  550.    In "directory" mode, the bottom like of the screen contains
  551.    a menu of functions provided by the function keys.
  552.  
  553. 1-Help 2-Add 3-View 4-Fresh 5-Volume 6-Move 7-Update 8-Delete 9-Option 0-Quit
  554.  
  555.    The line indicates that you may obtain help by pressing <F1>, add
  556.    files to an archive by pressing <F2>, view files by pressing <F3>
  557.    etc. Press <F10> to quit. These functions are the main command set
  558.    when you are in a directory (not in archive).
  559.  
  560.    Alternatively, pressing and holding down the <ALT> key will cause
  561.    the display of additional functions:
  562.  
  563. 1-  2-Solid 3-View.. 4-SFX 5-SFXVol 6-SolVol 7-SolSVl 8-Repair 9-SolSFX 0-
  564.  
  565.    This indicates that Pressing <ALT-F2> may be used to create a SOLID
  566.    archive, <ALT-F3> to view an archive using the internal viewer, etc.
  567.  
  568.    Also shown, by holding down the <ALT> key, will be the options list:
  569.  
  570.    Alt-C ... Toggle between color and monochrome mode
  571.    Alt-D ... Select drive
  572.    Alt-J ... DOS shell
  573.    Alt-M ... Select compression method
  574.    Alt-P ... Set password
  575.    Alt-S ... Save setup
  576.    Alt-W ... Set work directory to store temporary files
  577.  
  578.    The OS/2 version contains two additional options:
  579.  
  580.    Alt-A ... Select dictionary size
  581.              (see -md<size> description for details)
  582.    Alt-R ... Set task priority and sleep time
  583.              (see ri<P>[:<S>] description for details)
  584.  
  585.    Pressing keys, other than those which indicate options and
  586.    functions, will put RAR into speed search mode for file names. This
  587.    feature can save a lot of keystrokes when looking for specific file
  588.    names.
  589.  
  590.    Changing from a directory to an archive will automatically change
  591.    the set of available functions to those which are more suitable to
  592.    those circumstances.
  593.  
  594.    In "archive" mode the available functions line looks like:
  595.  
  596. 1-Help 2-Test 3-View 4-Extr 5-Comment 6-ExCurD 7-SFX 8-Delete 9-Option 0-Quit
  597.  
  598.    This line indicates you may obtain help by pressing <F1>, test files
  599.    in archive by pressing <F2>, view file by <F3> etc. Press <F10> to
  600.    quit. These functions are the main set when you are inside (Entered-
  601.    to) an archive.
  602.  
  603.    Alternatively, when holding down the <Alt> key, the following would
  604.    be displayed:
  605.  
  606. 1-    2-    3-View.. 4-ExtrTo 5-FilCmt 6-AddRec 7-Lock  8      9      0
  607.  
  608.    Files may be marked/unmarked by using the [Space], [Ins], or right
  609.    mouse key. You may also mark/unmark file groups by wildcards (file
  610.    mask) using the [Gray +] and [Gray -] keys on the numeric keypad.
  611.    Marking a directory, automatically marks all the sub-directories and
  612.    files within it.
  613.  
  614.    The marked/unmarked status of a group of files may be reversed by
  615.    using the [Gray *] key.  Marking or unmarking a file, or group of
  616.    files, updates a highlighted status display line at the bottom of
  617.    the screen.  This status line indicates the number of files marked
  618.    and the total size in bytes (the file size of marked directories is
  619.    not included in the summary file size).
  620.  
  621.    In full-screen mode, the use of the mouse is fully supported.  Use
  622.    the left mouse key to move through a directory.  Click the left key
  623.    twice to <Enter>.  Use the right key to mark files.  When entering
  624.    text (archive name, password etc.) the left mouse key cancels the
  625.    data entry operation and right mouse key confirms entered text.  Use
  626.    the left mouse key to choose function commands (F1-F10) of menu
  627.    items and options.
  628.  
  629.  
  630.    2.1. In a directory
  631.  
  632.      F1       Help information
  633.  
  634.      F2       Add file(s) to an archive, if the archive does
  635.               not exist, it will be created
  636.  
  637.      F3       View a file (if no external viewer is set, the
  638.               internal viewer will be used)
  639.  
  640.      F4       Freshen files in an archive - only recently changed files
  641.               will be added instead of their old copies in archive
  642.  
  643.      F5       Create archive volumes (Span diskettes)
  644.  
  645.      F6       Add files not already in the archive and update those
  646.               files changed since they were packed to the archive
  647.  
  648.      F7       Move file(s) to archive
  649.  
  650.      F8       Repair a damaged archive
  651.  
  652.      F9       Set up / Save options
  653.  
  654.      F10      Quit RAR.  Pressing the ESC key has the same
  655.               effect.
  656.  
  657.      Alt-F2   Create a solid archive.
  658.  
  659.      Alt-F3   View a file (with internal viewer).
  660.  
  661.      Alt-F4   Create a SFX archive.
  662.  
  663.      Alt-F5   Create Self-Extracting (SFX) volumes.
  664.  
  665.      Alt-F6   Create solid archive volumes.
  666.  
  667.      Alt-F7   Create solid SFX-volumes.
  668.  
  669.      Alt-F8   Repair a broken archive.
  670.  
  671.      Alt-F9   Create a solid SFX archive
  672.  
  673.  
  674.    2.2. In an archive
  675.  
  676.    Press [Enter] with the cursor on the archive name to expand the
  677.    archive contents.  The same effect may be achieved with the command-
  678.    line option "en".   (See Chapter 3, 'en' command)
  679.  
  680.    Once inside an archive, the list of files is displayed on the left
  681.    side of the screen.  These files may be marked, just as files in a
  682.    directory.
  683.  
  684.    An asterisk (*) to the left of a file name, indicates that the file
  685.    is password encrypted.
  686.  
  687.    Below the list of files the status line is displayed. Status line
  688.    contains information about size and number of selected files and
  689.    directories or if no files are selected about the current marked
  690.    file: name, and at the end of status line - compression method,
  691.    dictionary size and ratio.
  692.  
  693.    The right-hand portion of the screen is given over to a dialogue
  694.    box, which includes information on:  archive name and status,
  695.    presence of comments, encrypted files, recovery record, authenticity
  696.    verification, dictionary size, total number of files in the archive,
  697.    file sizes, compression ratio, the minimum RAR version required to
  698.    extract files and the host Operating System used to create the
  699.    archive.
  700.  
  701.    For example:
  702.  
  703.    Dialogue Box:                    Meaning:
  704.  
  705.    Archive          EXAMPLE.RAR     archive name
  706.    Archive type     Normal          not a 'solid' archive
  707.    Main comment     Present         archive comment present
  708.    File comments    Absent          no individual file comments
  709.    Passwords        Absent          no password encrypted files
  710.    Recovery data    Present         recovery record present
  711.    Lock             Absent          archive is not locked
  712.    Auth. verif.     Present         authenticity verification is present
  713.    Dictionary       64Kb            dictionary size
  714.    Files            1               number of files (1)
  715.    Total length     14917           total length in bytes
  716.    Packed length    3938            length in archive
  717.    Ratio            26%             compression ratio.  Now 26% of
  718.                                     original size.
  719.    Version to extr. 2.00            minimum RAR version required to extract
  720.    Host OS          DOS             OS used to create this archive
  721.  
  722.  
  723.    Function keys actions:
  724.  
  725.      F1       Help information
  726.  
  727.      F2       Test archive (validate integrity)
  728.  
  729.      F3       View a file (if an external viewer is not set,
  730.               the internal viewer will be used)
  731.  
  732.      F4       Extract files from an archive with directory
  733.               structure
  734.  
  735.      F5       Add a comment to the archive
  736.  
  737.      F6       Extract file(s) to the current directory
  738.  
  739.      F7       Make a Self-Extracting (SFX) archive
  740.  
  741.      F8       Delete file(s) from an archive
  742.  
  743.      F9       Set up / Save options
  744.  
  745.      F10      Quit RAR
  746.  
  747.      ESC      Return from the archive
  748.  
  749.      Alt-F3   View a file (using the internal viewer)
  750.  
  751.      Alt-F4   Extract file(s) to an alternate path
  752.  
  753.      Alt-F5   Add individual file comment(s)
  754.  
  755.      Alt-F6   Add archive recovery record
  756.  
  757.      Alt-F7   Lock the archive preventing modifications
  758.  
  759.  
  760.    When working with archive volumes in full-screen mode you must begin
  761.    the process with the first volume, you will be prompted with a menu:
  762.  
  763.    "Proceed with all volumes from current"
  764.    "Proceed with selected files only"
  765.  
  766.    Choose the method you wish to use to work with the volumes.
  767.  
  768.    When files are displayed which were split between archive volumes,
  769.    the compressed size displayed refers to the compressed size on the
  770.    current volume.  The symbol '<-' indicates that part of the file
  771.    exists on a previous volume. The symbol '->' indicates that part of
  772.    the file exist on the next volume. You can change to the previous or
  773.    next volume by pressing corresponding arrow keys (left or right).
  774.  
  775.    2.3. In a non-RAR archive
  776.  
  777.    In full-screen mode RAR offers the management of non-RAR archives.
  778.    Supported non-RAR archive types are ZIP, ARJ and LZH.
  779.  
  780.    RAR provides the following operations for non-RAR archives:
  781.  
  782.     - extract files, creating the directory structure;
  783.     - extract to the current directory;
  784.     - extract to a specified directory;
  785.     - test files in the archive;
  786.     - delete files from the archive;
  787.     - view contents of the archive in full-screen mode;
  788.     - make SFX-archives;
  789.     - add archive comment (ZIP and ARJ only);
  790.     - add file comment (ZIP and ARJ only).
  791.  
  792.    Also the user may set a password for the archive (pressing Alt-P)
  793.    and the path for temporary files (Alt-W).
  794.  
  795.    For viewing the archive contents the user will need only RAR.
  796.    However for operations with non-RAR archives the user should have
  797.    the corresponding programs (PKUNZIP, PKZIP, ZIP2EXE, ARJ, LHA, or as
  798.    specified in RARARC2.CFG for OS/2 version), also the path to these
  799.    programs must be included in the PATH environment variable.
  800.  
  801.    You can use RAR as the archive manager for archives of all the
  802.    above-mentioned types in shell programs such as Norton Commander.
  803.  
  804.    Note, RAR does not provide facilities for the management of non-RAR
  805.    SFX archives.
  806.  
  807.    Only the standard LZH archive header is supported.  Archives created
  808.    by LHA using the switch '/h2' are not supported.
  809.  
  810.  ╔════════════════════════════════════════════════════════════════════════╗
  811.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒ Chapter 3.           RAR Command Line Options ▒▒▒▒▒▒▒▒▒▒▒▒║
  812.  ╚════════════════════════════════════════════════════════════════════════╝
  813.  
  814.    Command line mode is an alternative to the full-screen interactive mode.
  815.    This mode is best used in batch files and requires no interaction.
  816.  
  817.  
  818.    Usage:
  819.  
  820.  
  821.     RAR <command> -<switch1> -<switchN> <archive> <files...>
  822.         <@listfiles...> <path_to_extract\>
  823.  
  824.    All parameters must exist on the same, single command line.
  825.  
  826.    command      ..  The function to be performed by RAR, add,
  827.                     extract, move etc.
  828.  
  829.    switch       ..  Switches used to define a specific type of
  830.                     operation, compression strength, type of
  831.                     archive etc.
  832.  
  833.    archive      ..  The name of the archive to be operated upon.
  834.  
  835.    files        ..  The files to be processed.
  836.  
  837.    listfiles    ..  The name of a file containing the names of
  838.                     the files to be operated upon.
  839.  
  840.    path_to_extract  Used only with commands 'e' and 'x',
  841.                     indicating the directory in which to
  842.                     place extracted files.  If this directory
  843.                     does not exist, it will be created.
  844.  
  845.                     NOTE:  The use of the terminating backslash
  846.                            character, on this parameter, is
  847.                            MANDATORY.
  848.  
  849.  
  850.    3.1. Commands (Alphabetic sequence)
  851.  
  852.    ..  a: add files to archive
  853.  
  854.    ..  c: add archive comment
  855.  
  856.        Pressing [F10] will save the entered comment and exit.
  857.        Pressing [Esc] will cancel the comment.  Pressing [F10]
  858.        without entering a comment will remove any existing
  859.        comment.
  860.  
  861.        Comments are displayed while the archive is being
  862.        processed.  The maximum comment length is 16384 bytes.
  863.  
  864.        Support for ANSI esc-sequences is provided in RAR which
  865.        allows the use of color and cursor movements.  No ANSI
  866.        driver is required to display such comments.
  867.  
  868.        Redefinition of the keyboard using ANSI esc-sequences is
  869.        NOT supported and thus the so-called ANSI-bombs cannot be
  870.        delivered using RAR.
  871.  
  872.     Example:
  873.  
  874.        RAR c distrib.rar
  875.  
  876.        Comments may be entered from a file by using the '-z<file>'
  877.        switch before the name of the file containing the comment.
  878.  
  879.        RAR c -zinfo.txt dummy
  880.  
  881.    ..  cf: add file comments (not to entire archive)
  882.  
  883.        Pressing [F10] will save the entered comment and exit.
  884.        Pressing [Esc] will cancel the comment.  Pressing [F10]
  885.        without entering a comment will remove any existing
  886.        comment.
  887.  
  888.        Comments are displayed when the 'v' command is given.
  889.        Comment length is limited to 16384 bytes.
  890.  
  891.     Example:
  892.  
  893.        RAR cf bigarch *.txt
  894.  
  895.    ..  cw: write the archive comment to a file
  896.  
  897.     Example:
  898.  
  899.        RAR cw oldarch comment.txt
  900.  
  901.        The comment from the archive oldarch.rar will be
  902.        written to the file comment.txt
  903.  
  904.    ..  d: delete files from archive
  905.  
  906.     Note: If the processing of this command resulted in
  907.        removing all the files from the archive, the empty
  908.        archive would itself be removed.
  909.  
  910.    ..  e: extract files from archive to current directory
  911.  
  912.    ..  en: start RAR in full-screen mode and enter an archive
  913.  
  914.        Usually this command is included in the extension file
  915.        of a shell processor such as Norton Commander:
  916.  
  917.        RAR: RAR en !.!
  918.  
  919.     Examples:
  920.  
  921.        RAR en disk1.rar
  922.  
  923.        RAR en puppy.zip
  924.  
  925.        The 'en' may also be omitted, simply start RAR with
  926.        the archive name.
  927.  
  928.     Example:
  929.  
  930.        RAR baby.arj
  931.  
  932.    ..  f: freshen files in archive
  933.  
  934.        Updates those files changed since they were packed to
  935.        the archive.  This command will not add new files to the
  936.        archive.
  937.  
  938.    ..  k: lock archive
  939.  
  940.        Any commands that could change the archive will be
  941.        ignored.
  942.  
  943.     Example:
  944.  
  945.        RAR k final.rar
  946.  
  947.    ..  l: list archive contents (brief listing)
  948.  
  949.        Files are listed as with the 'v' command with the
  950.        exception of the file path.  i.e. only the file name
  951.        is displayed.
  952.  
  953.    ..  m: move files and directories to archive
  954.  
  955.        Moving files and directories results in the files and
  956.        directories being erased upon successful completion of
  957.        the packing operation.  Directories will not be removed
  958.        if '-ed' switch is used.
  959.  
  960.    ..  mf: move files to archive
  961.  
  962.         Moving files results in the files being erased upon
  963.         successful completion of the packing operation.
  964.  
  965.    ..  p: print file(s) to screen (STDOUT)
  966.  
  967.    ..  r: repair a damaged archive
  968.  
  969.        Archive repairing consists of two stages. Firstly, the damaged
  970.        archive is scanned for a recovery record (see the 'rr' command).
  971.        If the archive contains a previously added recovery record and
  972.        if the portion of the damaged data is continuous and less than
  973.        N*512 bytes, where N is number of recovery sectors placed into
  974.        the archive, the chance of a successful archive reconstruction
  975.        is very high. When this stage has been completed, a new archive
  976.        will be created, called _RECOVER.RAR
  977.  
  978.        If a damaged archive does not contain a recovery record or if
  979.        the archive cannot be completely recovered due to too severe
  980.        damage, a second stage is begun. During this stage only the
  981.        archive structure is reconstructed and it is impossible to
  982.        recover files which fail CRC validation, but it is still
  983.        possible to recover undamaged files which were inaccessible due
  984.        to a broken archive structure. Generally this is useful for non-
  985.        solid archives.
  986.  
  987.        When this stage has been completed, a new archive will be
  988.        created, called _RECONST.RAR
  989.  
  990.        While the recovery process is in operation, RAR may
  991.        prompt the user for assistance when suspicious files are
  992.        located.
  993.  
  994.                       Suspicious entry
  995.  
  996.               Name:  <possibly filename>
  997.               Size:  <size>    Packed: <compressed size>
  998.  
  999.                       Add it: Yes/No/All
  1000.  
  1001.     Answer 'Y' to add this entry to the file $RECOVER.RAR.
  1002.  
  1003.     Example:
  1004.  
  1005.        RAR r buggy.rar
  1006.  
  1007.    ..  rr[N]: add data recovery record
  1008.  
  1009.        Optionally, redundant information (recovery record) may be added
  1010.        to an archive, incurring a small penalty in archive size, which
  1011.        will help to recover archived files in the case of floppy disk
  1012.        failure or other data losses. A recovery record may contain up
  1013.        to 8 recovery sectors. The number of sectors may be specified
  1014.        directly in the 'rr' command (N = 1 .. 8) or selected
  1015.        automatically according to the archive size:
  1016.  
  1017.                    Archive size       Number of sectors
  1018.                      < 50Kb                   2
  1019.                      50Kb-500Kb               4
  1020.                      > 500Kb                  8
  1021.  
  1022.        If damaged data is continuous then each sector is able to
  1023.        recover 512 bytes of damaged information, although this value
  1024.        may decrease for multiple areas of damage.
  1025.  
  1026.        The size of the recovery record may be calculated
  1027.        (approximately) as <archive size>/256 + <number of recovery
  1028.        sectors>*512 bytes.
  1029.  
  1030.  
  1031.    ..  s: convert archive to a Self-Extracting (SFX) type.
  1032.  
  1033.        In the Dos environment, this will create a *.EXE file
  1034.        which, when executed, will extract the files contained
  1035.        within it.
  1036.  
  1037.        It is also possible to make an SFX archive as the first
  1038.        of a multi-volume sequence, but it should be noted that
  1039.        the size will be larger by the amount of the SFX-module.
  1040.        Please ensure that the first volume in the sequence is
  1041.        created with the correct size.
  1042.  
  1043.        Should SFX volumes be created using the command 'a' with
  1044.        the switches: '-v[<size>] -sfx', then you do not need to
  1045.        ensure the volume size - first volume will be automatically
  1046.        created with the proper size.
  1047.  
  1048.     Example:
  1049.  
  1050.         RAR s diamant
  1051.  
  1052.    ..  s<file.sfx>: convert archive to a Self-Extracting (SFX) type
  1053.        using alternate SFX module
  1054.  
  1055.        You may indicate an alternate SFX module (pathname) to build
  1056.        the SFX archive.
  1057.  
  1058.        For instance the Installation SFX:
  1059.  
  1060.        RAR sidos.sfx myinst
  1061.        RAR c -zscript.s myinst
  1062.  
  1063.        See the Installation SFX documentation, SFX.DOC, for details
  1064.        of the command language of the installation SFX.
  1065.  
  1066.    ..  t: test archive files
  1067.  
  1068.        This command performs a dummy file extraction, writing
  1069.        nothing to the output stream, in order to validate the
  1070.        specified file(s).
  1071.  
  1072.    ..  u: update files in archive
  1073.  
  1074.        Adds files not already in the archive and updates those
  1075.        files changed since they were packed to the archive.
  1076.  
  1077.    ..  v: verbosely list archive content (full listing)
  1078.  
  1079.        Files are listed using the format: full pathname, file
  1080.        comment, original and compressed size, compression ratio,
  1081.        last update date and time, attributes, CRC, compression
  1082.        method with the code of sliding dictionary size and minimum
  1083.        RAR version required to extract. The dictionary size is coded
  1084.        as following: 'a' means 64 Kb, 'b' - 128 Kb, 'c' - 256 Kb,
  1085.        'd' - 512 Kb, 'e' - 1024 Kb.
  1086.  
  1087.        To list the contents of all archive volumes, use and
  1088.        asterisk (*) in place of the archive file extension.
  1089.  
  1090.     Example:
  1091.  
  1092.         RAR v multivol.*
  1093.  
  1094.    ..  x: extract files from archive to original (relative)
  1095.           directory if pathnames exist in the archive
  1096.  
  1097.     Command limitations:
  1098.  
  1099.        The commands 'd', 'u', 'f', 'c', 'cf' will not operate with
  1100.        archive volumes.
  1101.  
  1102.        The command 'a' cannot be used to update an archive volume, only
  1103.        to create one.
  1104.  
  1105.  
  1106.    3.2. Switches  (Alphabetic sequence)
  1107.  
  1108.    ..  -?  display help on commands and switches
  1109.  
  1110.    ..  -$[drive]  provide volume label support
  1111.  
  1112.        When adding to an archive the switch causes the adding of the
  1113.        volume label of the current or specified disk drive to the
  1114.        archive. When extracting from the archive the switch instructs
  1115.        RAR to set the volume label from the archive to the specified
  1116.        disk drive or, if not specified, to the drive on which
  1117.        extraction has been processed.
  1118.  
  1119.        Volume labels are ignored in SFX and the UNRAR utility.
  1120.  
  1121.    ..  -ac  clear Archive attribute after compression or extraction
  1122.  
  1123.    ..  -ao  add files with Archive attribute set
  1124.  
  1125.        Example:
  1126.  
  1127.        add all disk C: files with Archive attribute set
  1128.        to the 'f:backup' and clear files Archive attribute
  1129.  
  1130.        rar a -r -ac -ao f:backup c:\*.*
  1131.  
  1132.    ..  -ap  set path inside archive
  1133.  
  1134.        this path is merged to file names when adding files to
  1135.        an archive and removed from file names when extracting.
  1136.  
  1137.        For example, if you wish to add the file 'readme.txt'
  1138.        to the directory 'DOCS\ENG' of archive 'release',
  1139.        you may run:
  1140.  
  1141.        rar a -apDOCS\ENG release readme.txt
  1142.  
  1143.        or to extract 'ENG' to the current directory:
  1144.  
  1145.        rar x -apDOCS release DOCS\ENG\*.*
  1146.  
  1147.    ..  -av  apply authenticity verification (registered versions only)
  1148.  
  1149.        RAR will put, in every new and updated archive, information
  1150.        concerning the creator, last update time and archive name.
  1151.  
  1152.        If an archive, containing authenticity verification, is being
  1153.        modified and this switch is not specified, the authenticity
  1154.        verification information will be removed.
  1155.  
  1156.        When extracting, testing, listing or updating and archive with
  1157.        the '-av' switch, RAR will perform integrity validation and
  1158.        display the message:
  1159.  
  1160.             Verifying authenticity information ...
  1161.  
  1162.        In the case of successful authenticity verification, the message
  1163.        'Ok', creator name and last update information will be
  1164.        displayed.  In the case of authenticity verification failure,
  1165.        the message 'FAILED' will be displayed.
  1166.  
  1167.        When creating archive volumes with the '-av' switch, Cyclic
  1168.        Redundancy Check (CRC) information will be added to each volume.
  1169.  
  1170.        The Authenticity Verification feature, '-av,' is recommended for
  1171.        use with archives in a software distribution environment.
  1172.  
  1173.        In order to enable the Authenticity verification feature, the
  1174.        program MUST be registered.  Please contact your local
  1175.        distribution site or the world-wide distribution center.
  1176.  
  1177.    ..  -av-  disable checking or adding authenticity verification
  1178.  
  1179.    ..  -b   enable backup archives
  1180.  
  1181.        This switch will create a backup before an archive is modified.
  1182.        The backup file will have the same name as the original archive
  1183.        but with the .BAK extension.  Should this file already exist,
  1184.        the backup file will be named with a .$BK extension.
  1185.  
  1186.    ..  -bw  black & white (monochrome) mode
  1187.  
  1188.    ..  -c-   disable comment display
  1189.  
  1190.    ..  -cfg- disable read configuration and environment
  1191.  
  1192.    ..  -col  color mode
  1193.  
  1194.    ..  -dh   disable sharing files
  1195.  
  1196.        This helps when accessing files open by other applications on
  1197.        networks or multi-tasking environment.
  1198.  
  1199.    ..  -ds   do not sort files while adding to a solid archive
  1200.  
  1201.        Note: see the RARFILES.LST description - solid archiving file
  1202.        order list.
  1203.  
  1204.    ..  -e<s,h,a,r> set file exclusion attributes
  1205.  
  1206.        The switches 's', 'h', 'a' or 'r' signify that files having the
  1207.        System, Hidden, Archive or Read only attributes should be
  1208.        excluded.  The order in which the attributes are given is not
  1209.        significant.
  1210.  
  1211.     Example:
  1212.  
  1213.        RAR a -ehs purity *.exe
  1214.  
  1215.        Do NOT add files with Hidden or System attributes.
  1216.  
  1217.    ..  -ed  do not add empty directories
  1218.  
  1219.        This switch indicates that empty directories are not to be
  1220.        stored in the created archive.
  1221.  
  1222.    ..  -ems-  disable EMS usage (DOS version only)
  1223.  
  1224.    ..  -ee  disable extended attributes saving (OS/2 version only)
  1225.  
  1226.    ..  -ep  exclude paths from names
  1227.  
  1228.        This switch enables files to be added to an archive without
  1229.        including the path information.  This could, of course, result
  1230.        in multiple files existing in the archive with the same name.
  1231.  
  1232.    ..  -ep1 exclude base dir from names
  1233.  
  1234.        Do not store the path from the command line.
  1235.  
  1236.        Example:
  1237.  
  1238.           RAR a -ep1 -r pasta tmp\*.*
  1239.  
  1240.        All files and directories from the directory TMP will be added
  1241.        to the archive 'pasta', but the path will not include 'TMP\'.
  1242.        This is equivalent to the commands:
  1243.  
  1244.          cd tmp
  1245.          RAR a -ep1 -r pasta
  1246.          cd ..
  1247.  
  1248.    ..  -f   freshen files
  1249.  
  1250.        May be used with archive extraction or creation.
  1251.  
  1252.        The command string "a -f" is equivalent to the command 'f', you
  1253.        could also use the switch '-f' with the commands 'm' or 'mf'.
  1254.        If the switch '-f' is used with the commands 'x' or 'e', then
  1255.        only old files would be replaced with new versions extracted
  1256.        from the archive.
  1257.  
  1258.    ..  -ialt  Disables the changing, by pressing the left Alt key, the
  1259.        context function key information in the bottom line of the
  1260.        screen (in full-screen mode).  This helps some users who wished
  1261.        to use certain TSRs while in RAR.  The action of the left and
  1262.        right function keys are in other respects, unchanged.  This may
  1263.        be permanently configured by adding the switch to the RAR
  1264.        environment variable (SET in autoexec.bat) with SET RAR=-ialt
  1265.  
  1266.    ..  -kb     keep broken extracted files
  1267.  
  1268.        RAR, by default, deletes files with CRC errors after
  1269.        extraction. The switch -kb specifies that files with
  1270.        CRC errors should not be deleted.
  1271.  
  1272.    ..  -m<0..5> set compression method
  1273.  
  1274.        -m0   store     do not compress file when adding to
  1275.                        archive
  1276.        -m1   fastest   use fastest method (less compressive)
  1277.        -m2   fast      use fast compression method
  1278.        -m3   normal    use normal (default) compression method
  1279.        -m4   good      use good compression method (more
  1280.                        compressive, but slower)
  1281.        -m5   best      use best compression method (sightly more
  1282.                        compressive, but slowest)
  1283.  
  1284.        By default RAR uses -m3 method (Normal compression).
  1285.  
  1286.    ..  -md<size>: select dictionary size in Kb (OS/2 version only)
  1287.            size must be equal to 64, 128, 256, 512 or 1024
  1288.            or a letter 'a', 'b', 'c', 'd' or 'e' accordingly.
  1289.  
  1290.        The sliding dictionary is a special memory area used by the
  1291.        compression algorithm. If the size of the file being compressed
  1292.        (or the total files size in the case of a solid archive) is
  1293.        greater than the dictionary size, then increasing the dictionary
  1294.        size will generally increase compression ratio, decrease packing
  1295.        speed and increase memory requirements.  RAR for DOS has a fixed
  1296.        dictionary size of 64 Kb.  RAR for OS/2 (and other 32-bit
  1297.        platforms) has a default dictionary size of 256Kb, but this may
  1298.        be changed by the user to be 64 Kb, 128 Kb, 256 Kb, 512 Kb or
  1299.        1024 Kb.  Unlike compression, extraction speed is unaffected by
  1300.        dictionary size.
  1301.  
  1302.        The amount of memory required to create large dictionary
  1303.        archives may be calculated as 5*<dictionary size>+150Kb. About 1
  1304.        Mb is required for extraction and 5*<dictionary size>+1150Kb to
  1305.        update solid archives.
  1306.  
  1307.        RAR for DOS can extract from large dictionary archives using
  1308.        conventional, EMS and disk memory. If no EMS or disk
  1309.        cache is available, the operation may slow down significantly. RAR
  1310.        for DOS cannot convert large dictionary archives to SFX with the
  1311.        default SFX module and cannot update such solid archives.
  1312.  
  1313.     Example:
  1314.  
  1315.        RAR a -s -mdd sources *.asm
  1316.            or
  1317.        RAR a -s -md512 sources *.asm
  1318.  
  1319.        Will create a solid archive using a 512 Kb dictionary.
  1320.  
  1321.    ..  -mm multimedia compression
  1322.  
  1323.        Enables a special multimedia compression algorithm. This is
  1324.        intended to be used primarily when compressing raw digital audio
  1325.        data such as WAV's up to four 8-bit or two 16-bit channels but
  1326.        also show good results with true color (24-bit) bitmaps. An
  1327.        improvement in the compression ratio, of up to 30%, may be
  1328.        expected over normal compression.
  1329.  
  1330.        During archiving of a file, in multimedia mode, RAR performs
  1331.        intelligent data analysis and may use the general or multimedia
  1332.        compression algorithm for different parts of the file depending
  1333.        upon which algorithm is the more suitable. Such analysis allows
  1334.        optimum performance when different data types exist in the same
  1335.        file (This is typical for STM and MOD files).
  1336.  
  1337.        The switches -m<N> "Set compression method" and -s "Create solid
  1338.        archive" also may be used with multimedia compression but -m<N>
  1339.        influences only those parts compressed with the general
  1340.        algorithm.
  1341.  
  1342.        If -mm is used with data which is not multimedia, the
  1343.        compression ratio, generally, will not be changed but, due to
  1344.        the multimedia analysis overhead, speed is always decreased. So
  1345.        it is not recommended to use -mm with data other than multimedia
  1346.        data.
  1347.  
  1348.        Note: multimedia compression is designed only for a certain
  1349.        file types. E.g. it works well with WAV, STM, MOD and true color
  1350.        bitmaps, but will gain nothing for MID, GIF, JPG or 8-bit bitmaps.
  1351.  
  1352.     Example:
  1353.  
  1354.        RAR a -m5 -s -mm songs *.wav
  1355.  
  1356.    ..  -mmf force multimedia compression
  1357.  
  1358.        This switch works as the -mm with one exception: it always
  1359.        compress files as multimedia independent of the multimedia
  1360.        analysis results. Usually this leads to a worse compression
  1361.        ratio but may be useful in the hypothetical case when RAR cannot
  1362.        correctly detect a multimedia file.
  1363.  
  1364.    ..  -o+ overwrite existing files
  1365.  
  1366.    ..  -o- do not overwrite existing files (default)
  1367.  
  1368.    ..  -p<password> set password
  1369.  
  1370.    ..  -p  set password
  1371.  
  1372.        The password is case-sensitive. If you omit the password on the
  1373.        command line, you will be prompted with:
  1374.  
  1375.        Enter password:
  1376.  
  1377.     Example:
  1378.  
  1379.        RAR a -pmyhoney secret *.txt
  1380.  
  1381.        Newly added files will be encrypted with the password 'myhoney'.
  1382.  
  1383.    ..  -r recurse subdirectories
  1384.  
  1385.        May be used with commands: 'a', 'u', 'f', 'm', 'x', 'e', 't',
  1386.        'p', 'v', 'l', 'c', 'cf' and 's'.
  1387.  
  1388.        When used with the commands, 'a', 'u', 'f' or 'm', will
  1389.        process files in all sub-directories as well as the
  1390.        current working directory.
  1391.  
  1392.        When used with the commands, 'x', 'e', 't', 'p', 'v', 'l', 'c',
  1393.        'cf' or 's', will process all archives in sub-directories as well
  1394.        as the current working directory.
  1395.  
  1396.    ..  -r0  recurse subdirectories (wildcards only)
  1397.  
  1398.        Similar to -r, but when used with the commands 'a', 'u',
  1399.        'f', 'm' will recurse subdirectories only for wildcard names.
  1400.  
  1401.    ..  -ri<P>[:<S>] set priority and sleep time (OS/2 version only)
  1402.  
  1403.        This option is used to regulate system load by RAR in a
  1404.        multitasking environment.
  1405.  
  1406.        The task priority <P> (possible values, 0 to 128) is the OS/2
  1407.        task priority.  Values of <P> are grouped as follows:
  1408.  
  1409.                  <P> value      OS/2 <priority class>:<priority level>
  1410.                     0                OS/2 default (i.e. 2:0, or <P>=33)
  1411.                    1-32              1:0-1:31
  1412.                   33-64              2:0-2:31
  1413.                   65-96              3:0-3:31
  1414.                   97-128             4:0-4:31
  1415.  
  1416.        When <P> is equal to 0, the default OS/2 task priority is used.
  1417.  
  1418.        The sleep time <S> is a value from 0 to 1000 (milliseconds).
  1419.        This is the period of time that RAR will give back to OS/2 after
  1420.        every read or write during the packing or unpacking operation.
  1421.        The sleep time setting is useful when several tasks with the
  1422.        same priority are running in the system.
  1423.  
  1424.     Example:
  1425.  
  1426.        RAR a -r -sfx -ri0:100 backup *.*
  1427.  
  1428.        Execute RAR with default priority and 100 ms of sleep after each
  1429.        read or write.
  1430.  
  1431.    ..  -rr[N]: add data recovery record
  1432.  
  1433.        If this switch is used when creating or modifying an archive, a
  1434.        data recovery record will be added to the resulting archive. See
  1435.        command 'rr[N]' description for details.
  1436.  
  1437.    ..  -s   create a solid archive
  1438.  
  1439.        Solid is a special archive type.  Please refer to the appendix
  1440.        "Glossary" for further information.
  1441.  
  1442.     Example:
  1443.  
  1444.        RAR a -s -v1440 -sfx maddy *.*
  1445.  
  1446.        Will create solid Self-Extracting (SFX) volumes of size 1440000
  1447.        bytes.
  1448.  
  1449.        Note: see the RARFILES.LST description - solid archiving file
  1450.        order list.
  1451.  
  1452.    ..  -s<N>  create solid groups using file count
  1453.  
  1454.        Similar to -s, but reset solid statistics after compressing
  1455.        <N> files. Usually decreases compression, but also
  1456.        decreases losses in case of solid archive damages.
  1457.  
  1458.    ..  -se  create solid groups using extension
  1459.  
  1460.        Similar to -s, but reset solid statistics if file extension
  1461.        is changed. Usually decreases compression, but also
  1462.        decreases losses in case of solid archive damages.
  1463.  
  1464.    ..  -sv  create independent solid volumes
  1465.  
  1466.        Similar to -s, but reset solid statistics as soon as possible
  1467.        when starting a new volume. Ignored, if used to create
  1468.        non-volume archive. Usually slightly decreases compression,
  1469.        but also seriously decreases data losses, when one volume
  1470.        in volume set is damaged. In such case you may try to start
  1471.        extraction from the next volume after damaged. Note that
  1472.        because of internal buffering, sometimes RAR cannot reset
  1473.        dictionary immediately after creating a new volume and one or
  1474.        more small files in the beginning of new volume may still use
  1475.        data from the previous volume.
  1476.  
  1477.    ..  -s-  disable solid archiving
  1478.  
  1479.    ..  -sfx create Self-Extracting (SFX) archive
  1480.  
  1481.        If this switch is used when creating a new archive, a Self-
  1482.        Extracting archive would be created.
  1483.  
  1484.     Example:
  1485.  
  1486.        RAR a -sfx sources *.asm
  1487.  
  1488.        This command would create a Self-Extracting archive named
  1489.        SOURCES.EXE.  To extract files from such an archive, you would
  1490.        simply execute it.  Self-Extracting archives may be processed
  1491.        normally using RAR.
  1492.  
  1493.    ..  -sfx<file.sfx> create Self-Extracting (SFX) archive using an
  1494.        alternate SFX module.
  1495.  
  1496.    Example:
  1497.  
  1498.        RAR a -sfxidos.sfx -zscript.s myinst
  1499.  
  1500.        See the Installation SFX documentation, SFX.DOC for details.
  1501.  
  1502.    ..  -std  stdout mode
  1503.  
  1504.        All output text is sent to the stdout stream.  This allows
  1505.        redirection of RAR output to a file, for example:
  1506.  
  1507.        RAR v -std bambam >bambam.lst
  1508.  
  1509.          or in 'silent' mode without any output:
  1510.  
  1511.        RAR x -std dime 10cents.txt >nul
  1512.  
  1513.        Note:  In stdout mode, if an archive comment exists, no delay
  1514.               will be implemented when the comment is displayed.
  1515.  
  1516.    ..  -tk  do not modify archive date
  1517.  
  1518.        Prevents RAR from modifying the archive date when changing an
  1519.        archive.
  1520.  
  1521.    ..  -tl  set archive date as the date of newest file
  1522.  
  1523.        Forces RAR to set the date of a changed archive to the date of
  1524.        the newest file in the archive.
  1525.  
  1526.    ..  -u   update files
  1527.  
  1528.        May be used with archive extraction or creation.
  1529.  
  1530.        The command string "a -u" is equivalent to the command 'u', you
  1531.        could also use the switch '-u' with the commands 'm' or 'mf'.
  1532.        If the switch '-u' is used with the commands 'x' or 'e', then
  1533.        files not present on the disk and files newer than their copies
  1534.        on the disk would extracted from the archive.
  1535.  
  1536.    ..  -v create volumes with autodetected size
  1537.  
  1538.        Note: when the switch is used with 'v' or 'l' command RAR
  1539.        lists all volumes starting from specified.
  1540.  
  1541.    ..  -v<size> create archive volumes
  1542.  
  1543.        By default this switch uses <size> as thousands (1000) of bytes
  1544.        (not 1024 x bytes). You may also enter the size in kilobytes
  1545.        using the symbol 'k', in bytes using the symbol 'b' or
  1546.        select one from several predefined values using the symbol 'f'
  1547.        following the numerical value. Predefined values can be
  1548.        360, 720, 1200, 1440 or 2880 and replaced with corresponding
  1549.        floppy disk size.
  1550.  
  1551.        If the size is omitted, autodetection will be used.
  1552.  
  1553.        If volumes are created on the same drive as the temporary files
  1554.        (current drive by default, but may be changed with the switch '-
  1555.        w'), the autodetected size becomes meaningless.  In this case
  1556.        the volume size must be explicitly defined.
  1557.  
  1558.        If volumes are created on a drive OTHER than the drive
  1559.        containing the temporary files, then after the first volume has
  1560.        been created, the user will be prompted with:
  1561.  
  1562.            Create next volume: Yes/No/All/Quit
  1563.  
  1564.        At this moment in time, you should change the disks. Answering
  1565.        'A' will cause all volumes to be created without a pause.
  1566.  
  1567.        The first volume file in a multi-volume set has the extension
  1568.        .RAR, following volumes are numbered from .R00 to .R99.
  1569.  
  1570.        When extracting or testing a multi-volume archive you must use
  1571.        only the first volume name (*.RAR).  If there is no next volume
  1572.        on the drive (and volumes are not placed in the same directory
  1573.        as the temporary files), the user will be prompted with:
  1574.  
  1575.            Insert disk with <next volume name>
  1576.  
  1577.        Insert the disk with the correct volume and press any key.
  1578.  
  1579.        If while extracting, the next volume is not found and volumes
  1580.        are placed in the same directory as the temporary files, RAR
  1581.        will abort with the error message:
  1582.  
  1583.            Cannot find <volume name>
  1584.            Cannot change disk with temporary files
  1585.  
  1586.        Archive volumes may not be modified.  The commands 'd', 'f',
  1587.        'u', 's' can not be used with Multi-volume sets. The command 'a'
  1588.        may be used only for the creation of a new multi-volume
  1589.        sequence.
  1590.  
  1591.        It is possible, although unlikely, that the file size, of a file
  1592.        in a multi-volume set, could be greater than it's uncompressed
  1593.        size.  This is due to the fact that 'storing' (no compression if
  1594.        size increases) cannot be enabled for multi-volume sets.
  1595.  
  1596.        Archive volumes may be Self-Extracting (SFX).  Such an archive
  1597.        should be created using both the '-v' and '-sfx' switches.
  1598.  
  1599.  
  1600.     Example:
  1601.  
  1602.     1. Archive drive C: on floppy drive A:
  1603.  
  1604.        RAR a -r -v a:allhard c:\*.*
  1605.  
  1606.     (current disk MUST NOT be a:)
  1607.  
  1608.     2. Create archive volumes with 1440000 byte size in current
  1609.        directory.
  1610.  
  1611.        RAR a -v1440 4flopp
  1612.  
  1613.        or
  1614.  
  1615.        RAR a -v1440 4flopp *.*
  1616.  
  1617.    .. -vd erase disk contents before creating volume
  1618.  
  1619.        All files and directories on the target disk will be erased when
  1620.        '-vd' is used.  The switch applies only to removable media, the
  1621.        hard disk cannot be erased using this switch.
  1622.  
  1623.    ..  -w<path> assign work directory
  1624.  
  1625.        This switch may be used to assign the directory for temporary
  1626.        files to another drive.  For example a RAM drive or high
  1627.        performance disc.
  1628.  
  1629.     Example:
  1630.  
  1631.        RAR a -we:\tmp bmps *.bmp
  1632.  
  1633.        Temporary files would be created in directory E:\TMP
  1634.  
  1635.  
  1636.    ..  -x<mask> exclude files specified by mask
  1637.  
  1638.     Example:
  1639.  
  1640.        RAR a -x*.bak purearch.rar
  1641.  
  1642.        You may specify the switch '-x' several times:
  1643.  
  1644.        RAR a -r -x*.arj -x*.rar rawfiles
  1645.  
  1646.    ..  -x@<list> exclude files using specified list file
  1647.  
  1648.     Example:
  1649.  
  1650.        RAR a -x@exlist.txt arch *.exe
  1651.  
  1652.    ..  -y   assume Yes on all queries
  1653.  
  1654.    ..  -z<file> add comment to archive
  1655.  
  1656.  
  1657.    3.3. SFX switches
  1658.  
  1659.     An SFX archive module may be handled by the switches:
  1660.  
  1661.    ..  -e   Extract from the SFX archive
  1662.  
  1663.        The switch is used by default similar to 'x' command in RAR.
  1664.  
  1665.    ..  -t   Test the SFX archive
  1666.  
  1667.        This is similar to 't' command in RAR.
  1668.  
  1669.    ..  -v   View the archive content
  1670.  
  1671.        This is similar to 'v' command in RAR.
  1672.  
  1673.    3.4. The file order list for solid archiving - RARFILES.LST.
  1674.  
  1675.        RARFILES.LST contains user-defined file list which tells RAR
  1676.        the order to add files to a solid archive. It may contain file
  1677.        names, wildcards and special entry - $default. The default
  1678.        entry defines the place in order list for files not matched
  1679.        with other entries in this file. The comment character is ';'.
  1680.  
  1681.        This file should be placed in the same directory as RAR.
  1682.  
  1683.        Tips to provide improved compression and speed of operation:
  1684.  
  1685.        - similar files should be grouped together in the archive;
  1686.        - frequently accessed files should be placed at the beginning.
  1687.  
  1688.  
  1689.  ╔════════════════════════════════════════════════════════════════════════╗
  1690.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Glossary  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  1691.  ╚════════════════════════════════════════════════════════════════════════╝
  1692.  
  1693.    Archive       Special file containing one or more files optionally
  1694.                  compressed and/or encrypted.
  1695.  
  1696.    Compression   A method of encoding data to reduce it's size.
  1697.  
  1698.    CRC           Cyclic Redundancy Check. Mathematical method
  1699.                  calculating special checking information for data
  1700.                  validity.
  1701.  
  1702.    Dictionary    The length of a buffer used to search similarities
  1703.    size          (the stage of a compression process) in a file been
  1704.                  added to the archive.
  1705.  
  1706.    SFX           Archive module used to extract files from when
  1707.                  executed. (SelF-eXtracting module), usually in the
  1708.                  form of a .EXE file.
  1709.  
  1710.    Sliding       See the 'Dictionary size' description.
  1711.    dictionary
  1712.  
  1713.    Solid         An archive packed using a special compression method
  1714.                  which sees all files as one continuous data stream.
  1715.                  Particularly advantageous when packing a large number
  1716.                  of small files.
  1717.  
  1718.    Volume        Part of a split archive. Splitting an archive to
  1719.                  volumes allows storing them on diskettes. Solid volumes
  1720.                  must be extracted starting from first in sequence.
  1721.  
  1722.