.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.37.1.
.TH DDRESCUE "1" "June 2012" "ddrescue 1.16" "User Commands"
.SH NAME
ddrescue \- data recovery tool
.SH SYNOPSIS
.B ddrescue
[\fIoptions\fR] \fIinfile outfile \fR[\fIlogfile\fR]
.SH DESCRIPTION
GNU ddrescue \- Data recovery tool.
Copies data from one file or block device to another,
trying hard to rescue data in case of read errors.
.PP
You should use a logfile unless you know what you are doing.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
output version information and exit
.TP
\fB\-a\fR, \fB\-\-min\-read\-rate=\fR<bytes>
minimum read rate of good areas in bytes/s
.TP
\fB\-A\fR, \fB\-\-try\-again\fR
mark non\-split, non\-trimmed blocks as non\-tried
.TP
\fB\-b\fR, \fB\-\-block\-size=\fR<bytes>
sector size of input device [default 512]
.TP
\fB\-B\fR, \fB\-\-binary\-prefixes\fR
show binary multipliers in numbers [SI]
.TP
\fB\-c\fR, \fB\-\-cluster\-size=\fR<sectors>
sectors to copy at a time [128]
.TP
\fB\-C\fR, \fB\-\-complete\-only\fR
do not read new data beyond logfile limits
.TP
\fB\-d\fR, \fB\-\-direct\fR
use direct disc access for input file
.TP
\fB\-D\fR, \fB\-\-synchronous\fR
use synchronous writes for output file
.TP
\fB\-e\fR, \fB\-\-max\-errors\fR=\fI[\fR+]<n>
maximum number of [new] error areas allowed
.TP
\fB\-E\fR, \fB\-\-max\-error\-rate=\fR<bytes>
maximum allowed rate of read errors per second
.TP
\fB\-f\fR, \fB\-\-force\fR
overwrite output device or partition
.TP
\fB\-F\fR, \fB\-\-fill=\fR<types>
fill given type blocks with infile data (?*/\-+)
.TP
\fB\-g\fR, \fB\-\-generate\-logfile\fR
generate approximate logfile from partial copy
.TP
\fB\-i\fR, \fB\-\-input\-position=\fR<bytes>
starting position in input file [0]
.TP
\fB\-I\fR, \fB\-\-verify\-input\-size\fR
verify input file size with size in logfile
.TP
\fB\-K\fR, \fB\-\-skip\-size=\fR<bytes>
initial size to skip on read error [64 KiB]
.TP
\fB\-m\fR, \fB\-\-domain\-logfile=\fR<file>
restrict domain to finished blocks in file
.TP
\fB\-M\fR, \fB\-\-retrim\fR
mark all failed blocks as non\-trimmed
.TP
\fB\-n\fR, \fB\-\-no\-split\fR
do not try to split or retry failed blocks
.TP
\fB\-o\fR, \fB\-\-output\-position=\fR<bytes>
starting position in output file [ipos]
.TP
\fB\-p\fR, \fB\-\-preallocate\fR
preallocate space on disc for output file
.TP
\fB\-q\fR, \fB\-\-quiet\fR
suppress all messages
.TP
\fB\-r\fR, \fB\-\-max\-retries=\fR<n>
exit after given retries (\fB\-1\fR=\fIinfinity\fR) [0]
.TP
\fB\-R\fR, \fB\-\-reverse\fR
reverse direction of copy operations
.TP
\fB\-s\fR, \fB\-\-max\-size=\fR<bytes>
maximum size of input data to be copied
.TP
\fB\-S\fR, \fB\-\-sparse\fR
use sparse writes for output file
.TP
\fB\-t\fR, \fB\-\-truncate\fR
truncate output file to zero size
.TP
\fB\-T\fR, \fB\-\-timeout=\fR<interval>
maximum time since last successful read
.TP
\fB\-v\fR, \fB\-\-verbose\fR
be verbose (a 2nd \fB\-v\fR gives more)
.TP
\fB\-x\fR, \fB\-\-extend\-outfile=\fR<bytes>
extend outfile size to be at least this long
.PP
Numbers may be followed by a multiplier: b = blocks, k = kB = 10^3 = 1000,
Ki = KiB = 2^10 = 1024, M = 10^6, Mi = 2^20, G = 10^9, Gi = 2^30, etc...
Time intervals have the format 1[.5][smhd] or 1/2[smhd].
.SH "REPORTING BUGS"
Report bugs to bug\-ddrescue@gnu.org
.br
Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
.br
General help using GNU software: http://www.gnu.org/gethelp
.SH COPYRIGHT
Copyright \(co 2012 Antonio Diaz Diaz.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B ddrescue
is maintained as a Texinfo manual.  If the
.B info
and
.B ddrescue
programs are properly installed at your site, the command
.IP
.B info ddrescue
.PP
should give you access to the complete manual.