NAME

       xlunzip - test tool for the lzip_decompress linux module

SYNOPSIS

       xlunzip [options] [files]

DESCRIPTION

       Xlunzip  is a test tool for the lzip decompression code of my lzip patch for linux. Xlunzip is similar to
       lunzip, but it uses the lzip_decompress linux module as a backend. Xlunzip tests the module  for  stream,
       buffer-to-buffer,  and mixed decompression modes, including in-place decompression (using the same buffer
       for input and output). You can use xlunzip to verify  that  the  module  produces  correct  results  when
       decompressing  single  member  files,  multimember  files, or the concatenation of two or more compressed
       files.  Xlunzip can be used with unzcrash to test the robustness of the module to  the  decompression  of
       corrupted data.

       The  distributed  index  feature  of  the  lzip format allows xlunzip to decompress concatenated files in
       place. This can't be guaranteed to work with formats like gzip or bzip2 because they can't detect whether
       a  high  compression  ratio  in  the  first  members  of  the  multimember  data is being masked by a low
       compression ratio in the last members.

OPTIONS

       -h, --help
              display this help and exit

       -V, --version
              output version information and exit

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

       -d, --decompress
              decompress (this is the default)

       -f, --force
              overwrite existing output files

       -I, --in-place
              decompress or test using only one buffer

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

       -o, --output=<file>
              write to <file>, keep input files

       -q, --quiet
              suppress all messages

       -t, --test
              test compressed file integrity

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

   These options are ignored when --in-place is in effect:
       --insize[=<size>]
              pre-allocate and fill inbuf [default 16 KiB]

       --outsize[=<size>]
              pre-allocate outbuf [default 512 MiB]

       --nofill
              do not pass a fill function; requires --insize

       --noflush
              do not pass a flush function; requires --outsize

       If no file names are given, or if a file is '-', xlunzip 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 'xlunzip -cd
       foo.tar.lz | tar -xf -'.

       Exit  status:  0  for  a  normal  exit,  1 for environmental problems (file not found, invalid flags, I/O
       errors, etc), 2 to indicate a corrupt or invalid input file, 3 for an  internal  consistency  error  (eg,
       bug) which caused xlunzip to panic.

REPORTING BUGS

       Report bugs to lzip-bug@nongnu.org
       Xlunzip home page: http://www.nongnu.org/lzip/xlunzip.html

COPYRIGHT

       Copyright   ©   2021   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.