Current File : //proc/309157/task/309157/root/usr/share/doc/gddrescue/html/Mapfile-structure.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">
<title>Mapfile structure (GNU ddrescue Manual)</title>
<meta name="description" content="Mapfile structure (GNU ddrescue Manual)">
<meta name="keywords" content="Mapfile structure (GNU ddrescue Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="Concept-index.html" rel="index" title="Concept index">
<link href="index.html" rel="up" title="Top">
<link href="Emergency-save.html" rel="next" title="Emergency save">
<link href="Invoking-ddrescue.html" rel="prev" title="Invoking ddrescue">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="Mapfile-structure"></span><div class="header">
<p>
Next: <a href="Emergency-save.html" accesskey="n" rel="next">Emergency save</a>, Previous: <a href="Invoking-ddrescue.html" accesskey="p" rel="prev">Invoking ddrescue</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="Concept-index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Mapfile-structure-1"></span><h2 class="chapter">7 Mapfile structure</h2>
<span id="index-mapfile-structure"></span>
<p>NOTE: In versions of ddrescue prior to 1.20 the mapfile was called
‘<samp>logfile</samp>’. The format is the same; only the name has changed.
</p>
<p>The mapfile 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. The character ‘<samp>#</samp>’ at begin of line or after whitespace
starts a comment that extends to the end of the line.
</p>
<p>The heading comments contain the version of ddrescue or ddrescuelog that
created the mapfile, the command line used, and the time when the
program started. If the mapfile was created by ddrescue it will also
contain the current time when the mapfile was saved and a copy of the
status message from the screen describing the operation being performed
(copying, trimming, finished, etc). They are intended as information for
the user.
</p>
<p>The first non-comment line is the status line. It contains a
non-negative integer, a status character, and a positive decimal
integer. The first integer is the position being tried in the input
file. (The beginning of the block being tried in a forward pass or the
end of the block in a backward pass). The status character is one of
these:
</p>
<table>
<tr><td>Character</td><td>Meaning</td></tr>
<tr><td>’?’</td><td>copying non-tried blocks</td></tr>
<tr><td>’*’</td><td>trimming non-trimmed blocks</td></tr>
<tr><td>’/’</td><td>scraping non-scraped blocks</td></tr>
<tr><td>’-’</td><td>retrying bad sectors</td></tr>
<tr><td>’F’</td><td>filling specified blocks</td></tr>
<tr><td>’G’</td><td>generating approximate mapfile</td></tr>
<tr><td>’+’</td><td>finished</td></tr>
</table>
<p>Finally, the last integer is the number of the current pass in the
current phase. The status line allows ddrescue to resume the copying
phase instead of restarting it from pass 1. It also allows the retrying
phase to resume in the same direction it was interrupted.
</p>
<p>The blocks in the list of data blocks must be contiguous and
non-overlapping.
</p>
<p>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:
</p>
<table>
<tr><td>Character</td><td>Meaning</td></tr>
<tr><td>’?’</td><td>non-tried block</td></tr>
<tr><td>’*’</td><td>failed block non-trimmed</td></tr>
<tr><td>’/’</td><td>failed block non-scraped</td></tr>
<tr><td>’-’</td><td>failed block bad-sector(s)</td></tr>
<tr><td>’+’</td><td>finished block</td></tr>
</table>
<p>And here is an example mapfile:
</p>
<div class="example">
<pre class="example"># Mapfile. Created by GNU ddrescue version 1.23
# Command line: ddrescue -d -c18 /dev/fd0 fdimage mapfile
# Start time: 2015-07-21 09:37:44
# Current time: 2015-07-21 09:38:19
# Copying non-tried blocks... Pass 1 (forwards)
# current_pos current_status current_pass
0x00120000 ? 1
# pos size status
0x00000000 0x00117000 +
0x00117000 0x00000200 -
0x00117200 0x00001000 /
0x00118200 0x00007E00 *
0x00120000 0x00048000 ?
</pre></div>
<p>If you edit the file, you may use decimal, hexadecimal or octal values,
using the same syntax as integer constants in C++, except for
current_pass, which must be a decimal integer.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Emergency-save.html" accesskey="n" rel="next">Emergency save</a>, Previous: <a href="Invoking-ddrescue.html" accesskey="p" rel="prev">Invoking ddrescue</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="Concept-index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
Mini Shell