summaryrefslogtreecommitdiffstats
path: root/doc/tarlz.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tarlz.1')
-rw-r--r--doc/tarlz.141
1 files changed, 35 insertions, 6 deletions
diff --git a/doc/tarlz.1 b/doc/tarlz.1
index 6b685c5..906fee0 100644
--- a/doc/tarlz.1
+++ b/doc/tarlz.1
@@ -1,12 +1,25 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.1.
-.TH TARLZ "1" "April 2018" "tarlz 0.4" "User Commands"
+.TH TARLZ "1" "December 2018" "tarlz 0.8" "User Commands"
.SH NAME
tarlz \- creates tar archives with multimember lzip compression
.SH SYNOPSIS
.B tarlz
[\fI\,options\/\fR] [\fI\,files\/\fR]
.SH DESCRIPTION
-Tarlz \- Archiver with multimember lzip compression.
+Tarlz is a small and simple implementation of the tar archiver. By default
+tarlz creates, lists and extracts archives in a simplified posix pax format
+compressed with lzip on a per file basis. Each tar member is compressed in
+its own lzip member, as well as the end\-of\-file blocks. This method is fully
+backward compatible with standard tar tools like GNU tar, which treat the
+resulting multimember tar.lz archive like any other tar.lz archive. Tarlz
+can append files to the end of such compressed archives.
+.PP
+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.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
@@ -15,6 +28,9 @@ display this help and exit
\fB\-V\fR, \fB\-\-version\fR
output version information and exit
.TP
+\fB\-A\fR, \fB\-\-concatenate\fR
+append tar.lz archives to the end of an archive
+.TP
\fB\-c\fR, \fB\-\-create\fR
create a new archive
.TP
@@ -48,17 +64,29 @@ create solidly compressed appendable archive
\fB\-\-dsolid\fR
create per\-directory compressed archive
.TP
+\fB\-\-no\-solid\fR
+create per\-file compressed archive (default)
+.TP
\fB\-\-solid\fR
create solidly compressed archive
.TP
-\fB\-\-group=\fR<group>
-use <group> name/id for added files
+\fB\-\-anonymous\fR
+equivalent to '\-\-owner=root \fB\-\-group\fR=\fI\,root\/\fR'
.TP
\fB\-\-owner=\fR<owner>
-use <owner> name/id for added files
+use <owner> name/ID for files added
+.TP
+\fB\-\-group=\fR<group>
+use <group> name/ID for files added
+.TP
+\fB\-\-keep\-damaged\fR
+don't delete partially extracted files
+.TP
+\fB\-\-missing\-crc\fR
+exit with error status if missing extended CRC
.TP
\fB\-\-uncompressed\fR
-don't compress the created archive
+don't compress the archive created
.PP
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
@@ -70,6 +98,7 @@ Report bugs to lzip\-bug@nongnu.org
Tarlz home page: http://www.nongnu.org/lzip/tarlz.html
.SH COPYRIGHT
Copyright \(co 2018 Antonio Diaz Diaz.
+Using lzlib 1.11\-rc2
License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.