1DDRESCUELOG(1)                   User Commands                  DDRESCUELOG(1)
2
3
4

NAME

6       ddrescuelog - tool for ddrescue mapfiles
7

SYNOPSIS

9       ddrescuelog [options] mapfile
10

DESCRIPTION

12       GNU  ddrescuelog  is  a  tool that manipulates ddrescue mapfiles, shows
13       mapfile contents, converts mapfiles  to/from  other  formats,  compares
14       mapfiles,  tests  rescue status, and can delete a mapfile if the rescue
15       is done. Ddrescuelog operations can be restricted  to  one  or  several
16       parts of the mapfile if the domain setting options are used.
17
18       Use '-' as mapfile to read the mapfile from standard input (also in the
19       options taking a mapfile argument) or to write the mapfile  created  by
20       '--create-mapfile' to standard output.
21
22       NOTE:  In  versions  of  ddrescue  prior to 1.20 the mapfile was called
23       'logfile'. The format is the same; only the name has changed.
24

OPTIONS

26       -h, --help
27              display this help and exit
28
29       -V, --version
30              output version information and exit
31
32       -a, --change-types=<ot>,<nt>
33              change the block types of mapfile
34
35       -A, --annotate-mapfile
36              add comments with human-readable pos/sizes
37
38       -b, --block-size=<bytes>
39              block size in bytes [default 512]
40
41       -B, --binary-prefixes
42              show binary multipliers in numbers [SI]
43
44       -c, --create-mapfile[=<tt>]
45              create mapfile from list of blocks [+-]
46
47       -C, --complete-mapfile[=<t>]
48              complete mapfile adding blocks of type t [?]
49
50       -d, --delete-if-done
51              delete the mapfile if rescue is finished
52
53       -D, --done-status
54              return 0 if rescue is finished
55
56       -f, --force
57              overwrite existing output files
58
59       -i, --input-position=<bytes>
60              starting position of rescue domain [0]
61
62       -l, --list-blocks=<types>
63              print block numbers of given types (?*/-+)
64
65       -L, --loose-domain
66              accept an incomplete domain mapfile
67
68       -m, --domain-mapfile=<file>
69              restrict domain to finished blocks in file
70
71       -n, --invert-mapfile
72              invert block types (finished <--> others)
73
74       -o, --output-position=<bytes>
75              starting position in output file [ipos]
76
77       -p, --compare-mapfile=<file>
78              compare block types in domain of both files
79
80       -P, --compare-as-domain=<file>
81              like -p but compare finished blocks only
82
83       -q, --quiet
84              suppress all messages
85
86       -s, --size=<bytes>
87              maximum size of rescue domain to be processed
88
89       -t, --show-status
90              show a summary of mapfile contents
91
92       -v, --verbose
93              be verbose (a 2nd -v gives more)
94
95       -x, --xor-mapfile=<file>
96              XOR the finished blocks in file with mapfile
97
98       -y, --and-mapfile=<file>
99              AND the finished blocks in file with mapfile
100
101       -z, --or-mapfile=<file>
102              OR the finished blocks in file with mapfile
103
104       --shift
105              shift all block positions by (opos - ipos)
106
107       Numbers may be in decimal, hexadecimal, or octal, and may  be  followed
108       by a multiplier: s = sectors, k = 1000, Ki = 1024, M = 10^6, Mi = 2^20,
109       etc...
110
111       Exit status: 0 for a normal exit, 1 for  environmental  problems  (file
112       not  found, invalid flags, I/O errors, etc), 2 to indicate a corrupt or
113       invalid input file, 3 for an internal consistency error (eg, bug) which
114       caused ddrescuelog to panic.
115

REPORTING BUGS

117       Report bugs to bug-ddrescue@gnu.org
118       Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
119       General help using GNU software: http://www.gnu.org/gethelp
120
122       Copyright  © 2020 Antonio Diaz Diaz.  License GPLv2+: GNU GPL version 2
123       or later <http://gnu.org/licenses/gpl.html>
124       This is free software: you are free  to  change  and  redistribute  it.
125       There is NO WARRANTY, to the extent permitted by law.
126
127
128
129ddrescuelog 1.25                 February 2020                  DDRESCUELOG(1)
Impressum