summaryrefslogtreecommitdiffstats
path: root/doc/tarlz.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/tarlz.1')
-rw-r--r--doc/tarlz.181
1 files changed, 44 insertions, 37 deletions
diff --git a/doc/tarlz.1 b/doc/tarlz.1
index d7cc093..d23b164 100644
--- a/doc/tarlz.1
+++ b/doc/tarlz.1
@@ -1,10 +1,10 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16.
-.TH TARLZ "1" "January 2022" "tarlz 0.22" "User Commands"
+.TH TARLZ "1" "September 2022" "tarlz 0.23" "User Commands"
.SH NAME
tarlz \- creates tar archives with multimember lzip compression
.SH SYNOPSIS
.B tarlz
-[\fI\,options\/\fR] [\fI\,files\/\fR]
+\fI\,operation \/\fR[\fI\,options\/\fR] [\fI\,files\/\fR]
.SH DESCRIPTION
Tarlz is a massively parallel (multi\-threaded) combined implementation of
the tar archiver and the lzip compressor. Tarlz uses the compression library
@@ -28,7 +28,7 @@ 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
+.SS "Operations:"
.TP
\fB\-\-help\fR
display this help and exit
@@ -39,26 +39,36 @@ output version information and exit
\fB\-A\fR, \fB\-\-concatenate\fR
append archives to the end of an archive
.TP
-\fB\-B\fR, \fB\-\-data\-size=\fR<bytes>
-set target size of input data blocks [2x8=16 MiB]
-.TP
\fB\-c\fR, \fB\-\-create\fR
create a new archive
.TP
-\fB\-C\fR, \fB\-\-directory=\fR<dir>
-change to directory <dir>
-.TP
\fB\-d\fR, \fB\-\-diff\fR
find differences between archive and file system
.TP
-\fB\-\-ignore\-ids\fR
-ignore differences in owner and group IDs
-.TP
\fB\-\-delete\fR
delete files/directories from an archive
.TP
-\fB\-\-exclude=\fR<pattern>
-exclude files matching a shell pattern
+\fB\-r\fR, \fB\-\-append\fR
+append files to the end of an archive
+.TP
+\fB\-t\fR, \fB\-\-list\fR
+list the contents of an archive
+.TP
+\fB\-x\fR, \fB\-\-extract\fR
+extract files/directories from an archive
+.TP
+\fB\-z\fR, \fB\-\-compress\fR
+compress existing POSIX tar archives
+.TP
+\fB\-\-check\-lib\fR
+check version of lzlib and exit
+.SH OPTIONS
+.TP
+\fB\-B\fR, \fB\-\-data\-size=\fR<bytes>
+set target size of input data blocks [2x8=16 MiB]
+.TP
+\fB\-C\fR, \fB\-\-directory=\fR<dir>
+change to directory <dir>
.TP
\fB\-f\fR, \fB\-\-file=\fR<archive>
use archive file <archive>
@@ -66,9 +76,6 @@ use archive file <archive>
\fB\-h\fR, \fB\-\-dereference\fR
follow symlinks; archive the files they point to
.TP
-\fB\-\-mtime=\fR<date>
-use <date> as mtime for files added to archive
-.TP
\fB\-n\fR, \fB\-\-threads=\fR<n>
set number of (de)compression threads [2]
.TP
@@ -81,21 +88,9 @@ don't subtract the umask on extraction
\fB\-q\fR, \fB\-\-quiet\fR
suppress all messages
.TP
-\fB\-r\fR, \fB\-\-append\fR
-append files to the end of an archive
-.TP
-\fB\-t\fR, \fB\-\-list\fR
-list the contents of an archive
-.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbosely list files processed
.TP
-\fB\-x\fR, \fB\-\-extract\fR
-extract files/directories from an archive
-.TP
-\fB\-z\fR, \fB\-\-compress\fR
-compress existing POSIX tar archives
-.TP
\fB\-0\fR .. \fB\-9\fR
set compression level [default 6]
.TP
@@ -126,32 +121,44 @@ use <owner> name/ID for files added to archive
\fB\-\-group=\fR<group>
use <group> name/ID for files added to archive
.TP
+\fB\-\-exclude=\fR<pattern>
+exclude files matching a shell pattern
+.TP
+\fB\-\-ignore\-ids\fR
+ignore differences in owner and group IDs
+.TP
+\fB\-\-ignore\-overflow\fR
+ignore mtime overflow differences on 32\-bit
+.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\-\-mtime=\fR<date>
+use <date> as mtime for files added to archive
+.TP
\fB\-\-out\-slots=\fR<n>
number of 1 MiB output packets buffered [64]
.TP
-\fB\-\-check\-lib\fR
-compare version of lzlib.h with liblz.{a,so}
-.TP
\fB\-\-warn\-newer\fR
warn if any file is newer than the archive
.PP
-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.
+If no archive is specified, tarlz tries to read it from standard input or
+write it to standard output.
+.PP
+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.
.SH "REPORTING BUGS"
Report bugs to lzip\-bug@nongnu.org
.br
Tarlz home page: http://www.nongnu.org/lzip/tarlz.html
.SH COPYRIGHT
Copyright \(co 2022 Antonio Diaz Diaz.
-Using lzlib 1.13\-rc1
+Using lzlib 1.13
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.