diff options
Diffstat (limited to 'doc/tarlz.info')
| -rw-r--r-- | doc/tarlz.info | 83 |
1 files changed, 43 insertions, 40 deletions
diff --git a/doc/tarlz.info b/doc/tarlz.info index c797f0b..79661cc 100644 --- a/doc/tarlz.info +++ b/doc/tarlz.info @@ -11,7 +11,7 @@ File: tarlz.info, Node: Top, Next: Introduction, Up: (dir) Tarlz Manual ************ -This manual is for Tarlz (version 0.21, 14 June 2021). +This manual is for Tarlz (version 0.22, 5 January 2022). * Menu: @@ -28,7 +28,7 @@ This manual is for Tarlz (version 0.21, 14 June 2021). * Concept index:: Index of concepts - Copyright (C) 2013-2021 Antonio Diaz Diaz. + Copyright (C) 2013-2022 Antonio Diaz Diaz. This manual is free documentation: you have unlimited permission to copy, distribute, and modify it. @@ -101,8 +101,9 @@ The format for running tarlz is: tarlz [OPTIONS] [FILES] -All operations except '--concatenate' operate on whole trees if any FILE is -a directory. Tarlz overwrites output files without warning. +All operations except '--concatenate' and '--compress' operate on whole +trees if any FILE is a directory. All operations except '--compress' +overwrite output files without warning. On archive creation or appending tarlz archives the files specified, but removes from member names any leading and trailing slashes and any file name @@ -432,12 +433,14 @@ to '-1 --solid'. '--check-lib' Compare the version of lzlib used to compile tarlz with the version - actually being used and exit. Report any differences found. Exit with - error status 1 if differences are found. A mismatch may indicate that - lzlib is not correctly installed or that a different version of lzlib - has been installed after compiling tarlz. 'tarlz -v --check-lib' shows - the version of lzlib being used and the value of 'LZ_API_VERSION' (if - defined). *Note Library version: (lzlib)Library version. + actually being used at run time and exit. Report any differences + found. Exit with error status 1 if differences are found. A mismatch + may indicate that lzlib is not correctly installed or that a different + version of lzlib has been installed after compiling tarlz. Exit with + error status 2 if LZ_API_VERSION and LZ_version_string don't match. + 'tarlz -v --check-lib' shows the version of lzlib being used and the + value of LZ_API_VERSION (if defined). *Note Library version: + (lzlib)Library version. '--warn-newer' During archive creation, warn if any file being archived has a @@ -594,10 +597,10 @@ space, equal-sign, and newline. representing the CRC <value> itself. The <value> is represented as 8 hexadecimal digits in big endian order, '22 GNU.crc32=00000000\n'. The keyword of the CRC record is protected by the CRC to guarante that - corruption is always detected (except in case of CRC collision). A CRC - was chosen because a checksum is too weak for a potentially large list - of variable sized records. A checksum can't detect simple errors like - the swapping of two bytes. + corruption is always detected when using '--missing-crc' (except in + case of CRC collision). A CRC was chosen because a checksum is too + weak for a potentially large list of variable sized records. A + checksum can't detect simple errors like the swapping of two bytes. At verbosity level 1 or higher tarlz prints a diagnostic for each unknown @@ -844,16 +847,16 @@ workers. The workers compress the metadata received from the grouper along with the file data read from the file system. The muxer collects processed packets from the workers, and writes them to the archive. -,--------, +.--------. | data|---> to each worker below -| | ,------------, +| | .------------. | file | ,-->| worker 0 |--, | system | | `------------' | -| | ,---------, | ,------------, | ,-------, ,---------, +| | .---------. | .------------. | .-------. .---------. |metadata|--->| grouper |-+-->| worker 1 |--+-->| muxer |-->| archive | `--------' `---------' | `------------' | `-------' `---------' | ... | - | ,------------, | + | .------------. | `-->| worker N-1 |--' `------------' @@ -864,17 +867,17 @@ worker may access files in the file system either to read them (diff) or write them (extract). As in plzip, each worker reads members directly from the archive. -,--------, +.--------. | file |<---> data to/from each worker below | system | -`--------' ,------------, +`--------' .------------. ,-->| worker 0 |--, | `------------' | -,---------, | ,------------, | ,-------, ,--------, +.---------. | .------------. | .-------. .--------. | archive |-+-->| worker 1 |--+-->| muxer |-->| stdout | `---------' | `------------' | `-------' | stderr | | ... | `--------' - | ,------------, | + | .------------. | `-->| worker N-1 |--' `------------' @@ -956,7 +959,7 @@ example listing the Silesia corpus on a dual core machine: On the other hand, multi-threaded '--list' won't detect corruption in the tar member data because it only decodes the part of each lzip member corresponding to the tar member header. This is another reason why the tar -headers must provide its own integrity checking. +headers must provide their own integrity checking. 7.1 Limitations of multi-threaded extraction @@ -1101,7 +1104,7 @@ eternity, if not longer. If you find a bug in tarlz, please send electronic mail to <lzip-bug@nongnu.org>. Include the version number, which you can find by -running 'tarlz --version'. +running 'tarlz --version' and 'tarlz -v --check-lib'. File: tarlz.info, Node: Concept index, Prev: Problems, Up: Top @@ -1131,22 +1134,22 @@ Concept index Tag Table: Node: Top223 -Node: Introduction1212 -Node: Invoking tarlz4020 -Ref: --data-size6389 -Ref: --bsolid16341 -Node: Portable character set21079 -Node: File format21874 -Ref: key_crc3226799 -Node: Amendments to pax format32400 -Ref: crc3233064 -Ref: flawed-compat34375 -Node: Program design37176 -Node: Multi-threaded decoding41101 -Node: Minimum archive sizes45590 -Node: Examples47728 -Node: Problems49744 -Node: Concept index50272 +Node: Introduction1214 +Node: Invoking tarlz4022 +Ref: --data-size6436 +Ref: --bsolid16388 +Node: Portable character set21224 +Node: File format22019 +Ref: key_crc3226944 +Node: Amendments to pax format32572 +Ref: crc3233236 +Ref: flawed-compat34547 +Node: Program design37348 +Node: Multi-threaded decoding41273 +Node: Minimum archive sizes45764 +Node: Examples47902 +Node: Problems49918 +Node: Concept index50473 End Tag Table |