XZDEC(1)                                                    XZ Utils                                                    XZDEC(1)



NAME
       xzdec, lzmadec - Small .xz and .lzma decompressors

SYNOPSIS
       xzdec [option]...  [file]...
       lzmadec [option]...  [file]...

DESCRIPTION
       xzdec  is  a  liblzma-based decompression-only tool for .xz (and only .xz) files.  xzdec is intended to work as a drop-in
       replacement for xz(1) in the most common situations where a script has been written to use xz --decompress --stdout  (and
       possibly  a  few other commonly used options) to decompress .xz files.  lzmadec is identical to xzdec except that lzmadec
       supports .lzma files instead of .xz files.

       To reduce the size of the executable, xzdec doesn't support multithreading or localization, and doesn't read options from
       XZ_OPT  environment  variable.   xzdec  doesn't  support displaying intermediate progress information: sending SIGINFO to
       xzdec does nothing, but sending SIGUSR1 terminates the process instead of displaying progress information.

OPTIONS
       -d, --decompress, --uncompress
              Ignored for xz(1) compatibility.  xzdec supports only decompression.

       -k, --keep
              Ignored for xz(1) compatibility.  xzdec never creates or removes any files.

       -c, --stdout, --to-stdout
              Ignored for xz(1) compatibility.  xzdec always writes the decompressed data to standard output.

       -M limit, --memory=limit
              Set the memory usage limit.  If this option is specified multiple times, the last one takes effect. The limit  can
              be specified in multiple ways:

              o  The  limit  can  be an absolute value in bytes. Using an integer suffix like MiB can be useful. Example: --mem-
                 ory=80MiB

              o  The limit can be specified as a percentage of physical RAM. Example: --memory=70%

              o  The limit can be reset back to its default value by setting it to 0.

              o  The memory usage limiting can be effectively disabled by setting limit to max.  This  isn't  recommended.  It's
                 usually better to use, for example, --memory=90%.

              The current limit can be seen near the bottom of the output of the --help option.

       -q, --quiet
              Specifying  this once does nothing since xzdec never displays any warnings or notices.  Specify this twice to sup-
              press errors.

       -Q, --no-warn
              Ignored for xz(1) compatibility.  xzdec never uses the exit status 2.

       -h, --help
              Display a help message and exit successfully.

       -V, --version
              Display the version number of xzdec and liblzma.

EXIT STATUS
       0      All was good.

       1      An error occurred.

       xzdec doesn't have any warning messages like xz(1) has, thus the exit status 2 is not used by xzdec.

NOTES
       xzdec and lzmadec are not really that small. The size can be reduced further by dropping features from liblzma at compile
       time,  but  that shouldn't usually be done for executables distributed in typical non-embedded operating system distribu-
       tions. If you need a truly small .xz decompressor, consider using XZ Embedded.

SEE ALSO
       xz(1)

       XZ Embedded: <http://tukaani.org/xz/embedded.html>;



Tukaani                                                    2010-03-07                                                   XZDEC(1)