1DDRESCUELOG(1) User Commands DDRESCUELOG(1)
2
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 Use a hyphen '-' as mapfile to read the mapfile from standard input
19 (also in the options taking a mapfile argument) or to write the mapfile
20 created by '--create-mapfile' to standard output.
21 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 -V, --version
30 output version information and exit
31 -a, --change-types=<ot>,<nt>
33 change the block types of mapfile
34 -A, --annotate-mapfile
36 add comments with human-readable pos/sizes
37 -b, --block-size=<bytes>
39 block (sector) size in bytes [default 512]
40 -B, --binary-prefixes
42 show binary multipliers in numbers [SI]
43 -c, --create-mapfile[=<tt>]
45 create mapfile from list of blocks [+-]
46 -C, --complete-mapfile[=<t>]
48 complete mapfile adding blocks of type t [?]
49 -d, --delete-if-done
51 delete the mapfile if rescue is finished
52 -D, --done-status
54 return 0 if rescue is finished
55 -f, --force
57 overwrite existing output files
58 -F, --format=<name>
60 format for -c and -l (list, bitmap-[bl]e)
61 -i, --input-position=<bytes>
63 starting position of rescue domain [0]
64 -l, --list-blocks=<types>
66 print block numbers of given types (?*/-+)
67 -L, --loose-domain
69 accept unordered domain mapfile with gaps
70 -m, --domain-mapfile=<file>
72 restrict domain to finished blocks in <file>
73 -n, --invert-mapfile
75 invert block types (finished <--> others)
76 -o, --output-position=<bytes>
78 starting position in output file [ipos]
79 -p, --compare-mapfile=<file>
81 compare block types in domain of both files
82 -P, --compare-as-domain=<file>
84 like -p but compare finished blocks only
85 -q, --quiet
87 suppress all messages
88 -s, --size=<bytes>
90 maximum size of rescue domain to be processed
91 -t, --show-status
93 show a summary of mapfile contents
94 -v, --verbose
96 be verbose (a 2nd -v gives more)
97 -x, --xor-mapfile=<file>
99 XOR the finished blocks in file with mapfile
100 -y, --and-mapfile=<file>
102 AND the finished blocks in file with mapfile
103 -z, --or-mapfile=<file>
105 OR the finished blocks in file with mapfile
106 --shift
108 shift all block positions by (opos - ipos)
109 Numbers may be in decimal, hexadecimal, or octal, and may be followed
111 by a multiplier: s = sectors, k = 1000, Ki = 1024, M = 10^6, Mi = 2^20,
112 etc...
113 Exit status: 0 for a normal exit, 1 for environmental problems (file
115 not found, invalid command line options, I/O errors, etc), 2 to indi‐
116 cate a corrupt or invalid input file, 3 for an internal consistency er‐
117 ror (e.g., bug) which caused ddrescuelog to panic.
118
120 Report bugs to bug-ddrescue@gnu.org
121 Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
122 General help using GNU software: http://www.gnu.org/gethelp
123
125 Copyright © 2023 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2
126 or later <http://gnu.org/licenses/gpl.html>
127 This is free software: you are free to change and redistribute it.
128 There is NO WARRANTY, to the extent permitted by law.
129
131 The full documentation for ddrescuelog is maintained as a Texinfo man‐
132 ual. If the info and ddrescuelog programs are properly installed at
133 your site, the command
134 info ddrescue
136 should give you access to the complete manual.
138GNU ddrescuelog 1.27 January 2023 DDRESCUELOG(1)