2 .\" Author: Lasse Collin
4 .\" This file has been put into the public domain.
5 .\" You can do whatever you want with this file.
7 .TH XZDEC 1 "2010-03-07" "Tukaani" "XZ Utils"
9 xzdec, lzmadec \- Small .xz and .lzma decompressors
20 is a liblzma-based decompression-only tool for
26 is intended to work as a drop-in replacement for
28 in the most common situations where a script has been written to use
29 .B "xz \-\-decompress \-\-stdout"
30 (and possibly a few other commonly used options) to decompress
44 To reduce the size of the executable,
46 doesn't support multithreading or localization, and doesn't read options from
50 doesn't support displaying intermediate progress information: sending
54 does nothing, but sending
56 terminates the process instead of displaying progress information.
59 .BR \-d ", " \-\-decompress ", " \-\-uncompress
64 supports only decompression.
71 never creates or removes any files.
73 .BR \-c ", " \-\-stdout ", " \-\-to-stdout
78 always writes the decompressed data to standard output.
80 \fB\-M\fR \fIlimit\fR, \fB\-\-memory=\fIlimit
83 If this option is specified multiple times, the last one takes effect. The
85 can be specified in multiple ways:
90 can be an absolute value in bytes. Using an integer suffix like
92 can be useful. Example:
97 can be specified as a percentage of physical RAM. Example:
102 can be reset back to its default value by setting it to
105 The memory usage limiting can be effectively disabled by setting
109 This isn't recommended. It's usually better to use, for example,
115 can be seen near the bottom of the output of the
119 .BR \-q ", " \-\-quiet
120 Specifying this once does nothing since
122 never displays any warnings or notices.
123 Specify this twice to suppress errors.
125 .BR \-Q ", " \-\-no-warn
130 never uses the exit status
133 .BR \-h ", " \-\-help
134 Display a help message and exit successfully.
136 .BR \-V ", " \-\-version
137 Display the version number of
149 doesn't have any warning messages like
151 has, thus the exit status
159 are not really that small. The size can be reduced further by dropping
160 features from liblzma at compile time, but that shouldn't usually be done
161 for executables distributed in typical non-embedded operating system
162 distributions. If you need a truly small
164 decompressor, consider using XZ Embedded.
168 XZ Embedded: <http://tukaani.org/xz/embedded.html>