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
       'logfile'. 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 indi-
       cate a corrupt or invalid input file, 3 for an internal consistency er-
       ror (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  man-
       ual.   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+14.3.quarterly>

home | help