Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

unrar (1)

Name

unrar - list, test and extract compressed files from RAR archive

Synopsis

unrar command [switches] archive {files | @listfiles} [path_to_extract]

Description

UNRAR(1)                    General Commands Manual                   UNRAR(1)



NAME
       unrar - list, test and extract compressed files from RAR archive

SYNOPSIS
       unrar command [switches] archive {files | @listfiles} [path_to_extract]

DESCRIPTION
       unrar  is  commandline utility to list, test, or extract files from RAR
       archive.

COMMANDS
       e      Extract files to current directory

       l[t|b] List archive [technical format, bare format]

       p      Print file to stdout

       t      Test archive files

       v[t|b] Verbosely list archive [technical format, bare format]

       x      Extract files with full path

SWITCHES
       -      Stop switches scanning

       -ad    Append archive name to destination path

       -ap<path>
              Set path inside archive

       -c-    Disable comments show

       -cfg-  Disable read configuration

       -cl    Convert names to lower case

       -cu    Convert names to upper case

       -dh    Open shared files

       -ep    Exclude paths from names

       -ep3   Expand paths to full including the drive letter

       -f     Freshen files

       -id[c,d,p,q]
              Disable messages. c-copyright, d-'done'  message,  p-percentage,
              q-be completely quiet

       -ierr  Send all messages to stderr

       -inul  Disable all messages

       -kb    Keep broken extracted files

       -n<file>
              Include only specified file

       -n@    Read file names to include from stdin

       -n@<list>
              Include files in specified list file

       -o+    Overwrite existing files

       -o-    Do not overwrite existing files

       -or    Rename files automatically

       -ow    Save or restore file owner and group

       -p[password]
              Set password

       -p-    Do not query password

       -r     Recurse subdirectories

       -sl<size>
              Process files with size less than specified

       -sm<size>
              Process files with size more than specified

       -ta<date>
              Process files modified after <date> in YYYYMMDDHHMMSS format

       -tb<date>
              Process files modified before <date> in YYYYMMDDHHMMSS format

       -tn<time>
              Process files newer than <time>

       -to<time>
              Process files older than <time>

       -ts<m,c,a>[N]
              Save or restore file time (modification, creation, access)

       -u     Update files

       -v     List all volumes

       -ver[n]
              File version control

       -vp    Pause before each volume

       -x<file>
              Exclude specified file

       -x@    Read file names to exclude from stdin

       -x@<list>
              Exclude files in specified list file

       -y     Assume Yes on all queries

EXAMPLES
       To use unrar to extract all members of the archive letters.rar into the
       current directory and subdirectories below it, creating any subdirecto-
       ries as necessary:

       unrar x letters

       To extract all members of letters.rar into the current directory only:

       unrar e letters

       To test letters.rar:

       unrar t letters

       To  extract  to  standard output all members of letters.rar whose names
       end in .tex piping the output into more(1):

       unrar p -inul letters '*.tex' | more

       To extract the binary file  paper1.dvi  from  archive  articles.rar  to
       standard output and pipe it to a printing program:

       unrar -p -inul articles paper1.dvi | dvips

       To  extract  all  FORTRAN  and C source files--*.f, *.c, *.h, and Make-
       file--into the /tmp directory:

       unrar source.rar "*.[fch]" Makefile /tmp

       To extract any such files but convert any uppercase MS-DOS or VMS names
       to lowercase:

       unrar -cl source.rar "*.[fch]" Makefile /tmp

       To extract newer versions of the files already in the current directory
       and to create any files not already there:

       unrar x -u -o+ sources.rar

ENVIRONMENT VARIABLES
       RAR    Unrar reads the switches from RAR, unless the commandline option
              -cfg- is given. Theese two examples do the same thing:

       unrar x -u -o+ sources.rar
       RAR='-u -o+' unrar x sources.rar

FILES
       .rarrc Unrar  reads  the switches from .rarrc unless commandline option
              -cfg- is given. Unrar goes sequentially through theese  directo-
              ries and reads first (and only first) .rarrc found.
              $HOME/.rarrc (if $HOME is defined)
              /etc/.rarrc
              /etc/rar/.rarrc
              /usr/lib/.rarrc
              /usr/local/lib/.rarrc
              /usr/local/etc/.rarrc

       rarrc  should  consist  of  lines  in the form switches=<switches>. For
       example:
       switches=-y

DIAGNOSTICS
       The exit status (or error level) has the following meanings:

              0      normal; no errors or warnings detected.

              1      one or more warning errors were encountered, but process-
                     ing completed anyway.

              2      fatal error encountered during rar archive processing.

              3      CRC  error.  Internal archive checksum does not match the
                     data.

              4      Locking issue. Not used in unrar.

              5      unrar was unable to write data to disk.

              6      unrar was unable to open a file

              7      User error (like wrong switch, etc.)

              8      unrar was unable to allocate memory

              9      unrar was unable to create file

              255    User terminated the process by using Ctrl+C

URL
       Unrar sources can be obtained at
       http://www.rarlab.com/rar_add.htm

COPYRIGHT
       The source code of UnRAR utility is freeware. This means:

       1      All copyrights to RAR and  the  utility  UnRAR  are  exclusively
              owned by the author - Alexander Roshal.

       2      The  UnRAR sources may be used in any software to handle RAR ar-
              chives without limitations free of charge, but cannot be used to
              re-create  the  RAR compression algorithm, which is proprietary.
              Distribution of modified UnRAR sources in separate form or as  a
              part of other software is permitted, provided that it is clearly
              stated in the documentation and source comments  that  the  code
              may not be used to develop a RAR (WinRAR) compatible archiver.

       3      The  UnRAR  utility  may be freely distributed. It is allowed to
              distribute UnRAR inside of other software packages.

       4      THE RAR ARCHIVER AND THE UnRAR UTILITY ARE DISTRIBUTED "AS  IS".
              NO  WARRANTY  OF  ANY  KIND IS EXPRESSED OR IMPLIED.  YOU USE AT
              YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAM-
              AGES,  LOSS  OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR
              MISUSING THIS SOFTWARE.

       5      Installing and using the UnRAR utility signifies  acceptance  of
              these terms and conditions of the license.

       6      If  you  don't  agree  with terms of the license you must remove
              UnRAR files from your storage devices and cease to use the util-
              ity.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | archiver/unrar   |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source        was        downloaded        from        https://www.rar-
       lab.com/rar/unrarsrc-5.5.7.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.rarlabs.com/rar_add.htm.



unrar                             18 Feb 2009                         UNRAR(1)