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

FreeBSD Manual Pages

  
 
  

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

NAME
       lziprecover - recovers data from	damaged	files

SYNOPSIS
       lziprecover [options] [files]

DESCRIPTION
       Lziprecover  is	a data recovery	tool and decompressor for files	in the
       lzip compressed data format (.lz). Lziprecover  also  provides  Forward
       Error Correction	(FEC) able to repair any kind of file.

       With  the help of lziprecover, losing an	entire archive just because of
       a corrupt byte near the beginning is a thing of the past.

       Lziprecover can remove the damaged members from multimember files,  for
       example multimember tar.lz archives.

       Lziprecover provides random access to the data in multimember files; it
       only decompresses the members containing	the desired data.

       Lziprecover  is	not a replacement for regular backups, but a last line
       of defense for the case where the backups are also damaged.

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

       -V, --version
	      output version information and exit

       -a, --trailing-error
	      exit with	error status if	trailing data

       -A, --alone-to-lz
	      convert lzma-alone files to lzip format

       -b, --block-size=<bytes>
	      make FEC block size a multiple of	<bytes>

       -B, --byte-repair
	      try to repair a corrupt byte in file

       -c, --stdout
	      write to standard	output,	keep input files

       -d, --decompress
	      decompress, test compressed file integrity

       -D, --range-decompress=<n-m>
	      decompress a range of bytes to stdout

       -e, --reproduce
	      try to reproduce a zeroed	sector in file

       --lzip-level=N|a|m[N]
	      reproduce	one level, all,	or match length

       --lzip-name=<name>
	      name of lzip executable for --reproduce

       --reference-file=<file>
	      reference	file for --reproduce

       -f, --force
	      overwrite	existing output	files

       -F, --fec=c[N]|r|t|l
	      create, repair, test, list (using) fec file

       -0 .. -9
	      set FEC fragmentation level [default 9]

       --fec-file=<file>[/]
	      read fec file from <file>	or directory

       -i, --ignore-errors
	      ignore non-fatal errors

       -k, --keep
	      keep (don't delete) input	files

       -l, --list
	      print (un)compressed file	sizes

       -m, --merge
	      repair errors in file using several copies

       -n, --threads=<n>
	      set number of threads for	fec create [2]

       -o, --output=<file>[/]
	      place the	output into <file> or directory

       -q, --quiet
	      suppress all messages

       -r, --recursive
	      (fec) operate recursively	on directories

       -R, --dereference-recursive
	      (fec) recursively	follow symbolic	links

       -s, --split
	      split multimember	file in	single-member files

       -t, --test
	      test compressed file integrity

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

       --dump=<list>:d:e:t
	      dump members, damaged/empty, tdata to stdout

       --remove=<list>:d:e:t
	      remove members, tdata from files in place

       --strip=<list>:d:e:t
	      copy files to stdout stripping members given

       --loose-trailing
	      allow trailing data seeming corrupt header

       --nonzero-repair
	      repair in	place a	nonzero	first LZMA byte

       If no file names	are given, or if a file	 is  '-',  lziprecover	decom-
       presses	from  standard	input to standard output.  Numbers may be fol-
       lowed by	a multiplier: k	= kB = 10^3 = 1000, Ki = KiB = 2^10 = 1024,  M
       =  10^6,	 Mi  =	2^20,  G  =  10^9,  Gi = 2^30, etc...  The argument to
       --fec=create may	be a number of blocks (-Fc20), a  percentage  (-Fc5%),
       or a size in bytes (-Fc10KiB).

       To  extract  all	 the files from	archive	'foo.tar.lz', use the commands
       'tar -xf	foo.tar.lz' or 'lziprecover -cd	foo.tar.lz | tar -xf -'.

       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 lziprecover	to panic.

REPORTING BUGS
       Report bugs to lzip-bug@nongnu.org
       Lziprecover home	page: http://www.nongnu.org/lzip/lziprecover.html

COPYRIGHT
       Copyright (C) 2025 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 lziprecover is maintained as a Texinfo  man-
       ual.   If  the  info and	lziprecover programs are properly installed at
       your site, the command

	      info lziprecover

       should give you access to the complete manual.

lziprecover 1.25		 January 2025			LZIPRECOVER(1)

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

home | help