manpagez: man pages & more
info ddrescue
Home | html | info | man
[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

5. Logfile Structure

The logfile is a text file easy to read and edit. It is formed by three parts, the heading comments, the status line, and the list of data blocks.

Any line beginning with ‘#’ is a comment line. The blocks in the list of data blocks must be contiguous and non-overlapping.

NOTE: Logfiles generated by a version of ddrescue prior to 1.6 lack the status line. If you want to use an old logfile with ddrescue 1.6 or later, you will have to insert a line like ‘0 +’ at the beginning of the logfile.

The heading comments contain the version of ddrescue and the command line used to create the logfile. They are intended as information for the user.

The first non-comment line is the status line. It contains a non-negative integer and a status character. The integer is the position being tried in the input file. The status character is one of these:

’?’copying non-tried blocks
’*’trimming non-trimmed blocks
’/’splitting non-split blocks
’-’retrying bad sectors
’F’filling specified blocks
’G’generating approximate logfile

Every line in the list of data blocks describes a block of data. It contains 2 non-negative integers and a status character. The first integer is the starting position of the block in the input file, the second integer is the size (in bytes) of the block. The status character is one of these:

’?’non-tried block
’*’failed block non-trimmed
’/’failed block non-split
’-’failed block bad-sector(s)
’+’finished block

And here is an example logfile:

# Rescue Logfile. Created by GNU ddrescue version 1.13
# Command line: ddrescue /dev/fd0 fdimage logfile
# current_pos current_status
0x00120000 ?
# pos size status


If you edit the file, you may use decimal, hexadecimal or octal values, using the same syntax that integer constants in C++.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]
© 2000-2018
Individual documents may contain additional copyright information.