Make sure only one of is_* flags is set.
[rarfile.git] / dumprar.py
blobacc4f310214452c2ca1d70ca55dc31523d5a26bf
1 #! /usr/bin/env python3
3 """Dump archive contents, test extraction."""
5 import getopt
6 import io
7 import sys
8 from datetime import datetime
10 import rarfile as rf
12 usage = """
13 dumprar [switches] [ARC1 ARC2 ...] [@ARCLIST]
14 switches:
15 @file read archive names from file
16 -pPWD set password
17 -Ccharset set fallback charset
18 -v increase verbosity
19 -t attempt to read all files
20 -x write read files out
21 -c show archive comment
22 -h show usage
23 -- stop switch parsing
24 """.strip()
26 os_list = ["DOS", "OS2", "WIN", "UNIX", "MACOS", "BEOS"]
28 block_strs = ["MARK", "MAIN", "FILE", "OLD_COMMENT", "OLD_EXTRA",
29 "OLD_SUB", "OLD_RECOVERY", "OLD_AUTH", "SUB", "ENDARC"]
31 r5_block_types = {
32 rf.RAR5_BLOCK_MAIN: "R5_MAIN",
33 rf.RAR5_BLOCK_FILE: "R5_FILE",
34 rf.RAR5_BLOCK_SERVICE: "R5_SVC",
35 rf.RAR5_BLOCK_ENCRYPTION: "R5_ENC",
36 rf.RAR5_BLOCK_ENDARC: "R5_ENDARC",
40 def rar3_type(btype):
41 """RAR3 type code as string."""
42 if btype < rf.RAR_BLOCK_MARK or btype > rf.RAR_BLOCK_ENDARC:
43 return "*UNKNOWN*"
44 return block_strs[btype - rf.RAR_BLOCK_MARK]
47 def rar5_type(btype):
48 """RAR5 type code as string."""
49 return r5_block_types.get(btype, "*UNKNOWN*")
52 main_bits = (
53 (rf.RAR_MAIN_VOLUME, "VOL"),
54 (rf.RAR_MAIN_COMMENT, "COMMENT"),
55 (rf.RAR_MAIN_LOCK, "LOCK"),
56 (rf.RAR_MAIN_SOLID, "SOLID"),
57 (rf.RAR_MAIN_NEWNUMBERING, "NEWNR"),
58 (rf.RAR_MAIN_AUTH, "AUTH"),
59 (rf.RAR_MAIN_RECOVERY, "RECOVERY"),
60 (rf.RAR_MAIN_PASSWORD, "PASSWORD"),
61 (rf.RAR_MAIN_FIRSTVOLUME, "FIRSTVOL"),
62 (rf.RAR_SKIP_IF_UNKNOWN, "SKIP"),
63 (rf.RAR_LONG_BLOCK, "LONG"),
66 endarc_bits = (
67 (rf.RAR_ENDARC_NEXT_VOLUME, "NEXTVOL"),
68 (rf.RAR_ENDARC_DATACRC, "DATACRC"),
69 (rf.RAR_ENDARC_REVSPACE, "REVSPACE"),
70 (rf.RAR_ENDARC_VOLNR, "VOLNR"),
71 (rf.RAR_SKIP_IF_UNKNOWN, "SKIP"),
72 (rf.RAR_LONG_BLOCK, "LONG"),
75 file_bits = (
76 (rf.RAR_FILE_SPLIT_BEFORE, "SPLIT_BEFORE"),
77 (rf.RAR_FILE_SPLIT_AFTER, "SPLIT_AFTER"),
78 (rf.RAR_FILE_PASSWORD, "PASSWORD"),
79 (rf.RAR_FILE_COMMENT, "COMMENT"),
80 (rf.RAR_FILE_SOLID, "SOLID"),
81 (rf.RAR_FILE_LARGE, "LARGE"),
82 (rf.RAR_FILE_UNICODE, "UNICODE"),
83 (rf.RAR_FILE_SALT, "SALT"),
84 (rf.RAR_FILE_VERSION, "VERSION"),
85 (rf.RAR_FILE_EXTTIME, "EXTTIME"),
86 (rf.RAR_FILE_EXTFLAGS, "EXTFLAGS"),
87 (rf.RAR_SKIP_IF_UNKNOWN, "SKIP"),
88 (rf.RAR_LONG_BLOCK, "LONG"),
91 generic_bits = (
92 (rf.RAR_SKIP_IF_UNKNOWN, "SKIP"),
93 (rf.RAR_LONG_BLOCK, "LONG"),
96 file_parms = ("D64", "D128", "D256", "D512",
97 "D1024", "D2048", "D4096", "DIR")
99 r5_block_flags = (
100 (rf.RAR5_BLOCK_FLAG_EXTRA_DATA, "EXTRA"),
101 (rf.RAR5_BLOCK_FLAG_DATA_AREA, "DATA"),
102 (rf.RAR5_BLOCK_FLAG_SKIP_IF_UNKNOWN, "SKIP"),
103 (rf.RAR5_BLOCK_FLAG_SPLIT_BEFORE, "SPLIT_BEFORE"),
104 (rf.RAR5_BLOCK_FLAG_SPLIT_AFTER, "SPLIT_AFTER"),
105 (rf.RAR5_BLOCK_FLAG_DEPENDS_PREV, "DEPENDS"),
106 (rf.RAR5_BLOCK_FLAG_KEEP_WITH_PARENT, "KEEP"),
109 r5_main_flags = (
110 (rf.RAR5_MAIN_FLAG_ISVOL, "ISVOL"),
111 (rf.RAR5_MAIN_FLAG_HAS_VOLNR, "VOLNR"),
112 (rf.RAR5_MAIN_FLAG_SOLID, "SOLID"),
113 (rf.RAR5_MAIN_FLAG_RECOVERY, "RECOVERY"),
114 (rf.RAR5_MAIN_FLAG_LOCKED, "LOCKED"),
117 r5_file_flags = (
118 (rf.RAR5_FILE_FLAG_ISDIR, "DIR"),
119 (rf.RAR5_FILE_FLAG_HAS_MTIME, "MTIME"),
120 (rf.RAR5_FILE_FLAG_HAS_CRC32, "CRC32"),
121 (rf.RAR5_FILE_FLAG_UNKNOWN_SIZE, "NOSIZE"),
124 r5_enc_flags = (
125 (rf.RAR5_ENC_FLAG_HAS_CHECKVAL, "CHECKVAL"),
128 r5_endarc_flags = (
129 (rf.RAR5_ENDARC_FLAG_NEXT_VOL, "NEXTVOL"),
132 r5_file_enc_flags = (
133 (rf.RAR5_XENC_CHECKVAL, "CHECKVAL"),
134 (rf.RAR5_XENC_TWEAKED, "TWEAKED"),
137 r5_file_redir_types = {
138 rf.RAR5_XREDIR_UNIX_SYMLINK: "UNIX_SYMLINK",
139 rf.RAR5_XREDIR_WINDOWS_SYMLINK: "WINDOWS_SYMLINK",
140 rf.RAR5_XREDIR_WINDOWS_JUNCTION: "WINDOWS_JUNCTION",
141 rf.RAR5_XREDIR_HARD_LINK: "HARD_LINK",
142 rf.RAR5_XREDIR_FILE_COPY: "FILE_COPY",
145 r5_file_redir_flags = (
146 (rf.RAR5_XREDIR_ISDIR, "DIR"),
150 dos_mode_bits = (
151 (0x01, "READONLY"),
152 (0x02, "HIDDEN"),
153 (0x04, "SYSTEM"),
154 (0x08, "VOLUME_ID"),
155 (0x10, "DIRECTORY"),
156 (0x20, "ARCHIVE"),
157 (0x40, "DEVICE"),
158 (0x80, "NORMAL"),
159 (0x0100, "TEMPORARY"),
160 (0x0200, "SPARSE_FILE"),
161 (0x0400, "REPARSE_POINT"),
162 (0x0800, "COMPRESSED"),
163 (0x1000, "OFFLINE"),
164 (0x2000, "NOT_CONTENT_INDEXED"),
165 (0x4000, "ENCRYPTED"),
166 (0x8000, "INTEGRITY_STREAM"),
167 (0x00010000, "VIRTUAL"),
168 (0x00020000, "NO_SCRUB_DATA"),
169 (0x00040000, "RECALL_ON_OPEN"),
170 (0x00080000, "PINNED"),
171 (0x00100000, "UNPINNED"),
172 (0x00400000, "RECALL_ON_DATA_ACCESS"),
173 (0x20000000, "STRICTLY_SEQUENTIAL"),
177 def xprint(m, *args):
178 """Print string to stdout.
180 Format unicode safely.
182 if sys.hexversion < 0x3000000:
183 m = m.decode("utf8")
184 if args:
185 m = m % args
186 if sys.hexversion < 0x3000000:
187 m = m.encode("utf8")
188 sys.stdout.write(m)
189 sys.stdout.write("\n")
192 def render_flags(flags, bit_list):
193 """Show bit names.
195 res = []
196 known = 0
197 for bit in bit_list:
198 known = known | bit[0]
199 if flags & bit[0]:
200 res.append(bit[1])
201 unknown = flags & ~known
202 n = 0
203 while unknown:
204 if unknown & 1:
205 res.append("UNK_%04x" % (1 << n))
206 unknown = unknown >> 1
207 n += 1
209 if not res:
210 return "-"
212 return ",".join(res)
215 def get_file_flags(flags):
216 """Show flag names and handle dict size.
218 res = render_flags(flags & ~rf.RAR_FILE_DICTMASK, file_bits)
220 xf = (flags & rf.RAR_FILE_DICTMASK) >> 5
221 res += "," + file_parms[xf]
222 return res
225 def fmt_time(t):
226 """Format time.
228 if t is None:
229 return "(-)"
230 if isinstance(t, datetime):
231 return t.isoformat("T")
232 return "%04d-%02d-%02d %02d:%02d:%02d" % t
235 def show_item(h):
236 """Show any RAR3/5 record.
238 if isinstance(h, rf.Rar3Info):
239 show_item_v3(h)
240 elif isinstance(h, rf.Rar5Info):
241 show_item_v5(h)
242 else:
243 xprint("Unknown info record")
246 def show_rftype(h):
247 return "".join([
248 h.is_file() and "F" or "-",
249 h.is_dir() and "D" or "-",
250 h.is_symlink() and "L" or "-",
254 def modex3(v):
255 return [v & 4 and "r" or "-", v & 2 and "w" or "-", v & 1 and "x" or "-"]
258 def unix_mode(mode):
259 perms = modex3(mode >> 6) + modex3(mode >> 3) + modex3(mode)
260 if mode & 0x0800:
261 perms[2] = perms[2] == "x" and "s" or "S"
262 if mode & 0x0400:
263 perms[5] = perms[5] == "x" and "s" or "S"
264 if mode & 0x0200:
265 perms[8] = perms[8] == "x" and "t" or "-"
266 rest = mode & 0xF000
267 if rest == 0x4000:
268 perms.insert(0, "d")
269 elif rest == 0xA000:
270 perms.insert(0, "l")
271 elif rest == 0x8000:
272 # common
273 perms.insert(0, "-")
274 elif rest == 0:
275 perms.insert(0, "-")
276 else:
277 perms.insert(0, "?")
278 perms.append("(0x%04x)" % rest)
279 return "".join(perms)
282 def show_mode(h):
283 if h.host_os in (rf.RAR_OS_UNIX, rf.RAR_OS_BEOS):
284 s_mode = unix_mode(h.mode)
285 elif h.host_os in (rf.RAR_OS_MSDOS, rf.RAR_OS_WIN32, rf.RAR_OS_OS2):
286 s_mode = render_flags(h.mode, dos_mode_bits)
287 else:
288 s_mode = "0x%x" % h.mode
289 return s_mode
292 def show_item_v3(h):
293 """Show any RAR3 record.
295 st = rar3_type(h.type)
296 xprint("%s: hdrlen=%d datlen=%d is=%s",
297 st, h.header_size, h.add_size, show_rftype(h))
298 if h.type in (rf.RAR_BLOCK_FILE, rf.RAR_BLOCK_SUB):
299 s_mode = show_mode(h)
300 xprint(" flags=0x%04x:%s", h.flags, get_file_flags(h.flags))
301 if h.host_os >= 0 and h.host_os < len(os_list):
302 s_os = os_list[h.host_os]
303 else:
304 s_os = "?"
305 if h.flags & rf.RAR_FILE_UNICODE:
306 s_namecmp = " namecmp=%d/%d" % (len(h.orig_filename), h._name_size)
307 else:
308 s_namecmp = ""
309 xprint(" os=%d:%s ver=%d mode=%s meth=%c cmp=%d dec=%d vol=%d%s",
310 h.host_os, s_os,
311 h.extract_version, s_mode, h.compress_type,
312 h.compress_size, h.file_size, h.volume, s_namecmp)
313 ucrc = (h.CRC + (1 << 32)) & ((1 << 32) - 1)
314 xprint(" crc=0x%08x (%d) date_time=%s", ucrc, h.CRC, fmt_time(h.date_time))
315 xprint(" name=%s", h.filename)
316 if h.mtime:
317 xprint(" mtime=%s", fmt_time(h.mtime))
318 if h.ctime:
319 xprint(" ctime=%s", fmt_time(h.ctime))
320 if h.atime:
321 xprint(" atime=%s", fmt_time(h.atime))
322 if h.arctime:
323 xprint(" arctime=%s", fmt_time(h.arctime))
324 elif h.type == rf.RAR_BLOCK_MAIN:
325 xprint(" flags=0x%04x:%s", h.flags, render_flags(h.flags, main_bits))
326 elif h.type == rf.RAR_BLOCK_ENDARC:
327 xprint(" flags=0x%04x:%s", h.flags, render_flags(h.flags, endarc_bits))
328 if h.flags & rf.RAR_ENDARC_DATACRC:
329 xprint(" datacrc=0x%08x", h.endarc_datacrc)
330 if h.flags & rf.RAR_ENDARC_DATACRC:
331 xprint(" volnr=%d", h.endarc_volnr)
332 elif h.type == rf.RAR_BLOCK_MARK:
333 xprint(" flags=0x%04x:", h.flags)
334 else:
335 xprint(" flags=0x%04x:%s", h.flags, render_flags(h.flags, generic_bits))
337 if h.comment is not None:
338 cm = repr(h.comment)
339 if cm[0] == "u":
340 cm = cm[1:]
341 xprint(" comment=%s", cm)
344 def show_item_v5(h):
345 """Show any RAR5 record.
347 st = rar5_type(h.block_type)
348 xprint("%s: hdrlen=%d datlen=%d hdr_extra=%d is=%s", st, h.header_size,
349 h.compress_size, h.block_extra_size, show_rftype(h))
350 xprint(" block_flags=0x%04x:%s", h.block_flags, render_flags(h.block_flags, r5_block_flags))
351 if h.block_type in (rf.RAR5_BLOCK_FILE, rf.RAR5_BLOCK_SERVICE):
352 xprint(" name=%s", h.filename)
353 s_mode = show_mode(h)
354 if h.file_host_os == rf.RAR5_OS_UNIX:
355 s_os = "UNIX"
356 else:
357 s_os = "WINDOWS"
358 xprint(" file_flags=0x%04x:%s", h.file_flags, render_flags(h.file_flags, r5_file_flags))
360 cmp_flags = h.file_compress_flags
361 xprint(" cmp_algo=%d cmp_meth=%d dict=%d solid=%r",
362 cmp_flags & 0x3f,
363 (cmp_flags >> 7) & 0x07,
364 cmp_flags >> 10,
365 cmp_flags & rf.RAR5_COMPR_SOLID > 0)
366 xprint(" os=%d:%s mode=%s cmp=%r dec=%r vol=%r",
367 h.file_host_os, s_os, s_mode,
368 h.compress_size, h.file_size, h.volume)
369 if h.CRC is not None:
370 xprint(" crc=0x%08x (%d)", h.CRC, h.CRC)
371 if h.blake2sp_hash is not None:
372 xprint(" blake2sp=%s", rf.tohex(h.blake2sp_hash))
373 if h.date_time is not None:
374 xprint(" date_time=%s", fmt_time(h.date_time))
375 if h.mtime:
376 xprint(" mtime=%s", fmt_time(h.mtime))
377 if h.ctime:
378 xprint(" ctime=%s", fmt_time(h.ctime))
379 if h.atime:
380 xprint(" atime=%s", fmt_time(h.atime))
381 if h.arctime:
382 xprint(" arctime=%s", fmt_time(h.arctime))
383 if h.flags & rf.RAR_FILE_PASSWORD:
384 enc_algo, enc_flags, kdf_count, salt, iv, checkval = h.file_encryption
385 algo_name = "AES256" if enc_algo == rf.RAR5_XENC_CIPHER_AES256 else "UnknownAlgo"
386 xprint(" algo=%d:%s enc_flags=%04x:%s kdf_lg=%d kdf_count=%d salt=%s iv=%s checkval=%s",
387 enc_algo, algo_name, enc_flags, render_flags(enc_flags, r5_file_enc_flags),
388 kdf_count, 1 << kdf_count, rf.tohex(salt), rf.tohex(iv),
389 checkval and rf.tohex(checkval) or "-")
390 if h.file_redir:
391 redir_type, redir_flags, redir_name = h.file_redir
392 xprint(" redir: type=%s flags=%d:%s destination=%s",
393 r5_file_redir_types.get(redir_type, "Unknown"),
394 redir_flags, render_flags(redir_flags, r5_file_redir_flags),
395 redir_name)
396 if h.file_owner:
397 uname, gname, uid, gid = h.file_owner
398 xprint(" owner: name=%r group=%r uid=%r gid=%r",
399 uname, gname, uid, gid)
400 if h.file_version:
401 flags, version = h.file_version
402 xprint(" version: flags=%r version=%r", flags, version)
403 elif h.block_type == rf.RAR5_BLOCK_MAIN:
404 xprint(" flags=0x%04x:%s", h.flags, render_flags(h.main_flags, r5_main_flags))
405 elif h.block_type == rf.RAR5_BLOCK_ENDARC:
406 xprint(" flags=0x%04x:%s", h.flags, render_flags(h.endarc_flags, r5_endarc_flags))
407 elif h.block_type == rf.RAR5_BLOCK_ENCRYPTION:
408 algo_name = "AES256" if h.encryption_algo == rf.RAR5_XENC_CIPHER_AES256 else "UnknownAlgo"
409 xprint(" algo=%d:%s flags=0x%04x:%s", h.encryption_algo, algo_name, h.flags,
410 render_flags(h.encryption_flags, r5_enc_flags))
411 xprint(" kdf_lg=%d kdf_count=%d", h.encryption_kdf_count, 1 << h.encryption_kdf_count)
412 xprint(" salt=%s", rf.tohex(h.encryption_salt))
413 else:
414 xprint(" - missing info -")
416 if h.comment is not None:
417 cm = repr(h.comment)
418 if cm[0] == "u":
419 cm = cm[1:]
420 xprint(" comment=%s", cm)
423 cf_show_comment = 0
424 cf_verbose = 0
425 cf_charset = None
426 cf_extract = 0
427 cf_test_read = 0
428 cf_test_unrar = 0
429 cf_test_memory = 0
432 def check_crc(f, inf, desc):
433 """Compare result crc to expected value.
435 exp = inf._md_expect
436 if exp is None:
437 return
438 ucrc = f._md_context.digest()
439 if ucrc != exp:
440 print("crc error - %s - exp=%r got=%r" % (desc, exp, ucrc))
443 def test_read_long(r, inf):
444 """Test read and readinto.
446 md_class = inf._md_class or rf.NoHashContext
447 bctx = md_class()
448 f = r.open(inf.filename)
449 total = 0
450 while 1:
451 data = f.read(8192)
452 if not data:
453 break
454 bctx.update(data)
455 total += len(data)
456 if total != inf.file_size:
457 xprint("\n *** %s has corrupt file: %s ***", r.rarfile, inf.filename)
458 xprint(" *** short read: got=%d, need=%d ***\n", total, inf.file_size)
459 check_crc(f, inf, "read")
460 bhash = bctx.hexdigest()
461 if cf_verbose > 1:
462 if f._md_context.digest() == inf._md_expect:
463 #xprint(" checkhash: %r", bhash)
464 pass
465 else:
466 xprint(" checkhash: %r got=%r exp=%r cls=%r\n",
467 bhash, f._md_context.digest(), inf._md_expect, inf._md_class)
469 # test .seek() & .readinto()
470 if cf_test_read > 1:
471 f.seek(0, 0)
473 total = 0
474 buf = bytearray(1024)
475 while 1:
476 res = f.readinto(buf)
477 if not res:
478 break
479 total += res
480 if inf.file_size != total:
481 xprint(" *** readinto failed: got=%d, need=%d ***\n", total, inf.file_size)
482 #check_crc(f, inf, "readinto")
483 f.close()
486 def test_read(r, inf):
487 """Test file read."""
488 test_read_long(r, inf)
491 def test_real(fn, pwd):
492 """Actual archive processing.
494 xprint("Archive: %s", fn)
496 cb = None
497 if cf_verbose > 1:
498 cb = show_item
500 rfarg = fn
501 if cf_test_memory:
502 rfarg = io.BytesIO(open(fn, "rb").read())
504 # check if rar
505 if not rf.is_rarfile(rfarg):
506 xprint(" --- %s is not a RAR file ---", fn)
507 return
509 # open
510 r = rf.RarFile(rfarg, charset=cf_charset, info_callback=cb)
511 # set password
512 if r.needs_password():
513 if pwd:
514 r.setpassword(pwd)
515 else:
516 xprint(" --- %s requires password ---", fn)
517 return
519 # show comment
520 if cf_show_comment and r.comment:
521 for ln in r.comment.split("\n"):
522 xprint(" %s", ln)
523 elif cf_verbose > 0 and r.comment:
524 cm = repr(r.comment)
525 if cm[0] == "u":
526 cm = cm[1:]
527 xprint(" comment=%s", cm)
529 # process
530 for n in r.namelist():
531 inf = r.getinfo(n)
532 if cf_verbose == 1:
533 show_item(inf)
534 if inf.is_dir() or inf.is_symlink():
535 continue
536 if cf_test_read:
537 test_read(r, inf)
539 if cf_extract:
540 r.extractall()
541 for inf in r.infolist():
542 r.extract(inf)
544 if cf_test_unrar:
545 r.testrar()
548 def test(fn, pwd):
549 """Process one archive with error handling.
551 try:
552 test_real(fn, pwd)
553 except rf.NeedFirstVolume as ex:
554 xprint(" --- %s is middle part of multi-vol archive (%s)---", fn, str(ex))
555 except rf.Error:
556 exc, msg, tb = sys.exc_info()
557 xprint("\n *** %s: %s ***\n", exc.__name__, msg)
558 del tb
559 except IOError:
560 exc, msg, tb = sys.exc_info()
561 xprint("\n *** %s: %s ***\n", exc.__name__, msg)
562 del tb
565 def main():
566 """Program entry point.
568 global cf_verbose, cf_show_comment, cf_charset
569 global cf_extract, cf_test_read, cf_test_unrar
570 global cf_test_memory
572 pwd = None
574 # parse args
575 try:
576 opts, args = getopt.getopt(sys.argv[1:], "p:C:hvcxtRM")
577 except getopt.error as ex:
578 print(str(ex), file=sys.stderr)
579 sys.exit(1)
581 for o, v in opts:
582 if o == "-p":
583 pwd = v
584 elif o == "-h":
585 xprint(usage)
586 return
587 elif o == "-v":
588 cf_verbose += 1
589 elif o == "-c":
590 cf_show_comment = 1
591 elif o == "-x":
592 cf_extract = 1
593 elif o == "-t":
594 cf_test_read += 1
595 elif o == "-T":
596 cf_test_unrar = 1
597 elif o == "-M":
598 cf_test_memory = 1
599 elif o == "-C":
600 cf_charset = v
601 else:
602 raise Exception("unhandled switch: " + o)
604 args2 = []
605 for a in args:
606 if a[0] == "@":
607 for ln in open(a[1:], "r"):
608 fn = ln[:-1]
609 args2.append(fn)
610 else:
611 args2.append(a)
612 args = args2
614 if not args:
615 xprint(usage)
617 for fn in args:
618 test(fn, pwd)
621 if __name__ == "__main__":
622 try:
623 main()
624 except KeyboardInterrupt:
625 pass