Scroll to navigation



ddrescuelog - tool for ddrescue mapfiles


ddrescuelog [options] mapfile


GNU ddrescuelog - Tool for ddrescue mapfiles. Manipulates ddrescue mapfiles, shows their contents, converts them to/from other formats, compares them, and tests rescue status.

NOTE: In versions of ddrescue prior to 1.20 the mapfile was called 'logfile'. The format is the same; only the name has changed.


display this help and exit
output version information and exit
change the block types of mapfile
add comments with human-readable pos/sizes
block size in bytes [default 512]
show binary multipliers in numbers [SI]
create mapfile from list of blocks [+-]
complete mapfile adding blocks of type t [?]
delete the mapfile if rescue is finished
return 0 if rescue is finished
overwrite existing output files
starting position of rescue domain [0]
print block numbers of given types (?*/-+)
accept an incomplete domain mapfile
restrict domain to finished blocks in file
invert block types (finished <--> others)
starting position in output file [ipos]
compare block types in domain of both files
like -p but compare finished blocks only
suppress all messages
maximum size of rescue domain to be processed
show a summary of mapfile contents
be verbose (a 2nd -v gives more)
XOR the finished blocks in file with mapfile
AND the finished blocks in file with mapfile
OR the finished blocks in file with mapfile
shift all block positions by (opos - ipos)

Use '-' to read a mapfile from standard input or to write the mapfile created by '--create-mapfile' to standard output. Numbers may be in decimal, hexadecimal or octal, and may be followed by a multiplier: s = sectors, k = 1000, Ki = 1024, M = 10^6, Mi = 2^20, etc...

Exit status: 0 for a normal exit, 1 for environmental problems (file not found, invalid flags, I/O errors, etc), 2 to indicate a corrupt or invalid input file, 3 for an internal consistency error (eg, bug) which caused ddrescuelog to panic.


Report bugs to
Ddrescue home page:
General help using GNU software:


Copyright © 2018 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later <>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

February 2018 ddrescuelog 1.23