RAR(1)                                                      RAR archiver                                                     RAR(1)

NAME
       rar - archive files with compression

SYNOPSIS
       rar <command> [-<switch 1> -<switch N>] archive [files...]

DESCRIPTION
       This manual page documents briefly the rar archiver.
       This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.
       Commands and options described here are as of rar 3.0b5.

       rar and unrar are programs for manipulation with .rar archives.

OPTIONS
       After the program name comes a command and then optional switches with dashes before them.
       A summary of commands is included below.  For a complete description, run rar without options.

       a      Add files to archive.

       c      Add archive comment. Comment length is limited to 62000 bytes.

       cf     Add files comment. File comments are displayed when the 'v' command is given. File comment length is limited to 32767
              bytes.

       cw     Write archive comment to a specified file.

       d      Delete files from archive.

       e      Extract files to current directory. Does not create any subdirectories.

       f      Freshen files in archive. Updates those files changed since they were packed to the archive. This  command  will  not
              add new to the archive.

       k      Lock archive. Any command which intend to change the archive will be ignored.

       l[t]   List  content  of  archive [technical]. Files are listed as the 'v' command with the exception of the file path. i.e.
              the file name is displayed. Optional technical information displayed when 't' modifier is used.

       m[f]   Move to archive [files only]. Directories will not be removed if 'f' modifier is used and/or '-ed' switch is applied.

       p      Print file to stdout.

       r      Repair archive. For further details look in rar.txt.

       rc     Reconstruct missing volumes using recovery volumes (.rev files).  You need to specify any existing volume as the  ar‐
              chive name, for example, 'rar rc backup.part03.rar'.

       rr[N]  Add data recovery record. Optionally, redundant information (recovery record) may be added to an archive.

       rv[N]  Create  recovery  volumes  (.rev  files), which can be later used to reconstruct missing files in a volume set.  This
              command has sense only for multivolume archives.  For further details look in rar.txt.

       s[name|-]
              Convert archive to or from SFX. The archive is merged with SFX-module in the user's home directory.

       t      Test archive files.

       u      Update files in archive. Adds files not already in the archive and updates files changed since they  were  packed  to
              the archive.

       v[t]   Verbosely list archive [technical]

       x      Extract files with full path.

SWITCHES
       NOTE: Every switch must be separated by a whitespace. They cannot be put together.

       -?     Display help on commands and switches. The same as when none or an illegal command line option is entered.

       --     This switch tells to RAR that there is no more switches in the command line. It could be useful, if either archive or
              file name starts from '-' character. Without '--' switch such name would be treated as switch.

       -ac    Clear Archive attribute after compression or extraction (Windows version only).

       -ag[format]
              Generate archive name using the current date and time.  Appends the current date string to an archive name when  cre‐
              ating an archive. Useful for daily backups.  For further details look in rar.txt.

       -ao    Add files with Archive attribute set (Windows version only).

       -ap    Set  path  inside  archive.  This  path is merged to file names when adding files to an archive and removed from file
              names when extracting.

       -as    Synchronize archive contents. If this switch is used when archiving, those archived files which are  not  present  in
              the  list of the currently added files, will be deleted from archive. It is convenient to use this switch in combina‐
              tion with -u (update) to synchronize contents of an archive and an archiving directory.

       -av    Put authenticity verification (registered versions only). Details in register.txt.

       -av-   Disable AV checking or adding.

       -cfg-  Disable read configuration and environment.

       -cl    Convert file names to lower case.

       -cu    Convert file names to upper case.

       -c-    Disable comments show.

       -df    Delete files after archiving. This switch in combination with the command "A" performs the same action as the command
              "M".

       -dh    Open shared files. Allows to process files opened by other applications for writing.

       -ds    Do not sort files while adding to a solid archive.

       -ed    Do not add empty directories.

       -ee    Do not process extended attributes. Only for OS/2 versions.

       -en    Do not add "end of archive" block.

              This  switch cannot be used with volumes, because the end of archive block contains information important for correct
              volume processing.

       -ep    Exclude paths from names.

       -ep1   Exclude base dir from names.

       -ep2   Expand paths to full. Store full file paths (except a drive letter and leading path separator) when archiving.

       -e<attr>
              Specifies file exclude attributes mask.

       -f     Freshen files. May be used with archive extraction or creation.

       -hp<password>
              Encrypt both file data and headers.  The password is case-sensitive. If you omit the password on  the  command  line,
              you will be prompted with message "Enter password".

       -idp   Disable percentage indicator.

       -ieml[.][addr]
              Send archive by email. Win32 version only.

       -ierr  Send all messages to stderr.

       -ilog  Log errors to file (registered versions only).

       -inul  Disable all messages.

       -isnd  Enable sound.

       -k     Lock archive. Any command which intends to change the archive will be ignored.

       -kb    Keep broken extracted files.

       -m<0..5>
              Set compression level (0-store...3-default...5-best). By default rar uses -m3 method (Normal compression).

       -mc<par>
              Set advanced compression parameters.  For further details look in rar.txt.

       -md<size>
              Set dictionary size in Kb (64,128,256,512,1024,2048,4097 or a,b,c,d,e,f,g)

       -ms[list]
              Specify file types to store.

       -o+    Overwrite existing files.

       -o-    Do not overwrite existing files.

       -ol    Save symbolic links as the link instead of the file.

       -os    Save NTFS streams. Win32 version only.

       -ow    Save file owner and group.

       -p<password>
              Encrypt  files  with  the string <password> as password while archiving.  The password is case-sensitive. If you omit
              the password on the command line, you will be prompted with message "Enter password".

       -p-    Do not query password.

       -r     Recurse subdirectories.

       -r0    Similar to -r, but when used with the commands 'a', 'u', 'f', 'm'  will  recurse  subdirectories  only  for  wildcard
              names.

       -ri<p>[:<s>]
              Set priority and sleep time. Available only in RAR for Windows.

       -rr[N] Add data recovery record.

       -rv[N] Create recovery volumes.  -s Create solid archive.

       -s<N>  Create solid groups using file count. Similar to -s, but reset solid statistics after compressing <N> files.

       -se    Create solid groups using extension. Similar to -s, but reset solid statistics if file extension is changed.

       -sv    Create  independent  solid volumes. Similar to -s, but reset solid statistics as soon as possible when starting a new
              volume.

       -sv-   Create dependent solid volumes. Similar to -s, but reset of solid statistics is disabled.

       -s-    Disable solid archiving.

       -sfx[name]
              Create SFX archives. The archive is merged with SFX-module in the user's home directory.

       -t     Test files after archiving. This switch is especially useful in combination with the move command, so files  will  be
              deleted only if archive had been successfully tested.

       -tk    Keep original archive time. Prevents rar from modifying the archive date when changing an archive.

       -tl    Set  archive  time  to latest file. Forces rar to set the date of a changed archive to the date of the newest file in
              the archive.

       -u     Update files.

       -v<size>[k|b|f]
              Create volumes with size=<size>*1000 [*1024, *1].

       -vd    Erase disk contents before creating volume.All files and directories on the target disk will be erased when '-vd'  is
              used.  The switch applies only to removable media, the hard disk cannot be erased using this switch.

       -w<path>
              Assign work directory.

       -x<file>
              Exclude specified file. Wildcards may be used and you may specify the switch '-x' several times.

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

       -x@    Read file names to exclude from stdin.

       -y     Assume Yes on all queries.

       -z<file>
              Read archive comment from file.

SEE ALSO
       The program is documented fully in rar.txt which you find in /usr/share/doc/rar.

AUTHOR
       This  manual  page was written by Petr Cech <cech@debian.org> according to "rar -h" for the Debian GNU/Linux system (but may
       be used by others).

                                                             22.04.2002                                                      RAR(1)

RAR 5.50   Copyright (c) 1993-2017 Alexander Roshal   11 Aug 2017
Trial version             Type 'rar -?' for help

Usage:     rar <command> -<switch 1> -<switch N> <archive> <files...>
               <@listfiles...> <path_to_extract\>

<Commands>
  a             Add files to archive
  c             Add archive comment
  ch            Change archive parameters
  cw            Write archive comment to file
  d             Delete files from archive
  e             Extract files without archived paths
  f             Freshen files in archive
  i[par]=<str>  Find string in archives
  k             Lock archive
  l[t[a],b]     List archive contents [technical[all], bare]
  m[f]          Move to archive [files only]
  p             Print file to stdout
  r             Repair archive
  rc            Reconstruct missing volumes
  rn            Rename archived files
  rr[N]         Add data recovery record
  rv[N]         Create recovery volumes
  s[name|-]     Convert archive to or from SFX
  t             Test archive files
  u             Update files in archive
  v[t[a],b]     Verbosely list archive contents [technical[all],bare]
  x             Extract files with full path

<Switches>
  -             Stop switches scanning
  @[+]          Disable [enable] file lists
  ad            Append archive name to destination path
  ag[format]    Generate archive name using the current date
  ai            Ignore file attributes
  ap<path>      Set path inside archive
  as            Synchronize archive contents
  c-            Disable comments show
  cfg-          Disable read configuration
  cl            Convert names to lower case
  cu            Convert names to upper case
  df            Delete files after archiving
  dh            Open shared files
  ds            Disable name sort for solid archive
  dw            Wipe files after archiving
  e[+]<attr>    Set file exclude and include attributes
  ed            Do not add empty directories
  en            Do not put 'end of archive' block
  ep            Exclude paths from names
  ep1           Exclude base directory from names
  ep3           Expand paths to full including the drive letter
  f             Freshen files
  hp[password]  Encrypt both file data and headers
  ht[b|c]       Select hash type [BLAKE2,CRC32] for file checksum
  id[c,d,p,q]   Disable messages
  ierr          Send all messages to stderr
  ilog[name]    Log errors to file (registered versions only)
  inul          Disable all messages
  isnd          Enable sound
  iver          Display the version number
  k             Lock archive
  kb            Keep broken extracted files
  log[f][=name] Write names to log file
  m<0..5>       Set compression level (0-store...3-default...5-maximal)
  ma[4|5]       Specify a version of archiving format
  mc<par>       Set advanced compression parameters
  md<n>[k,m,g]  Dictionary size in KB, MB or GB
  ms[ext;ext]   Specify file types to store
  mt<threads>   Set the number of threads
  n<file>       Additionally filter included files
  n@            Read additional filter masks from stdin
  n@<list>      Read additional filter masks from list file
  o[+|-]        Set the overwrite mode
  oh            Save hard links as the link instead of the file
  oi[0-4][:min] Save identical files as references
  ol[a]         Process symbolic links as the link [absolute paths]
  or            Rename files automatically
  ow            Save or restore file owner and group
  p[password]   Set password
  p-            Do not query password
  qo[-|+]       Add quick open information [none|force]
  r             Recurse subdirectories
  r-            Disable recursion
  r0            Recurse subdirectories for wildcard names only
  rr[N]         Add data recovery record
  rv[N]         Create recovery volumes
  s[<N>,v[-],e] Create solid archive
  s-            Disable solid archiving
  sc<chr>[obj]  Specify the character set
  sfx[name]     Create SFX archive
  si[name]      Read data from standard input (stdin)
  sl<size>      Process files with size less than specified
  sm<size>      Process files with size more than specified
  t             Test files after archiving
  ta<date>      Process files modified after <date> in YYYYMMDDHHMMSS format
  tb<date>      Process files modified before <date> in YYYYMMDDHHMMSS format
  tk            Keep original archive time
  tl            Set archive time to latest file
  tn<time>      Process files newer than <time>
  to<time>      Process files older than <time>
  ts[m|c|a]     Save or restore file time (modification, creation, access)
  u             Update files
  v<size>[k,b]  Create volumes with size=<size>*1000 [*1024, *1]
  ver[n]        File version control
  vn            Use the old style volume naming scheme
  vp            Pause before each volume
  w<path>       Assign work directory
  x<file>       Exclude specified file
  x@            Read file names to exclude from stdin
  x@<list>      Exclude files listed in specified list file
  y             Assume Yes on all queries
  z[file]       Read archive comment from file