lziprecover - Man Page

recovers data from damaged lzip files

Synopsis

lziprecover [options] [files]

Description

Lziprecover is a data recovery tool and decompressor for files in the lzip compressed data format (.lz). Lziprecover is able to repair slightly damaged files (up to one single-byte error per member), produce a correct file by merging the good parts of two or more damaged copies, reproduce a missing (zeroed) sector using a reference file, extract data from damaged files, decompress files, and test integrity of files.

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 facilitates the management of metadata stored as trailing data in lzip files.

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

-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

-i,  --ignore-errors

ignore some errors in -d, -D, -l, -t, --dump

-k,  --keep

keep (don't delete) input files

-l,  --list

print (un)compressed file sizes

-m,  --merge

repair errors in file using several copies

-o,  --output=<file>

place the output into <file>

-q,  --quiet

suppress all messages

-R,  --byte-repair

try to repair a corrupt byte in file

-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

--empty-error

exit with error status if empty member in file

--marking-error

exit with error status if 1st LZMA byte not 0

--loose-trailing

allow trailing data seeming corrupt header

--clear-marking

reset the first LZMA byte of each member

If no file names are given, or if a file is '-', lziprecover decompresses from standard input to standard output. Numbers may be followed 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...

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 indicate a corrupt or invalid input file, 3 for an internal consistency error (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

See Also

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

info lziprecover

should give you access to the complete manual.

Info

January 2024 lziprecover 1.24