1XZDEC(1)                           XZ Utils                           XZDEC(1)
2
3
4

NAME

6       xzdec, lzmadec - Small .xz and .lzma decompressors
7

SYNOPSIS

9       xzdec [option]...  [file]...
10       lzmadec [option]...  [file]...
11

DESCRIPTION

13       xzdec is a liblzma-based decompression-only tool for .xz (and only .xz)
14       files.  xzdec is intended to work as a drop-in replacement for xz(1) in
15       the  most  common  situations where a script has been written to use xz
16       --decompress --stdout (and possibly a few other commonly used  options)
17       to  decompress  .xz  files.   lzmadec is identical to xzdec except that
18       lzmadec supports .lzma files instead of .xz files.
19
20       To reduce the size of the  executable,  xzdec  doesn't  support  multi‐
21       threading  or  localization, and doesn't read options from XZ_OPT envi‐
22       ronment  variable.   xzdec  doesn't  support  displaying   intermediate
23       progress  information: sending SIGINFO to xzdec does nothing, but send‐
24       ing SIGUSR1 terminates  the  process  instead  of  displaying  progress
25       information.
26

OPTIONS

28       -d, --decompress, --uncompress
29              Ignored for xz(1) compatibility.  xzdec supports only decompres‐
30              sion.
31
32       -k, --keep
33              Ignored for xz(1) compatibility.  xzdec never creates or removes
34              any files.
35
36       -c, --stdout, --to-stdout
37              Ignored for xz(1) compatibility.  xzdec always writes the decom‐
38              pressed data to standard output.
39
40       -M limit, --memory=limit
41              Set the memory usage limit.  If this option is specified  multi‐
42              ple times, the last one takes effect. The limit can be specified
43              in multiple ways:
44
45              ·  The limit can be an absolute value in bytes. Using an integer
46                 suffix like MiB can be useful. Example: --memory=80MiB
47
48              ·  The  limit  can be specified as a percentage of physical RAM.
49                 Example: --memory=70%
50
51              ·  The limit can be reset back to its default value  by  setting
52                 it to 0.
53
54              ·  The memory usage limiting can be effectively disabled by set‐
55                 ting limit to max.  This isn't recommended. It's usually bet‐
56                 ter to use, for example, --memory=90%.
57
58              The  current  limit can be seen near the bottom of the output of
59              the --help option.
60
61       -q, --quiet
62              Specifying this once does nothing since xzdec never displays any
63              warnings or notices.  Specify this twice to suppress errors.
64
65       -Q, --no-warn
66              Ignored for xz(1) compatibility.  xzdec never uses the exit sta‐
67              tus 2.
68
69       -h, --help
70              Display a help message and exit successfully.
71
72       -V, --version
73              Display the version number of xzdec and liblzma.
74

EXIT STATUS

76       0      All was good.
77
78       1      An error occurred.
79
80       xzdec doesn't have any warning messages like xz(1) has, thus  the  exit
81       status 2 is not used by xzdec.
82

NOTES

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

SEE ALSO

91       xz(1)
92
93       XZ Embedded: <http://tukaani.org/xz/embedded.html>
94
95
96
97Tukaani                           2010-03-07                          XZDEC(1)
Impressum