@@ -1,4 +1,33 @@

 -------------------------------------------------------------------

+Fri Jun 15 21:38:36 UTC 2012 - lazy.kent@opensuse.org

+

+- Update to 4.2.0.

+  * Changes in RAR compression:

+    a) Multithreaded RAR compression is enabled by default. You can

+       disable it with -mt1 switch.

+       Comparing to RAR 4.11, some speed gain is possible in single

+       processor mode as well.

+       Speed gain depends on data type and average file size.

+       Several cores are utilized more efficiently when compressing

+       large files.

+    b) We had to increase memory requirements to achieve higher

+       compression speed. General RAR compression algorithm

+       allocates about 120 MB comparing to 40 MB in RAR 4.11.

+    c) RAR text compression algorithm cannot utilize several CPU

+       cores efficiently, so its performance in multiprocessor

+       environment is much lower than for general algorithm. Also

+       its decompression speed is much lower than in general

+       algorithm regardless of CPU number. So we decided to disable

+       the text algorithm by default.

+       If you need maximum possible compression ratio for plain

+       text data regardless of speed, you can enable the text

+       compression with -mct switch.

+  * RAR general decompression algorithm speed is slightly improved

+    though not to same extent as RAR compression. RAR

+    decompression is not able to use several processor cores, so

+    its performance does not depend on a number of cores.

+

+-------------------------------------------------------------------

 Thu Mar  1 06:43:41 UTC 2012 - lazy.kent@opensuse.org

 - Update to 4.1.1.

​

@@ -4,7 +4,7 @@

 Name:           rar

-Version:        4.1.1

+Version:        4.2.0

 Release:        0

 License:        see license.txt

 Summary:        Compression and decompression program rar

​

@@ -0,0 +1,81 @@

+                           ACKNOWLEDGMENTS

+

+* RAR text compression algorithm is based on Dmitry Shkarin PPMII

+  and Dmitry Subbotin carryless rangecoder public domain source code.

+  You may find it in ftp.elf.stuba.sk/pub/pc/pack.

+

+* RAR encryption includes parts of code from Szymon Stefanek

+  and Brian Gladman AES implementations also as Steve Reid SHA-1 source.

+

+  ---------------------------------------------------------------------------

+  Copyright (c) 2002, Dr Brian Gladman <                 >, Worcester, UK.

+  All rights reserved.

+

+  LICENSE TERMS

+

+  The free distribution and use of this software in both source and binary

+  form is allowed (with or without changes) provided that:

+

+    1. distributions of this source code include the above copyright

+       notice, this list of conditions and the following disclaimer;

+

+    2. distributions in binary form include the above copyright

+       notice, this list of conditions and the following disclaimer

+       in the documentation and/or other associated materials;

+

+    3. the copyright holder's name is not used to endorse products

+       built using this software without specific written permission.

+

+  ALTERNATIVELY, provided that this notice is retained in full, this product

+  may be distributed under the terms of the GNU General Public License (GPL),

+  in which case the provisions of the GPL apply INSTEAD OF those given above.

+

+  DISCLAIMER

+

+  This software is provided 'as is' with no explicit or implied warranties

+  in respect of its properties, including, but not limited to, correctness

+  and/or fitness for purpose.

+  ---------------------------------------------------------------------------

+

+  Source code of this package also as other cryptographic technology

+  and computing project related links are available on Brian Gladman's

+  web site: http://www.gladman.me.uk

+

+* RAR uses CRC32 function based on Intel Slicing-by-8 algorithm.

+  Original Intel Slicing-by-8 code is available here:

+

+    http://sourceforge.net/projects/slicing-by-8/

+

+  Original Intel Slicing-by-8 code is licensed under BSD License

+  available at http://www.opensource.org/licenses/bsd-license.html

+

+    Copyright (c) 2004-2006 Intel Corporation. 

+    All Rights Reserved

+

+    Redistribution and use in source and binary forms, with or without

+    modification, are permitted provided that the following conditions

+    are met:

+

+    Redistributions of source code must retain the above copyright notice,

+    this list of conditions and the following disclaimer.

+    

+    Redistributions in binary form must reproduce the above copyright

+    notice, this list of conditions and the following disclaimer

+    in the documentation and/or other materials provided with

+    the distribution.

+

+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

+    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

+    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS

+    FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

+    HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

+    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

+    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

+    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

+    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

+    OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

+    SUCH DAMAGE.

+

+* Useful hints provided by Alexander Khoroshev and Bulat Ziganshin allowed

+  to significantly improve RAR compression and speed.

​

@@ -1,157 +1,114 @@

-      The RAR Archiver

-      EULA (End User License Agreement) for use and distribution

-

-

-      The RAR archiver is distributed as try before you buy. This means:

-

-   1. The author and holder of the copyright of RAR and WinRAR

-      is Alexander L. Roshal. The licensor of the following license

-      and bearer of the worldwide exclusive usage rights to reproduce

-      and distribute RAR and WinRAR is win.rar GmbH, Schumannstr. 17,

-      10117 Berlin, Germany.

-

-   2. Anyone may use this software during a test period of 40 days.

-      Following this test period of 40 days or less, if you wish to

-      continue to use RAR, you must purchase a license.

-

-   3. There are 2 basic types of licenses issued for RAR, these are:

-

-      a.  A single computer usage license. The user purchases one license

-          to use RAR archiver on one computer.

-

-          Home users may use their single computer usage license on

-          all computers which are in property of the license owner.

-

-          Business users require one license per computer RAR is

-          installed on.

-

-      b.  A multiple usage license. The user purchases a number of usage

-          licenses for use, by the purchaser or the purchaser's employees

-          on the same number of computers.

-

-          In a network (server/client) environment you must purchase

-          a license copy for each separate client (workstation)

-          on which RAR is installed, used, or accessed. A separate

-          license copy for each client (workstation) is needed regardless

-          of whether the clients (workstations) will use RAR simultaneously

-          or at different times. If for example you wish to have

-          9 different clients (workstations) in your network with access

-          to RAR, you must purchase 9 license copies.

-

-      A user who purchased a RAR license, is granted a non-exclusive

-      right to use RAR on as many computers as defined by the licensing

-      terms above according to the number of licenses purchased,

-      for any legal purpose. The licensed RAR software may not be rented

-      or leased, but may be permanently transferred, in it's entirety,

-      if the person receiving it agrees to the terms of this license.

-      If the software is an update, the transfer must include the update

-      and all previous versions.

-

-   4. Licensing for RAR on mobile devices (U3 stick, USB stick,

-      external harddrive):

-

-      In addition to the terms stated above following licensing terms

-      apply to the licensing of RAR on mobile devices.

-

-      a.  A single computer usage license. Home users may use their

-          single computer usage license on all mobile devices which are

-          in property of the license owner.

-

-          Business users may use their single computer usage license

-          on one computer and one mobile device.

-

-      b.  A multiple usage license. Users who own a multiple usage

-          license may use that license on the same number of mobile

-          devices as number of computers (clients) the license was

-          purchased for.

-

-          The number of computers/devices running RAR at any time is

-          limited to the number of licenses purchased according to the

-          licensing terms above.

-

-      A licensed version of RAR on a mobile device may be used by

-      the purchaser or the purchaser's employees, on several computers

-      consecutively.

-

-      There are no additional license fees, apart from the cost of

-      purchasing a license, associated with the use of RAR from

-      a mobile device on computers that are not owned by the owner

-      of the RAR license.

-

-   5. The RAR/WinRAR unlicensed trial version may be freely distributed,

-      with exceptions noted below, provided the distribution package is not

-      modified in any way.

-

-      a.  No person or company may distribute separate parts of the package

-          with the exception of the UnRAR components, without written

-          permission of the copyright owner.

-

-      b.  The RAR/WinRAR unlicensed trial version may not be distributed

-          inside of any other software package without written permission

-          of the copyright owner.

-

-      c.  Hacks/cracks, keys or key generators may not be included on the

-          same distribution.

-

-   6. To buy a license please see order.htm for details.

-

-   7. THE RAR ARCHIVER IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY

-      KIND IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK.

-      NEITHER THE AUTHOR NOR THE AGENTS OF THE AUTHOR WILL BE LIABLE

-      FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS

-      WHILE USING OR MISUSING THIS SOFTWARE.

-

-   8. There are no additional license fees, apart from the cost of

-      purchasing a license, associated with the creation and distribution

-      of RAR archives, volumes, self-extracting archives or self-extracting

-      volumes. Legally registered owners may use their copies of RAR/WinRAR

-      to produce archives and self-extracting archives and to distribute

-      those archives free of any additional RAR royalties.

-

-   9. You may not use, copy, emulate, clone, rent, lease, sell, modify,

-      decompile, disassemble, otherwise reverse engineer, or transfer

-      the licensed program, or any subset of the licensed program, except

-      as provided for in this agreement. Any such unauthorized use shall

-      result in immediate and automatic termination of this license and

-      may result in criminal and/or civil prosecution.

-

-      7zxa.dll library is copyrighted by Igor Pavlov and distributed

-      under LGPL Version 3 license ( http://www.gnu.org/licenses/lgpl.html ).

-      You can modify portions of 7zxa.dll and perform reverse engineering

-      solely for purpose of debugging such 7zxa.dll modifications according

-      to LGPL. Source code of 7zxa.dll is available on www.7-zip.org.

-

-      Neither RAR binary code, WinRAR binary code, UnRAR source or UnRAR

-      binary code may be used or reverse engineered to re-create the RAR

-      compression algorithm, which is proprietary, without written

-      permission of the author.

-

-      RAR and WinRAR keyfiles may not be distributed, except as stated

-      in item 3) above, outside of the area of legal control of the

-      person or persons who purchased the original license, without

-      written permission of the copyright holder.

-

-  10. WinRAR unregistered version can display a registration reminder dialog

-      prompting a user to obtain a license. Depending on WinRAR version

-      and configuration such dialog can contain either a predefined text

-      and links loaded locally or a web page loaded from the internet.

-      Such web page can contain licensing instructions and other materials

-      according to win.rar GmbH's choice, including advertisement.

-      When opening a web page, WinRAR transfers only those parameters

-      which are technically required by HTTP protocol to successfully open

-      a web page in a browser.

-

-  11. All rights not expressly granted in the license are reserved by

-      Alexander Roshal.

-

-      Installing and using RAR/WinRAR signifies acceptance of these terms

-      and conditions of the license.

-

-  12. If you do not agree with the terms of this license you must

-      remove RAR/WinRAR files from your storage devices and cease to

-      use the product.

-

-      Thank you for using the original RAR.

-

-                                            Alexander L. Roshal

-

+     END USER LICENSE AGREEMENT

+

+     The following agreement regarding RAR (and its Windows version - WinRAR)

+     archiver - referred to as "software" - is made between win.rar GmbH -

+     referred to as "licensor" - and anyone who is installing, accessing

+     or in any other way using the software - referred to as "user".

+

+  1. The author and holder of the copyright of the software is

+     Alexander L. Roshal. The licensor and as such issuer of the license

+     and bearer of the worldwide exclusive usage rights including the rights

+     to reproduce, distribute and make the software available to the public

+     in any form is win.rar GmbH, Schumannstr. 17, 10117 Berlin, Germany.

+

+  2. The software is distributed as try before you buy. This means that

+     anyone may use the software during a test period of a maximum of 40 days

+     at no charge. Following this test period, the user must purchase

+     a license to continue using the software.

+

+  3. The software's trial version may be freely distributed, with exceptions

+     noted below, provided the distribution package is not modified in any way.

+

+     a. Nobody may distribute separate parts of the package, with the exception

+        of the UnRAR components, without written permission.

+

+     b. The software's unlicensed trial version may not be distributed

+        inside of any other software package without written permission.

+

+     c. Hacks/cracks, keys or key generators may not be included, pointed to

+        or referred to by the distributor of the trial version.

+

+  4. The trial version of the software can display a registration reminder

+     dialog. Depending on the software version and configuration such dialog

+     can contain either a predefined text and links loaded locally

+     or a web page loaded from the internet. Such web page can contain

+     licensing instructions or other materials according to the licensor's

+     choice, including advertisement. When opening a web page, the software

+     transfers only those parameters which are technically required

+     by HTTP protocol to successfully open a web page in a browser.

+

+  5. The software is distributed "as is". No warranty of any kind is expressed

+     or implied. You use at your own risk. Neither the author, the licensor

+     nor the agents of the licensor will be liable for data loss, damages,

+     loss of profits or any other kind of loss while using or misusing

+     this software.

+

+  6. There are 2 basic types of licenses issued for the software. These are:

+

+     a. A single computer usage license. The user purchases one license to

+        use the software on one computer.

+

+        Home users may use their single computer usage license on all

+        computers and mobile devices (USB drive, external hard drive, etc.)

+        which are property of the license owner.

+

+        Business users require one license per computer or mobile device

+        on which the software is installed.

+

+     b. A multiple usage license. The user purchases a number of usage

+        licenses for use, by the purchaser or the purchaser's employees

+        on the same number of computers.

+

+        In a network (server/client) environment the user must purchase

+        a license copy for each separate client (workstation) on which

+        the software is installed, used or accessed. A separate license copy

+        for each client (workstation) is needed regardless of whether

+        the clients (workstations) will use the software simultaneously

+        or at different times. If for example you wish to have 9 different

+        clients (workstations) in your network with access to RAR,

+        you must purchase 9 license copies.

+

+     A user who purchased a license, is granted a non-exclusive right to use

+     the software on as many computers as defined by the licensing terms above

+     according to the number of licenses purchased, for any legal purpose.

+

+  7. There are no additional license fees, apart from the cost of the license,

+     associated with the creation and distribution of RAR archives,

+     volumes, self-extracting archives or self-extracting volumes.

+     Owners of a license may use their copies of the software to produce

+     archives and self-extracting archives and to distribute those archives

+     free of any additional royalties.

+

+  8. The licensed software may not be rented or leased but may be permanently

+     transferred, in its entirety, if the recipient agrees to the terms of

+     this license.

+

+  9. To buy a license, please read the file order.htm provided with

+     the software for details.

+

+ 10. You may not use, copy, emulate, clone, rent, lease, sell, modify,

+     decompile, disassemble, otherwise reverse engineer, or transfer

+     the licensed software, or any subset of the licensed software,

+     except as provided for in this agreement. Any such unauthorized use

+     shall result in immediate and automatic termination of this license

+     and may result in criminal and/or civil prosecution.

+

+     Neither RAR binary code, WinRAR binary code, UnRAR source

+     or UnRAR binary code may be used or reverse engineered to re-create

+     the RAR compression algorithm, which is proprietary, without written

+     permission.

+

+     The software may be using components developed and/or copyrighted

+     by third parties. Please read "Acknowledgments" help file topic

+     for WinRAR or acknow.txt text file for other RAR versions for details.

+

+ 11. This License Agreement is construed solely and exclusively under

+     German law. If you are a merchant, the courts at the registered office

+     of win.rar GmbH in Berlin/Germany shall have exclusive jurisdiction

+     for any and all disputes arising in connection with this License

+     Agreement or its validity.

+

+ 12. Installing and using the software signifies acceptance of these terms

+     and conditions of the license. If you do not agree with the terms of this

+     license, you must remove all software files from your storage devices

+     and cease to use the software.

​

@@ -1,6 +1,6 @@

                              User's Manual

                              ~~~~~~~~~~~~~

-                        RAR 4.11 console version

+                        RAR 4.20 console version

                         ~~~~~~~~~~~~~~~~~~~~~~~~

                        =-=-=-=-=-=-=-=-=-=-=-=-=-=-

@@ -881,7 +881,7 @@

             This switch indicates that directory records are not to be

             stored in the created archive. When extracting such archives,

-            RAR creates non-empty directories basing on paths of files

+            RAR creates non-empty directories based on paths of files

             contained in them. Information about empty directories is

             lost. All attributes of non-empty directories except a name

             (access rights, streams, etc.) will be lost as well, so use

@@ -1192,12 +1192,11 @@

             If this switch is not specified, RAR uses -m3 method

             (normal compression).

-            By default, RAR uses only the general compression

-            algorithm in -m1 and -m2 methods, advanced algorithms

-            like audio and true color processing are enabled

-            only in -m3..-m5 modes, the advanced text compression

-            is activated only in -m4..-m5. This default can be

-            overridden using -mc switch.

+            By default, RAR uses only the general compression algorithm

+            in -m1 and -m2 methods, advanced algorithms like audio

+            and true color processing are enabled only in -m3..-m5 modes,

+            advanced text compression is disabled in all modes.

+            This default can be overridden using -mc switch.

     -mc<par>

@@ -1237,6 +1236,7 @@

             <Param1> and <Param2> are module dependent parameters

             described below.

+

             Audio compression, delta compression:

             <Param1> is a number of byte channels (can be 1 - 31).

@@ -1256,6 +1256,20 @@

             Text compression:

+            Text compression algorithm provides noticeably higher compression

+            on plain text data. But it cannot utilize several CPU cores

+            efficiently resulting in slower compression time comparing to

+            general algorithm in multicore and multiprocessor environment.

+            Also its decompression speed is much slower than in general

+            algorithm regardless of CPU cores number. This is why

+            the text compression is disabled by default. You can specify

+            -mct switch to allow RAR to select this algorithm automatically

+            for suitable data. Switch -mct+ will force use of the text

+            compression for all data.

+

+            Switch -mct can also include <Param1> and <Param2>, so its

+            full syntax is -mc[param1][:param2]t[+ or -].

+

             <Param1> is the order of PPM algorithm (can be 2 - 63).

             Usually a higher value slightly increases the compression ratio

             of redundant data, but only if enough memory is available

@@ -1286,7 +1300,8 @@

             when the text compression is used, but leaves to RAR to

             decide when to use it.

-            4) switches -mct- -mcd- disable text and delta compression.

+            4) switches -mct -mcd- allow RAR to apply the text compression

+            to suitable data and disable the delta compression.

     -md<n>  Select dictionary size <n> in KB. Must be 64, 128, 256, 512,

@@ -1337,18 +1352,14 @@

     -mt<threads>

-            Set the number of threads. Available in Windows version only.

+            Set the number of threads.

-            <threads> parameter can take values from 0 to 16.

-            It defines the recommended number of active threads

-            for compression algorithm. If it is greater than 0,

-            RAR will use the multithreaded version of compression

-            algorithm providing higher speed on multiprocessor

-            architectures. Real number of active threads can differ

-            from the specified.

-

-            If <threads> is zero, RAR will use the single threaded

-            compression algorithm.

+            <threads> parameter can take values from 1 to 32.

+            It defines the recommended maximum number of active threads

+            for compression algorithm also as for other RAR modules,

+            which can start several threads. While RAR attempts to follow

+            this recommendation, sometimes the real number of active

+            threads can exceed the specified value.

             Change of <threads> parameter slightly affects the compression

             ratio, so archives created with different -mt switches

@@ -1414,10 +1425,11 @@

             This switch has meaning only for NTFS file system and allows

             to save alternative data streams associated with a file.

-            It is especially important in Windows 2000, XP and newer,

-            which use streams to keep some file dependent information

-            like file descriptions. If you use RAR to backup your

-            NTFS disks, it is recommended to specify this switch.

+            You may need to specify it when archiving if you use software

+            storing data in alternative streams and wish to preserve

+            these streams.

+

+            Streams are not saved for NTFS encrypted files.

     -ow     Use this switch when archiving to save file security

​

@@ -1,5 +1,5 @@

-               RAR version 4.11 - Technical information

+               RAR version 4.20 - Technical information

                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  THE ARCHIVE FORMAT DESCRIBED BELOW IS ONLY VALID FOR VERSIONS SINCE 1.50

​

@@ -1,6 +1,40 @@

                 RAR - What's new in the latest version

+   Version 4.20

+

+   1. Changes in RAR compression:

+

+      a) Multithreaded RAR compression is enabled by default.

+         You can disable it with -mt1 switch.

+

+         Comparing to RAR 4.11, some speed gain is possible

+         in single processor mode as well.

+

+         Speed gain depends on data type and average file size.

+         Several cores are utilized more efficiently when compressing

+         large files.

+

+      b) we had to increase memory requirements to achieve higher

+         compression speed. General RAR compression algorithm allocates

+         about 120 MB comparing to 40 MB in RAR 4.11;

+

+      c) RAR text compression algorithm cannot utilize several CPU cores

+         efficiently, so its performance in multiprocessor environment

+         is much lower than for general algorithm. Also its decompression

+         speed is much lower than in general algorithm regardless of

+         CPU number. So we decided to disable the text algorithm by default.

+

+         If you need maximum possible compression ratio for plain text data

+         regardless of speed, you can enable the text compression

+         with -mct switch.

+

+   2. RAR general decompression algorithm speed is slightly improved,

+      though not to same extent as RAR compression. RAR decompression

+      is not able to use several processor cores, so its performance

+      does not depend on a number of cores.

+

+

    Version 4.11

    1. Bugs fixed:

@@ -134,200 +168,3 @@

       modification time of archived entry to current system time.

       Previous RAR versions did not fill this field, resulting in

       meaningless modification time for stdin.

-

-   

-   Version 3.80

-

-   1. Switch -o[+|-] can now be specified when archiving to control

-      RAR behavior when updating already existing files in archive.

-      Unlike already existing -f and -u, switch -o[+|-] ignores

-      the file date and compares only file names.

-

-      Available overwrite modes are:

-

-        -o           Ask before overwrite

-                     (default for extracting files);

-

-        -o+          Overwrite all

-                     (default for updating archiving files);

-

-        -o-          Skip existing files.

-

-   2. New -dw switch enables "Wipe files" mode when deleting archived files.

-      Before deleting file data are overwritten by zero bytes to prevent 

-      recovery of deleted files.

-

-   3. RAR displays the total progress bar when unpacking a multivolume

-      archive if all volumes are present in the same folder.

-

-   

-   Version 3.71

-

-   1. Archive names in rar.log error log file always include

-      the full path.

-

-   2. Bugs fixed:

-

-      a) if -ag switch mask contained archive number, month and minute

-         characters, RAR placed 'I' character instead of minute value

-         into generated archive name for archive numbers exceeding 1;

-

-      b) RAR could crash when decompressing some of corrupt RAR archives.

-

-

-   Version 3.70

-

-   1. New switch -sc<charset>[objects] allowing to select character

-      sets for archive comments and list files. It replaces -fcu switch

-      introduced in RAR 3.60, which was removed from list of supported

-      switches. Now you need to specify -scuc instead of -fcu to use

-      Unicode comments. Unlike -fcu, -sc also supports OEM and ANSI charset.

-

-   2. Operation progress is displayed when adding the recovery record.

-

-   3. RAR displays "Calculating the control sum" message when calculating

-      CRC32 control sum for newly created RAR volume. Previous versions

-      also calculated the volume control sum, but they did it silently.

-

-   4. Stack overflow vulnerability has been corrected in password

-      processing module of console RAR and UnRAR. GUI WinRAR is not

-      affected. We are thankful to the iDEFENSE LABS for reporting this bug.

-

-

-   Version 3.60

-

-   1. New 'ch' (change archive parameters) command line mode command.

-      Its purpose is to apply switches like -av, -tl and -cl to archive.

-

-   2. New command line -sl<size> and -sm<size> switches to set size

-      limits of processing files.

-

-   3. 7Z added to list of formats stored without compression

-      when using -ms switch without a parameter.

-

-   4. Switch -e[+]<attr> is now supported by most of command line

-      operations including extracting and deleting files. Previously

-      it was supported by only archiving command.

-

-

-   Version 3.51

-

-   1. Bugs fixed:

-

-      a) previous version tried to create symbolic links even when

-         testing an archive;

-

-      b) symbolic links unpacked with -ow switch had a wrong owner;

-

-      c) RAR failed to restore setuid and setgid access rights

-         when unpacking files with -ow switch.

-

-

-   Version 3.50

-

-   1. New -n<mask> and -n@<listfile> switches set additional include

-      filters, so only files matching the mask will be processed.

-

-   2. New -id[c,d,p,q] switch. Additionally to previously available

-      -idp switch (disable percentage indicator), switches -idc, -idd

-      and -idq instruct the console RAR to hide the copyright message,

-      "Done" message and all information messages.

-

-   3. Switch -e+<attr> allows to specify file include attributes mask.

-

-      It is possible to use 'd' and 'v' characters in -e[+]<attr> switch

-      to denote directory and device attributes.

-

-   4. Switch -ver[n] supports the optional 'n' parameter also when

-      archiving. It limits the maximum number of file versions.

-

-

-   Version 3.41

-

-   1. When adding new files to already existing RAR solid archive,

-      RAR 3.40 compression ratio was lower than in RAR 3.30.

-      Corrected in this version.

-

-   2. If archived Unicode name is invalid, RAR 'l' and 'v' commands

-      display ASCII file name instead of corrupt Unicode.

-

-

-   Version 3.40

-

-   1. "Fastest" (-m1) RAR compression method has been modified

-      to provide much higher compression speed and lower ratio.

-      It may be useful for tasks requiring the high speed like

-      regular backups.

-

-      You may increase "Fastest" speed even more selecting 64KB

-      compression dictionary instead of default 4MB.

-

-   2. Starting from this version, RAR volumes contain the volume number

-      field. Volume number is displayed by 'L' and 'V' commands

-      in the line with the total volume information.

-

-      This feature may be useful if original volume names are lost

-      and you need to rename them to correct names.

-

-   3. Commands 'L' and 'V' display NTFS "Compressed" attribute

-      in archive listing.

-

-   4. Switch -ag may include an optional text enclosed in '{' and '}'

-      characters. This text is inserted into archive name.

-      For example: -agHH{hours}MM{minutes}

-

-   5. Removed the erroneous "CRC error" message when unpacking symlinks

-      from archive created with -hp<pwd> switch. In fact, such symlinks

-      were unpacked correctly.

-

-   6. RAR displays the operation progress while repairing

-      an archive containing the recovery record.

-

-

-   Version 3.30

-

-   1. Several -v<size> switches can be specified in the command

-      line mode to set different sizes for different volumes.

-      For example, 'rar a -v100k -v200k -v300k arcname' command

-      sets 100 KB size for first volume, 200KB for second

-      and 300KB for all following volumes.

-

-   2. New -st[name] switch to compress data from stdin

-      (standard input).

-

-   3. Data analyzing module is tuned to detect executable and audio

-      data more accurately. Erroneous selecting of executable

-      and audio algorithms could reduce the compression ratio

-      in some situations.

-

-   4. 'vt' and 'lt' commands display symlink target names,

-      when listing RAR/Unix archives contained symbolic links.

-      These commands also display NTFS stream names, when listing

-      WinRAR archives contained streams.

-

-

-   Version 3.20

-

-   1. Previous RAR versions stored only the file modification time

-      and only in DOS FAT format with 2 seconds precision.

-      While it was enough for FAT, modern file systems provide

-      a higher precision. Now RAR format can preserve modification,

-      creation and last access time with the precision up to 0.0000001

-      second. RAR/Unix supports modification and last access time

-      with 1 second precision.

-

-      You may use the command line -ts<m,c,a> switch to choose time

-      fields to process and precision of these fields.

-

-   2. 'rn' command allows to rename files inside of RAR archives.

-

-   3. 'lb' and 'vb' commands list contents of archive in the bare mode -

-      file names without any additional information.

-

-   4. RAR displays the operation percentage when creating recovery

-      volumes or reconstructing missing or corrupt volumes.

-

-   5. Directories are archived after files which they contain,

-      so directory time and owner information is set after unpacking

-      its contents. Otherwise unpacking files may modify

-      the directory time.

​

@@ -0,0 +1,81 @@

+                           ACKNOWLEDGMENTS

+

+* RAR text compression algorithm is based on Dmitry Shkarin PPMII

+  and Dmitry Subbotin carryless rangecoder public domain source code.

+  You may find it in ftp.elf.stuba.sk/pub/pc/pack.

+

+* RAR encryption includes parts of code from Szymon Stefanek

+  and Brian Gladman AES implementations also as Steve Reid SHA-1 source.

+

+  ---------------------------------------------------------------------------

+  Copyright (c) 2002, Dr Brian Gladman <                 >, Worcester, UK.

+  All rights reserved.

+

+  LICENSE TERMS

+

+  The free distribution and use of this software in both source and binary

+  form is allowed (with or without changes) provided that:

+

+    1. distributions of this source code include the above copyright

+       notice, this list of conditions and the following disclaimer;

+

+    2. distributions in binary form include the above copyright

+       notice, this list of conditions and the following disclaimer

+       in the documentation and/or other associated materials;

+

+    3. the copyright holder's name is not used to endorse products

+       built using this software without specific written permission.

+

+  ALTERNATIVELY, provided that this notice is retained in full, this product

+  may be distributed under the terms of the GNU General Public License (GPL),

+  in which case the provisions of the GPL apply INSTEAD OF those given above.

+

+  DISCLAIMER

+

+  This software is provided 'as is' with no explicit or implied warranties

+  in respect of its properties, including, but not limited to, correctness

+  and/or fitness for purpose.

+  ---------------------------------------------------------------------------

+

+  Source code of this package also as other cryptographic technology

+  and computing project related links are available on Brian Gladman's

+  web site: http://www.gladman.me.uk

+

+* RAR uses CRC32 function based on Intel Slicing-by-8 algorithm.

+  Original Intel Slicing-by-8 code is available here:

+

+    http://sourceforge.net/projects/slicing-by-8/

+

+  Original Intel Slicing-by-8 code is licensed under BSD License

+  available at http://www.opensource.org/licenses/bsd-license.html

+

+    Copyright (c) 2004-2006 Intel Corporation. 

+    All Rights Reserved

+

+    Redistribution and use in source and binary forms, with or without

+    modification, are permitted provided that the following conditions

+    are met:

+

+    Redistributions of source code must retain the above copyright notice,

+    this list of conditions and the following disclaimer.

+    

+    Redistributions in binary form must reproduce the above copyright

+    notice, this list of conditions and the following disclaimer

+    in the documentation and/or other materials provided with

+    the distribution.

+

+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

+    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

+    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS

+    FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

+    HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

+    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

+    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

+    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

+    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

+    OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

+    SUCH DAMAGE.

+

+* Useful hints provided by Alexander Khoroshev and Bulat Ziganshin allowed

+  to significantly improve RAR compression and speed.

​

@@ -1,157 +1,114 @@

-      The RAR Archiver

-      EULA (End User License Agreement) for use and distribution

-

-

-      The RAR archiver is distributed as try before you buy. This means:

-

-   1. The author and holder of the copyright of RAR and WinRAR

-      is Alexander L. Roshal. The licensor of the following license

-      and bearer of the worldwide exclusive usage rights to reproduce

-      and distribute RAR and WinRAR is win.rar GmbH, Schumannstr. 17,

-      10117 Berlin, Germany.

-

-   2. Anyone may use this software during a test period of 40 days.

-      Following this test period of 40 days or less, if you wish to

-      continue to use RAR, you must purchase a license.

-

-   3. There are 2 basic types of licenses issued for RAR, these are:

-

-      a.  A single computer usage license. The user purchases one license

-          to use RAR archiver on one computer.

-

-          Home users may use their single computer usage license on

-          all computers which are in property of the license owner.

-

-          Business users require one license per computer RAR is

-          installed on.

-

-      b.  A multiple usage license. The user purchases a number of usage

-          licenses for use, by the purchaser or the purchaser's employees

-          on the same number of computers.

-

-          In a network (server/client) environment you must purchase

-          a license copy for each separate client (workstation)

-          on which RAR is installed, used, or accessed. A separate

-          license copy for each client (workstation) is needed regardless

-          of whether the clients (workstations) will use RAR simultaneously

-          or at different times. If for example you wish to have

-          9 different clients (workstations) in your network with access

-          to RAR, you must purchase 9 license copies.

-

-      A user who purchased a RAR license, is granted a non-exclusive

-      right to use RAR on as many computers as defined by the licensing

-      terms above according to the number of licenses purchased,

-      for any legal purpose. The licensed RAR software may not be rented

-      or leased, but may be permanently transferred, in it's entirety,

-      if the person receiving it agrees to the terms of this license.

-      If the software is an update, the transfer must include the update

-      and all previous versions.

-

-   4. Licensing for RAR on mobile devices (U3 stick, USB stick,

-      external harddrive):

-

-      In addition to the terms stated above following licensing terms

-      apply to the licensing of RAR on mobile devices.

-

-      a.  A single computer usage license. Home users may use their

-          single computer usage license on all mobile devices which are

-          in property of the license owner.

-

-          Business users may use their single computer usage license

-          on one computer and one mobile device.

-

-      b.  A multiple usage license. Users who own a multiple usage

-          license may use that license on the same number of mobile

-          devices as number of computers (clients) the license was

-          purchased for.

-

-          The number of computers/devices running RAR at any time is

-          limited to the number of licenses purchased according to the

-          licensing terms above.

-

-      A licensed version of RAR on a mobile device may be used by

-      the purchaser or the purchaser's employees, on several computers

-      consecutively.

-

-      There are no additional license fees, apart from the cost of

-      purchasing a license, associated with the use of RAR from

-      a mobile device on computers that are not owned by the owner

-      of the RAR license.

-

-   5. The RAR/WinRAR unlicensed trial version may be freely distributed,

-      with exceptions noted below, provided the distribution package is not

-      modified in any way.

-

-      a.  No person or company may distribute separate parts of the package

-          with the exception of the UnRAR components, without written

-          permission of the copyright owner.

-

-      b.  The RAR/WinRAR unlicensed trial version may not be distributed

-          inside of any other software package without written permission

-          of the copyright owner.

-

-      c.  Hacks/cracks, keys or key generators may not be included on the

-          same distribution.

-

-   6. To buy a license please see order.htm for details.

-

-   7. THE RAR ARCHIVER IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY

-      KIND IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK.

-      NEITHER THE AUTHOR NOR THE AGENTS OF THE AUTHOR WILL BE LIABLE

-      FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS

-      WHILE USING OR MISUSING THIS SOFTWARE.

-

-   8. There are no additional license fees, apart from the cost of

-      purchasing a license, associated with the creation and distribution

-      of RAR archives, volumes, self-extracting archives or self-extracting

-      volumes. Legally registered owners may use their copies of RAR/WinRAR

-      to produce archives and self-extracting archives and to distribute

-      those archives free of any additional RAR royalties.

-

-   9. You may not use, copy, emulate, clone, rent, lease, sell, modify,

-      decompile, disassemble, otherwise reverse engineer, or transfer

-      the licensed program, or any subset of the licensed program, except

-      as provided for in this agreement. Any such unauthorized use shall

-      result in immediate and automatic termination of this license and

-      may result in criminal and/or civil prosecution.

-

-      7zxa.dll library is copyrighted by Igor Pavlov and distributed

-      under LGPL Version 3 license ( http://www.gnu.org/licenses/lgpl.html ).

-      You can modify portions of 7zxa.dll and perform reverse engineering

-      solely for purpose of debugging such 7zxa.dll modifications according

-      to LGPL. Source code of 7zxa.dll is available on www.7-zip.org.

-

-      Neither RAR binary code, WinRAR binary code, UnRAR source or UnRAR

-      binary code may be used or reverse engineered to re-create the RAR

-      compression algorithm, which is proprietary, without written

-      permission of the author.

-

-      RAR and WinRAR keyfiles may not be distributed, except as stated

-      in item 3) above, outside of the area of legal control of the

-      person or persons who purchased the original license, without

-      written permission of the copyright holder.

-

-  10. WinRAR unregistered version can display a registration reminder dialog

-      prompting a user to obtain a license. Depending on WinRAR version

-      and configuration such dialog can contain either a predefined text

-      and links loaded locally or a web page loaded from the internet.

-      Such web page can contain licensing instructions and other materials

-      according to win.rar GmbH's choice, including advertisement.

-      When opening a web page, WinRAR transfers only those parameters

-      which are technically required by HTTP protocol to successfully open

-      a web page in a browser.

-

-  11. All rights not expressly granted in the license are reserved by

-      Alexander Roshal.

-

-      Installing and using RAR/WinRAR signifies acceptance of these terms

-      and conditions of the license.

-

-  12. If you do not agree with the terms of this license you must

-      remove RAR/WinRAR files from your storage devices and cease to

-      use the product.

-

-      Thank you for using the original RAR.

-

-                                            Alexander L. Roshal

-

+     END USER LICENSE AGREEMENT

+

+     The following agreement regarding RAR (and its Windows version - WinRAR)

+     archiver - referred to as "software" - is made between win.rar GmbH -

+     referred to as "licensor" - and anyone who is installing, accessing

+     or in any other way using the software - referred to as "user".

+

+  1. The author and holder of the copyright of the software is

+     Alexander L. Roshal. The licensor and as such issuer of the license

+     and bearer of the worldwide exclusive usage rights including the rights

+     to reproduce, distribute and make the software available to the public

+     in any form is win.rar GmbH, Schumannstr. 17, 10117 Berlin, Germany.

+

+  2. The software is distributed as try before you buy. This means that

+     anyone may use the software during a test period of a maximum of 40 days

+     at no charge. Following this test period, the user must purchase

+     a license to continue using the software.

+

+  3. The software's trial version may be freely distributed, with exceptions

+     noted below, provided the distribution package is not modified in any way.

+

+     a. Nobody may distribute separate parts of the package, with the exception

+        of the UnRAR components, without written permission.

+

+     b. The software's unlicensed trial version may not be distributed

+        inside of any other software package without written permission.

+

+     c. Hacks/cracks, keys or key generators may not be included, pointed to

+        or referred to by the distributor of the trial version.

+

+  4. The trial version of the software can display a registration reminder

+     dialog. Depending on the software version and configuration such dialog

+     can contain either a predefined text and links loaded locally

+     or a web page loaded from the internet. Such web page can contain

+     licensing instructions or other materials according to the licensor's

+     choice, including advertisement. When opening a web page, the software

+     transfers only those parameters which are technically required

+     by HTTP protocol to successfully open a web page in a browser.

+

+  5. The software is distributed "as is". No warranty of any kind is expressed

+     or implied. You use at your own risk. Neither the author, the licensor

+     nor the agents of the licensor will be liable for data loss, damages,

+     loss of profits or any other kind of loss while using or misusing

+     this software.

+

+  6. There are 2 basic types of licenses issued for the software. These are:

+

+     a. A single computer usage license. The user purchases one license to

+        use the software on one computer.

+

+        Home users may use their single computer usage license on all

+        computers and mobile devices (USB drive, external hard drive, etc.)

+        which are property of the license owner.

+

+        Business users require one license per computer or mobile device

+        on which the software is installed.

+

+     b. A multiple usage license. The user purchases a number of usage

+        licenses for use, by the purchaser or the purchaser's employees

+        on the same number of computers.

+

+        In a network (server/client) environment the user must purchase

+        a license copy for each separate client (workstation) on which

+        the software is installed, used or accessed. A separate license copy

+        for each client (workstation) is needed regardless of whether

+        the clients (workstations) will use the software simultaneously

+        or at different times. If for example you wish to have 9 different

+        clients (workstations) in your network with access to RAR,

+        you must purchase 9 license copies.

+

+     A user who purchased a license, is granted a non-exclusive right to use

+     the software on as many computers as defined by the licensing terms above

+     according to the number of licenses purchased, for any legal purpose.

+

+  7. There are no additional license fees, apart from the cost of the license,

+     associated with the creation and distribution of RAR archives,

+     volumes, self-extracting archives or self-extracting volumes.

+     Owners of a license may use their copies of the software to produce

+     archives and self-extracting archives and to distribute those archives

+     free of any additional royalties.

+

+  8. The licensed software may not be rented or leased but may be permanently

+     transferred, in its entirety, if the recipient agrees to the terms of

+     this license.

+

+  9. To buy a license, please read the file order.htm provided with

+     the software for details.

+

+ 10. You may not use, copy, emulate, clone, rent, lease, sell, modify,

+     decompile, disassemble, otherwise reverse engineer, or transfer

+     the licensed software, or any subset of the licensed software,

+     except as provided for in this agreement. Any such unauthorized use

+     shall result in immediate and automatic termination of this license

+     and may result in criminal and/or civil prosecution.

+

+     Neither RAR binary code, WinRAR binary code, UnRAR source

+     or UnRAR binary code may be used or reverse engineered to re-create

+     the RAR compression algorithm, which is proprietary, without written

+     permission.

+

+     The software may be using components developed and/or copyrighted

+     by third parties. Please read "Acknowledgments" help file topic

+     for WinRAR or acknow.txt text file for other RAR versions for details.

+

+ 11. This License Agreement is construed solely and exclusively under

+     German law. If you are a merchant, the courts at the registered office

+     of win.rar GmbH in Berlin/Germany shall have exclusive jurisdiction

+     for any and all disputes arising in connection with this License

+     Agreement or its validity.

+

+ 12. Installing and using the software signifies acceptance of these terms

+     and conditions of the license. If you do not agree with the terms of this

+     license, you must remove all software files from your storage devices

+     and cease to use the software.

​

@@ -1,6 +1,6 @@

                              User's Manual

                              ~~~~~~~~~~~~~

-                        RAR 4.11 console version

+                        RAR 4.20 console version

                         ~~~~~~~~~~~~~~~~~~~~~~~~

                        =-=-=-=-=-=-=-=-=-=-=-=-=-=-

@@ -881,7 +881,7 @@

             This switch indicates that directory records are not to be

             stored in the created archive. When extracting such archives,

-            RAR creates non-empty directories basing on paths of files

+            RAR creates non-empty directories based on paths of files

             contained in them. Information about empty directories is

             lost. All attributes of non-empty directories except a name

             (access rights, streams, etc.) will be lost as well, so use

@@ -1192,12 +1192,11 @@

             If this switch is not specified, RAR uses -m3 method

             (normal compression).

-            By default, RAR uses only the general compression

-            algorithm in -m1 and -m2 methods, advanced algorithms

-            like audio and true color processing are enabled

-            only in -m3..-m5 modes, the advanced text compression

-            is activated only in -m4..-m5. This default can be

-            overridden using -mc switch.

+            By default, RAR uses only the general compression algorithm

+            in -m1 and -m2 methods, advanced algorithms like audio

+            and true color processing are enabled only in -m3..-m5 modes,

+            advanced text compression is disabled in all modes.

+            This default can be overridden using -mc switch.

     -mc<par>

@@ -1237,6 +1236,7 @@

             <Param1> and <Param2> are module dependent parameters

             described below.

+

             Audio compression, delta compression:

             <Param1> is a number of byte channels (can be 1 - 31).

@@ -1256,6 +1256,20 @@

             Text compression:

+            Text compression algorithm provides noticeably higher compression

+            on plain text data. But it cannot utilize several CPU cores

+            efficiently resulting in slower compression time comparing to

+            general algorithm in multicore and multiprocessor environment.

+            Also its decompression speed is much slower than in general

+            algorithm regardless of CPU cores number. This is why

+            the text compression is disabled by default. You can specify

+            -mct switch to allow RAR to select this algorithm automatically

+            for suitable data. Switch -mct+ will force use of the text

+            compression for all data.

+

+            Switch -mct can also include <Param1> and <Param2>, so its

+            full syntax is -mc[param1][:param2]t[+ or -].

+

             <Param1> is the order of PPM algorithm (can be 2 - 63).

             Usually a higher value slightly increases the compression ratio

             of redundant data, but only if enough memory is available

@@ -1286,7 +1300,8 @@

             when the text compression is used, but leaves to RAR to

             decide when to use it.

-            4) switches -mct- -mcd- disable text and delta compression.

+            4) switches -mct -mcd- allow RAR to apply the text compression

+            to suitable data and disable the delta compression.

     -md<n>  Select dictionary size <n> in KB. Must be 64, 128, 256, 512,

@@ -1337,18 +1352,14 @@

     -mt<threads>

-            Set the number of threads. Available in Windows version only.

+            Set the number of threads.

-            <threads> parameter can take values from 0 to 16.

-            It defines the recommended number of active threads

-            for compression algorithm. If it is greater than 0,

-            RAR will use the multithreaded version of compression

-            algorithm providing higher speed on multiprocessor

-            architectures. Real number of active threads can differ

-            from the specified.

-

-            If <threads> is zero, RAR will use the single threaded

-            compression algorithm.

+            <threads> parameter can take values from 1 to 32.

+            It defines the recommended maximum number of active threads

+            for compression algorithm also as for other RAR modules,

+            which can start several threads. While RAR attempts to follow

+            this recommendation, sometimes the real number of active

+            threads can exceed the specified value.

             Change of <threads> parameter slightly affects the compression

             ratio, so archives created with different -mt switches

@@ -1414,10 +1425,11 @@

             This switch has meaning only for NTFS file system and allows

             to save alternative data streams associated with a file.

-            It is especially important in Windows 2000, XP and newer,

-            which use streams to keep some file dependent information

-            like file descriptions. If you use RAR to backup your

-            NTFS disks, it is recommended to specify this switch.

+            You may need to specify it when archiving if you use software

+            storing data in alternative streams and wish to preserve

+            these streams.

+

+            Streams are not saved for NTFS encrypted files.

     -ow     Use this switch when archiving to save file security

​