NAME

       tarlz - creates tar archives with multimember lzip compression

SYNOPSIS

       tarlz operation [options] [files]

DESCRIPTION

       Tarlz is a massively parallel (multi-threaded) combined implementation of the tar archiver
       and the lzip compressor. Tarlz uses the compression library lzlib.

       Tarlz creates tar archives using a simplified and safer variant of the  POSIX  pax  format
       compressed in lzip format, keeping the alignment between tar members and lzip members. The
       resulting multimember tar.lz archive is backward compatible with standard tar  tools  like
       GNU  tar,  which treat it like any other tar.lz archive. Tarlz can append files to the end
       of such compressed archives.

       Keeping the alignment between tar members and lzip members has two advantages. It adds  an
       indexed  lzip  layer  on  top of the tar archive, making it possible to decode the archive
       safely in parallel. It also minimizes the amount of data lost in case of corruption.

       The tarlz file format is a safe POSIX-style backup format. In case  of  corruption,  tarlz
       can  extract  all the undamaged members from the tar.lz archive, skipping over the damaged
       members, just like the standard (uncompressed) tar. Moreover, the option  '--keep-damaged'
       can  be used to recover as much data as possible from each damaged member, and lziprecover
       can be used to recover some of the damaged members.

   Operations:
       --help display this help and exit

       -V, --version
              output version information and exit

       -A, --concatenate
              append archives to the end of an archive

       -c, --create
              create a new archive

       -d, --diff
              find differences between archive and file system

       --delete
              delete files/directories from an archive

       -r, --append
              append files to the end of an archive

       -t, --list
              list the contents of an archive

       -x, --extract
              extract files/directories from an archive

       -z, --compress
              compress existing POSIX tar archives

       --check-lib
              check version of lzlib and exit

OPTIONS

       -B, --data-size=<bytes>
              set target size of input data blocks [2x8=16 MiB]

       -C, --directory=<dir>
              change to directory <dir>

       -f, --file=<archive>
              use archive file <archive>

       -h, --dereference
              follow symlinks; archive the files they point to

       -n, --threads=<n>
              set number of (de)compression threads [2]

       -o, --output=<file>
              compress to <file> ('-' for stdout)

       -p, --preserve-permissions
              don't subtract the umask on extraction

       -q, --quiet
              suppress all messages

       -v, --verbose
              verbosely list files processed

       -0 .. -9
              set compression level [default 6]

       --uncompressed
              don't compress the archive created

       --asolid
              create solidly compressed appendable archive

       --bsolid
              create per block compressed archive (default)

       --dsolid
              create per directory compressed archive

       --no-solid
              create per file compressed archive

       --solid
              create solidly compressed archive

       --anonymous
              equivalent to '--owner=root --group=root'

       --owner=<owner>
              use <owner> name/ID for files added to archive

       --group=<group>
              use <group> name/ID for files added to archive

       --exclude=<pattern>
              exclude files matching a shell pattern

       --ignore-ids
              ignore differences in owner and group IDs

       --ignore-metadata
              compare only file size and file content

       --ignore-overflow
              ignore mtime overflow differences on 32-bit

       --keep-damaged
              don't delete partially extracted files

       --missing-crc
              exit with error status if missing extended CRC

       --mtime=<date>
              use <date> as mtime for files added to archive

       --out-slots=<n>
              number of 1 MiB output packets buffered [64]

       --warn-newer
              warn if any file is newer than the archive

       If no archive is specified, tarlz tries to read it from standard  input  or  write  it  to
       standard output.

       Exit  status:  0  for  a  normal exit, 1 for environmental problems (file not found, files
       differ, 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 tarlz to panic.

REPORTING BUGS

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

COPYRIGHT

       Copyright  © 2024 Antonio Diaz Diaz.  Using lzlib 1.14-rc1 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 tarlz is maintained as a Texinfo manual.  If the info and tarlz
       programs are properly installed at your site, the command

              info tarlz

       should give you access to the complete manual.