File unrar.1 of Package unrar

.\" Copyright (C) 2013-2019 Kyrill Detinov <lazy.kent@opensuse.org>
.\"
.TH UNRAR "1" "2019-02-24" "unrar 5.70" "User Commands"

.SH NAME
unrar \- extract, test, and view RAR archives

.SH SYNOPSIS
.BI unrar \ command
.RI [ option1 ]\ [ optionN ]\  archive
.RI [ files... ]\ [ @listfiles... ]\ [ path_to_extract/ ]

.SH DESCRIPTION
The \fBunrar\fR utility is a freeware program distributed with source
code and developed for extracting, testing, and viewing the contents of
archives created with the RAR archiver.

.SH COMMANDS
.TP
.B e
Extract files without archived paths.
.TP
.B l[t[a],b]
List archive [technical[all],bare].
.TP
.B p
Print file to stdout.
.TP
.B t
Test archive files.
.TP
.B v[t[a],b]
Verbosely list archive [technical[all],bare].
.TP
.B x
Extract files with full path.

.SH OPTIONS
.TP
.B \-
Stop switches scanning.
.TP
.B \-@[+]
Disable [enable] file lists.
.TP
.B \-ad
Append archive name to destination path.
.TP
.B \-ai
Ignore file attributes.
.TP
.BI \-ap path
Set \fIpath\fR inside archive.
.TP
.B \-c\-
Disable comments show.
.TP
.B \-cfg\-
Disable read configuration.
.TP
.B \-cl
Convert names to lower case.
.TP
.B \-cu
Convert names to upper case.
.TP
.B \-dh
Open shared files.
.TP
.B \-ep
Exclude paths from names.
.TP
.B \-ep3
Expand paths to full including the drive letter.
.TP
.B \-f
Freshen files.
.TP
.B \-id[c,d,p,q]
Disable messages.
.TP
.B \-ierr
Send all messages to stderr.
.TP
.B \-inul
Disable all messages.
.TP
.B \-kb
Keep broken extracted files.
.TP
.BI \-n file
Additionally filter included \fIfiles\fR.
.TP
.B \-n@
Read additional filter masks from stdin.
.TP
.BI \-n@ list
Read additional filter masks from \fIlist\fR file.
.TP
.B \-o[+|\-]
Set the overwrite mode [yes|no].
.TP
.B \-ol[a]
Process symbolic links as the link [absolute paths].
.TP
.B \-or
Rename files automatically.
.TP
.B \-ow
Save or restore file owner and group.
.TP
.B \-p[password]
Set password.
.TP
.B \-p\-
Do not query password.
.TP
.B \-r
Recurse subdirectories.
.TP
.BI \-sc chr [obj]
Specify the \fIcharacter\fR set.
\'Charset\' parameter is mandatory and can have one of the following values:
.TP
u - Unicode UTF-16
.TP
f - Unicode UTF-8
.TP
a - Native single byte encoding, which is ANSI for Windows
.TP
o - OEM (DOS) encoding
.TP
\'Objects\' parameter is optional and can have one of the following values:
.TP
g - Log files produced by -ilogswitch
.TP
l - List files
.TP
c - Comment files
.TP
.BI \-sl size
Process files with \fIsize\fR less than specified.
.TP
.BI \-sm size
Process files with \fIsize\fR more than specified.
.TP
.BI \-ta date
Process files modified after \fIdate\fR in YYYYMMDDHHMMSS format.
.TP
.BI \-tb date
Process files modified before \fIdate\fR in YYYYMMDDHHMMSS format.
.TP
.BI \-tn time
Process files newer than \fItime\fR.
.TP
.BI \-to time
Process files older than \fItime\fR.
.TP
.B \-ts[m,c,a][N]
Save or restore file time [modification, creation, access].
.TP
.B \-u
Update files.
.TP
.B \-v
List all volumes.
.TP
.B \-ver[n]
File version control.
.TP
.B \-vp
Pause before each volume.
.TP
.BI \-x file
Exclude specified \fIfile\fR.
.TP
.B \-x@
Read file names to exclude from stdin.
.TP
.BI \-x@ list
Exclude files listed in specified \fIlist\fR file.
.TP
.B \-y
Assume Yes on all queries.

.SH EXIT STATUS
.TP
.B 0
Successful operation.
.TP
.B 1
Warning. Non fatal error(s) occurred.
.TP
.B 2
A fatal error occurred.
.TP
.B 3
Invalid checksum. Data is damaged.
.TP
.B 5
Write error.
.TP
.B 6
File open error.
.TP
.B 7
Wrong command line option.
.TP
.B 8
Not enough memory.
.TP
.B 9
File create error.
.TP
.B 10
No files matching the specified mask and options were found.
.TP
.B 11
Wrong password.
.TP
.B 255
User break.

.SH FILES
.B unrar
reads configuration from the \fI~/.rarrc\fR file.
.SS "File syntax:"
switches= option1 option2 ... optionN

.SH SEE ALSO
.BR rar (1)