Your company here — click to reach over 10,000 unique daily visitors

ddrescuelog - Man Page

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.

Reporting Bugs

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

See Also

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.


January 2024 GNU ddrescuelog 1.28