/usr/share/doc/gddrescue/html/Invoking-ddrescuelog.html is in gddrescue 1.22-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<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">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-index.html#Concept-index" rel="index" title="Concept index">
<link href="index.html#Top" rel="up" title="Top">
<link href="Problems.html#Problems" rel="next" title="Problems">
<link href="Ddrescuelog.html#Ddrescuelog" rel="prev" title="Ddrescuelog">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
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">
<a name="Invoking-ddrescuelog"></a>
<div class="header">
<p>
Next: <a href="Problems.html#Problems" accesskey="n" rel="next">Problems</a>, Previous: <a href="Ddrescuelog.html#Ddrescuelog" accesskey="p" rel="prev">Ddrescuelog</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Invoking-ddrescuelog-1"></a>
<h2 class="chapter">14 Invoking ddrescuelog</h2>
<a name="index-invoking-ddrescuelog"></a>
<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">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">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">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">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">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>
</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#Problems" accesskey="n" rel="next">Problems</a>, Previous: <a href="Ddrescuelog.html#Ddrescuelog" accesskey="p" rel="prev">Ddrescuelog</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|