97 lines
3.5 KiB
Groff
97 lines
3.5 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16.
|
|
.TH LUNZIP "1" "January 2021" "lunzip 1.12" "User Commands"
|
|
.SH NAME
|
|
lunzip \- decompressor for the lzip format
|
|
.SH SYNOPSIS
|
|
.B lunzip
|
|
[\fI\,options\/\fR] [\fI\,files\/\fR]
|
|
.SH DESCRIPTION
|
|
Lunzip is a decompressor for the lzip format written in C. Its small size
|
|
makes it well suited for embedded devices or software installers that need
|
|
to decompress files but don't need compression capabilities. Lunzip is fully
|
|
compatible with lzip 1.4 or newer.
|
|
.PP
|
|
Lunzip provides a 'low memory' mode able to decompress any file using as
|
|
little memory as 50 kB, irrespective of the dictionary size used to
|
|
compress the file. To activate it, specify the size of the output buffer
|
|
with the option \fB\-\-buffer\-size\fR and lunzip will use the decompressed
|
|
file as dictionary for distances beyond the buffer size. Of course, the
|
|
larger the difference between the buffer size and the dictionary size, the
|
|
more accesses to disk are needed and the slower the decompression is.
|
|
This 'low memory' mode only works when decompressing to a regular file
|
|
and is intended for systems without enough memory (RAM + swap) to keep
|
|
the whole dictionary at once.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
display this help and exit
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
output version information and exit
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-trailing\-error\fR
|
|
exit with error status if trailing data
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-stdout\fR
|
|
write to standard output, keep input files
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-decompress\fR
|
|
decompress (this is the default)
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-force\fR
|
|
overwrite existing output files
|
|
.TP
|
|
\fB\-k\fR, \fB\-\-keep\fR
|
|
keep (don't delete) input files
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-list\fR
|
|
print (un)compressed file sizes
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output=\fR<file>
|
|
write to <file>, keep input files
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
suppress all messages
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-test\fR
|
|
test compressed file integrity
|
|
.TP
|
|
\fB\-u\fR, \fB\-\-buffer\-size=\fR<bytes>
|
|
set output buffer size in bytes
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
be verbose (a 2nd \fB\-v\fR gives more)
|
|
.TP
|
|
\fB\-\-loose\-trailing\fR
|
|
allow trailing data seeming corrupt header
|
|
.PP
|
|
If no file names are given, or if a file is '\-', lunzip decompresses
|
|
from standard input to standard output.
|
|
Numbers may be followed by a multiplier: k = kB = 10^3 = 1000,
|
|
Ki = KiB = 2^10 = 1024, M = 10^6, Mi = 2^20, G = 10^9, Gi = 2^30, etc...
|
|
Buffer sizes 12 to 29 are interpreted as powers of two, meaning 2^12
|
|
to 2^29 bytes.
|
|
.PP
|
|
To extract all the files from archive 'foo.tar.lz', use the commands
|
|
\&'tar \fB\-xf\fR foo.tar.lz' or 'lunzip \fB\-cd\fR foo.tar.lz | tar \fB\-xf\fR \-'.
|
|
.PP
|
|
Exit status: 0 for a normal exit, 1 for environmental problems (file
|
|
not found, invalid flags, I/O errors, etc), 2 to indicate a corrupt or
|
|
invalid input file, 3 for an internal consistency error (eg, bug) which
|
|
caused lunzip to panic.
|
|
.PP
|
|
The ideas embodied in lunzip are due to (at least) the following people:
|
|
Abraham Lempel and Jacob Ziv (for the LZ algorithm), Andrey Markov (for the
|
|
definition of Markov chains), G.N.N. Martin (for the definition of range
|
|
encoding), Igor Pavlov (for putting all the above together in LZMA), and
|
|
Julian Seward (for bzip2's CLI).
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to lzip\-bug@nongnu.org
|
|
.br
|
|
Lunzip home page: http://www.nongnu.org/lzip/lunzip.html
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2021 Antonio Diaz Diaz.
|
|
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.
|
|
There is NO WARRANTY, to the extent permitted by law.
|