NAME

       tarlz - creates tar archives with multimember lzip compression

SYNOPSIS

       tarlz [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, lists, and extracts archives in 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 fully 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.

OPTIONS

       --help display this help and exit

       -V, --version
              output version information and exit

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

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

       -c, --create
              create a new archive

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

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

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

       --delete
              delete files/directories from an archive

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

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

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

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

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

       -o, --output=<file>
              compress to <file>

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

       -q, --quiet
              suppress all messages

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

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

       -v, --verbose
              verbosely list files processed

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

       -z, --compress
              compress existing POSIX tar archives

       -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

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

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

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

       --check-lib
              compare version of lzlib.h with liblz.{a,so}

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

       Exit status: 0 for a normal exit, 1 for environmental problems (file not  found,  files  differ,  invalid
       flags,  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 © 2022 Antonio Diaz Diaz.  Using lzlib 1.13-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.