1DDRESCUELOG(1) User Commands DDRESCUELOG(1)
2
3
4
6 ddrescuelog - tool for ddrescue mapfiles
7
9 ddrescuelog [options] mapfile
10
12 GNU ddrescuelog - Tool for ddrescue mapfiles. Manipulates ddrescue
13 mapfiles, shows their contents, converts them to/from other formats,
14 compares them, and tests rescue status.
15
16 NOTE: In versions of ddrescue prior to 1.20 the mapfile was called
17 'logfile'. The format is the same; only the name has changed.
18
20 -h, --help
21 display this help and exit
22
23 -V, --version
24 output version information and exit
25
26 -a, --change-types=<ot>,<nt>
27 change the block types of mapfile
28
29 -A, --annotate-mapfile
30 add comments with human-readable pos/sizes
31
32 -b, --block-size=<bytes>
33 block size in bytes [default 512]
34
35 -B, --binary-prefixes
36 show binary multipliers in numbers [SI]
37
38 -c, --create-mapfile[=<tt>]
39 create mapfile from list of blocks [+-]
40
41 -C, --complete-mapfile[=<t>]
42 complete mapfile adding blocks of type t [?]
43
44 -d, --delete-if-done
45 delete the mapfile if rescue is finished
46
47 -D, --done-status
48 return 0 if rescue is finished
49
50 -f, --force
51 overwrite existing output files
52
53 -i, --input-position=<bytes>
54 starting position of rescue domain [0]
55
56 -l, --list-blocks=<types>
57 print block numbers of given types (?*/-+)
58
59 -L, --loose-domain
60 accept an incomplete domain mapfile
61
62 -m, --domain-mapfile=<file>
63 restrict domain to finished blocks in file
64
65 -n, --invert-mapfile
66 invert block types (finished <--> others)
67
68 -o, --output-position=<bytes>
69 starting position in output file [ipos]
70
71 -p, --compare-mapfile=<file>
72 compare block types in domain of both files
73
74 -P, --compare-as-domain=<file>
75 like -p but compare finished blocks only
76
77 -q, --quiet
78 suppress all messages
79
80 -s, --size=<bytes>
81 maximum size of rescue domain to be processed
82
83 -t, --show-status
84 show a summary of mapfile contents
85
86 -v, --verbose
87 be verbose (a 2nd -v gives more)
88
89 -x, --xor-mapfile=<file>
90 XOR the finished blocks in file with mapfile
91
92 -y, --and-mapfile=<file>
93 AND the finished blocks in file with mapfile
94
95 -z, --or-mapfile=<file>
96 OR the finished blocks in file with mapfile
97
98 --shift
99 shift all block positions by (opos - ipos)
100
101 Use '-' to read a mapfile from standard input or to write the mapfile
102 created by '--create-mapfile' to standard output. Numbers may be in
103 decimal, hexadecimal or octal, and may be followed by a multiplier: s =
104 sectors, k = 1000, Ki = 1024, M = 10^6, Mi = 2^20, etc...
105
106 Exit status: 0 for a normal exit, 1 for environmental problems (file
107 not found, invalid flags, I/O errors, etc), 2 to indicate a corrupt or
108 invalid input file, 3 for an internal consistency error (eg, bug) which
109 caused ddrescuelog to panic.
110
112 Report bugs to bug-ddrescue@gnu.org
113 Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
114 General help using GNU software: http://www.gnu.org/gethelp
115
117 Copyright © 2018 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2
118 or later <http://gnu.org/licenses/gpl.html>
119 This is free software: you are free to change and redistribute it.
120 There is NO WARRANTY, to the extent permitted by law.
121
122
123
124ddrescuelog 1.23 February 2018 DDRESCUELOG(1)