From 1d0f658132f3be0c133ecd8bec347ad426244f40 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 24 Feb 2019 21:21:12 +0100 Subject: Merging upstream version 0.12. Signed-off-by: Daniel Baumann --- doc/tarlz.texi | 42 ++++++++++++++++++++++++++++-------------- 1 file changed, 28 insertions(+), 14 deletions(-) (limited to 'doc/tarlz.texi') diff --git a/doc/tarlz.texi b/doc/tarlz.texi index 6026fe3..56c4dab 100644 --- a/doc/tarlz.texi +++ b/doc/tarlz.texi @@ -6,8 +6,8 @@ @finalout @c %**end of header -@set UPDATED 13 February 2019 -@set VERSION 0.11 +@set UPDATED 22 February 2019 +@set VERSION 0.12 @dircategory Data Compression @direntry @@ -69,7 +69,7 @@ tar, which treat it like any other tar.lz archive. Tarlz can append files to the end of such compressed archives. Tarlz can create tar archives with five levels of compression granularity; -per file, per block, per directory, appendable solid, and solid. +per file, per block (default), per directory, appendable solid, and solid. @noindent Of course, compressing each file (or each directory) individually can't @@ -130,7 +130,7 @@ appended or concatenated, and skips it. On extraction and listing, tarlz removes leading @samp{./} strings from member names in the archive or given in the command line, so that -@w{@code{tarlz -xf foo ./bar baz}} extracts members @samp{bar} and +@w{@samp{tarlz -xf foo ./bar baz}} extracts members @samp{bar} and @samp{./baz} from archive @samp{foo}. If several compression levels or @samp{--*solid} options are given, the last @@ -162,10 +162,10 @@ specified. Tarlz can't concatenate uncompressed tar archives. @anchor{--data-size} @item -B @var{bytes} @itemx --data-size=@var{bytes} -Set target size of input data blocks for the @samp{--bsolid} option. Valid -values range from @w{8 KiB} to @w{1 GiB}. Default value is two times the -dictionary size, except for option @samp{-0} where it defaults to @w{1 MiB}. -@xref{Minimum archive sizes}. +Set target size of input data blocks for the @samp{--bsolid} option. +@xref{--bsolid}. Valid values range from @w{8 KiB} to @w{1 GiB}. Default +value is two times the dictionary size, except for option @samp{-0} where it +defaults to @w{1 MiB}. @xref{Minimum archive sizes}. @item -c @itemx --create @@ -186,6 +186,19 @@ Note that a process can only have one current working directory (CWD). Therefore multi-threading can't be used to create an archive if a @samp{-C} option appears after a relative filename in the command line. +@item -d +@itemx --diff +Find differences between archive and file system. For each tar member in the +archive, verify that the corresponding file exists and is of the same type +(regular file, directory, etc). Report the differences found in type, mode +(permissions), owner and group IDs, modification time, file size, file +contents (of regular files), target (of symlinks) and device number (of +block/character special files). + +@item --ignore-ids +Make @samp{--diff} ignore differences in owner and group IDs. This option is +useful when comparing an @samp{--anonymous} archive. + @item -f @var{archive} @itemx --file=@var{archive} Use archive file @var{archive}. @samp{-} used as an @var{archive} @@ -205,7 +218,7 @@ Multi-threaded extraction of files from an archive is not yet implemented. Note that the number of usable threads is limited during compression to @w{ceil( uncompressed_size / data_size )} (@pxref{Minimum archive sizes}), and during decompression to the number of lzip members in the tar.lz -archive, which you can find by running @w{@code{lzip -lv archive.tar.lz}}. +archive, which you can find by running @w{@samp{lzip -lv archive.tar.lz}}. @item -q @itemx --quiet @@ -255,6 +268,10 @@ it creates, reducing the amount of memory required for decompression. @item -9 @tab 32 MiB @tab 273 bytes @end multitable +@item --uncompressed +With @samp{--create}, don't compress the created tar archive. Create an +uncompressed tar archive instead. + @item --asolid When creating or appending to a compressed archive, use appendable solid compression. All the files being added to the archive are compressed into a @@ -262,6 +279,7 @@ single lzip member, but the end-of-file blocks are compressed into a separate lzip member. This creates a solidly compressed appendable archive. Solid archives can't be created nor decoded in parallel. +@anchor{--bsolid} @item --bsolid When creating or appending to a compressed archive, use block compression. Tar members are compressed together in a lzip member until they approximate @@ -329,10 +347,6 @@ headers preceding a ustar header, or several records with the same keyword appearing in the same block of extended records. @end ignore -@item --uncompressed -With @samp{--create}, don't compress the created tar archive. Create an -uncompressed tar archive instead. - @end table Exit status: 0 for a normal exit, 1 for environmental problems (file not @@ -871,7 +885,7 @@ for all eternity, if not longer. If you find a bug in tarlz, please send electronic mail to @email{lzip-bug@@nongnu.org}. Include the version number, which you can -find by running @w{@code{tarlz --version}}. +find by running @w{@samp{tarlz --version}}. @node Concept index -- cgit v1.2.3