Man page - ddrescuelog(1)

Packages contains this manual

Package: gddrescue
apt-get install gddrescue

Manuals in package:

Documentations in package:

gddrescue

Manual

DDRESCUELOG

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
REPORTING BUGS
COPYRIGHT
SEE ALSO

NAME

ddrescuelog - tool for ddrescue mapfiles

SYNOPSIS

ddrescuelog [ options ] mapfile

DESCRIPTION

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.

OPTIONS

-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

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

COPYRIGHT

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