Scroll to navigation

TARLZ(1) User Commands TARLZ(1)

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

display this help and exit
output version information and exit
append archives to the end of an archive
set target size of input data blocks [2x8=16 MiB]
create a new archive
change to directory <dir>
find differences between archive and file system
ignore differences in owner and group IDs
delete files/directories from an archive
exclude files matching a shell pattern
use archive file <archive>
follow symlinks; archive the files they point to
use <date> as mtime for files added to archive
set number of (de)compression threads [2]
compress to <file>
don't subtract the umask on extraction
suppress all messages
append files to the end of an archive
list the contents of an archive
verbosely list files processed
extract files/directories from an archive
compress existing POSIX tar archives
-0 .. -9
set compression level [default 6]
don't compress the archive created
create solidly compressed appendable archive
create per block compressed archive (default)
create per directory compressed archive
create per file compressed archive
create solidly compressed archive
equivalent to '--owner=root --group=root'
use <owner> name/ID for files added to archive
use <group> name/ID for files added to archive
don't delete partially extracted files
exit with error status if missing extended CRC
number of 1 MiB output packets buffered [64]
compare version of lzlib.h with liblz.{a,so}
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 © 2021 Antonio Diaz Diaz. Using lzlib 1.12 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.

June 2021 tarlz 0.21