3 .\" Author: Lasse Collin
5 .\" This file has been put into the public domain.
6 .\" You can do whatever you want with this file.
8 .TH XZ 1 "2010-01-15" "Tukaani" "XZ Utils"
10 xz, unxz, xzcat, lzma, unlzma, lzcat \- Compress or decompress .xz and .lzma files
18 .BR "xz \-\-decompress" .
22 .BR "xz \-\-decompress \-\-stdout" .
26 .BR "xz \-\-format=lzma" .
30 .BR "xz \-\-format=lzma \-\-decompress" .
34 .BR "xz \-\-format=lzma \-\-decompress \-\-stdout" .
36 When writing scripts that need to decompress files, it is recommended to
39 with appropriate arguments
49 is a general-purpose data compression tool with command line syntax similar to
53 The native file format is the
55 format, but also the legacy
57 format and raw compressed streams with no container format headers
61 compresses or decompresses each
63 according to the selected operation mode.
71 reads from standard input and writes the processed data to standard output.
73 will refuse (display an error and skip the
75 to write compressed data to standard output if it is a terminal. Similarly,
77 will refuse to read compressed data from standard input if it is a terminal.
85 are written to a new file whose name is derived from the source
89 When compressing, the suffix of the target file format
93 is appended to the source filename to get the target filename.
95 When decompressing, the
99 suffix is removed from the filename to get the target filename.
101 also recognizes the suffixes
105 and replaces them with the
109 If the target file already exists, an error is displayed and the
113 Unless writing to standard output,
115 will display a warning and skip the
117 if any of the following applies:
120 is not a regular file. Symbolic links are not followed, thus they
121 are not considered to be regular files.
124 has more than one hard link.
127 has setuid, setgid, or sticky bit set.
129 The operation mode is set to compress, and the
131 already has a suffix of the target file format
135 when compressing to the
141 when compressing to the
145 The operation mode is set to decompress, and the
147 doesn't have a suffix of any of the supported file formats
154 After successfully compressing or decompressing the
157 copies the owner, group, permissions, access time, and modification time
160 to the target file. If copying the group fails, the permissions are modified
161 so that the target file doesn't become accessible to users who didn't have
162 permission to access the source
165 doesn't support copying other metadata like access control lists
166 or extended attributes yet.
168 Once the target file has been successfully closed, the source
172 was specified. The source
174 is never removed if the output is written to standard output.
182 process makes it print progress information to standard error.
183 This has only limited use since when standard error is a terminal, using
185 will display an automatically updating progress indicator.
189 varies from a few hundred kilobytes to several gigabytes depending on
190 the compression settings. The settings used when compressing a file
191 affect also the memory usage of the decompressor. Typically the decompressor
192 needs only 5\ % to 20\ % of the amount of RAM that the compressor needed when
193 creating the file. Still, the worst-case memory usage of the decompressor
194 is several gigabytes.
196 To prevent uncomfortable surprises caused by huge memory usage,
198 has a built-in memory usage limiter. The default limit is 40 % of total
199 physical RAM. While operating systems provide ways to limit the memory usage
200 of processes, relying on it wasn't deemed to be flexible enough.
202 When compressing, if the selected compression settings exceed the memory
203 usage limit, the settings are automatically adjusted downwards and a notice
204 about this is displayed. As an exception, if the memory usage limit is
205 exceeded when compressing with
207 an error is displayed and
209 will exit with exit status
214 cannot be decompressed without exceeding the memory usage limit, an error
215 message is displayed and the file is skipped. Note that compressed files
216 may contain many blocks, which may have been compressed with different
217 settings. Typically all blocks will have roughly the same memory requirements,
218 but it is possible that a block later in the file will exceed the memory usage
219 limit, and an error about too low memory usage limit gets displayed after some
220 data has already been decompressed.
222 The absolute value of the active memory usage limit can be seen with
224 or near the bottom of the output of
226 The default limit can be overridden with
227 \fB\-\-memory=\fIlimit\fR.
229 .SS "Integer suffixes and special values"
230 In most places where an integer argument is expected, an optional suffix
231 is supported to easily indicate large integers. There must be no space
232 between the integer and the suffix.
235 The integer is multiplied by 1,000 (10^3). For example,
243 The integer is multiplied by 1,024 (2^10).
246 The integer is multiplied by 1,000,000 (10^6).
249 The integer is multiplied by 1,048,576 (2^20).
252 The integer is multiplied by 1,000,000,000 (10^9).
255 The integer is multiplied by 1,073,741,824 (2^30).
259 can be used to indicate the maximum integer value supported by the option.
261 If multiple operation mode options are given, the last one takes effect.
263 .BR \-z ", " \-\-compress
264 Compress. This is the default operation mode when no operation mode option
265 is specified, and no other operation mode is implied from the command name
269 .BR \-\-decompress ).
271 .BR \-d ", " \-\-decompress ", " \-\-uncompress
274 .BR \-t ", " \-\-test
275 Test the integrity of compressed
277 No files are created or removed. This option is equivalent to
278 .B "\-\-decompress \-\-stdout"
279 except that the decompressed data is discarded instead of being
280 written to standard output.
282 .BR \-l ", " \-\-list
283 View information about the compressed files. No uncompressed output is
284 produced, and no files are created or removed. In list mode, the program
285 cannot read the compressed data from standard input or from other
288 .B "This feature has not been implemented yet."
289 .SS "Operation modifiers"
291 .BR \-k ", " \-\-keep
292 Keep (don't delete) the input files.
294 .BR \-f ", " \-\-force
295 This option has several effects:
298 If the target file already exists, delete it before compressing or
301 Compress or decompress even if the input is a symbolic link to a regular file,
302 has more than one hard link, or has setuid, setgid, or sticky bit set.
303 The setuid, setgid, and sticky bits are not copied to the target file.
310 doesn't recognize the type of the source file,
312 will copy the source file as is to standard output. This allows using
317 for files that have not been compressed with
321 might support new compressed file formats, which may make
323 decompress more types of files instead of copying them as is to
325 .BI \-\-format= format
326 can be used to restrict
328 to decompress only a single file format.
331 .BR \-c ", " \-\-stdout ", " \-\-to-stdout
332 Write the compressed or decompressed data to standard output instead of
337 Disable creation of sparse files. By default, if decompressing into
340 tries to make the file sparse if the decompressed data contains long
341 sequences of binary zeros. It works also when writing to standard output
342 as long as standard output is connected to a regular file, and certain
343 additional conditions are met to make it safe. Creating sparse files may
344 save disk space and speed up the decompression by reducing the amount of
347 \fB\-S\fR \fI.suf\fR, \fB\-\-suffix=\fI.suf
348 When compressing, use
350 as the suffix for the target file instead of
354 If not writing to standard output and the source file already has the suffix
356 a warning is displayed and the file is skipped.
358 When decompressing, recognize also files with the suffix
360 in addition to files with the
366 suffix. If the source file has the suffix
368 the suffix is removed to get the target filename.
370 When compressing or decompressing raw streams
371 .RB ( \-\-format=raw ),
372 the suffix must always be specified unless writing to standard output,
373 because there is no default suffix for raw streams.
375 \fB\-\-files\fR[\fB=\fIfile\fR]
376 Read the filenames to process from
380 is omitted, filenames are read from standard input. Filenames must be
381 terminated with the newline character. A dash
383 is taken as a regular filename; it doesn't mean standard input.
384 If filenames are given also as command line arguments, they are
385 processed before the filenames read from
388 \fB\-\-files0\fR[\fB=\fIfile\fR]
389 This is identical to \fB\-\-files\fR[\fB=\fIfile\fR] except that the
390 filenames must be terminated with the null character.
391 .SS "Basic file format and compression options"
393 \fB\-F\fR \fIformat\fR, \fB\-\-format=\fIformat
394 Specify the file format to compress or decompress:
398 This is the default. When compressing,
402 When decompressing, the format of the input file is automatically detected.
403 Note that raw streams (created with
405 cannot be auto-detected.
410 file format, or accept only
412 files when decompressing.
417 Compress to the legacy
419 file format, or accept only
421 files when decompressing. The alternative name
423 is provided for backwards compatibility with LZMA Utils.
426 Compress or uncompress a raw stream (no headers). This is meant for advanced
427 users only. To decode raw streams, you need to set not only
429 but also specify the filter chain, which would normally be stored in the
430 container format headers.
433 \fB\-C\fR \fIcheck\fR, \fB\-\-check=\fIcheck
434 Specify the type of the integrity check, which is calculated from the
435 uncompressed data. This option has an effect only when compressing into the
439 format doesn't support integrity checks.
440 The integrity check (if any) is verified when the
442 file is decompressed.
450 Don't calculate an integrity check at all. This is usually a bad idea. This
451 can be useful when integrity of the data is verified by other means anyway.
454 Calculate CRC32 using the polynomial from IEEE-802.3 (Ethernet).
457 Calculate CRC64 using the polynomial from ECMA-182. This is the default, since
458 it is slightly better than CRC32 at detecting damaged files and the speed
459 difference is negligible.
462 Calculate SHA-256. This is somewhat slower than CRC32 and CRC64.
467 headers is always verified with CRC32. It is not possible to change or
471 Select compression preset. If a preset level is specified multiple times,
472 the last one takes effect.
474 The compression preset levels can be categorised roughly into three
477 .IP "\fB\-0\fR ... \fB\-2"
478 Fast presets with relatively low memory usage.
482 should give compression speed and ratios comparable to
489 is not very good (not much faster than
491 but much worse compression). In future,
493 may be indicate some fast algorithm instead of LZMA2.
494 .IP "\fB\-3\fR ... \fB\-5"
495 Good compression ratio with low to medium memory usage.
496 These are significantly slower than levels 0\-2.
497 .IP "\fB\-6\fR ... \fB\-9"
498 Excellent compression with medium to high memory usage. These are also
499 slower than the lower preset levels. The default is
501 Unless you want to maximize the compression ratio, you probably don't want
502 a higher preset level than
504 due to speed and memory usage.
507 The exact compression settings (filter chain) used by each preset may
510 versions. The settings may also vary between files being compressed, if
512 determines that modified settings will probably give better compression
513 ratio without significantly affecting compression time or memory usage.
515 Because the settings may vary, the memory usage may vary too. The following
516 table lists the maximum memory usage of each preset level, which won't be
517 exceeded even in future versions of
520 .B "FIXME: The table below is just a rough idea."
527 Preset;Compression;Decompression
544 automatically adjusts the compression settings downwards if
545 the memory usage limit would be exceeded, so it is safe to specify
546 a high preset level even on systems that don't have lots of RAM.
548 .BR \-\-fast " and " \-\-best
549 These are somewhat misleading aliases for
554 These are provided only for backwards compatibility with LZMA Utils.
555 Avoid using these options.
557 Especially the name of
559 is misleading, because the definition of best depends on the input data,
560 and that usually people don't want the very best compression ratio anyway,
561 because it would be very slow.
563 .BR \-e ", " \-\-extreme
564 Modify the compression preset (\fB\-0\fR ... \fB\-9\fR) so that a little bit
565 better compression ratio can be achieved without increasing memory usage
566 of the compressor or decompressor (exception: compressor memory usage may
567 increase a little with presets \fB\-0\fR ... \fB\-2\fR). The downside is that
568 the compression time will increase dramatically (it can easily double).
570 \fB\-M\fR \fIlimit\fR, \fB\-\-memory=\fIlimit
571 Set the memory usage limit. If this option is specified multiple times,
572 the last one takes effect. The
574 can be specified in multiple ways:
579 can be an absolute value in bytes. Using an integer suffix like
581 can be useful. Example:
582 .B "\-\-memory=80MiB"
586 can be specified as a percentage of physical RAM. Example:
591 can be reset back to its default value (currently 40 % of physical RAM)
595 The memory usage limiting can be effectively disabled by setting
599 This isn't recommended. It's usually better to use, for example,
605 can be seen near the bottom of the output of the
609 \fB\-T\fR \fIthreads\fR, \fB\-\-threads=\fIthreads
610 Specify the maximum number of worker threads to use. The default is
611 the number of available CPU cores. You can see the current value of
613 near the end of the output of the
617 The actual number of worker threads can be less than
619 if using more threads would exceed the memory usage limit.
620 In addition to CPU-intensive worker threads,
622 may use a few auxiliary threads, which don't use a lot of CPU time.
624 .B "Multithreaded compression and decompression are not implemented yet,"
625 .B "so this option has no effect for now."
626 .SS Custom compressor filter chains
627 A custom filter chain allows specifying the compression settings in detail
628 instead of relying on the settings associated to the preset levels.
629 When a custom filter chain is specified, the compression preset level options
630 (\fB\-0\fR ... \fB\-9\fR and \fB\-\-extreme\fR) are silently ignored.
632 A filter chain is comparable to piping on the UN*X command line.
633 When compressing, the uncompressed input goes to the first filter, whose
634 output goes to the next filter (if any). The output of the last filter
635 gets written to the compressed file. The maximum number of filters in
636 the chain is four, but typically a filter chain has only one or two filters.
638 Many filters have limitations where they can be in the filter chain:
639 some filters can work only as the last filter in the chain, some only
640 as a non-last filter, and some work in any position in the chain. Depending
641 on the filter, this limitation is either inherent to the filter design or
642 exists to prevent security issues.
644 A custom filter chain is specified by using one or more filter options in
645 the order they are wanted in the filter chain. That is, the order of filter
646 options is significant! When decoding raw streams
647 .RB ( \-\-format=raw ),
648 the filter chain is specified in the same order as it was specified when
651 Filters take filter-specific
653 as a comma-separated list. Extra commas in
655 are ignored. Every option has a default value, so you need to
656 specify only those you want to change.
658 \fB\-\-lzma1\fR[\fB=\fIoptions\fR], \fB\-\-lzma2\fR[\fB=\fIoptions\fR]
659 Add LZMA1 or LZMA2 filter to the filter chain. These filter can be used
660 only as the last filter in the chain.
662 LZMA1 is a legacy filter, which is supported almost solely due to the legacy
664 file format, which supports only LZMA1. LZMA2 is an updated
665 version of LZMA1 to fix some practical issues of LZMA1. The
667 format uses LZMA2, and doesn't support LZMA1 at all. Compression speed and
668 ratios of LZMA1 and LZMA2 are practically the same.
670 LZMA1 and LZMA2 share the same set of
675 Reset all LZMA1 or LZMA2
680 consist of an integer, which may be followed by single-letter preset
681 modifiers. The integer can be from
685 matching the command line options \fB\-0\fR ... \fB\-9\fR.
686 The only supported modifier is currently
695 from which the default values for the rest of the LZMA1 or LZMA2
700 Dictionary (history buffer) size indicates how many bytes of the recently
701 processed uncompressed data is kept in memory. One method to reduce size of
702 the uncompressed data is to store distance-length pairs, which
703 indicate what data to repeat from the dictionary buffer. The bigger
704 the dictionary, the better the compression ratio usually is,
705 but dictionaries bigger than the uncompressed data are waste of RAM.
707 Typical dictionary size is from 64 KiB to 64 MiB. The minimum is 4 KiB.
708 The maximum for compression is currently 1.5 GiB. The decompressor already
709 supports dictionaries up to one byte less than 4 GiB, which is the
710 maximum for LZMA1 and LZMA2 stream formats.
712 Dictionary size has the biggest effect on compression ratio.
713 Dictionary size and match finder together determine the memory usage of
714 the LZMA1 or LZMA2 encoder. The same dictionary size is required
715 for decompressing that was used when compressing, thus the memory usage of
716 the decoder is determined by the dictionary size used when compressing.
719 Specify the number of literal context bits. The minimum is
725 In addition, the sum of
733 Specify the number of literal position bits. The minimum is
741 Specify the number of position bits. The minimum is
751 specifies the function used to analyze the data produced by the match finder.
770 Match finder has a major effect on encoder speed, memory usage, and
771 compression ratio. Usually Hash Chain match finders are faster than
772 Binary Tree match finders. Hash Chains are usually used together with
774 and Binary Trees with
776 The memory usage formulas are only rough estimates,
777 which are closest to reality when
783 Hash Chain with 2- and 3-byte hashing
801 Hash Chain with 2-, 3-, and 4-byte hashing
812 Binary Tree with 2-byte hashing
823 Binary Tree with 2- and 3-byte hashing
841 Binary Tree with 2-, 3-, and 4-byte hashing
853 Specify what is considered to be a nice length for a match. Once a match
856 bytes is found, the algorithm stops looking for possibly better matches.
859 can be 2\-273 bytes. Higher values tend to give better compression ratio
860 at expense of speed. The default depends on the
865 Specify the maximum search depth in the match finder. The default is the
868 which makes the compressor determine a reasonable
875 Using very high values for
877 can make the encoder extremely slow with carefully crafted files.
880 over 1000 unless you are prepared to interrupt the compression in case it
884 When decoding raw streams
885 .RB ( \-\-format=raw ),
886 LZMA2 needs only the value of
894 \fB\-\-x86\fR[\fB=\fIoptions\fR]
896 \fB\-\-powerpc\fR[\fB=\fIoptions\fR]
898 \fB\-\-ia64\fR[\fB=\fIoptions\fR]
900 \fB\-\-arm\fR[\fB=\fIoptions\fR]
902 \fB\-\-armthumb\fR[\fB=\fIoptions\fR]
904 \fB\-\-sparc\fR[\fB=\fIoptions\fR]
905 Add a branch/call/jump (BCJ) filter to the filter chain. These filters
906 can be used only as non-last filter in the filter chain.
908 A BCJ filter converts relative addresses in the machine code to their
909 absolute counterparts. This doesn't change the size of the data, but
910 it increases redundancy, which allows e.g. LZMA2 to get better
913 The BCJ filters are always reversible, so using a BCJ filter for wrong
914 type of data doesn't cause any data loss. However, applying a BCJ filter
915 for wrong type of data is a bad idea, because it tends to make the
916 compression ratio worse.
918 Different instruction sets have have different alignment:
925 Filter;Alignment;Notes
926 x86;1;32-bit and 64-bit x86
927 PowerPC;4;Big endian only
928 ARM;4;Little endian only
929 ARM-Thumb;2;Little endian only
930 IA-64;16;Big or little endian
931 SPARC;4;Big or little endian
936 Since the BCJ-filtered data is usually compressed with LZMA2, the compression
937 ratio may be improved slightly if the LZMA2 options are set to match the
938 alignment of the selected BCJ filter. For example, with the IA-64 filter,
941 with LZMA2 (2^4=16). The x86 filter is an exception; it's usually good to
942 stick to LZMA2's default four-byte alignment when compressing x86 executables.
944 All BCJ filters support the same
951 that is used when converting between relative and absolute addresses.
954 must be a multiple of the alignment of the filter (see the table above).
955 The default is zero. In practice, the default is good; specifying
958 is almost never useful.
960 Specifying a non-zero start
962 is probably useful only if the executable has multiple sections, and there
963 are many cross-section jumps or calls. Applying a BCJ filter separately for
964 each section with proper start offset and then compressing the result as
965 a single chunk may give some improvement in compression ratio compared
966 to applying the BCJ filter with the default
968 for the whole executable.
971 \fB\-\-delta\fR[\fB=\fIoptions\fR]
972 Add Delta filter to the filter chain. The Delta filter
973 can be used only as non-last filter in the filter chain.
975 Currently only simple byte-wise delta calculation is supported. It can
976 be useful when compressing e.g. uncompressed bitmap images or uncompressed
977 PCM audio. However, special purpose algorithms may give significantly better
978 results than Delta + LZMA2. This is true especially with audio, which
979 compresses faster and better e.g. with FLAC.
988 of the delta calculation as bytes.
990 must be 1\-256. The default is 1.
994 and eight-byte input A1 B1 A2 B3 A3 B5 A4 B7, the output will be
995 A1 B1 01 02 01 02 01 02.
999 .BR \-q ", " \-\-quiet
1000 Suppress warnings and notices. Specify this twice to suppress errors too.
1001 This option has no effect on the exit status. That is, even if a warning
1002 was suppressed, the exit status to indicate a warning is still used.
1004 .BR \-v ", " \-\-verbose
1005 Be verbose. If standard error is connected to a terminal,
1007 will display a progress indicator.
1010 twice will give even more verbose output (useful mostly for debugging).
1012 The progress indicator shows the following information:
1015 Completion percentage is shown if the size of the input file is known.
1016 That is, percentage cannot be shown in pipes.
1018 Amount of compressed data produced (compressing) or consumed (decompressing).
1020 Amount of uncompressed data consumed (compressing) or produced
1023 Compression ratio, which is calculated by dividing the amount of
1024 compressed data processed so far by the amount of uncompressed data
1027 Compression or decompression speed. This is measured as the amount of
1028 uncompressed data consumed (compression) or produced (decompression)
1029 per second. It is shown once a few seconds have passed since
1031 started processing the file.
1033 Elapsed time or estimated time remaining.
1034 Elapsed time is displayed in the format M:SS or H:MM:SS.
1035 The estimated remaining time is displayed in a less precise format
1036 which never has colons, for example, 2 min 30 s. The estimate can
1037 be shown only when the size of the input file is known and a couple of
1038 seconds have already passed since
1040 started processing the file.
1043 When standard error is not a terminal,
1047 print the filename, compressed size, uncompressed size, compression ratio,
1048 speed, and elapsed time on a single line to standard error after
1049 compressing or decompressing the file. If operating took at least a few
1050 seconds, also the speed and elapsed time are printed. If the operation
1051 didn't finish, for example due to user interruption, also the completion
1052 percentage is printed if the size of the input file is known.
1054 .BR \-Q ", " \-\-no\-warn
1055 Don't set the exit status to
1057 even if a condition worth a warning was detected. This option doesn't affect
1058 the verbosity level, thus both
1062 have to be used to not display warnings and to not alter the exit status.
1065 Print messages in a machine-parsable format. This is intended to ease
1066 writing frontends that want to use
1068 instead of liblzma, which may be the case with various scripts. The output
1069 with this option enabled is meant to be stable across
1073 is implemented only for
1077 but the idea is to make it usable for actual compression
1078 and decompression too.
1081 Display the current memory usage limit in human-readable format on
1082 a single line, and exit successfully. To see how much RAM
1084 thinks your system has, use
1085 .BR "\-\-memory=100% \-\-info\-memory" .
1086 To get machine-parsable output
1087 (memory usage limit as bytes without thousand separators), specify
1090 .BR \-\-info-memory .
1092 .BR \-h ", " \-\-help
1093 Display a help message describing the most commonly used options,
1094 and exit successfully.
1096 .BR \-H ", " \-\-long\-help
1097 Display a help message describing all features of
1099 and exit successfully
1101 .BR \-V ", " \-\-version
1102 Display the version number of
1104 and liblzma in human readable format. To get machine-parsable output, specify
1117 Something worth a warning occurred, but no actual errors occurred.
1119 Notices (not warnings or errors) printed on standard error don't affect
1124 A space-separated list of options is parsed from
1126 before parsing the options given on the command line. Note that only
1127 options are parsed from
1129 all non-options are silently ignored. Parsing is done with
1131 which is used also for the command line arguments.
1132 .SH "LZMA UTILS COMPATIBILITY"
1133 The command line syntax of
1135 is practically a superset of
1140 as found from LZMA Utils 4.32.x. In most cases, it is possible to replace
1141 LZMA Utils with XZ Utils without breaking existing scripts. There are some
1142 incompatibilities though, which may sometimes cause problems.
1143 .SS "Compression preset levels"
1144 The numbering of the compression level presets is not identical in
1147 The most important difference is how dictionary sizes are mapped to different
1148 presets. Dictionary size is roughly equal to the decompressor memory usage.
1167 The dictionary size differences affect the compressor memory usage too,
1168 but there are some other differences between LZMA Utils and XZ Utils, which
1169 make the difference even bigger:
1175 Level;xz;LZMA Utils 4.32.x
1188 The default preset level in LZMA Utils is
1190 while in XZ Utils it is
1192 so both use 8 MiB dictionary by default.
1193 .SS "Streamed vs. non-streamed .lzma files"
1194 Uncompressed size of the file can be stored in the
1196 header. LZMA Utils does that when compressing regular files.
1197 The alternative is to mark that uncompressed size is unknown and
1198 use end of payload marker to indicate where the decompressor should stop.
1199 LZMA Utils uses this method when uncompressed size isn't known, which is
1200 the case for example in pipes.
1203 supports decompressing
1205 files with or without end of payload marker, but all
1209 will use end of payload marker and have uncompressed size marked as unknown
1212 header. This may be a problem in some (uncommon) situations. For example, a
1214 decompressor in an embedded device might work only with files that have known
1215 uncompressed size. If you hit this problem, you need to use LZMA Utils or
1218 files with known uncompressed size.
1219 .SS "Unsupported .lzma files"
1226 values up to 4. LZMA Utils can decompress files with any
1230 but always creates files with
1234 Creating files with other
1242 The implementation of the LZMA1 filter in liblzma requires
1247 must not exceed 4. Thus,
1249 files which exceed this limitation, cannot be decompressed with
1252 LZMA Utils creates only
1254 files which have dictionary size of
1256 (a power of 2), but accepts files with any dictionary size.
1257 liblzma accepts only
1259 files which have dictionary size of
1262 .RI "2^" n " + 2^(" n "\-1)."
1263 This is to decrease false positives when detecting
1267 These limitations shouldn't be a problem in practice, since practically all
1269 files have been compressed with settings that liblzma will accept.
1270 .SS "Trailing garbage"
1271 When decompressing, LZMA Utils silently ignore everything after the first
1273 stream. In most situations, this is a bug. This also means that LZMA Utils
1274 don't support decompressing concatenated
1278 If there is data left after the first
1282 considers the file to be corrupt. This may break obscure scripts which have
1283 assumed that trailing garbage is ignored.
1285 .SS Compressed output may vary
1286 The exact compressed output produced from the same uncompressed input file
1287 may vary between XZ Utils versions even if compression options are identical.
1288 This is because the encoder can be improved (faster or better compression)
1289 without affecting the file format. The output can vary even between different
1290 builds of the same XZ Utils version, if different build options are used.
1292 The above means that implementing
1296 files is not going to happen without freezing a part of the encoder
1297 implementation, which can then be used with
1299 .SS Embedded .xz decompressors
1302 decompressor implementations like XZ Embedded don't necessarily support files
1309 Since the default is \fB\-\-check=\fIcrc64\fR, you must use
1313 when creating files for embedded systems.
1315 Outside embedded systems, all
1317 format decompressors support all the
1319 types, or at least are able to decompress the file without verifying the
1320 integrity check if the particular
1324 XZ Embedded supports BCJ filters, but only with the default start offset.
1330 XZ Utils: <http://tukaani.org/xz/>
1332 XZ Embedded: <http://tukaani.org/xz/embedded.html>
1334 LZMA SDK: <http://7-zip.org/sdk.html>