12 Invoking ddrescuelog

The format for running ddrescuelog is:

ddrescuelog [options] logfile

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 logfile to standard output. old_types and new_types are strings of block status characters as defined in the chapter Logfile structure (see section Logfile 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.

‘-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.

‘-c[type1type2]’

‘--create-logfile[=type1type2]’

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

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

‘-d’

‘--delete-if-done’

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

‘-D’

‘--done-status’

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

‘-f’

‘--force’

Force overwrite of logfile.

‘-i bytes’

‘--input-position=bytes’

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

‘-l types’

‘--list-blocks=types’

Print on standard output the block numbers of the blocks specified as any of types in logfile and included in the rescue domain. types contains one or more of the block status characters defined in the chapter Logfile structure (see section Logfile 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.

‘-m file’

‘--domain-logfile=file’

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

‘-n’

‘--invert-logfile’

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

‘-o bytes’

‘--output-position=bytes’

Starting position in output file, in bytes. Is used by the ‘--list-blocks’ option. Defaults to ‘--input-position’.

‘-p file’

‘--compare-logfile=file’

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

‘-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 input file.

‘-t’

‘--show-status’

Print a summary of logfile contents on the standard output. The summary can be restricted to one or several parts of logfile if the domain setting options are used.

‘-v’

‘--verbose’

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

‘-x file’

‘--xor-logfile=file’

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

‘-y file’

‘--and-logfile=file’

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

‘-z file’

‘--or-logfile=file’

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

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.

This document was generated on August 24, 2013 using texi2html 5.0.