home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / dos / tools / rar200.exe / rar / RAR.DOC < prev    next >
Text File  |  1996-05-02  |  62KB  |  1,657 lines
  1.  
  2.  ██████╗   █████╗  ██████╗      User's Manual
  3.  ██╔══██╗ ██╔══██╗ ██╔══██╗     ~~~~~~~~~~~~~
  4.  ██████╔╝ ███████║ ██████╔╝     RAR 2.00 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' and 'f' will not operate with archive 
  1100.        volumes. 
  1101.  
  1102.        The command 'a' cannot be used to update an archive volume, only 
  1103.        to create one. 
  1104.  
  1105.        The commands 'c' and 'cf' will not operate with archive volumes, 
  1106.        but will work with solid archives. 
  1107.  
  1108.  
  1109.    3.2. Switches  (Alphabetic sequence)
  1110.  
  1111.    ..  -?  display help on commands and switches
  1112.  
  1113.    ..  -$[drive]  provide volume label support
  1114.  
  1115.        When adding to an archive the switch causes the adding of the 
  1116.        volume label of the current or specified disk drive to the 
  1117.        archive. When extracting from the archive the switch instructs 
  1118.        RAR to set the volume label from the archive to the specified 
  1119.        disk drive or, if not specified, to the drive on which 
  1120.        extraction has been processed. 
  1121.  
  1122.        Volume labels are ignored in SFX and the UNRAR utility.
  1123.  
  1124.    ..  -av  apply authenticity verification (registered versions only)
  1125.  
  1126.        RAR will put, in every new and updated archive, information 
  1127.        concerning the creator, last update time and archive name. 
  1128.  
  1129.        If an archive, containing authenticity verification, is being 
  1130.        modified and this switch is not specified, the authenticity 
  1131.        verification information will be removed. 
  1132.  
  1133.        When extracting, testing, listing or updating and archive with 
  1134.        the '-av' switch, RAR will perform integrity validation and 
  1135.        display the message:
  1136.  
  1137.             Verifying authenticity information ...
  1138.  
  1139.        In the case of successful authenticity verification, the message 
  1140.        'Ok', creator name and last update information will be 
  1141.        displayed.  In the case of authenticity verification failure, 
  1142.        the message 'FAILED' will be displayed. 
  1143.  
  1144.        When creating archive volumes with the '-av' switch, Cyclic 
  1145.        Redundancy Check (CRC) information will be added to each volume. 
  1146.  
  1147.        The Authenticity Verification feature, '-av,' is recommended for 
  1148.        use with archives in a software distribution environment. 
  1149.  
  1150.        In order to enable the Authenticity verification feature, the 
  1151.        program MUST be registered.  Please contact your local 
  1152.        distribution site or the world-wide distribution center. 
  1153.  
  1154.    ..  -av-  disable checking or adding authenticity verification
  1155.  
  1156.    ..  -b   enable backup archives
  1157.  
  1158.        This switch will create a backup before an archive is modified.  
  1159.        The backup file will have the same name as the original archive 
  1160.        but with the .BAK extension.  Should this file already exist, 
  1161.        the backup file will be named with a .$BK extension. 
  1162.  
  1163.    ..  -bw  black & white (monochrome) mode
  1164.  
  1165.    ..  -c-   disable comment display
  1166.  
  1167.    ..  -cfg- disable read configuration and environment
  1168.  
  1169.    ..  -col  color mode
  1170.  
  1171.    ..  -dh   disable sharing files
  1172.  
  1173.        This helps when accessing files open by other applications on 
  1174.        networks or multi-tasking environment. 
  1175.  
  1176.    ..  -ds   do not sort files while adding to a solid archive
  1177.  
  1178.        Note: see the RARFILES.LST description - solid archiving file
  1179.        order list.
  1180.  
  1181.    ..  -e<s,h,a,r> set file exclusion attributes
  1182.  
  1183.        The switches 's', 'h', 'a' or 'r' signify that files having the 
  1184.        System, Hidden, Archive or Read only attributes should be 
  1185.        excluded.  The order in which the attributes are given is not 
  1186.        significant. 
  1187.  
  1188.     Example:
  1189.  
  1190.        RAR a -ehs purity *.exe
  1191.  
  1192.        Do NOT add files with Hidden or System attributes.
  1193.  
  1194.    ..  -ed  do not add empty directories
  1195.  
  1196.        This switch indicates that empty directories are not to be 
  1197.        stored in the created archive. 
  1198.  
  1199.    ..  -ems-  disable EMS usage (DOS version only)
  1200.  
  1201.    ..  -ee  disable extended attributes saving (OS/2 version only)
  1202.  
  1203.    ..  -ep  exclude paths from names
  1204.  
  1205.        This switch enables files to be added to an archive without 
  1206.        including the path information.  This could, of course, result 
  1207.        in multiple files existing in the archive with the same name. 
  1208.  
  1209.    ..  -ep1 exclude base dir from names
  1210.  
  1211.        Do not store the path from the command line.
  1212.  
  1213.        Example:
  1214.  
  1215.           RAR a -ep1 -r pasta tmp\*.*
  1216.  
  1217.        All files and directories from the directory TMP will be added 
  1218.        to the archive 'pasta', but the path will not include 'TMP\'.  
  1219.        This is equivalent to the commands: 
  1220.  
  1221.          cd tmp
  1222.          RAR a -ep1 -r pasta
  1223.          cd ..
  1224.  
  1225.    ..  -f   freshen files
  1226.  
  1227.        May be used with archive extraction or creation.
  1228.  
  1229.        The command string "a -f" is equivalent to the command 'f', you 
  1230.        could also use the switch '-f' with the commands 'm' or 'mf'.  
  1231.        If the switch '-f' is used with the commands 'x' or 'e', then 
  1232.        only old files would be replaced with new versions extracted 
  1233.        from the archive. 
  1234.  
  1235.    ..  -ialt  Disables the changing, by pressing the left Alt key, the 
  1236.        context function key information in the bottom line of the 
  1237.        screen (in full-screen mode).  This helps some users who wished
  1238.        to use certain TSRs while in RAR.  The action of the left and 
  1239.        right function keys are in other respects, unchanged.  This may 
  1240.        be permanently configured by adding the switch to the RAR 
  1241.        environment variable (SET in autoexec.bat) with SET RAR=-ialt 
  1242.  
  1243.    ..  -m<0..5> set compression method
  1244.  
  1245.        -m0   store     do not compress file when adding to
  1246.                        archive
  1247.        -m1   fastest   use fastest method (less compressive)
  1248.        -m2   fast      use fast compression method
  1249.        -m3   normal    use normal (default) compression method
  1250.        -m4   good      use good compression method (more
  1251.                        compressive, but slower)
  1252.        -m5   best      use best compression method (sightly more
  1253.                        compressive, but slowest)
  1254.  
  1255.        By default RAR uses -m3 method (Normal compression).
  1256.  
  1257.    ..  -md<size>: select dictionary size in Kb (OS/2 version only)
  1258.            size must be equal to 64, 128, 256, 512 or 1024
  1259.            or a letter 'a', 'b', 'c', 'd' or 'e' accordingly.
  1260.  
  1261.        The sliding dictionary is a special memory area used by the 
  1262.        compression algorithm. If the size of the file being compressed 
  1263.        (or the total files size in the case of a solid archive) is 
  1264.        greater than the dictionary size, then increasing the dictionary 
  1265.        size will generally increase compression ratio, decrease packing 
  1266.        speed and increase memory requirements.  RAR for DOS has a fixed 
  1267.        dictionary size of 64 Kb.  RAR for OS/2 (and other 32-bit 
  1268.        platforms) has a default dictionary size of 256Kb, but this may 
  1269.        be changed by the user to be 64 Kb, 128 Kb, 256 Kb, 512 Kb or 
  1270.        1024 Kb.  Unlike compression, extraction speed is unaffected by 
  1271.        dictionary size.
  1272.  
  1273.        The amount of memory required to create large dictionary 
  1274.        archives may be calculated as 5*<dictionary size>+150Kb. About 1 
  1275.        Mb is required for extraction and 5*<dictionary size>+1150Kb to 
  1276.        update solid archives. 
  1277.  
  1278.        RAR for DOS can extract from large dictionary archives using 
  1279.        conventional, EMS and disk memory. If no EMS or disk 
  1280.        cache is available, the operation may slow down significantly. RAR
  1281.        for DOS cannot convert large dictionary archives to SFX with the 
  1282.        default SFX module and cannot update such solid archives. 
  1283.  
  1284.     Example:
  1285.  
  1286.        RAR a -s -mdd sources *.asm
  1287.            or
  1288.        RAR a -s -md512 sources *.asm
  1289.  
  1290.        Will create a solid archive using a 512 Kb dictionary.
  1291.  
  1292.    ..  -mm multimedia compression
  1293.  
  1294.        Enables a special multimedia compression algorithm. This is 
  1295.        intended to be used primarily when compressing raw digital audio 
  1296.        data such as WAV's up to four 8-bit or two 16-bit channels but 
  1297.        also show good results with true color (24-bit) bitmaps. An 
  1298.        improvement in the compression ratio, of up to 30%, may be 
  1299.        expected over normal compression. 
  1300.  
  1301.        During archiving of a file, in multimedia mode, RAR performs 
  1302.        intelligent data analysis and may use the general or multimedia 
  1303.        compression algorithm for different parts of the file depending
  1304.        upon which algorithm is the more suitable. Such analysis allows 
  1305.        optimum performance when different data types exist in the same 
  1306.        file (This is typical for STM and MOD files). 
  1307.  
  1308.        The switches -m<N> "Set compression method" and -s "Create solid 
  1309.        archive" also may be used with multimedia compression but they 
  1310.        influence only those parts compressed with the general 
  1311.        algorithm. 
  1312.  
  1313.        If -mm is used with data which is not multimedia, the 
  1314.        compression ratio, generally, will not be changed but, due to 
  1315.        the multimedia analysis overhead, speed is always decreased. So 
  1316.        it is not recommended to use -mm with data other than multimedia 
  1317.        data. 
  1318.  
  1319.        Note: multimedia compression is designed only for a certain
  1320.        file types. E.g. it works well with WAV, STM, MOD and true color 
  1321.        bitmaps, but will gain nothing for MID, GIF, JPG or 8-bit bitmaps. 
  1322.  
  1323.     Example:
  1324.  
  1325.        RAR a -m5 -s -mm songs *.wav
  1326.  
  1327.    ..  -mmf force multimedia compression
  1328.  
  1329.        This switch works as the -mm with one exception: it always 
  1330.        compress files as multimedia independent of the multimedia 
  1331.        analysis results. Usually this leads to a worse compression 
  1332.        ratio but may be useful in the hypothetical case when RAR cannot 
  1333.        correctly detect a multimedia file. 
  1334.  
  1335.    ..  -o+ overwrite existing files
  1336.  
  1337.    ..  -o- do not overwrite existing files (default)
  1338.  
  1339.    ..  -p<password> set password
  1340.  
  1341.    ..  -p  set password
  1342.  
  1343.        The password is case-sensitive. If you omit the password on the 
  1344.        command line, you will be prompted with: 
  1345.  
  1346.        Enter password:
  1347.  
  1348.     Example:
  1349.  
  1350.        RAR a -pmyhoney secret *.txt
  1351.  
  1352.        Newly added files will be encrypted with the password 'myhoney'. 
  1353.  
  1354.    ..  -r recurse subdirectories
  1355.  
  1356.        May be used with commands: 'a', 'u', 'f', 'm', 'x', 'e', 't', 
  1357.        'p', 'v', 'l', 'c', 'cf' and 's'. 
  1358.  
  1359.        When used with the commands, 'a', 'u', 'f' or 'm', will
  1360.        process files in all sub-directories as well as the
  1361.        current working directory.
  1362.  
  1363.        When used with the commands, 'x', 'e', 't', 'p', 'v', 'l', 'c', 
  1364.        'cf' or 's', will process all archives in sub-directories as well 
  1365.        as the current working directory. 
  1366.  
  1367.    ..  -ri<P>[:<S>] set priority and sleep time (OS/2 version only)
  1368.  
  1369.        This option is used to regulate system load by RAR in a 
  1370.        multitasking environment. 
  1371.  
  1372.        The task priority <P> (possible values, 0 to 128) is the OS/2 
  1373.        task priority.  Values of <P> are grouped as follows: 
  1374.  
  1375.                  <P> value      OS/2 <priority class>:<priority level>
  1376.                     0                OS/2 default (i.e. 2:0, or <P>=33)
  1377.                    1-32              1:0-1:31
  1378.                   33-64              2:0-2:31
  1379.                   65-96              3:0-3:31
  1380.                   97-128             4:0-4:31
  1381.  
  1382.        When <P> is equal to 0, the default OS/2 task priority is used.
  1383.  
  1384.        The sleep time <S> is a value from 0 to 1000 (milliseconds). 
  1385.        This is the period of time that RAR will give back to OS/2 after 
  1386.        every read or write during the packing or unpacking operation.  
  1387.        The sleep time setting is useful when several tasks with the
  1388.        same priority are running in the system. 
  1389.  
  1390.     Example:
  1391.  
  1392.        RAR a -r -sfx -ri0:100 backup *.*
  1393.  
  1394.        Execute RAR with default priority and 100 ms of sleep after each 
  1395.        read or write. 
  1396.  
  1397.    ..  -rr[N]: add data recovery record
  1398.  
  1399.        If this switch is used when creating or modifying an archive, a 
  1400.        data recovery record will be added to the resulting archive. See 
  1401.        command 'rr[N]' description for details. 
  1402.  
  1403.    ..  -s   create a solid archive
  1404.  
  1405.        Solid is a special archive type.  Please refer to the appendix 
  1406.        "Glossary" for further information. 
  1407.  
  1408.     Example:
  1409.  
  1410.        RAR a -s -v1440 -sfx maddy *.*
  1411.  
  1412.        Will create solid Self-Extracting (SFX) volumes of size 1440000 
  1413.        bytes. 
  1414.  
  1415.        Note: see the RARFILES.LST description - solid archiving file
  1416.        order list.
  1417.  
  1418.    ..  -sfx create Self-Extracting (SFX) archive
  1419.  
  1420.        If this switch is used when creating a new archive, a Self-
  1421.        Extracting archive would be created. 
  1422.  
  1423.     Example:
  1424.  
  1425.        RAR a -sfx sources *.asm
  1426.  
  1427.        This command would create a Self-Extracting archive named 
  1428.        SOURCES.EXE.  To extract files from such an archive, you would 
  1429.        simply execute it.  Self-Extracting archives may be processed 
  1430.        normally using RAR. 
  1431.  
  1432.    ..  -sfx<file.sfx> create Self-Extracting (SFX) archive using an 
  1433.        alternate SFX module. 
  1434.  
  1435.    Example:
  1436.  
  1437.        RAR a -sfxidos.sfx -zscript.s myinst
  1438.  
  1439.        See the Installation SFX documentation, SFX.DOC for details.
  1440.  
  1441.    ..  -std  stdout mode
  1442.  
  1443.        All output text is sent to the stdout stream.  This allows 
  1444.        redirection of RAR output to a file, for example: 
  1445.  
  1446.        RAR v -std bambam >bambam.lst
  1447.  
  1448.          or in 'silent' mode without any output:
  1449.  
  1450.        RAR x -std dime 10cents.txt >nul
  1451.  
  1452.        Note:  In stdout mode, if an archive comment exists, no delay 
  1453.               will be implemented when the comment is displayed.
  1454.  
  1455.    ..  -tk  do not modify archive date
  1456.  
  1457.        Prevents RAR from modifying the archive date when changing an 
  1458.        archive. 
  1459.  
  1460.    ..  -tl  set archive date as the date of newest file
  1461.  
  1462.        Forces RAR to set the date of a changed archive to the date of 
  1463.        the newest file in the archive. 
  1464.  
  1465.    ..  -u   update files
  1466.  
  1467.        May be used with archive extraction or creation.
  1468.  
  1469.        The command string "a -u" is equivalent to the command 'u', you 
  1470.        could also use the switch '-u' with the commands 'm' or 'mf'.  
  1471.        If the switch '-u' is used with the commands 'x' or 'e', then 
  1472.        files not present on the disk and files newer than their copies 
  1473.        on the disk would extracted from the archive. 
  1474.  
  1475.    ..  -v create volumes with autodetected size
  1476.  
  1477.        Note: when the switch is used with 'v' or 'l' command RAR
  1478.        lists all volumes starting from specified.
  1479.  
  1480.    ..  -v<size> create archive volumes
  1481.  
  1482.        By default this switch uses <size> as thousands (1000) of bytes 
  1483.        (not 1024 x bytes). You may also enter the size in kilobytes 
  1484.        using the symbol 'k' or in bytes using the symbol 'b' following 
  1485.        the numerical value. If the size is omitted, autodetection will 
  1486.        be used. 
  1487.  
  1488.        If volumes are created on the same drive as the temporary files 
  1489.        (current drive by default, but may be changed with the switch '-
  1490.        w'), the autodetected size becomes meaningless.  In this case 
  1491.        the volume size must be explicitly defined. 
  1492.  
  1493.        If volumes are created on a drive OTHER than the drive 
  1494.        containing the temporary files, then after the first volume has 
  1495.        been created, the user will be prompted with: 
  1496.  
  1497.            Create next volume: Yes/No/All/Quit
  1498.  
  1499.        At this moment in time, you should change the disks. Answering 
  1500.        'A' will cause all volumes to be created without a pause. 
  1501.  
  1502.        The first volume file in a multi-volume set has the extension 
  1503.        .RAR, following volumes are numbered from .R00 to .R99. 
  1504.  
  1505.        When extracting or testing a multi-volume archive you must use 
  1506.        only the first volume name (*.RAR).  If there is no next volume 
  1507.        on the drive (and volumes are not placed in the same directory 
  1508.        as the temporary files), the user will be prompted with: 
  1509.  
  1510.            Insert disk with <next volume name>
  1511.  
  1512.        Insert the disk with the correct volume and press any key. 
  1513.  
  1514.        If while extracting, the next volume is not found and volumes 
  1515.        are placed in the same directory as the temporary files, RAR 
  1516.        will abort with the error message: 
  1517.  
  1518.            Cannot find <volume name>
  1519.            Cannot change disk with temporary files
  1520.  
  1521.        Archive volumes may not be modified.  The commands 'd', 'f', 
  1522.        'u', 's' can not be used with Multi-volume sets. The command 'a' 
  1523.        may be used only for the creation of a new multi-volume 
  1524.        sequence. 
  1525.  
  1526.        It is possible, although unlikely, that the file size, of a file 
  1527.        in a multi-volume set, could be greater than it's uncompressed 
  1528.        size.  This is due to the fact that 'storing' (no compression if 
  1529.        size increases) cannot be enabled for multi-volume sets. 
  1530.  
  1531.        Archive volumes may be Self-Extracting (SFX).  Such an archive 
  1532.        should be created using both the '-v' and '-sfx' switches. 
  1533.  
  1534.  
  1535.     Example:
  1536.  
  1537.     1. Archive drive C: on floppy drive A:
  1538.  
  1539.        RAR a -r -v a:allhard c:\*.*
  1540.  
  1541.     (current disk MUST NOT be a:)
  1542.  
  1543.     2. Create archive volumes with 1440000 byte size in current
  1544.        directory.
  1545.  
  1546.        RAR a -v1440 4flopp
  1547.  
  1548.        or
  1549.  
  1550.        RAR a -v1440 4flopp *.*
  1551.  
  1552.    .. -vd erase disk contents before creating volume
  1553.  
  1554.        All files and directories on the target disk will be erased when 
  1555.        '-vd' is used.  The switch applies only to removable media, the 
  1556.        hard disk cannot be erased using this switch. 
  1557.  
  1558.    ..  -w<path> assign work directory
  1559.  
  1560.        This switch may be used to assign the directory for temporary 
  1561.        files to another drive.  For example a RAM drive or high 
  1562.        performance disc. 
  1563.  
  1564.     Example:
  1565.  
  1566.        RAR a -we:\tmp bmps *.bmp
  1567.  
  1568.        Temporary files would be created in directory E:\TMP
  1569.  
  1570.  
  1571.    ..  -x<mask> exclude files specified by mask
  1572.  
  1573.     Example:
  1574.  
  1575.        RAR a -x*.bak purearch.rar
  1576.  
  1577.        You may specify the switch '-x' several times:
  1578.  
  1579.        RAR a -r -x*.arj -x*.rar rawfiles
  1580.  
  1581.    ..  -x@<list> exclude files using specified list file
  1582.  
  1583.     Example:
  1584.  
  1585.        RAR a -x@exlist.txt arch *.exe
  1586.  
  1587.    ..  -y   assume Yes on all queries
  1588.  
  1589.    ..  -z<file> add comment to archive
  1590.  
  1591.  
  1592.    3.3. SFX switches
  1593.  
  1594.     An SFX archive module may be handled by the switches:
  1595.  
  1596.    ..  -e   Extract from the SFX archive
  1597.  
  1598.        The switch is used by default similar to 'x' command in RAR.
  1599.  
  1600.    ..  -t   Test the SFX archive
  1601.  
  1602.        This is similar to 't' command in RAR.
  1603.  
  1604.    ..  -v   View the archive content
  1605.  
  1606.        This is similar to 'v' command in RAR.
  1607.  
  1608.    3.4. The file order list for solid archiving - RARFILES.LST.
  1609.  
  1610.        RARFILES.LST contains user-defined file list which tells RAR
  1611.        the order to add files to a solid archive. It may contain file
  1612.        names, wildcards and special entry - $default. The default
  1613.        entry defines the place in order list for files not matched
  1614.        with other entries in this file. The comment character is ';'.
  1615.  
  1616.        This file should be placed in the same directory as RAR.
  1617.  
  1618.        Tips to provide improved compression and speed of operation:
  1619.  
  1620.        - similar files should be grouped together in the archive;
  1621.        - frequently accessed files should be placed at the beginning.
  1622.  
  1623.  
  1624.  ╔════════════════════════════════════════════════════════════════════════╗
  1625.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Glossary  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  1626.  ╚════════════════════════════════════════════════════════════════════════╝
  1627.  
  1628.    Archive       Special file containing one or more files optionally 
  1629.                  encoded and/or compressed. 
  1630.  
  1631.    Compression   A method of encoding data to reduce it's size. 
  1632.  
  1633.    CRC           Cyclic Redundancy Check. Mathematical method 
  1634.                  calculating special checking information for data 
  1635.                  validity. 
  1636.  
  1637.    Dictionary    The length of a buffer used to search similarities
  1638.    size          (the stage of a compression process) in a file been
  1639.                  added to the archive.
  1640.  
  1641.    SFX           Archive module used to extract files from when 
  1642.                  executed. (SelF-eXtracting module), usually in the 
  1643.                  form of a .EXE file. 
  1644.  
  1645.    Sliding       See the 'Dictionary size' description.
  1646.    dictionary
  1647.  
  1648.    Solid         An archive packed using a special compression method 
  1649.                  which sees all files as one continuous data stream.  
  1650.                  Particularly advantageous when packing a large number 
  1651.                  of small files. 
  1652.  
  1653.    Volume        Part of a split archive. Splitting an archive to 
  1654.                  volumes allows storing them on diskettes. Volumes must 
  1655.                  be extracted starting from first in sequence. 
  1656.  
  1657.