unrar
(1)
Name
unrar - chive
Synopsis
unrar command [switches] archive {files | @listfiles}
[path_to_extract]
Description
User Commands UNRAR(1)
NAME
unrar - list, test and extract compressed files from RAR ar-
chive
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
unrar Last change: 18 Feb 2009 1
User Commands UNRAR(1)
-id[c,d,p,q]
Disable messages. c-copyright, d-'done' message, p-per-
centage, 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>
unrar Last change: 18 Feb 2009 2
User Commands UNRAR(1)
-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 let-
ters.rar into the current directory and subdirectories below
it, creating any subdirectories 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 arti-
cles.rar to standard output and pipe it to a printing pro-
gram:
unrar Last change: 18 Feb 2009 3
User Commands UNRAR(1)
unrar -p -inul articles paper1.dvi | dvips
To extract all FORTRAN and C source files--*.f, *.c, *.h,
and Makefile--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 cur-
rent 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 command-
line 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 directories 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
processing completed anyway.
2 fatal error encountered during rar archive pro-
cessing.
unrar Last change: 18 Feb 2009 4
User Commands UNRAR(1)
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 exclu-
sively owned by the author - Alexander Roshal.
2 The UnRAR sources may be used in any software to handle
RAR archives without limitations free of charge, but
cannot be used to re-create the RAR compression algo-
rithm, 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) com-
patible 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, DAMAGES, LOSS OF PROFITS OR
ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS
SOFTWARE.
5 Installing and using the UnRAR utility signifies accep-
tance of these terms and conditions of the license.
6 If you don't agree with terms of the license you must
unrar Last change: 18 Feb 2009 5
User Commands UNRAR(1)
remove UnRAR files from your storage devices and cease
to use the utility.
ATTRIBUTES
See attributes(5) 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://java.net/projects/solaris-userland. The original
community source was downloaded from http://www.rar-
lab.com/rar/unrarsrc-4.2.4.tar.gz
Further information about this software can be found on the
open source community website at http://www.rar-
labs.com/rar_add.htm.
unrar Last change: 18 Feb 2009 6