| 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 |