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       NOTE:  In  versions  of  ddrescue  prior to 1.20 the mapfile was called
19       'logfile'. The format is the same; only the name has changed.
20

OPTIONS

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

REPORTING BUGS

114       Report bugs to bug-ddrescue@gnu.org
115       Ddrescue home page: http://www.gnu.org/software/ddrescue/ddrescue.html
116       General help using GNU software: http://www.gnu.org/gethelp
117

119       Copyright © 2019 Antonio Diaz Diaz.  License GPLv2+: GNU GPL version  2
120       or later <http://gnu.org/licenses/gpl.html>
121       This  is  free  software:  you  are free to change and redistribute it.
122       There is NO WARRANTY, to the extent permitted by law.
123
124
125
126ddrescuelog 1.24                 February 2019                  DDRESCUELOG(1)
Impressum