OLD | NEW |
1 .\" | 1 .\" |
2 .\" Author: Lasse Collin | 2 .\" Author: Lasse Collin |
3 .\" | 3 .\" |
4 .\" This file has been put into the public domain. | 4 .\" This file has been put into the public domain. |
5 .\" You can do whatever you want with this file. | 5 .\" You can do whatever you want with this file. |
6 .\" | 6 .\" |
7 .TH XZDEC 1 "2010-03-07" "Tukaani" "XZ Utils" | 7 .TH XZDEC 1 "2010-09-27" "Tukaani" "XZ Utils" |
8 .SH NAME | 8 .SH NAME |
9 xzdec, lzmadec \- Small .xz and .lzma decompressors | 9 xzdec, lzmadec \- Small .xz and .lzma decompressors |
10 .SH SYNOPSIS | 10 .SH SYNOPSIS |
11 .B xzdec | 11 .B xzdec |
12 .RI [ option ]... | 12 .RI [ option ]... |
13 .RI [ file ]... | 13 .RI [ file ]... |
14 .br | 14 .br |
15 .B lzmadec | 15 .B lzmadec |
16 .RI [ option ]... | 16 .RI [ option ]... |
17 .RI [ file ]... | 17 .RI [ file ]... |
18 .SH DESCRIPTION | 18 .SH DESCRIPTION |
19 .B xzdec | 19 .B xzdec |
20 is a liblzma-based decompression-only tool for | 20 is a liblzma-based decompression-only tool for |
21 .B .xz | 21 .B .xz |
22 (and only | 22 (and only |
23 .BR .xz ) | 23 .BR .xz ) |
24 files. | 24 files. |
25 .B xzdec | 25 .B xzdec |
26 is intended to work as a drop-in replacement for | 26 is intended to work as a drop-in replacement for |
27 .BR xz (1) | 27 .BR xz (1) |
28 in the most common situations where a script has been written to use | 28 in the most common situations where a script |
| 29 has been written to use |
29 .B "xz \-\-decompress \-\-stdout" | 30 .B "xz \-\-decompress \-\-stdout" |
30 (and possibly a few other commonly used options) to decompress | 31 (and possibly a few other commonly used options) to decompress |
31 .B .xz | 32 .B .xz |
32 files. | 33 files. |
33 .B lzmadec | 34 .B lzmadec |
34 is identical to | 35 is identical to |
35 .B xzdec | 36 .B xzdec |
36 except that | 37 except that |
37 .B lzmadec | 38 .B lzmadec |
38 supports | 39 supports |
39 .B .lzma | 40 .B .lzma |
40 files instead of | 41 files instead of |
41 .B .xz | 42 .B .xz |
42 files. | 43 files. |
43 .PP | 44 .PP |
44 To reduce the size of the executable, | 45 To reduce the size of the executable, |
45 .B xzdec | 46 .B xzdec |
46 doesn't support multithreading or localization, and doesn't read options from | 47 doesn't support multithreading or localization, |
| 48 and doesn't read options from |
| 49 .B XZ_DEFAULTS |
| 50 and |
47 .B XZ_OPT | 51 .B XZ_OPT |
48 environment variable. | 52 environment variables. |
49 .B xzdec | 53 .B xzdec |
50 doesn't support displaying intermediate progress information: sending | 54 doesn't support displaying intermediate progress information: sending |
51 .B SIGINFO | 55 .B SIGINFO |
52 to | 56 to |
53 .B xzdec | 57 .B xzdec |
54 does nothing, but sending | 58 does nothing, but sending |
55 .B SIGUSR1 | 59 .B SIGUSR1 |
56 terminates the process instead of displaying progress information. | 60 terminates the process instead of displaying progress information. |
57 .SH OPTIONS | 61 .SH OPTIONS |
58 .TP | 62 .TP |
(...skipping 11 matching lines...) Expand all Loading... |
70 .B xzdec | 74 .B xzdec |
71 never creates or removes any files. | 75 never creates or removes any files. |
72 .TP | 76 .TP |
73 .BR \-c ", " \-\-stdout ", " \-\-to-stdout | 77 .BR \-c ", " \-\-stdout ", " \-\-to-stdout |
74 Ignored for | 78 Ignored for |
75 .BR xz (1) | 79 .BR xz (1) |
76 compatibility. | 80 compatibility. |
77 .B xzdec | 81 .B xzdec |
78 always writes the decompressed data to standard output. | 82 always writes the decompressed data to standard output. |
79 .TP | 83 .TP |
80 \fB\-M\fR \fIlimit\fR, \fB\-\-memory=\fIlimit | |
81 Set the memory usage | |
82 .IR limit . | |
83 If this option is specified multiple times, the last one takes effect. The | |
84 .I limit | |
85 can be specified in multiple ways: | |
86 .RS | |
87 .IP \(bu 3 | |
88 The | |
89 .I limit | |
90 can be an absolute value in bytes. Using an integer suffix like | |
91 .B MiB | |
92 can be useful. Example: | |
93 .B "\-\-memory=80MiB" | |
94 .IP \(bu 3 | |
95 The | |
96 .I limit | |
97 can be specified as a percentage of physical RAM. Example: | |
98 .B "\-\-memory=70%" | |
99 .IP \(bu 3 | |
100 The | |
101 .I limit | |
102 can be reset back to its default value by setting it to | |
103 .BR 0 . | |
104 .IP \(bu 3 | |
105 The memory usage limiting can be effectively disabled by setting | |
106 .I limit | |
107 to | |
108 .BR max . | |
109 This isn't recommended. It's usually better to use, for example, | |
110 .BR \-\-memory=90% . | |
111 .RE | |
112 .IP | |
113 The current | |
114 .I limit | |
115 can be seen near the bottom of the output of the | |
116 .B \-\-help | |
117 option. | |
118 .TP | |
119 .BR \-q ", " \-\-quiet | 84 .BR \-q ", " \-\-quiet |
120 Specifying this once does nothing since | 85 Specifying this once does nothing since |
121 .B xzdec | 86 .B xzdec |
122 never displays any warnings or notices. | 87 never displays any warnings or notices. |
123 Specify this twice to suppress errors. | 88 Specify this twice to suppress errors. |
124 .TP | 89 .TP |
125 .BR \-Q ", " \-\-no-warn | 90 .BR \-Q ", " \-\-no-warn |
126 Ignored for | 91 Ignored for |
127 .BR xz (1) | 92 .BR xz (1) |
128 compatibility. | 93 compatibility. |
129 .B xzdec | 94 .B xzdec |
130 never uses the exit status | 95 never uses the exit status 2. |
131 .BR "2" . | |
132 .TP | 96 .TP |
133 .BR \-h ", " \-\-help | 97 .BR \-h ", " \-\-help |
134 Display a help message and exit successfully. | 98 Display a help message and exit successfully. |
135 .TP | 99 .TP |
136 .BR \-V ", " \-\-version | 100 .BR \-V ", " \-\-version |
137 Display the version number of | 101 Display the version number of |
138 .B xzdec | 102 .B xzdec |
139 and liblzma. | 103 and liblzma. |
140 .SH "EXIT STATUS" | 104 .SH "EXIT STATUS" |
141 .TP | 105 .TP |
142 .B 0 | 106 .B 0 |
143 All was good. | 107 All was good. |
144 .TP | 108 .TP |
145 .B 1 | 109 .B 1 |
146 An error occurred. | 110 An error occurred. |
147 .PP | 111 .PP |
148 .B xzdec | 112 .B xzdec |
149 doesn't have any warning messages like | 113 doesn't have any warning messages like |
150 .BR xz (1) | 114 .BR xz (1) |
151 has, thus the exit status | 115 has, thus the exit status 2 is not used by |
152 .B 2 | |
153 is not used by | |
154 .BR xzdec . | 116 .BR xzdec . |
155 .SH NOTES | 117 .SH NOTES |
| 118 Use |
| 119 .BR xz (1) |
| 120 instead of |
| 121 .B xzdec |
| 122 or |
| 123 .B lzmadec |
| 124 for normal everyday use. |
| 125 .B xzdec |
| 126 or |
| 127 .B lzmadec |
| 128 are meant only for situations where it is important to have |
| 129 a smaller decompressor than the full-featured |
| 130 .BR xz (1). |
| 131 .PP |
156 .B xzdec | 132 .B xzdec |
157 and | 133 and |
158 .B lzmadec | 134 .B lzmadec |
159 are not really that small. The size can be reduced further by dropping | 135 are not really that small. |
160 features from liblzma at compile time, but that shouldn't usually be done | 136 The size can be reduced further by dropping |
161 for executables distributed in typical non-embedded operating system | 137 features from liblzma at compile time, |
162 distributions. If you need a truly small | 138 but that shouldn't usually be done for executables distributed |
| 139 in typical non-embedded operating system distributions. |
| 140 If you need a truly small |
163 .B .xz | 141 .B .xz |
164 decompressor, consider using XZ Embedded. | 142 decompressor, consider using XZ Embedded. |
165 .SH "SEE ALSO" | 143 .SH "SEE ALSO" |
166 .BR xz (1) | 144 .BR xz (1) |
167 .PP | 145 .PP |
168 XZ Embedded: <http://tukaani.org/xz/embedded.html> | 146 XZ Embedded: <http://tukaani.org/xz/embedded.html> |
OLD | NEW |