Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DDRESCUELOG(1)			  User Commands 		  DDRESCUELOG(1)

NAME
     ddrescuelog - tool for ddrescue mapfiles

SYNOPSIS
     ddrescuelog [options] mapfile

DESCRIPTION
     GNU ddrescuelog is a tool that manipulates ddrescue mapfiles, shows mapfile
     contents, converts mapfiles to/from other formats, compares mapfiles, tests
     rescue  status, and can delete a mapfile if the rescue is done. Ddrescuelog
     operations can be restricted to one or several parts of the mapfile if  the
     domain setting options are used.

     Use  a  hyphen '-' as mapfile to read the mapfile from standard input (also
     in the options taking a mapfile argument) or to write the	mapfile  created
     by '--create-mapfile' to standard output.

     NOTE:  In	versions  of ddrescue prior to 1.20 the mapfile was called 'log-
     file'. The format is the same; only the name has changed.

OPTIONS
     -h, --help
	    display this help and exit

     -V, --version
	    output version information and exit

     -a, --change-types=<ot>,<nt>
	    change the block types of mapfile

     -A, --annotate-mapfile
	    add comments with human-readable pos/sizes

     -b, --block-size=<bytes>
	    block (sector) size in bytes [default 512]

     -B, --binary-prefixes
	    show binary multipliers in numbers [SI]

     -c, --create-mapfile[=<tt>]
	    create mapfile from list of blocks [+-]

     -C, --complete-mapfile[=<t>]
	    complete mapfile adding blocks of type t [?]

     -d, --delete-if-done
	    delete the mapfile if rescue is finished

     -D, --done-status
	    return 0 if rescue is finished

     -f, --force
	    overwrite existing output files

     -F, --format=<name>
	    format for -c and -l (list, bitmap-[bl]e)

     -i, --input-position=<bytes>
	    starting position of rescue domain [0]

     -l, --list-blocks=<types>
	    print block numbers of given types (?*/-+)

     -L, --loose-domain
	    accept unordered domain mapfile with gaps

     -m, --domain-mapfile=<file>
	    restrict domain to finished blocks in <file>

     -n, --invert-mapfile
	    invert block types (finished <--> others)

     -o, --output-position=<bytes>
	    starting position in output file [ipos]

     -p, --compare-mapfile=<file>
	    compare block types in domain of both files

     -P, --compare-as-domain=<file>
	    like -p but compare finished blocks only

     -q, --quiet
	    suppress all messages

     -s, --size=<bytes>
	    maximum size of rescue domain to be processed

     -t, --show-status
	    show a summary of mapfile contents

     -v, --verbose
	    be verbose (a 2nd -v gives more)

     -x, --xor-mapfile=<file>
	    XOR the finished blocks in file with mapfile

     -y, --and-mapfile=<file>
	    AND the finished blocks in file with mapfile

     -z, --or-mapfile=<file>
	    OR the finished blocks in file with mapfile

     --shift
	    shift all block positions by (opos - ipos)

     Numbers may be in decimal, hexadecimal, or octal, and may be followed by  a
     multiplier: s = sectors, k = 1000, Ki = 1024, M = 10^6, Mi = 2^20, etc...

     Exit  status:  0  for a normal exit, 1 for environmental problems (file not
     found, invalid command line options, I/O errors, etc), 2 to indicate a cor-
     rupt or invalid input file, 3 for an internal consistency error (e.g., bug)
     which caused ddrescuelog to panic.

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

COPYRIGHT
     Copyright (C) 2023 Antonio Diaz Diaz.  License GPLv2+: GNU GPL version 2 or
     later <http://gnu.org/licenses/gpl.html>
     This is free software: you are free to change and redistribute  it.   There
     is NO WARRANTY, to the extent permitted by law.

SEE ALSO
     The  full	documentation for ddrescuelog is maintained as a Texinfo manual.
     If the info and ddrescuelog programs are properly installed at  your  site,
     the command

	    info ddrescue

     should give you access to the complete manual.

GNU ddrescuelog 1.27		  January 2023			  DDRESCUELOG(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ddrescuelog&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help