15 Invoking ddrescuelog

The format for running ddrescuelog is:

ddrescuelog [options] mapfile

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.

Ddrescuelog supports the following options:

-h

--help

Print an informative help message describing the options and exit.

-V

--version

Print the version number of ddrescuelog on the standard output and exit.

-a old_types,new_types

--change-types=old_types,new_types

Change the status of every block in the rescue domain from one type in old_types to the corresponding type in new_types, much like the ‘tr’ command does, and write the resulting mapfile to standard output. old_types and new_types are strings of block status characters as defined in the chapter Mapfile structure (see Mapfile structure). Blocks whose status is not in old_types are left unchanged. If new_types is shorter than old_types the last type of new_types is repeated as many times as necessary.

-A

--annotate-mapfile

Add comments containing the human-readable positions and sizes of the blocks in mapfile which are included in the rescue domain, and write the resulting mapfile to standard output.

-b bytes

--block-size=bytes

Block size used by ddrescuelog. Depending on the requested operation it may be the sector size of the input device, the block size of the rescued file system, etc. Defaults to 512.

-B

--binary-prefixes

Show units with binary prefixes (powers of 1024).
SI prefixes (powers of 1000) are used by default. (See table above, Invoking ddrescue).

-c[type1type2]

--create-mapfile[=type1type2]

Create a mapfile from a list of block numbers read from standard input. Only blocks included in the rescue domain will be added to mapfile.

type1 and type2 are block status characters as defined in the chapter Mapfile structure (see Mapfile structure). type1 sets the type for blocks included in the list, while type2 sets the type for the rest of mapfile. If not specified, type1 defaults to ‘+’ and type2 defaults to ‘-’.

-C[type]

--complete-mapfile[=type]

Complete a synthetic (user fabricated) mapfile by filling the gaps with blocks of type type, and write the completed mapfile to standard output. type is one of the block status characters defined in the chapter Mapfile structure (see Mapfile structure). If type is not specified, the gaps are filled with non-tried blocks. All gaps in mapfile are filled. Domain options are ignored.

-d

--delete-if-done

Delete the given mapfile if all the blocks in the rescue domain have been successfully recovered. The exit status is 0 if mapfile could be deleted, 1 otherwise.

-D

--done-status

Test if all the blocks in the rescue domain have been successfully recovered. The exit status is 0 if all tested blocks are finished, 1 otherwise.

-f

--force

Force overwrite of mapfile.

-i bytes

--input-position=bytes

Starting position of the rescue domain, in bytes. Defaults to 0. It refers to a position in the original infile.

-l types

--list-blocks=types

Print on standard output the block numbers of the blocks specified as any of types in mapfile and included in the rescue domain. types contains one or more of the block status characters defined in the chapter Mapfile structure (see Mapfile structure).

The list format is one block number per line in decimal, like the output of the badblocks program, so that it can be used as input for e2fsck or other similar filesystem repairing tool.

-L

--loose-domain

Accept an incomplete synthetic (user fabricated) domain mapfile or compare-as-domain mapfile and fill the gaps in the list of data blocks with non-tried blocks. The blocks in the mapfile must be strictly ascending and non-overlapping, but they don’t need to be contiguous. This option allows making quick edits to a mapfile without all the size calculations involved in making all data blocks contiguous again.

-m file

--domain-mapfile=file

Restrict the rescue domain to the blocks marked as finished in the mapfile file.

-n

--invert-mapfile

Invert the types of the blocks in mapfile which are included in the rescue domain, and write the resulting mapfile to standard output. Finished blocks (‘+’) are changed to bad-sector (‘-’), all other types are changed to finished. ‘--invert-mapfile’ is equivalent to ‘--change-types=?*/-+,++++-’

-o bytes

--output-position=bytes

Starting position of the image of the rescue domain in the original outfile, in bytes. Is used by the ‘--list-blocks’ option. Defaults to ‘--input-position’.

-p file

--compare-mapfile=file

Compare the types of the blocks included in the rescue domain. The exit status is 0 if all the blocks tested are the same in both file and mapfile, 1 otherwise.

-P file

--compare-as-domain=file

Compare only the blocks marked as finished in the rescue domain. The exit status is 0 if all the blocks tested are the same in both file and mapfile, 1 otherwise. Two files comparing equal with this option are equivalent when used as domain mapfiles.

-q

--quiet

Quiet operation. Suppress all messages.

-s bytes

--size=bytes

Maximum size of the rescue domain in bytes. It refers to a size in the original infile.

-t

--show-status

Print a summary of the contents of each mapfile to the standard output. This option allows more than one mapfile. If the domain setting options are used, the summary can be restricted to one or several parts of mapfile.

-v

--verbose

Verbose mode. Further -v’s (up to 4) increase the verbosity level.

-x file

--xor-mapfile=file

Perform a logical XOR (exclusive OR) operation between the finished blocks in file and those in mapfile, and write the resulting mapfile to standard output. In other words, in the resulting mapfile a block is only shown as finished if it was finished in either of the two input mapfiles but not in both.

-y file

--and-mapfile=file

Perform a logical AND operation between the finished blocks in file and those in mapfile, and write the resulting mapfile to standard output. In other words, in the resulting mapfile a block is only shown as finished if it was finished in both input mapfiles.

-z file

--or-mapfile=file

Perform a logical OR operation between the finished blocks in file and those in mapfile, and write the resulting mapfile to standard output. In other words, in the resulting mapfile a block is shown as finished if it was finished in either of the two input mapfiles.

--shift

Shift the positions of all the blocks in mapfile by the offset (‘--output-position’ - ‘--input-position’), and write the resulting mapfile to standard output. Either ‘--input-position’ or ‘--output-position’ must be 0. If the offset is positive, a non-tried block is inserted before the first block. Any blocks beyond the end of the rescue domain are removed before performing the shift.

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.