File: 7z.1

package info (click to toggle)
p7zip 16.02%2Bdfsg-3%2Bdeb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 14,112 kB
  • sloc: cpp: 167,145; ansic: 14,992; python: 1,911; asm: 1,688; sh: 1,132; makefile: 701
file content (270 lines) | stat: -rw-r--r-- 5,808 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
.TH 7z 1 "March 6th, 2016" "7-Zip"
.SH NAME
7z \- A file archiver with high compression ratio format
.SH SYNOPSIS
.B 7z
.B <command>
.RB [ <switches> "... ]"
.B <archive_name>
.RB [ <file_names> "... ]"
.RB [ <@listfiles> "... ]"
.PP
.SH DESCRIPTION
7-Zip is a file archiver supporting 7z (that implements LZMA compression algorithm
featuring very high compression ratio), 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.
.PP
.B 7z
uses plugins to handle archives, so it might be slightly slower than
.BR 7za (1)
but can handle more archive formats.
.SH COMMANDS
.TP
.B a
Add files to archive
.TP
.B b
Benchmark
.TP
.B d
Delete files from archive
.TP
.B e
Extract files from archive (without using directory names)
.TP
.B h
Calculate hash values for files
.TP
.B i
Show information about supported formats
.TP
.B l
List contents of archive
.TP
.B rn
Rename files in archive
.TP
.B t
Test integrity of archive
.TP
.B u
Update files to archive
.TP
.B x
eXtract files with full paths
.PP
.SH SWITCHES
.TP
.B \-\-
Stop switches parsing
.TP
.B \-ai[r[-|0]]{@listfile|!wildcard}
Include archives
.TP
.B \-ax[r[-|0]]{@listfile|!wildcard}
Exclude archives
.TP
.B \-ao{a|s|t|u}
Set Overwrite mode
.TP
.B \-an
Disable archive_name field
.TP
.B -bb[0-3]
Set output log level
.TP
.B \-bd
Disable progress indicator
.TP
.B \-bs{o|e|p}{0|1|2}
Set output stream for output/error/progress line
.TP
.B \-bt
Show execution time statistics
.TP
.B \-i[r[\-|0]]{@listfile|!wildcard}
Include filenames
.TP
.B \-m{Parameters}
Set Compression Method (see /usr/share/doc/p7zip/DOC/MANUAL/cmdline/switches/method.htm from the p7zip-full package for a list of methods)
.TP
.B \-o{Directory}
Set Output directory
.TP
.B \-p{Password}
Set Password (NOTE: this flag does not work with 7z,
.TP
.B \-r[\-|0]
Recurse subdirectories (CAUTION: this flag does not do what you think, avoid using it)
.TP
.B \-sa{a|e|s}
Set archive name mode
.TP
.B \-scc{UTF\-8|WIN|DOS}
Set charset for for console input/output
.TP
.B \-scs{UTF\-8|UTF\-16LE|UTF\-16BE|WIN|DOS|{id}}
Set charset for list files
.TP
.B \-scrc[CRC32|CRC64|SHA1|SHA256|*]
Set hash function for x, e, h commands
.TP
.B \-sdel
Delete files after compression
.TP
.B \-seml[.]
Send archive by email
.TP
.B \-sfx[{name}]
Create SFX archive
.TP
.B \-si[{name}]
Read data from stdin (e.g. tar cf \- directory | 7z a \-si directory.tar.7z)
.TP
.B \-slp
Set Large Pages mode
.TP
.B \-slt
Show technical information for l (List) command
.TP
.B \-snh
Store hard links as links
.TP
.B \-snl
Store symbolic links as links
.TP
.B \-sni
Store NT security information
.TP
.B \-sns[\-]
Store NTFS alternate streams
.TP
.B \-sfx[{name}]
Create SFX archive
.TP
.B \-so
Write data to stdout (e.g. 7z x \-so directory.tar.7z | tar xf \-)
.TP
.B \-spd
Disable wildcard matching for file names
.TP
.B \-spe
Eliminate duplication of root folder for extract command
.TP
.B \-spf
Use fully qualified file paths
.TP
.B \-ssc[\-]
Set sensitive case mode
.TP
.B \-ssw
Compress shared files
.TP
.B \-stl
Set archive timestamp from the most recently modified file
.TP
.B \-stm{HexMask}
Set CPU thread affinity mask (hexadecimal number)
.TP
.B \-stx{Type}
Exclude archive type
.TP
.B \-t{Type}
Set type of archive
.TP
.B \-u[-][p#][q#][r#][x#][y#][z#][!newArchiveName]
Update options
.TP
.B \-v{Size}[b|k|m|g]
Create volumes
.TP
.B \-w[path]
Set working directory. Empty path means a temporary directory
.TP
.B \-x[r[\-|0]]]{@listfile|!wildcard}
Exclude filenames
.TP
.B \-y
Assume Yes on all queries
.PP
.SH DIAGNOSTICS
7-Zip returns the following exit codes:
.RS
.IP 0
Normal (no errors or warnings detected)
.IP 1
Warning (Non fatal error(s)). For example, some files cannot be read during compressing,
so they were not compressed
.IP 2
Fatal error
.IP 7
Bad command line parameters
.IP 8
Not enough memory for operation
.IP 255
User stopped the process with control-C (or similar)
.SH 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.

.LP
On Linux/Unix, in order to backup directories you must use tar :
 \- to backup a directory  : tar cf \- directory | 7z a \-si directory.tar.7z
 \- to restore your backup : 7z 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 : 7z a directory.7z  directory

.LP
Do not use "\-r" because this flag does not do what you think.
.LP
Do not use directory/* because of ".*" files (example : "directory/*" does not match "directory/.profile")
.SH EXAMPLE 1
.TP
.B 7z 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"
.TP
.B \-t7z
7z archive
.TP
.B \-m0=lzma
lzma method
.TP
.B \-mx=9
level of compression = 9 (Ultra)
.TP
.B \-mfb=64
number of fast bytes for LZMA = 64
.TP
.B \-md=32m
dictionary size = 32 megabytes
.TP
.B \-ms=on
solid archive = on
.SH EXAMPLE 2
.TP
.B
7z a \-sfx archive.exe dir1
add all files from directory "dir1" to SFX archive archive.exe (Remark : SFX archive MUST end with ".exe")
.SH EXAMPLE 3
.TP
.B
7z a \-mhe=on \-pmy_password archive.7z a_directory
add all files from directory "a_directory" to the archive "archive.7z" (with data and header archive encryption on)
.SH "SEE ALSO"
.BR 7zr (1),
.BR 7za (1),
.BR p7zip (1),
.BR bzip2 (1),
.BR gzip (1),
.BR zip(1),
.PP
.SH "HTML Documentation"
/usr/share/doc/p7zip-full/DOC/MANUAL/start.htm
.SH AUTHOR
.TP
Written for Debian by Mohammed Adnene Trojette. Updated by Robert Luberda.