7zr Man page

7zr General Commands Manual 7zr

NAME

7zr – A file archiver with highest compression ratio

SYNOPSIS

7zr [adeltux] [-] [SWITCH]

DESCRIPTION

7-Zip is a file archiver with the highest compression ratio. The pro‐
gram supports 7z (that implements LZMA compression algorithm), LZMA2,
XZ, ZIP, Zip64, CAB, RAR (if the non-free p7zip-rar package is
installed), ARJ, GZIP, BZIP2, TAR, CPIO, RPM, ISO, most filesystem
images and DEB formats. Compression ratio in the new 7z format is
30-50% better than ratio in ZIP format.

7zr is a stand-alone executable. 7zr handles less archive formats than
7z. 7zr is a “light-version” of 7za that only handles 7z archives.

FUNCTION LETTERS
a Add

d Delete

e Extract

l List

t Test

u Update

x eXtract with full paths

SWITCHES
-ai[r[-|0]]{@listfile|!wildcard}
Include archives

-ax[r[-|0]]{@listfile|!wildcard}
eXclude archives

-bd Disable percentage indicator

-i[r[-|0]]{@listfile|!wildcard}
Include filenames

-l don’t store symlinks; store the files/directories they point to
(CAUTION : the scanning stage can never end because of recursive
symlinks like ‘ln -s .. ldir’)

-m{Parameters}
Set Compression Method (see /usr/share/doc/p7zip/DOCS/MAN‐
UAL/switches/method.htm for a list of methods)

-mhe=on|off
7z format only : enables or disables archive header encryption
(Default : off)

-o{Directory}
Set Output directory

-p{Password}
Set Password

-r[-|0] Recurse subdirectories (CAUTION: this flag does not do what you
think, avoid using it)

-sfx[{name}] Create SFX archive

-si Read data from StdIn (eg: tar cf – directory | 7zr a -si direc‐
tory.tar.7z)

-so Write data to StdOut (eg: 7zr x -so directory.tar.7z | tar xf -)

-slt Sets technical mode for l (list) command

-v{Size}[b|k|m|g] Create volumes

-u[-][p#][q#][r#][x#][y#][z#][!newArchiveName] Update options

-w[path] Set Working directory

-x[r[-|0]]]{@listfile|!wildcard}
Exclude filenames

-y Assume Yes on all queries

DIAGNOSTICS
7-Zip returns the following exit codes:

0 Normal (no errors or warnings detected)

1 Warning (Non fatal error(s)). For example, some files
cannot be read during compressing. So they were not com‐
pressed

2 Fatal error

7 Bad command line parameters

8 Not enough memory for operation

255 User stopped the process with control-C (or similar)

Backup and limitations
DO NOT USE the 7-zip format for backup purpose on Linux/Unix because :
– 7-zip does not store the owner/group of the file.

On Linux/Unix, in order to backup directories you must use tar :
– to backup a directory : tar cf – directory | 7zr a -si direc‐
tory.tar.7z
– to restore your backup : 7zr x -so directory.tar.7z | tar xf –

If you want to send files and directories (not the owner of file) to
others Unix/MacOS/Windows users, you can use the 7-zip format.

example : 7zr a directory.7z directory

Do not use “-r” because this flag does not do what you think.

Do not use directory/* because of “.*” files (example : “directory/*”
does not match “directory/.profile”)

EXAMPLE 1
7zr a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on archive.7z dir1
adds all files from directory “dir1” to archive archive.7z using
“ultra settings”

-t7z 7z archive

-m0=lzma
lzma method

-mx=9 level of compression = 9 (Ultra)

-mfb=64
number of fast bytes for LZMA = 64

-md=32m
dictionary size = 32 megabytes

-ms=on solid archive = on

EXAMPLE 2
7zr a -sfx archive.exe dir1
add all files from directory “dir1” to SFX archive archive.exe
(Remark : SFX archive MUST end with “.exe”)

EXAMPLE 3
7zr a -mhe=on -pmy_password archive.7z a_directory
add all files from directory “a_directory” to the archive “ar‐
chive.7z” (with data and header archive encryption on)

SEE ALSO

7z, 7za, bzip2, gzip, zip

HTML Documentation
/usr/share/doc/p7zip/DOCS/MANUAL/index.htm

AUTHOR

Written for Debian by Mohammed Adnene Trojette.

Mohammed Adnene Trojette September 1 2006 7zr