1DDRESCUELOG(1) User Commands DDRESCUELOG(1)
2
3
4
6 ddrescuelog - tool for ddrescue mapfiles
7
9 ddrescuelog [options] mapfile
10
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
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
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)