Man1 - ddrescuelog.1

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 ’-’ 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 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

-i, *–input-position=*<bytes>

starting position of rescue domain [0]

-l, *–list-blocks=*<types>

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

-L, –loose-domain

accept an incomplete domain mapfile

-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

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 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 bug-ddrescue@gnu.org
Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
General help using GNU software: http://www.gnu.org/gethelp

Copyright © 2020 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.