ddrescuelog - tool for ddrescue mapfiles



ddrescuelog − tool for ddrescue mapfiles


ddrescuelog [options] mapfile


GNU ddrescuelog is a tool that manipulates ddrescue mapfiles, shows mapfile contents, converts mapfiles to/from other formats, compares mapfiles, tests rescue status, and can delete a mapfile if the rescue is done. Ddrescuelog operations can be restricted to one or several parts of the mapfile if the domain setting options are used.

Use a hyphen ’−’ as mapfile to read the mapfile from standard input (also in the options taking a mapfile argument) or to write the mapfile created by ’−−create−mapfile’ to standard output.

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


−h, −−help

display this help and exit

−V, −−version

output version information and exit

−a, −−change−types=<ot>,<nt>

change the block types of mapfile

−A, −−annotate−mapfile

add comments with human−readable pos/sizes

−b, −−block−size=<bytes>

block (sector) size in bytes [default 512]

−B, −−binary−prefixes

show binary multipliers in numbers [SI]

−c, −−create−mapfile[=<tt>]

create mapfile from list of blocks [+−]

−C, −−complete−mapfile[=<t>]

complete mapfile adding blocks of type t [?]

−d, −−delete−if−done

delete the mapfile if rescue is finished

−D, −−done−status

return 0 if rescue is finished

−f, −−force

overwrite existing output files

−F, −−format=<name>

format for −c and −l (list, bitmap−[bl]e)

−i, −−input−position=<bytes>

starting position of rescue domain [0]

−l, −−list−blocks=<types>

print block numbers of given types (?*/−+)

−L, −−loose−domain

accept unordered domain mapfile with gaps

−m, −−domain−mapfile=<file>

restrict domain to finished blocks in <file>

−n, −−invert−mapfile

invert block types (finished <−−> others)

−o, −−output−position=<bytes>

starting position in output file [ipos]

−p, −−compare−mapfile=<file>

compare block types in domain of both files

−P, −−compare−as−domain=<file>

like −p but compare finished blocks only

−q, −−quiet

suppress all messages

−s, −−size=<bytes>

maximum size of rescue domain to be processed

−t, −−show−status

show a summary of mapfile contents

−v, −−verbose

be verbose (a 2nd −v gives more)

−x, −−xor−mapfile=<file>

XOR the finished blocks in file with mapfile

−y, −−and−mapfile=<file>

AND the finished blocks in file with mapfile

−z, −−or−mapfile=<file>

OR the finished blocks in file with mapfile


shift all block positions by (opos − ipos)

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 command line options, I/O errors, etc), 2 to indicate a corrupt or invalid input file, 3 for an internal consistency error (e.g., bug) which caused ddrescuelog to panic.


Report bugs to bug−[email protected]
Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
General help using GNU software: http://www.gnu.org/gethelp


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


The full documentation for ddrescuelog is maintained as a Texinfo manual. If the info and ddrescuelog programs are properly installed at your site, the command

info ddrescue

should give you access to the complete manual.

Updated 2024-01-29 - jenkler.se | uex.se