Current File : //proc/309157/task/309157/root/usr/share/doc/gddrescue/html/Invoking-ddrescuelog.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>Invoking ddrescuelog (GNU ddrescue Manual)</title>
<meta name="description" content="Invoking ddrescuelog (GNU ddrescue Manual)">
<meta name="keywords" content="Invoking ddrescuelog (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="Problems.html" rel="next" title="Problems">
<link href="Ddrescuelog.html" rel="prev" title="Ddrescuelog">
<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="Invoking-ddrescuelog"></span><div class="header">
<p>
Next: <a href="Problems.html" accesskey="n" rel="next">Problems</a>, Previous: <a href="Ddrescuelog.html" accesskey="p" rel="prev">Ddrescuelog</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="Invoking-ddrescuelog-1"></span><h2 class="chapter">15 Invoking ddrescuelog</h2>
<span id="index-invoking-ddrescuelog"></span>
<p>The format for running ddrescuelog is:
</p>
<div class="example">
<pre class="example">ddrescuelog [<var>options</var>] <var>mapfile</var>
</pre></div>
<p>Use ‘<samp>-</samp>’ as <var>mapfile</var> to read the mapfile from standard input
(also in the options taking a mapfile argument) or to write the mapfile
created by ‘<samp>--create-mapfile</samp>’ to standard output.
</p>
<p>Ddrescuelog supports the following options:
</p>
<dl compact="compact">
<dt><code>-h</code></dt>
<dt><code>--help</code></dt>
<dd><p>Print an informative help message describing the options and exit.
</p>
</dd>
<dt><code>-V</code></dt>
<dt><code>--version</code></dt>
<dd><p>Print the version number of ddrescuelog on the standard output and exit.
</p>
</dd>
<dt><code>-a <var>old_types</var>,<var>new_types</var></code></dt>
<dt><code>--change-types=<var>old_types</var>,<var>new_types</var></code></dt>
<dd><p>Change the status of every block in the rescue domain from one type in
<var>old_types</var> to the corresponding type in <var>new_types</var>, much like
the ‘<samp>tr</samp>’ command does, and write the resulting mapfile to standard
output. <var>old_types</var> and <var>new_types</var> are strings of block status
characters as defined in the chapter Mapfile structure (see <a href="Mapfile-structure.html">Mapfile structure</a>). Blocks whose status is not in <var>old_types</var> are left
unchanged. If <var>new_types</var> is shorter than <var>old_types</var> the last
type of <var>new_types</var> is repeated as many times as necessary.
</p>
</dd>
<dt><code>-A</code></dt>
<dt><code>--annotate-mapfile</code></dt>
<dd><p>Add comments containing the human-readable positions and sizes of the
blocks in <var>mapfile</var> which are included in the rescue domain, and
write the resulting mapfile to standard output.
</p>
</dd>
<dt><code>-b <var>bytes</var></code></dt>
<dt><code>--block-size=<var>bytes</var></code></dt>
<dd><p>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.
</p>
</dd>
<dt><code>-B</code></dt>
<dt><code>--binary-prefixes</code></dt>
<dd><p>Show units with binary prefixes (powers of 1024).<br>
SI prefixes (powers of 1000) are used by default. (See table above,
<a href="Invoking-ddrescue.html">Invoking ddrescue</a>).
</p>
</dd>
<dt><code>-c[<var>type1</var><var>type2</var>]</code></dt>
<dt><code>--create-mapfile[=<var>type1</var><var>type2</var>]</code></dt>
<dd><p>Create a <var>mapfile</var> from a list of block numbers read from standard
input. Only blocks included in the rescue domain will be added to
<var>mapfile</var>.
</p>
<p><var>type1</var> and <var>type2</var> are block status characters as defined in
the chapter Mapfile structure (see <a href="Mapfile-structure.html">Mapfile structure</a>). <var>type1</var>
sets the type for blocks included in the list, while <var>type2</var> sets
the type for the rest of <var>mapfile</var>. If not specified, <var>type1</var>
defaults to ‘<samp>+</samp>’ and <var>type2</var> defaults to ‘<samp>-</samp>’.
</p>
</dd>
<dt><code>-C[<var>type</var>]</code></dt>
<dt><code>--complete-mapfile[=<var>type</var>]</code></dt>
<dd><p>Complete a synthetic (user fabricated) <var>mapfile</var> by filling the gaps
with blocks of type <var>type</var>, and write the completed mapfile to
standard output. <var>type</var> is one of the block status characters
defined in the chapter Mapfile structure (see <a href="Mapfile-structure.html">Mapfile structure</a>). If
<var>type</var> is not specified, the gaps are filled with non-tried blocks.
All gaps in <var>mapfile</var> are filled. Domain options are ignored.
</p>
</dd>
<dt><code>-d</code></dt>
<dt><code>--delete-if-done</code></dt>
<dd><p>Delete the given <var>mapfile</var> if all the blocks in the rescue domain
have been successfully recovered. The exit status is 0 if <var>mapfile</var>
could be deleted, 1 otherwise.
</p>
</dd>
<dt><code>-D</code></dt>
<dt><code>--done-status</code></dt>
<dd><p>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.
</p>
</dd>
<dt><code>-f</code></dt>
<dt><code>--force</code></dt>
<dd><p>Force overwrite of <var>mapfile</var>.
</p>
</dd>
<dt><code>-i <var>bytes</var></code></dt>
<dt><code>--input-position=<var>bytes</var></code></dt>
<dd><p>Starting position of the rescue domain, in bytes. Defaults to 0. It
refers to a position in the original <var>infile</var>.
</p>
</dd>
<dt><code>-l <var>types</var></code></dt>
<dt><code>--list-blocks=<var>types</var></code></dt>
<dd><p>Print on standard output the block numbers of the blocks specified as
any of <var>types</var> in <var>mapfile</var> and included in the rescue domain.
<var>types</var> contains one or more of the block status characters defined
in the chapter Mapfile structure (see <a href="Mapfile-structure.html">Mapfile structure</a>).
</p>
<p>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.
</p>
</dd>
<dt><code>-L</code></dt>
<dt><code>--loose-domain</code></dt>
<dd><p>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.
</p>
</dd>
<dt><code>-m <var>file</var></code></dt>
<dt><code>--domain-mapfile=<var>file</var></code></dt>
<dd><p>Restrict the rescue domain to the blocks marked as finished in the
mapfile <var>file</var>.
</p>
</dd>
<dt><code>-n</code></dt>
<dt><code>--invert-mapfile</code></dt>
<dd><p>Invert the types of the blocks in <var>mapfile</var> which are included in
the rescue domain, and write the resulting mapfile to standard output.
Finished blocks (‘<samp>+</samp>’) are changed to bad-sector (‘<samp>-</samp>’), all
other types are changed to finished. ‘<samp>--invert-mapfile</samp>’ is
equivalent to ‘<samp>--change-types=?*/-+,++++-</samp>’
</p>
</dd>
<dt><code>-o <var>bytes</var></code></dt>
<dt><code>--output-position=<var>bytes</var></code></dt>
<dd><p>Starting position of the image of the rescue domain in the original
<var>outfile</var>, in bytes. Is used by the ‘<samp>--list-blocks</samp>’ option.
Defaults to ‘<samp>--input-position</samp>’.
</p>
</dd>
<dt><code>-p <var>file</var></code></dt>
<dt><code>--compare-mapfile=<var>file</var></code></dt>
<dd><p>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 <var>file</var> and
<var>mapfile</var>, 1 otherwise.
</p>
</dd>
<dt><code>-P <var>file</var></code></dt>
<dt><code>--compare-as-domain=<var>file</var></code></dt>
<dd><p>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
<var>file</var> and <var>mapfile</var>, 1 otherwise. Two files comparing equal
with this option are equivalent when used as domain mapfiles.
</p>
</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd><p>Quiet operation. Suppress all messages.
</p>
</dd>
<dt><code>-s <var>bytes</var></code></dt>
<dt><code>--size=<var>bytes</var></code></dt>
<dd><p>Maximum size of the rescue domain in bytes. It refers to a size in the
original <var>infile</var>.
</p>
</dd>
<dt><code>-t</code></dt>
<dt><code>--show-status</code></dt>
<dd><p>Print a summary of the contents of each <var>mapfile</var> to the standard
output. This option allows more than one <var>mapfile</var>. If the domain
setting options are used, the summary can be restricted to one or
several parts of <var>mapfile</var>.
</p>
</dd>
<dt><code>-v</code></dt>
<dt><code>--verbose</code></dt>
<dd><p>Verbose mode. Further -v’s (up to 4) increase the verbosity level.
</p>
</dd>
<dt><code>-x <var>file</var></code></dt>
<dt><code>--xor-mapfile=<var>file</var></code></dt>
<dd><p>Perform a logical XOR (exclusive OR) operation between the finished
blocks in <var>file</var> and those in <var>mapfile</var>, 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.
</p>
</dd>
<dt><code>-y <var>file</var></code></dt>
<dt><code>--and-mapfile=<var>file</var></code></dt>
<dd><p>Perform a logical AND operation between the finished blocks in
<var>file</var> and those in <var>mapfile</var>, 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.
</p>
</dd>
<dt><code>-z <var>file</var></code></dt>
<dt><code>--or-mapfile=<var>file</var></code></dt>
<dd><p>Perform a logical OR operation between the finished blocks in <var>file</var>
and those in <var>mapfile</var>, 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.
</p>
</dd>
<dt><code>--shift</code></dt>
<dd><p>Shift the positions of all the blocks in <var>mapfile</var> by the offset
(‘<samp>--output-position</samp>’ - ‘<samp>--input-position</samp>’), and write the
resulting mapfile to standard output. Either ‘<samp>--input-position</samp>’ or
‘<samp>--output-position</samp>’ 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.
</p>
</dd>
</dl>
<p>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.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Problems.html" accesskey="n" rel="next">Problems</a>, Previous: <a href="Ddrescuelog.html" accesskey="p" rel="prev">Ddrescuelog</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