Adding upstream version 0.12.
Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
parent
6bd0c00498
commit
454dd91a77
18 changed files with 427 additions and 212 deletions
|
@ -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
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue