diff options
Diffstat (limited to '')
-rw-r--r-- | doc/tarlz.1 | 81 |
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. |