# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR This file is put in the public domain. # This file is distributed under the same license as the XZ Utils package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: XZ Utils 5.2.5\n" "POT-Creation-Date: 2020-03-17 16:31+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: ../src/xz/xz.1:8 #, no-wrap msgid "XZ" msgstr "" #. type: TH #: ../src/xz/xz.1:8 #, no-wrap msgid "2020-02-01" msgstr "" #. type: TH #: ../src/xz/xz.1:8 ../src/xzdec/xzdec.1:7 ../src/lzmainfo/lzmainfo.1:7 ../src/scripts/xzdiff.1:9 ../src/scripts/xzgrep.1:9 ../src/scripts/xzless.1:10 ../src/scripts/xzmore.1:7 #, no-wrap msgid "Tukaani" msgstr "" #. type: TH #: ../src/xz/xz.1:8 ../src/xzdec/xzdec.1:7 ../src/lzmainfo/lzmainfo.1:7 ../src/scripts/xzdiff.1:9 ../src/scripts/xzgrep.1:9 ../src/scripts/xzless.1:10 ../src/scripts/xzmore.1:7 #, no-wrap msgid "XZ Utils" msgstr "" #. type: SH #: ../src/xz/xz.1:10 ../src/xzdec/xzdec.1:8 ../src/lzmainfo/lzmainfo.1:8 ../src/scripts/xzdiff.1:10 ../src/scripts/xzgrep.1:10 ../src/scripts/xzless.1:11 ../src/scripts/xzmore.1:8 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: ../src/xz/xz.1:12 msgid "" "xz, unxz, xzcat, lzma, unlzma, lzcat - Compress or decompress .xz and .lzma " "files" msgstr "" #. type: SH #: ../src/xz/xz.1:13 ../src/xzdec/xzdec.1:10 ../src/lzmainfo/lzmainfo.1:10 ../src/scripts/xzdiff.1:12 ../src/scripts/xzgrep.1:12 ../src/scripts/xzless.1:13 ../src/scripts/xzmore.1:10 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: ../src/xz/xz.1:17 msgid "B [I] [I]" msgstr "" #. type: SH #: ../src/xz/xz.1:18 #, no-wrap msgid "COMMAND ALIASES" msgstr "" #. type: Plain text #: ../src/xz/xz.1:22 msgid "B is equivalent to B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:26 msgid "B is equivalent to B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:30 msgid "B is equivalent to B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:34 msgid "B is equivalent to B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:38 msgid "B is equivalent to B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:50 msgid "" "When writing scripts that need to decompress files, it is recommended to " "always use the name B with appropriate arguments (B or B) " "instead of the names B and B." msgstr "" #. type: SH #: ../src/xz/xz.1:51 ../src/xzdec/xzdec.1:18 ../src/lzmainfo/lzmainfo.1:15 ../src/scripts/xzdiff.1:24 ../src/scripts/xzgrep.1:33 ../src/scripts/xzless.1:19 ../src/scripts/xzmore.1:16 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: ../src/xz/xz.1:65 msgid "" "B is a general-purpose data compression tool with command line syntax " "similar to B(1) and B(1). The native file format is the " "B<.xz> format, but the legacy B<.lzma> format used by LZMA Utils and raw " "compressed streams with no container format headers are also supported." msgstr "" #. type: Plain text #: ../src/xz/xz.1:87 msgid "" "B compresses or decompresses each I according to the selected " "operation mode. If no I are given or I is B<->, B reads " "from standard input and writes the processed data to standard output. B " "will refuse (display an error and skip the I) to write compressed " "data to standard output if it is a terminal. Similarly, B will refuse " "to read compressed data from standard input if it is a terminal." msgstr "" #. type: Plain text #: ../src/xz/xz.1:97 msgid "" "Unless B<--stdout> is specified, I other than B<-> are written to a " "new file whose name is derived from the source I name:" msgstr "" #. type: IP #: ../src/xz/xz.1:97 ../src/xz/xz.1:103 ../src/xz/xz.1:127 ../src/xz/xz.1:132 ../src/xz/xz.1:135 ../src/xz/xz.1:138 ../src/xz/xz.1:154 ../src/xz/xz.1:395 ../src/xz/xz.1:398 ../src/xz/xz.1:405 ../src/xz/xz.1:621 ../src/xz/xz.1:623 ../src/xz/xz.1:722 ../src/xz/xz.1:733 ../src/xz/xz.1:742 ../src/xz/xz.1:750 ../src/xz/xz.1:965 ../src/xz/xz.1:974 ../src/xz/xz.1:986 ../src/xz/xz.1:1552 ../src/xz/xz.1:1558 ../src/xz/xz.1:1674 ../src/xz/xz.1:1678 ../src/xz/xz.1:1681 ../src/xz/xz.1:1684 ../src/xz/xz.1:1688 ../src/xz/xz.1:1695 ../src/xz/xz.1:1697 #, no-wrap msgid "\\(bu" msgstr "" #. type: Plain text #: ../src/xz/xz.1:103 msgid "" "When compressing, the suffix of the target file format (B<.xz> or B<.lzma>) " "is appended to the source filename to get the target filename." msgstr "" #. type: Plain text #: ../src/xz/xz.1:117 msgid "" "When decompressing, the B<.xz> or B<.lzma> suffix is removed from the " "filename to get the target filename. B also recognizes the suffixes " "B<.txz> and B<.tlz>, and replaces them with the B<.tar> suffix." msgstr "" #. type: Plain text #: ../src/xz/xz.1:121 msgid "" "If the target file already exists, an error is displayed and the I is " "skipped." msgstr "" #. type: Plain text #: ../src/xz/xz.1:127 msgid "" "Unless writing to standard output, B will display a warning and skip the " "I if any of the following applies:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:132 msgid "" "I is not a regular file. Symbolic links are not followed, and thus " "they are not considered to be regular files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:135 msgid "I has more than one hard link." msgstr "" #. type: Plain text #: ../src/xz/xz.1:138 msgid "I has setuid, setgid, or sticky bit set." msgstr "" #. type: Plain text #: ../src/xz/xz.1:154 msgid "" "The operation mode is set to compress and the I already has a suffix " "of the target file format (B<.xz> or B<.txz> when compressing to the B<.xz> " "format, and B<.lzma> or B<.tlz> when compressing to the B<.lzma> format)." msgstr "" #. type: Plain text #: ../src/xz/xz.1:163 msgid "" "The operation mode is set to decompress and the I doesn't have a " "suffix of any of the supported file formats (B<.xz>, B<.txz>, B<.lzma>, or " "B<.tlz>)." msgstr "" #. type: Plain text #: ../src/xz/xz.1:178 msgid "" "After successfully compressing or decompressing the I, B copies " "the owner, group, permissions, access time, and modification time from the " "source I to the target file. If copying the group fails, the " "permissions are modified so that the target file doesn't become accessible " "to users who didn't have permission to access the source I. B " "doesn't support copying other metadata like access control lists or extended " "attributes yet." msgstr "" #. type: Plain text #: ../src/xz/xz.1:187 msgid "" "Once the target file has been successfully closed, the source I is " "removed unless B<--keep> was specified. The source I is never removed " "if the output is written to standard output." msgstr "" #. type: Plain text #: ../src/xz/xz.1:199 msgid "" "Sending B or B to the B process makes it print " "progress information to standard error. This has only limited use since " "when standard error is a terminal, using B<--verbose> will display an " "automatically updating progress indicator." msgstr "" #. type: SS #: ../src/xz/xz.1:200 #, no-wrap msgid "Memory usage" msgstr "" #. type: Plain text #: ../src/xz/xz.1:216 msgid "" "The memory usage of B varies from a few hundred kilobytes to several " "gigabytes depending on the compression settings. The settings used when " "compressing a file determine the memory requirements of the decompressor. " "Typically the decompressor needs 5\\ % to 20\\ % of the amount of memory " "that the compressor needed when creating the file. For example, " "decompressing a file created with B currently requires 65\\ MiB of " "memory. Still, it is possible to have B<.xz> files that require several " "gigabytes of memory to decompress." msgstr "" #. type: Plain text #: ../src/xz/xz.1:228 msgid "" "Especially users of older systems may find the possibility of very large " "memory usage annoying. To prevent uncomfortable surprises, B has a " "built-in memory usage limiter, which is disabled by default. While some " "operating systems provide ways to limit the memory usage of processes, " "relying on it wasn't deemed to be flexible enough (e.g. using B(1) " "to limit virtual memory tends to cripple B(2))." msgstr "" #. type: Plain text #: ../src/xz/xz.1:248 msgid "" "The memory usage limiter can be enabled with the command line option " "B<--memlimit=>I. Often it is more convenient to enable the limiter " "by default by setting the environment variable B, e.g.\\& " "B. It is possible to set the limits " "separately for compression and decompression by using " "B<--memlimit-compress=>I and B<--memlimit-decompress=>I. " "Using these two options outside B is rarely useful because a " "single run of B cannot do both compression and decompression and " "B<--memlimit=>I (or B<-M> I) is shorter to type on the " "command line." msgstr "" #. type: Plain text #: ../src/xz/xz.1:265 msgid "" "If the specified memory usage limit is exceeded when decompressing, B " "will display an error and decompressing the file will fail. If the limit is " "exceeded when compressing, B will try to scale the settings down so that " "the limit is no longer exceeded (except when using B<--format=raw> or " "B<--no-adjust>). This way the operation won't fail unless the limit is very " "small. The scaling of the settings is done in steps that don't match the " "compression level presets, e.g. if the limit is only slightly less than the " "amount required for B, the settings will be scaled down only a " "little, not all the way down to B." msgstr "" #. type: SS #: ../src/xz/xz.1:266 #, no-wrap msgid "Concatenation and padding with .xz files" msgstr "" #. type: Plain text #: ../src/xz/xz.1:274 msgid "" "It is possible to concatenate B<.xz> files as is. B will decompress " "such files as if they were a single B<.xz> file." msgstr "" #. type: Plain text #: ../src/xz/xz.1:283 msgid "" "It is possible to insert padding between the concatenated parts or after the " "last part. The padding must consist of null bytes and the size of the " "padding must be a multiple of four bytes. This can be useful e.g. if the " "B<.xz> file is stored on a medium that measures file sizes in 512-byte " "blocks." msgstr "" #. type: Plain text #: ../src/xz/xz.1:287 msgid "" "Concatenation and padding are not allowed with B<.lzma> files or raw " "streams." msgstr "" #. type: SH #: ../src/xz/xz.1:288 ../src/xzdec/xzdec.1:61 #, no-wrap msgid "OPTIONS" msgstr "" #. type: SS #: ../src/xz/xz.1:290 #, no-wrap msgid "Integer suffixes and special values" msgstr "" #. type: Plain text #: ../src/xz/xz.1:294 msgid "" "In most places where an integer argument is expected, an optional suffix is " "supported to easily indicate large integers. There must be no space between " "the integer and the suffix." msgstr "" #. type: TP #: ../src/xz/xz.1:294 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:305 msgid "" "Multiply the integer by 1,024 (2^10). B, B, B, B, and B " "are accepted as synonyms for B." msgstr "" #. type: TP #: ../src/xz/xz.1:305 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:315 msgid "" "Multiply the integer by 1,048,576 (2^20). B, B, B, and B are " "accepted as synonyms for B." msgstr "" #. type: TP #: ../src/xz/xz.1:315 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:325 msgid "" "Multiply the integer by 1,073,741,824 (2^30). B, B, B, and B " "are accepted as synonyms for B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:330 msgid "" "The special value B can be used to indicate the maximum integer value " "supported by the option." msgstr "" #. type: SS #: ../src/xz/xz.1:331 #, no-wrap msgid "Operation mode" msgstr "" #. type: Plain text #: ../src/xz/xz.1:334 msgid "If multiple operation mode options are given, the last one takes effect." msgstr "" #. type: TP #: ../src/xz/xz.1:334 #, no-wrap msgid "B<-z>, B<--compress>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:343 msgid "" "Compress. This is the default operation mode when no operation mode option " "is specified and no other operation mode is implied from the command name " "(for example, B implies B<--decompress>)." msgstr "" #. type: TP #: ../src/xz/xz.1:343 ../src/xzdec/xzdec.1:62 #, no-wrap msgid "B<-d>, B<--decompress>, B<--uncompress>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:346 msgid "Decompress." msgstr "" #. type: TP #: ../src/xz/xz.1:346 #, no-wrap msgid "B<-t>, B<--test>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:355 msgid "" "Test the integrity of compressed I. This option is equivalent to " "B<--decompress --stdout> except that the decompressed data is discarded " "instead of being written to standard output. No files are created or " "removed." msgstr "" #. type: TP #: ../src/xz/xz.1:355 #, no-wrap msgid "B<-l>, B<--list>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:364 msgid "" "Print information about compressed I. No uncompressed output is " "produced, and no files are created or removed. In list mode, the program " "cannot read the compressed data from standard input or from other unseekable " "sources." msgstr "" #. type: Plain text #: ../src/xz/xz.1:379 msgid "" "The default listing shows basic information about I, one file per " "line. To get more detailed information, use also the B<--verbose> option. " "For even more information, use B<--verbose> twice, but note that this may be " "slow, because getting all the extra information requires many seeks. The " "width of verbose output exceeds 80 characters, so piping the output to " "e.g.\\& B may be convenient if the terminal isn't wide enough." msgstr "" #. type: Plain text #: ../src/xz/xz.1:386 msgid "" "The exact output may vary between B versions and different locales. For " "machine-readable output, B<--robot --list> should be used." msgstr "" #. type: SS #: ../src/xz/xz.1:387 #, no-wrap msgid "Operation modifiers" msgstr "" #. type: TP #: ../src/xz/xz.1:388 ../src/xzdec/xzdec.1:69 #, no-wrap msgid "B<-k>, B<--keep>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:391 msgid "Don't delete the input files." msgstr "" #. type: TP #: ../src/xz/xz.1:391 #, no-wrap msgid "B<-f>, B<--force>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:394 msgid "This option has several effects:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:398 msgid "" "If the target file already exists, delete it before compressing or " "decompressing." msgstr "" #. type: Plain text #: ../src/xz/xz.1:405 msgid "" "Compress or decompress even if the input is a symbolic link to a regular " "file, has more than one hard link, or has the setuid, setgid, or sticky bit " "set. The setuid, setgid, and sticky bits are not copied to the target file." msgstr "" #. type: Plain text #: ../src/xz/xz.1:430 msgid "" "When used with B<--decompress> B<--stdout> and B cannot recognize the " "type of the source file, copy the source file as is to standard output. " "This allows B B<--force> to be used like B(1) for files that " "have not been compressed with B. Note that in future, B might " "support new compressed file formats, which may make B decompress more " "types of files instead of copying them as is to standard output. " "B<--format=>I can be used to restrict B to decompress only a " "single file format." msgstr "" #. type: TP #: ../src/xz/xz.1:431 ../src/xzdec/xzdec.1:76 #, no-wrap msgid "B<-c>, B<--stdout>, B<--to-stdout>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:437 msgid "" "Write the compressed or decompressed data to standard output instead of a " "file. This implies B<--keep>." msgstr "" #. type: TP #: ../src/xz/xz.1:437 #, no-wrap msgid "B<--single-stream>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:446 msgid "" "Decompress only the first B<.xz> stream, and silently ignore possible " "remaining input data following the stream. Normally such trailing garbage " "makes B display an error." msgstr "" #. type: Plain text #: ../src/xz/xz.1:455 msgid "" "B never decompresses more than one stream from B<.lzma> files or raw " "streams, but this option still makes B ignore the possible trailing data " "after the B<.lzma> file or raw stream." msgstr "" #. type: Plain text #: ../src/xz/xz.1:460 msgid "" "This option has no effect if the operation mode is not B<--decompress> or " "B<--test>." msgstr "" #. type: TP #: ../src/xz/xz.1:460 #, no-wrap msgid "B<--no-sparse>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:472 msgid "" "Disable creation of sparse files. By default, if decompressing into a " "regular file, B tries to make the file sparse if the decompressed data " "contains long sequences of binary zeros. It also works when writing to " "standard output as long as standard output is connected to a regular file " "and certain additional conditions are met to make it safe. Creating sparse " "files may save disk space and speed up the decompression by reducing the " "amount of disk I/O." msgstr "" #. type: TP #: ../src/xz/xz.1:472 #, no-wrap msgid "B<-S> I<.suf>, B<--suffix=>I<.suf>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:484 msgid "" "When compressing, use I<.suf> as the suffix for the target file instead of " "B<.xz> or B<.lzma>. If not writing to standard output and the source file " "already has the suffix I<.suf>, a warning is displayed and the file is " "skipped." msgstr "" #. type: Plain text #: ../src/xz/xz.1:497 msgid "" "When decompressing, recognize files with the suffix I<.suf> in addition to " "files with the B<.xz>, B<.txz>, B<.lzma>, or B<.tlz> suffix. If the source " "file has the suffix I<.suf>, the suffix is removed to get the target " "filename." msgstr "" #. type: Plain text #: ../src/xz/xz.1:503 msgid "" "When compressing or decompressing raw streams (B<--format=raw>), the suffix " "must always be specified unless writing to standard output, because there is " "no default suffix for raw streams." msgstr "" #. type: TP #: ../src/xz/xz.1:503 #, no-wrap msgid "B<--files>[B<=>I]" msgstr "" #. type: Plain text #: ../src/xz/xz.1:517 msgid "" "Read the filenames to process from I; if I is omitted, filenames " "are read from standard input. Filenames must be terminated with the newline " "character. A dash (B<->) is taken as a regular filename; it doesn't mean " "standard input. If filenames are given also as command line arguments, they " "are processed before the filenames read from I." msgstr "" #. type: TP #: ../src/xz/xz.1:517 #, no-wrap msgid "B<--files0>[B<=>I]" msgstr "" #. type: Plain text #: ../src/xz/xz.1:521 msgid "" "This is identical to B<--files>[B<=>I] except that each filename must " "be terminated with the null character." msgstr "" #. type: SS #: ../src/xz/xz.1:522 #, no-wrap msgid "Basic file format and compression options" msgstr "" #. type: TP #: ../src/xz/xz.1:523 #, no-wrap msgid "B<-F> I, B<--format=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:528 msgid "Specify the file I to compress or decompress:" msgstr "" #. type: TP #: ../src/xz/xz.1:529 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:541 msgid "" "This is the default. When compressing, B is equivalent to B. " "When decompressing, the format of the input file is automatically detected. " "Note that raw streams (created with B<--format=raw>) cannot be " "auto-detected." msgstr "" #. type: TP #: ../src/xz/xz.1:541 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:548 msgid "" "Compress to the B<.xz> file format, or accept only B<.xz> files when " "decompressing." msgstr "" #. type: TP #: ../src/xz/xz.1:548 #, no-wrap msgid "B, B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:558 msgid "" "Compress to the legacy B<.lzma> file format, or accept only B<.lzma> files " "when decompressing. The alternative name B is provided for backwards " "compatibility with LZMA Utils." msgstr "" #. type: TP #: ../src/xz/xz.1:558 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:566 msgid "" "Compress or uncompress a raw stream (no headers). This is meant for " "advanced users only. To decode raw streams, you need use B<--format=raw> " "and explicitly specify the filter chain, which normally would have been " "stored in the container headers." msgstr "" #. type: TP #: ../src/xz/xz.1:567 #, no-wrap msgid "B<-C> I, B<--check=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:582 msgid "" "Specify the type of the integrity check. The check is calculated from the " "uncompressed data and stored in the B<.xz> file. This option has an effect " "only when compressing into the B<.xz> format; the B<.lzma> format doesn't " "support integrity checks. The integrity check (if any) is verified when the " "B<.xz> file is decompressed." msgstr "" #. type: Plain text #: ../src/xz/xz.1:586 msgid "Supported I types:" msgstr "" #. type: TP #: ../src/xz/xz.1:587 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:593 msgid "" "Don't calculate an integrity check at all. This is usually a bad idea. " "This can be useful when integrity of the data is verified by other means " "anyway." msgstr "" #. type: TP #: ../src/xz/xz.1:593 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:596 msgid "Calculate CRC32 using the polynomial from IEEE-802.3 (Ethernet)." msgstr "" #. type: TP #: ../src/xz/xz.1:596 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:601 msgid "" "Calculate CRC64 using the polynomial from ECMA-182. This is the default, " "since it is slightly better than CRC32 at detecting damaged files and the " "speed difference is negligible." msgstr "" #. type: TP #: ../src/xz/xz.1:601 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:605 msgid "Calculate SHA-256. This is somewhat slower than CRC32 and CRC64." msgstr "" #. type: Plain text #: ../src/xz/xz.1:611 msgid "" "Integrity of the B<.xz> headers is always verified with CRC32. It is not " "possible to change or disable it." msgstr "" #. type: TP #: ../src/xz/xz.1:611 #, no-wrap msgid "B<--ignore-check>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:617 msgid "" "Don't verify the integrity check of the compressed data when decompressing. " "The CRC32 values in the B<.xz> headers will still be verified normally." msgstr "" #. type: Plain text #: ../src/xz/xz.1:620 msgid "" "B Possible " "reasons to use this option:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:623 msgid "Trying to recover data from a corrupt .xz file." msgstr "" #. type: Plain text #: ../src/xz/xz.1:629 msgid "" "Speeding up decompression. This matters mostly with SHA-256 or with files " "that have compressed extremely well. It's recommended to not use this " "option for this purpose unless the file integrity is verified externally in " "some other way." msgstr "" #. type: TP #: ../src/xz/xz.1:630 #, no-wrap msgid "B<-0> ... B<-9>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:639 msgid "" "Select a compression preset level. The default is B<-6>. If multiple " "preset levels are specified, the last one takes effect. If a custom filter " "chain was already specified, setting a compression preset level clears the " "custom filter chain." msgstr "" #. type: Plain text #: ../src/xz/xz.1:654 msgid "" "The differences between the presets are more significant than with " "B(1) and B(1). The selected compression settings determine " "the memory requirements of the decompressor, thus using a too high preset " "level might make it painful to decompress the file on an old system with " "little RAM. Specifically, B like it often is with B(1) and B(1)." msgstr "" #. type: TP #: ../src/xz/xz.1:655 #, no-wrap msgid "B<-0> ... B<-3>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:667 msgid "" "These are somewhat fast presets. B<-0> is sometimes faster than B " "while compressing much better. The higher ones often have speed comparable " "to B(1) with comparable or better compression ratio, although the " "results depend a lot on the type of data being compressed." msgstr "" #. type: TP #: ../src/xz/xz.1:667 #, no-wrap msgid "B<-4> ... B<-6>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:681 msgid "" "Good to very good compression while keeping decompressor memory usage " "reasonable even for old systems. B<-6> is the default, which is usually a " "good choice e.g. for distributing files that need to be decompressible even " "on systems with only 16\\ MiB RAM. (B<-5e> or B<-6e> may be worth " "considering too. See B<--extreme>.)" msgstr "" #. type: TP #: ../src/xz/xz.1:681 #, no-wrap msgid "B<-7 ... -9>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:688 msgid "" "These are like B<-6> but with higher compressor and decompressor memory " "requirements. These are useful only when compressing files bigger than 8\\ " "MiB, 16\\ MiB, and 32\\ MiB, respectively." msgstr "" #. type: Plain text #: ../src/xz/xz.1:696 msgid "" "On the same hardware, the decompression speed is approximately a constant " "number of bytes of compressed data per second. In other words, the better " "the compression, the faster the decompression will usually be. This also " "means that the amount of uncompressed output produced per second can vary a " "lot." msgstr "" #. type: Plain text #: ../src/xz/xz.1:698 msgid "The following table summarises the features of the presets:" msgstr "" #. type: tbl table #: ../src/xz/xz.1:705 ../src/xz/xz.1:786 ../src/xz/xz.1:2623 #, no-wrap msgid "Preset" msgstr "" #. type: tbl table #: ../src/xz/xz.1:705 ../src/xz/xz.1:786 #, no-wrap msgid "DictSize" msgstr "" #. type: tbl table #: ../src/xz/xz.1:705 ../src/xz/xz.1:786 ../src/xz/xz.1:2623 #, no-wrap msgid "CompCPU" msgstr "" #. type: tbl table #: ../src/xz/xz.1:705 ../src/xz/xz.1:786 #, no-wrap msgid "CompMem" msgstr "" #. type: tbl table #: ../src/xz/xz.1:705 ../src/xz/xz.1:786 #, no-wrap msgid "DecMem" msgstr "" #. type: tbl table #: ../src/xz/xz.1:706 ../src/xz/xz.1:2234 ../src/xz/xz.1:2259 ../src/xz/xz.1:2624 #, no-wrap msgid "-0" msgstr "" #. type: tbl table #: ../src/xz/xz.1:706 ../src/xz/xz.1:787 ../src/xz/xz.1:2234 #, no-wrap msgid "256 KiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:706 ../src/xz/xz.1:2624 #, no-wrap msgid "0" msgstr "" #. type: tbl table #: ../src/xz/xz.1:706 ../src/xz/xz.1:708 ../src/xz/xz.1:789 ../src/xz/xz.1:2259 #, no-wrap msgid "3 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:706 ../src/xz/xz.1:707 ../src/xz/xz.1:787 ../src/xz/xz.1:788 ../src/xz/xz.1:2235 ../src/xz/xz.1:2236 ../src/xz/xz.1:2238 #, no-wrap msgid "1 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:707 ../src/xz/xz.1:2235 ../src/xz/xz.1:2260 ../src/xz/xz.1:2625 #, no-wrap msgid "-1" msgstr "" #. type: tbl table #: ../src/xz/xz.1:707 ../src/xz/xz.1:1582 ../src/xz/xz.1:2625 #, no-wrap msgid "1" msgstr "" #. type: tbl table #: ../src/xz/xz.1:707 ../src/xz/xz.1:711 ../src/xz/xz.1:712 ../src/xz/xz.1:792 ../src/xz/xz.1:793 ../src/xz/xz.1:2260 #, no-wrap msgid "9 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:707 ../src/xz/xz.1:708 ../src/xz/xz.1:788 ../src/xz/xz.1:789 ../src/xz/xz.1:2236 ../src/xz/xz.1:2239 ../src/xz/xz.1:2260 #, no-wrap msgid "2 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:708 ../src/xz/xz.1:2236 ../src/xz/xz.1:2261 ../src/xz/xz.1:2626 #, no-wrap msgid "-2" msgstr "" #. type: tbl table #: ../src/xz/xz.1:708 ../src/xz/xz.1:1585 ../src/xz/xz.1:2626 #, no-wrap msgid "2" msgstr "" #. type: tbl table #: ../src/xz/xz.1:708 ../src/xz/xz.1:713 ../src/xz/xz.1:794 ../src/xz/xz.1:2261 #, no-wrap msgid "17 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:709 ../src/xz/xz.1:2237 ../src/xz/xz.1:2262 ../src/xz/xz.1:2627 #, no-wrap msgid "-3" msgstr "" #. type: tbl table #: ../src/xz/xz.1:709 ../src/xz/xz.1:710 ../src/xz/xz.1:787 ../src/xz/xz.1:790 ../src/xz/xz.1:791 ../src/xz/xz.1:2237 ../src/xz/xz.1:2238 ../src/xz/xz.1:2240 #, no-wrap msgid "4 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:709 ../src/xz/xz.1:2627 #, no-wrap msgid "3" msgstr "" #. type: tbl table #: ../src/xz/xz.1:709 ../src/xz/xz.1:714 ../src/xz/xz.1:795 ../src/xz/xz.1:2242 ../src/xz/xz.1:2243 ../src/xz/xz.1:2262 #, no-wrap msgid "32 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:709 ../src/xz/xz.1:710 ../src/xz/xz.1:790 ../src/xz/xz.1:791 #, no-wrap msgid "5 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:710 ../src/xz/xz.1:2238 ../src/xz/xz.1:2263 ../src/xz/xz.1:2628 #, no-wrap msgid "-4" msgstr "" #. type: tbl table #: ../src/xz/xz.1:710 ../src/xz/xz.1:1583 ../src/xz/xz.1:1584 ../src/xz/xz.1:1587 ../src/xz/xz.1:2628 #, no-wrap msgid "4" msgstr "" #. type: tbl table #: ../src/xz/xz.1:710 ../src/xz/xz.1:790 ../src/xz/xz.1:791 ../src/xz/xz.1:2263 #, no-wrap msgid "48 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:711 ../src/xz/xz.1:2239 ../src/xz/xz.1:2264 ../src/xz/xz.1:2629 #, no-wrap msgid "-5" msgstr "" #. type: tbl table #: ../src/xz/xz.1:711 ../src/xz/xz.1:712 ../src/xz/xz.1:792 ../src/xz/xz.1:793 ../src/xz/xz.1:2239 ../src/xz/xz.1:2240 ../src/xz/xz.1:2241 #, no-wrap msgid "8 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:711 ../src/xz/xz.1:2629 #, no-wrap msgid "5" msgstr "" #. type: tbl table #: ../src/xz/xz.1:711 ../src/xz/xz.1:712 ../src/xz/xz.1:792 ../src/xz/xz.1:793 ../src/xz/xz.1:2264 ../src/xz/xz.1:2265 #, no-wrap msgid "94 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:712 ../src/xz/xz.1:2240 ../src/xz/xz.1:2265 ../src/xz/xz.1:2630 #, no-wrap msgid "-6" msgstr "" #. type: tbl table #: ../src/xz/xz.1:712 ../src/xz/xz.1:713 ../src/xz/xz.1:714 ../src/xz/xz.1:715 ../src/xz/xz.1:2630 #, no-wrap msgid "6" msgstr "" #. type: tbl table #: ../src/xz/xz.1:713 ../src/xz/xz.1:2241 ../src/xz/xz.1:2266 #, no-wrap msgid "-7" msgstr "" #. type: tbl table #: ../src/xz/xz.1:713 ../src/xz/xz.1:794 ../src/xz/xz.1:2241 ../src/xz/xz.1:2242 ../src/xz/xz.1:2263 #, no-wrap msgid "16 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:713 ../src/xz/xz.1:794 ../src/xz/xz.1:2266 #, no-wrap msgid "186 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:714 ../src/xz/xz.1:2242 ../src/xz/xz.1:2267 #, no-wrap msgid "-8" msgstr "" #. type: tbl table #: ../src/xz/xz.1:714 ../src/xz/xz.1:795 ../src/xz/xz.1:2267 #, no-wrap msgid "370 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:714 ../src/xz/xz.1:795 #, no-wrap msgid "33 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:715 ../src/xz/xz.1:2243 ../src/xz/xz.1:2268 #, no-wrap msgid "-9" msgstr "" #. type: tbl table #: ../src/xz/xz.1:715 ../src/xz/xz.1:796 ../src/xz/xz.1:2243 #, no-wrap msgid "64 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:715 ../src/xz/xz.1:796 ../src/xz/xz.1:2268 #, no-wrap msgid "674 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:715 ../src/xz/xz.1:796 #, no-wrap msgid "65 MiB" msgstr "" #. type: Plain text #: ../src/xz/xz.1:721 msgid "Column descriptions:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:733 msgid "" "DictSize is the LZMA2 dictionary size. It is waste of memory to use a " "dictionary bigger than the size of the uncompressed file. This is why it is " "good to avoid using the presets B<-7> ... B<-9> when there's no real need " "for them. At B<-6> and lower, the amount of memory wasted is usually low " "enough to not matter." msgstr "" #. type: Plain text #: ../src/xz/xz.1:742 msgid "" "CompCPU is a simplified representation of the LZMA2 settings that affect " "compression speed. The dictionary size affects speed too, so while CompCPU " "is the same for levels B<-6> ... B<-9>, higher levels still tend to be a " "little slower. To get even slower and thus possibly better compression, see " "B<--extreme>." msgstr "" #. type: Plain text #: ../src/xz/xz.1:750 msgid "" "CompMem contains the compressor memory requirements in the single-threaded " "mode. It may vary slightly between B versions. Memory requirements of " "some of the future multithreaded modes may be dramatically higher than that " "of the single-threaded mode." msgstr "" #. type: Plain text #: ../src/xz/xz.1:757 msgid "" "DecMem contains the decompressor memory requirements. That is, the " "compression settings determine the memory requirements of the decompressor. " "The exact decompressor memory usage is slightly more than the LZMA2 " "dictionary size, but the values in the table have been rounded up to the " "next full MiB." msgstr "" #. type: TP #: ../src/xz/xz.1:758 #, no-wrap msgid "B<-e>, B<--extreme>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:767 msgid "" "Use a slower variant of the selected compression preset level (B<-0> " "... B<-9>) to hopefully get a little bit better compression ratio, but with " "bad luck this can also make it worse. Decompressor memory usage is not " "affected, but compressor memory usage increases a little at preset levels " "B<-0> ... B<-3>." msgstr "" #. type: Plain text #: ../src/xz/xz.1:779 msgid "" "Since there are two presets with dictionary sizes 4\\ MiB and 8\\ MiB, the " "presets B<-3e> and B<-5e> use slightly faster settings (lower CompCPU) than " "B<-4e> and B<-6e>, respectively. That way no two presets are identical." msgstr "" #. type: tbl table #: ../src/xz/xz.1:787 #, no-wrap msgid "-0e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:787 ../src/xz/xz.1:788 ../src/xz/xz.1:789 ../src/xz/xz.1:791 ../src/xz/xz.1:793 ../src/xz/xz.1:794 ../src/xz/xz.1:795 ../src/xz/xz.1:796 ../src/xz/xz.1:2632 #, no-wrap msgid "8" msgstr "" #. type: tbl table #: ../src/xz/xz.1:788 #, no-wrap msgid "-1e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:788 #, no-wrap msgid "13 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:789 #, no-wrap msgid "-2e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:789 #, no-wrap msgid "25 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:790 #, no-wrap msgid "-3e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:790 ../src/xz/xz.1:792 ../src/xz/xz.1:2631 #, no-wrap msgid "7" msgstr "" #. type: tbl table #: ../src/xz/xz.1:791 #, no-wrap msgid "-4e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:792 ../src/xz/xz.1:2631 #, no-wrap msgid "-5e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:793 ../src/xz/xz.1:2632 #, no-wrap msgid "-6e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:794 #, no-wrap msgid "-7e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:795 #, no-wrap msgid "-8e" msgstr "" #. type: tbl table #: ../src/xz/xz.1:796 #, no-wrap msgid "-9e" msgstr "" #. type: Plain text #: ../src/xz/xz.1:808 msgid "" "For example, there are a total of four presets that use 8\\ MiB dictionary, " "whose order from the fastest to the slowest is B<-5>, B<-6>, B<-5e>, and " "B<-6e>." msgstr "" #. type: TP #: ../src/xz/xz.1:808 #, no-wrap msgid "B<--fast>" msgstr "" #. type: TP #: ../src/xz/xz.1:811 #, no-wrap msgid "B<--best>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:822 msgid "" "These are somewhat misleading aliases for B<-0> and B<-9>, respectively. " "These are provided only for backwards compatibility with LZMA Utils. Avoid " "using these options." msgstr "" #. type: TP #: ../src/xz/xz.1:822 #, no-wrap msgid "B<--block-size=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:835 msgid "" "When compressing to the B<.xz> format, split the input data into blocks of " "I bytes. The blocks are compressed independently from each other, " "which helps with multi-threading and makes limited random-access " "decompression possible. This option is typically used to override the " "default block size in multi-threaded mode, but this option can be used in " "single-threaded mode too." msgstr "" #. type: Plain text #: ../src/xz/xz.1:853 msgid "" "In multi-threaded mode about three times I bytes will be allocated in " "each thread for buffering input and output. The default I is three " "times the LZMA2 dictionary size or 1 MiB, whichever is more. Typically a " "good value is 2-4 times the size of the LZMA2 dictionary or at least 1 MiB. " "Using I less than the LZMA2 dictionary size is waste of RAM because " "then the LZMA2 dictionary buffer will never get fully used. The sizes of " "the blocks are stored in the block headers, which a future version of B " "will use for multi-threaded decompression." msgstr "" #. type: Plain text #: ../src/xz/xz.1:862 msgid "" "In single-threaded mode no block splitting is done by default. Setting this " "option doesn't affect memory usage. No size information is stored in block " "headers, thus files created in single-threaded mode won't be identical to " "files created in multi-threaded mode. The lack of size information also " "means that a future version of B won't be able decompress the files in " "multi-threaded mode." msgstr "" #. type: TP #: ../src/xz/xz.1:862 #, no-wrap msgid "B<--block-list=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:868 msgid "" "When compressing to the B<.xz> format, start a new block after the given " "intervals of uncompressed data." msgstr "" #. type: Plain text #: ../src/xz/xz.1:874 msgid "" "The uncompressed I of the blocks are specified as a comma-separated " "list. Omitting a size (two or more consecutive commas) is a shorthand to " "use the size of the previous block." msgstr "" #. type: Plain text #: ../src/xz/xz.1:884 msgid "" "If the input file is bigger than the sum of I, the last value in " "I is repeated until the end of the file. A special value of B<0> may " "be used as the last value to indicate that the rest of the file should be " "encoded as a single block." msgstr "" #. type: Plain text #: ../src/xz/xz.1:899 msgid "" "If one specifies I that exceed the encoder's block size (either the " "default value in threaded mode or the value specified with " "B<--block-size=>I), the encoder will create additional blocks while " "keeping the boundaries specified in I. For example, if one specifies " "B<--block-size=10MiB> B<--block-list=5MiB,10MiB,8MiB,12MiB,24MiB> and the " "input file is 80 MiB, one will get 11 blocks: 5, 10, 8, 10, 2, 10, 10, 4, " "10, 10, and 1 MiB." msgstr "" #. type: Plain text #: ../src/xz/xz.1:905 msgid "" "In multi-threaded mode the sizes of the blocks are stored in the block " "headers. This isn't done in single-threaded mode, so the encoded output " "won't be identical to that of the multi-threaded mode." msgstr "" #. type: TP #: ../src/xz/xz.1:905 #, no-wrap msgid "B<--flush-timeout=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:922 msgid "" "When compressing, if more than I milliseconds (a positive integer) " "has passed since the previous flush and reading more input would block, all " "the pending input data is flushed from the encoder and made available in the " "output stream. This can be useful if B is used to compress data that is " "streamed over a network. Small I values make the data available at " "the receiving end with a small delay, but large I values give " "better compression ratio." msgstr "" #. type: Plain text #: ../src/xz/xz.1:930 msgid "" "This feature is disabled by default. If this option is specified more than " "once, the last one takes effect. The special I value of B<0> can " "be used to explicitly disable this feature." msgstr "" #. type: Plain text #: ../src/xz/xz.1:932 msgid "This feature is not available on non-POSIX systems." msgstr "" #. FIXME #. type: Plain text #: ../src/xz/xz.1:940 msgid "" "B Currently B is unsuitable for " "decompressing the stream in real time due to how B does buffering." msgstr "" #. type: TP #: ../src/xz/xz.1:940 #, no-wrap msgid "B<--memlimit-compress=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:945 msgid "" "Set a memory usage limit for compression. If this option is specified " "multiple times, the last one takes effect." msgstr "" #. type: Plain text #: ../src/xz/xz.1:960 msgid "" "If the compression settings exceed the I, B will adjust the " "settings downwards so that the limit is no longer exceeded and display a " "notice that automatic adjustment was done. Such adjustments are not made " "when compressing with B<--format=raw> or if B<--no-adjust> has been " "specified. In those cases, an error is displayed and B will exit with " "exit status 1." msgstr "" #. type: Plain text #: ../src/xz/xz.1:964 msgid "The I can be specified in multiple ways:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:974 msgid "" "The I can be an absolute value in bytes. Using an integer suffix " "like B can be useful. Example: B<--memlimit-compress=80MiB>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:986 msgid "" "The I can be specified as a percentage of total physical memory " "(RAM). This can be useful especially when setting the B " "environment variable in a shell initialization script that is shared between " "different computers. That way the limit is automatically bigger on systems " "with more memory. Example: B<--memlimit-compress=70%>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1006 msgid "" "The I can be reset back to its default value by setting it to B<0>. " "This is currently equivalent to setting the I to B (no memory " "usage limit). Once multithreading support has been implemented, there may " "be a difference between B<0> and B for the multithreaded case, so it is " "recommended to use B<0> instead of B until the details have been " "decided." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1026 msgid "" "For 32-bit B there is a special case: if the I would be over " "B<4020\\ MiB>, the I is set to B<4020\\ MiB>. (The values B<0> and " "B aren't affected by this. A similar feature doesn't exist for " "decompression.) This can be helpful when a 32-bit executable has access to " "4\\ GiB address space while hopefully doing no harm in other situations." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1029 msgid "See also the section B." msgstr "" #. type: TP #: ../src/xz/xz.1:1029 #, no-wrap msgid "B<--memlimit-decompress=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1043 msgid "" "Set a memory usage limit for decompression. This also affects the B<--list> " "mode. If the operation is not possible without exceeding the I, " "B will display an error and decompressing the file will fail. See " "B<--memlimit-compress=>I for possible ways to specify the I." msgstr "" #. type: TP #: ../src/xz/xz.1:1043 #, no-wrap msgid "B<-M> I, B<--memlimit=>I, B<--memory=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1047 msgid "" "This is equivalent to specifying B<--memlimit-compress=>IB<--memlimit-decompress=>I." msgstr "" #. type: TP #: ../src/xz/xz.1:1047 #, no-wrap msgid "B<--no-adjust>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1055 msgid "" "Display an error and exit if the compression settings exceed the memory " "usage limit. The default is to adjust the settings downwards so that the " "memory usage limit is not exceeded. Automatic adjusting is always disabled " "when creating raw streams (B<--format=raw>)." msgstr "" #. type: TP #: ../src/xz/xz.1:1055 #, no-wrap msgid "B<-T> I, B<--threads=>I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1070 msgid "" "Specify the number of worker threads to use. Setting I to a " "special value B<0> makes B use as many threads as there are CPU cores on " "the system. The actual number of threads can be less than I if the " "input file is not big enough for threading with the given settings or if " "using more threads would exceed the memory usage limit." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1077 msgid "" "Currently the only threading method is to split the input into blocks and " "compress them independently from each other. The default block size depends " "on the compression level and can be overridden with the " "B<--block-size=>I option." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1085 msgid "" "Threaded decompression hasn't been implemented yet. It will only work on " "files that contain multiple blocks with size information in block headers. " "All files compressed in multi-threaded mode meet this condition, but files " "compressed in single-threaded mode don't even if B<--block-size=>I is " "used." msgstr "" #. type: SS #: ../src/xz/xz.1:1086 ../src/xz/xz.1:2603 #, no-wrap msgid "Custom compressor filter chains" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1097 msgid "" "A custom filter chain allows specifying the compression settings in detail " "instead of relying on the settings associated to the presets. When a custom " "filter chain is specified, preset options (B<-0> ... B<-9> and B<--extreme>) " "earlier on the command line are forgotten. If a preset option is specified " "after one or more custom filter chain options, the new preset takes effect " "and the custom filter chain options specified earlier are forgotten." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1104 msgid "" "A filter chain is comparable to piping on the command line. When " "compressing, the uncompressed input goes to the first filter, whose output " "goes to the next filter (if any). The output of the last filter gets " "written to the compressed file. The maximum number of filters in the chain " "is four, but typically a filter chain has only one or two filters." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1112 msgid "" "Many filters have limitations on where they can be in the filter chain: some " "filters can work only as the last filter in the chain, some only as a " "non-last filter, and some work in any position in the chain. Depending on " "the filter, this limitation is either inherent to the filter design or " "exists to prevent security issues." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1120 msgid "" "A custom filter chain is specified by using one or more filter options in " "the order they are wanted in the filter chain. That is, the order of filter " "options is significant! When decoding raw streams (B<--format=raw>), the " "filter chain is specified in the same order as it was specified when " "compressing." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1129 msgid "" "Filters take filter-specific I as a comma-separated list. Extra " "commas in I are ignored. Every option has a default value, so you " "need to specify only those you want to change." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1138 msgid "" "To see the whole filter chain and I, use B (that is, use " "B<--verbose> twice). This works also for viewing the filter chain options " "used by presets." msgstr "" #. type: TP #: ../src/xz/xz.1:1138 #, no-wrap msgid "B<--lzma1>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1141 #, no-wrap msgid "B<--lzma2>[B<=>I]" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1146 msgid "" "Add LZMA1 or LZMA2 filter to the filter chain. These filters can be used " "only as the last filter in the chain." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1158 msgid "" "LZMA1 is a legacy filter, which is supported almost solely due to the legacy " "B<.lzma> file format, which supports only LZMA1. LZMA2 is an updated " "version of LZMA1 to fix some practical issues of LZMA1. The B<.xz> format " "uses LZMA2 and doesn't support LZMA1 at all. Compression speed and ratios " "of LZMA1 and LZMA2 are practically the same." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1161 msgid "LZMA1 and LZMA2 share the same set of I:" msgstr "" #. type: TP #: ../src/xz/xz.1:1162 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1186 msgid "" "Reset all LZMA1 or LZMA2 I to I. I consist of an " "integer, which may be followed by single-letter preset modifiers. The " "integer can be from B<0> to B<9>, matching the command line options B<-0> " "... B<-9>. The only supported modifier is currently B, which matches " "B<--extreme>. If no B is specified, the default values of LZMA1 or " "LZMA2 I are taken from the preset B<6>." msgstr "" #. type: TP #: ../src/xz/xz.1:1186 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1201 msgid "" "Dictionary (history buffer) I indicates how many bytes of the " "recently processed uncompressed data is kept in memory. The algorithm tries " "to find repeating byte sequences (matches) in the uncompressed data, and " "replace them with references to the data currently in the dictionary. The " "bigger the dictionary, the higher is the chance to find a match. Thus, " "increasing dictionary I usually improves compression ratio, but a " "dictionary bigger than the uncompressed file is waste of memory." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1210 msgid "" "Typical dictionary I is from 64\\ KiB to 64\\ MiB. The minimum is 4\\ " "KiB. The maximum for compression is currently 1.5\\ GiB (1536\\ MiB). The " "decompressor already supports dictionaries up to one byte less than 4\\ GiB, " "which is the maximum for the LZMA1 and LZMA2 stream formats." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1237 msgid "" "Dictionary I and match finder (I) together determine the memory " "usage of the LZMA1 or LZMA2 encoder. The same (or bigger) dictionary " "I is required for decompressing that was used when compressing, thus " "the memory usage of the decoder is determined by the dictionary size used " "when compressing. The B<.xz> headers store the dictionary I either as " "2^I or 2^I + 2^(I-1), so these I are somewhat preferred for " "compression. Other I will get rounded up when stored in the B<.xz> " "headers." msgstr "" #. type: TP #: ../src/xz/xz.1:1237 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1246 msgid "" "Specify the number of literal context bits. The minimum is 0 and the " "maximum is 4; the default is 3. In addition, the sum of I and I " "must not exceed 4." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1251 msgid "" "All bytes that cannot be encoded as matches are encoded as literals. That " "is, literals are simply 8-bit bytes that are encoded one at a time." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1265 msgid "" "The literal coding makes an assumption that the highest I bits of the " "previous uncompressed byte correlate with the next byte. E.g. in typical " "English text, an upper-case letter is often followed by a lower-case letter, " "and a lower-case letter is usually followed by another lower-case letter. " "In the US-ASCII character set, the highest three bits are 010 for upper-case " "letters and 011 for lower-case letters. When I is at least 3, the " "literal coding can take advantage of this property in the uncompressed data." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1274 msgid "" "The default value (3) is usually good. If you want maximum compression, " "test B. Sometimes it helps a little, and sometimes it makes " "compression worse. If it makes it worse, test e.g.\\& B too." msgstr "" #. type: TP #: ../src/xz/xz.1:1274 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1278 msgid "" "Specify the number of literal position bits. The minimum is 0 and the " "maximum is 4; the default is 0." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1285 msgid "" "I affects what kind of alignment in the uncompressed data is assumed " "when encoding literals. See I below for more information about " "alignment." msgstr "" #. type: TP #: ../src/xz/xz.1:1285 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1289 msgid "" "Specify the number of position bits. The minimum is 0 and the maximum is 4; " "the default is 2." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1296 msgid "" "I affects what kind of alignment in the uncompressed data is assumed in " "general. The default means four-byte alignment (2^I=2^2=4), which is " "often a good choice when there's no better guess." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1310 msgid "" "When the aligment is known, setting I accordingly may reduce the file " "size a little. E.g. with text files having one-byte alignment (US-ASCII, " "ISO-8859-*, UTF-8), setting B can improve compression slightly. For " "UTF-16 text, B is a good choice. If the alignment is an odd number " "like 3 bytes, B might be the best choice." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1318 msgid "" "Even though the assumed alignment can be adjusted with I and I, " "LZMA1 and LZMA2 still slightly favor 16-byte alignment. It might be worth " "taking into account when designing file formats that are likely to be often " "compressed with LZMA1 or LZMA2." msgstr "" #. type: TP #: ../src/xz/xz.1:1318 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1333 msgid "" "Match finder has a major effect on encoder speed, memory usage, and " "compression ratio. Usually Hash Chain match finders are faster than Binary " "Tree match finders. The default depends on the I: 0 uses B, " "1-3 use B, and the rest use B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1339 msgid "" "The following match finders are supported. The memory usage formulas below " "are rough approximations, which are closest to the reality when I is a " "power of two." msgstr "" #. type: TP #: ../src/xz/xz.1:1340 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1343 msgid "Hash Chain with 2- and 3-byte hashing" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1347 ../src/xz/xz.1:1396 msgid "Minimum value for I: 3" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1349 ../src/xz/xz.1:1368 ../src/xz/xz.1:1398 ../src/xz/xz.1:1417 msgid "Memory usage:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1354 msgid "I * 7.5 (if I E= 16 MiB);" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1359 msgid "I * 5.5 + 64 MiB (if I E 16 MiB)" msgstr "" #. type: TP #: ../src/xz/xz.1:1359 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1362 msgid "Hash Chain with 2-, 3-, and 4-byte hashing" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1366 ../src/xz/xz.1:1415 msgid "Minimum value for I: 4" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1373 msgid "I * 7.5 (if I E= 32 MiB);" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1378 msgid "I * 6.5 (if I E 32 MiB)" msgstr "" #. type: TP #: ../src/xz/xz.1:1378 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1381 msgid "Binary Tree with 2-byte hashing" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1385 msgid "Minimum value for I: 2" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1389 msgid "Memory usage: I * 9.5" msgstr "" #. type: TP #: ../src/xz/xz.1:1389 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1392 msgid "Binary Tree with 2- and 3-byte hashing" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1403 msgid "I * 11.5 (if I E= 16 MiB);" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1408 msgid "I * 9.5 + 64 MiB (if I E 16 MiB)" msgstr "" #. type: TP #: ../src/xz/xz.1:1408 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1411 msgid "Binary Tree with 2-, 3-, and 4-byte hashing" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1422 msgid "I * 11.5 (if I E= 32 MiB);" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1427 msgid "I * 10.5 (if I E 32 MiB)" msgstr "" #. type: TP #: ../src/xz/xz.1:1428 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1449 msgid "" "Compression I specifies the method to analyze the data produced by the " "match finder. Supported I are B and B. The default is " "B for I 0-3 and B for I 4-9." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1458 msgid "" "Usually B is used with Hash Chain match finders and B with " "Binary Tree match finders. This is also what the I do." msgstr "" #. type: TP #: ../src/xz/xz.1:1458 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1465 msgid "" "Specify what is considered to be a nice length for a match. Once a match of " "at least I bytes is found, the algorithm stops looking for possibly " "better matches." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1472 msgid "" "I can be 2-273 bytes. Higher values tend to give better compression " "ratio at the expense of speed. The default depends on the I." msgstr "" #. type: TP #: ../src/xz/xz.1:1472 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1482 msgid "" "Specify the maximum search depth in the match finder. The default is the " "special value of 0, which makes the compressor determine a reasonable " "I from I and I." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1493 msgid "" "Reasonable I for Hash Chains is 4-100 and 16-1000 for Binary Trees. " "Using very high values for I can make the encoder extremely slow with " "some files. Avoid setting the I over 1000 unless you are prepared to " "interrupt the compression in case it is taking far too long." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1504 msgid "" "When decoding raw streams (B<--format=raw>), LZMA2 needs only the dictionary " "I. LZMA1 needs also I, I, and I." msgstr "" #. type: TP #: ../src/xz/xz.1:1504 #, no-wrap msgid "B<--x86>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1507 #, no-wrap msgid "B<--powerpc>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1509 #, no-wrap msgid "B<--ia64>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1511 #, no-wrap msgid "B<--arm>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1513 #, no-wrap msgid "B<--armthumb>[B<=>I]" msgstr "" #. type: TP #: ../src/xz/xz.1:1515 #, no-wrap msgid "B<--sparc>[B<=>I]" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1521 msgid "" "Add a branch/call/jump (BCJ) filter to the filter chain. These filters can " "be used only as a non-last filter in the filter chain." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1533 msgid "" "A BCJ filter converts relative addresses in the machine code to their " "absolute counterparts. This doesn't change the size of the data, but it " "increases redundancy, which can help LZMA2 to produce 0-15\\ % smaller " "B<.xz> file. The BCJ filters are always reversible, so using a BCJ filter " "for wrong type of data doesn't cause any data loss, although it may make the " "compression ratio slightly worse." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1540 msgid "" "It is fine to apply a BCJ filter on a whole executable; there's no need to " "apply it only on the executable section. Applying a BCJ filter on an " "archive that contains both executable and non-executable files may or may " "not give good results, so it generally isn't good to blindly apply a BCJ " "filter when compressing binary packages for distribution." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1548 msgid "" "These BCJ filters are very fast and use insignificant amount of memory. If " "a BCJ filter improves compression ratio of a file, it can improve " "decompression speed at the same time. This is because, on the same " "hardware, the decompression speed of LZMA2 is roughly a fixed number of " "bytes of compressed data per second." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1551 msgid "These BCJ filters have known problems related to the compression ratio:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1558 msgid "" "Some types of files containing executable code (e.g. object files, static " "libraries, and Linux kernel modules) have the addresses in the instructions " "filled with filler values. These BCJ filters will still do the address " "conversion, which will make the compression worse with these files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1565 msgid "" "Applying a BCJ filter on an archive containing multiple similar executables " "can make the compression ratio worse than not using a BCJ filter. This is " "because the BCJ filter doesn't detect the boundaries of the executable " "files, and doesn't reset the address conversion counter for each executable." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1572 msgid "" "Both of the above problems will be fixed in the future in a new filter. The " "old BCJ filters will still be useful in embedded systems, because the " "decoder of the new filter will be bigger and use more memory." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1574 msgid "Different instruction sets have different alignment:" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1581 #, no-wrap msgid "Filter" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1581 #, no-wrap msgid "Alignment" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1581 #, no-wrap msgid "Notes" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1582 #, no-wrap msgid "x86" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1582 #, no-wrap msgid "32-bit or 64-bit x86" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1583 #, no-wrap msgid "PowerPC" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1583 #, no-wrap msgid "Big endian only" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1584 #, no-wrap msgid "ARM" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1584 ../src/xz/xz.1:1585 #, no-wrap msgid "Little endian only" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1585 #, no-wrap msgid "ARM-Thumb" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1586 #, no-wrap msgid "IA-64" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1586 #, no-wrap msgid "16" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1586 ../src/xz/xz.1:1587 #, no-wrap msgid "Big or little endian" msgstr "" #. type: tbl table #: ../src/xz/xz.1:1587 #, no-wrap msgid "SPARC" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1602 msgid "" "Since the BCJ-filtered data is usually compressed with LZMA2, the " "compression ratio may be improved slightly if the LZMA2 options are set to " "match the alignment of the selected BCJ filter. For example, with the IA-64 " "filter, it's good to set B with LZMA2 (2^4=16). The x86 filter is an " "exception; it's usually good to stick to LZMA2's default four-byte alignment " "when compressing x86 executables." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1605 msgid "All BCJ filters support the same I:" msgstr "" #. type: TP #: ../src/xz/xz.1:1606 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1620 msgid "" "Specify the start I that is used when converting between relative " "and absolute addresses. The I must be a multiple of the alignment " "of the filter (see the table above). The default is zero. In practice, the " "default is good; specifying a custom I is almost never useful." msgstr "" #. type: TP #: ../src/xz/xz.1:1621 #, no-wrap msgid "B<--delta>[B<=>I]" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1626 msgid "" "Add the Delta filter to the filter chain. The Delta filter can be only used " "as a non-last filter in the filter chain." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1635 msgid "" "Currently only simple byte-wise delta calculation is supported. It can be " "useful when compressing e.g. uncompressed bitmap images or uncompressed PCM " "audio. However, special purpose algorithms may give significantly better " "results than Delta + LZMA2. This is true especially with audio, which " "compresses faster and better e.g. with B(1)." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1638 msgid "Supported I:" msgstr "" #. type: TP #: ../src/xz/xz.1:1639 #, no-wrap msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1647 msgid "" "Specify the I of the delta calculation in bytes. I must " "be 1-256. The default is 1." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1652 msgid "" "For example, with B and eight-byte input A1 B1 A2 B3 A3 B5 A4 B7, " "the output will be A1 B1 01 02 01 02 01 02." msgstr "" #. type: SS #: ../src/xz/xz.1:1654 #, no-wrap msgid "Other options" msgstr "" #. type: TP #: ../src/xz/xz.1:1655 ../src/xzdec/xzdec.1:83 #, no-wrap msgid "B<-q>, B<--quiet>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1662 msgid "" "Suppress warnings and notices. Specify this twice to suppress errors too. " "This option has no effect on the exit status. That is, even if a warning " "was suppressed, the exit status to indicate a warning is still used." msgstr "" #. type: TP #: ../src/xz/xz.1:1662 #, no-wrap msgid "B<-v>, B<--verbose>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1671 msgid "" "Be verbose. If standard error is connected to a terminal, B will " "display a progress indicator. Specifying B<--verbose> twice will give even " "more verbose output." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1673 msgid "The progress indicator shows the following information:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1678 msgid "" "Completion percentage is shown if the size of the input file is known. That " "is, the percentage cannot be shown in pipes." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1681 msgid "" "Amount of compressed data produced (compressing) or consumed " "(decompressing)." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1684 msgid "" "Amount of uncompressed data consumed (compressing) or produced " "(decompressing)." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1688 msgid "" "Compression ratio, which is calculated by dividing the amount of compressed " "data processed so far by the amount of uncompressed data processed so far." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1695 msgid "" "Compression or decompression speed. This is measured as the amount of " "uncompressed data consumed (compression) or produced (decompression) per " "second. It is shown after a few seconds have passed since B started " "processing the file." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1697 msgid "Elapsed time in the format M:SS or H:MM:SS." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1705 msgid "" "Estimated remaining time is shown only when the size of the input file is " "known and a couple of seconds have already passed since B started " "processing the file. The time is shown in a less precise format which never " "has any colons, e.g. 2 min 30 s." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1720 msgid "" "When standard error is not a terminal, B<--verbose> will make B print " "the filename, compressed size, uncompressed size, compression ratio, and " "possibly also the speed and elapsed time on a single line to standard error " "after compressing or decompressing the file. The speed and elapsed time are " "included only when the operation took at least a few seconds. If the " "operation didn't finish, e.g. due to user interruption, also the completion " "percentage is printed if the size of the input file is known." msgstr "" #. type: TP #: ../src/xz/xz.1:1720 ../src/xzdec/xzdec.1:89 #, no-wrap msgid "B<-Q>, B<--no-warn>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1730 msgid "" "Don't set the exit status to 2 even if a condition worth a warning was " "detected. This option doesn't affect the verbosity level, thus both " "B<--quiet> and B<--no-warn> have to be used to not display warnings and to " "not alter the exit status." msgstr "" #. type: TP #: ../src/xz/xz.1:1730 #, no-wrap msgid "B<--robot>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1742 msgid "" "Print messages in a machine-parsable format. This is intended to ease " "writing frontends that want to use B instead of liblzma, which may be " "the case with various scripts. The output with this option enabled is meant " "to be stable across B releases. See the section B for " "details." msgstr "" #. type: TP #: ../src/xz/xz.1:1742 #, no-wrap msgid "B<--info-memory>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1748 msgid "" "Display, in human-readable format, how much physical memory (RAM) B " "thinks the system has and the memory usage limits for compression and " "decompression, and exit successfully." msgstr "" #. type: TP #: ../src/xz/xz.1:1748 ../src/xzdec/xzdec.1:96 #, no-wrap msgid "B<-h>, B<--help>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1752 msgid "" "Display a help message describing the most commonly used options, and exit " "successfully." msgstr "" #. type: TP #: ../src/xz/xz.1:1752 #, no-wrap msgid "B<-H>, B<--long-help>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1757 msgid "" "Display a help message describing all features of B, and exit " "successfully" msgstr "" #. type: TP #: ../src/xz/xz.1:1757 ../src/xzdec/xzdec.1:99 #, no-wrap msgid "B<-V>, B<--version>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1766 msgid "" "Display the version number of B and liblzma in human readable format. " "To get machine-parsable output, specify B<--robot> before B<--version>." msgstr "" #. type: SH #: ../src/xz/xz.1:1767 #, no-wrap msgid "ROBOT MODE" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1783 msgid "" "The robot mode is activated with the B<--robot> option. It makes the output " "of B easier to parse by other programs. Currently B<--robot> is " "supported only together with B<--version>, B<--info-memory>, and B<--list>. " "It will be supported for compression and decompression in the future." msgstr "" #. type: SS #: ../src/xz/xz.1:1784 #, no-wrap msgid "Version" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1789 msgid "" "B will print the version number of B and liblzma " "in the following format:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1791 msgid "BI" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1793 msgid "BI" msgstr "" #. type: TP #: ../src/xz/xz.1:1793 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1796 msgid "Major version." msgstr "" #. type: TP #: ../src/xz/xz.1:1796 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1801 msgid "" "Minor version. Even numbers are stable. Odd numbers are alpha or beta " "versions." msgstr "" #. type: TP #: ../src/xz/xz.1:1801 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1805 msgid "Patch level for stable releases or just a counter for development releases." msgstr "" #. type: TP #: ../src/xz/xz.1:1805 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1813 msgid "" "Stability. 0 is alpha, 1 is beta, and 2 is stable. I should be always 2 " "when I is even." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1818 msgid "" "I are the same on both lines if B and liblzma are from the " "same XZ Utils release." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1824 msgid "Examples: 4.999.9beta is B<49990091> and 5.0.0 is B<50000002>." msgstr "" #. type: SS #: ../src/xz/xz.1:1825 #, no-wrap msgid "Memory limit information" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1828 msgid "" "B prints a single line with three tab-separated " "columns:" msgstr "" #. type: IP #: ../src/xz/xz.1:1828 #, no-wrap msgid "1." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1830 msgid "Total amount of physical memory (RAM) in bytes" msgstr "" #. type: IP #: ../src/xz/xz.1:1830 ../src/xz/xz.1:1910 ../src/xz/xz.1:1947 ../src/xz/xz.1:1973 ../src/xz/xz.1:2043 ../src/xz/xz.1:2070 #, no-wrap msgid "2." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1834 msgid "" "Memory usage limit for compression in bytes. A special value of zero " "indicates the default setting, which for single-threaded mode is the same as " "no limit." msgstr "" #. type: IP #: ../src/xz/xz.1:1834 ../src/xz/xz.1:1912 ../src/xz/xz.1:1949 ../src/xz/xz.1:1975 ../src/xz/xz.1:2048 ../src/xz/xz.1:2072 #, no-wrap msgid "3." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1838 msgid "" "Memory usage limit for decompression in bytes. A special value of zero " "indicates the default setting, which for single-threaded mode is the same as " "no limit." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1842 msgid "" "In the future, the output of B may have more " "columns, but never more than a single line." msgstr "" #. type: SS #: ../src/xz/xz.1:1843 #, no-wrap msgid "List mode" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1848 msgid "" "B uses tab-separated output. The first column of every " "line has a string that indicates the type of the information found on that " "line:" msgstr "" #. type: TP #: ../src/xz/xz.1:1848 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1852 msgid "" "This is always the first line when starting to list a file. The second " "column on the line is the filename." msgstr "" #. type: TP #: ../src/xz/xz.1:1852 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1860 msgid "" "This line contains overall information about the B<.xz> file. This line is " "always printed after the B line." msgstr "" #. type: TP #: ../src/xz/xz.1:1860 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1870 msgid "" "This line type is used only when B<--verbose> was specified. There are as " "many B lines as there are streams in the B<.xz> file." msgstr "" #. type: TP #: ../src/xz/xz.1:1870 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1885 msgid "" "This line type is used only when B<--verbose> was specified. There are as " "many B lines as there are blocks in the B<.xz> file. The B " "lines are shown after all the B lines; different line types are not " "interleaved." msgstr "" #. type: TP #: ../src/xz/xz.1:1885 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1900 msgid "" "This line type is used only when B<--verbose> was specified twice. This " "line is printed after all B lines. Like the B line, the " "B line contains overall information about the B<.xz> file." msgstr "" #. type: TP #: ../src/xz/xz.1:1900 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1904 msgid "" "This line is always the very last line of the list output. It shows the " "total counts and sizes." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1908 msgid "The columns of the B lines:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1912 msgid "Number of streams in the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1914 msgid "Total number of blocks in the stream(s)" msgstr "" #. type: IP #: ../src/xz/xz.1:1914 ../src/xz/xz.1:1951 ../src/xz/xz.1:1978 ../src/xz/xz.1:2058 ../src/xz/xz.1:2074 #, no-wrap msgid "4." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1916 msgid "Compressed size of the file" msgstr "" #. type: IP #: ../src/xz/xz.1:1916 ../src/xz/xz.1:1953 ../src/xz/xz.1:1980 ../src/xz/xz.1:2076 #, no-wrap msgid "5." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1918 msgid "Uncompressed size of the file" msgstr "" #. type: IP #: ../src/xz/xz.1:1918 ../src/xz/xz.1:1955 ../src/xz/xz.1:1982 ../src/xz/xz.1:2078 #, no-wrap msgid "6." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1924 msgid "" "Compression ratio, for example B<0.123.> If ratio is over 9.999, three " "dashes (B<--->) are displayed instead of the ratio." msgstr "" #. type: IP #: ../src/xz/xz.1:1924 ../src/xz/xz.1:1957 ../src/xz/xz.1:1984 ../src/xz/xz.1:2080 #, no-wrap msgid "7." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1937 msgid "" "Comma-separated list of integrity check names. The following strings are " "used for the known check types: B, B, B, and " "B. For unknown check types, BI is used, where I is " "the Check ID as a decimal number (one or two digits)." msgstr "" #. type: IP #: ../src/xz/xz.1:1937 ../src/xz/xz.1:1959 ../src/xz/xz.1:1986 ../src/xz/xz.1:2083 #, no-wrap msgid "8." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1939 msgid "Total size of stream padding in the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1945 msgid "The columns of the B lines:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1949 msgid "Stream number (the first stream is 1)" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1951 msgid "Number of blocks in the stream" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1953 msgid "Compressed start offset" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1955 msgid "Uncompressed start offset" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1957 msgid "Compressed size (does not include stream padding)" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1959 ../src/xz/xz.1:1988 ../src/xz/xz.1:2078 msgid "Uncompressed size" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1961 ../src/xz/xz.1:1990 msgid "Compression ratio" msgstr "" #. type: IP #: ../src/xz/xz.1:1961 ../src/xz/xz.1:1988 ../src/xz/xz.1:2085 #, no-wrap msgid "9." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1963 ../src/xz/xz.1:1992 msgid "Name of the integrity check" msgstr "" #. type: IP #: ../src/xz/xz.1:1963 ../src/xz/xz.1:1990 ../src/xz/xz.1:2101 #, no-wrap msgid "10." msgstr "" #. type: Plain text #: ../src/xz/xz.1:1965 msgid "Size of stream padding" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1971 msgid "The columns of the B lines:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1975 msgid "Number of the stream containing this block" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1978 msgid "Block number relative to the beginning of the stream (the first block is 1)" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1980 msgid "Block number relative to the beginning of the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1982 msgid "Compressed start offset relative to the beginning of the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1984 msgid "Uncompressed start offset relative to the beginning of the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:1986 msgid "Total compressed size of the block (includes headers)" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2004 msgid "" "If B<--verbose> was specified twice, additional columns are included on the " "B lines. These are not displayed with a single B<--verbose>, because " "getting this information requires many seeks and can thus be slow:" msgstr "" #. type: IP #: ../src/xz/xz.1:2006 ../src/xz/xz.1:2106 #, no-wrap msgid "11." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2008 msgid "Value of the integrity check in hexadecimal" msgstr "" #. type: IP #: ../src/xz/xz.1:2008 ../src/xz/xz.1:2116 #, no-wrap msgid "12." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2010 msgid "Block header size" msgstr "" #. type: IP #: ../src/xz/xz.1:2010 #, no-wrap msgid "13." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2020 msgid "" "Block flags: B indicates that compressed size is present, and B " "indicates that uncompressed size is present. If the flag is not set, a dash " "(B<->) is shown instead to keep the string length fixed. New flags may be " "added to the end of the string in the future." msgstr "" #. type: IP #: ../src/xz/xz.1:2020 #, no-wrap msgid "14." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2023 msgid "" "Size of the actual compressed data in the block (this excludes the block " "header, block padding, and check fields)" msgstr "" #. type: IP #: ../src/xz/xz.1:2023 #, no-wrap msgid "15." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2028 msgid "" "Amount of memory (in bytes) required to decompress this block with this " "B version" msgstr "" #. type: IP #: ../src/xz/xz.1:2028 #, no-wrap msgid "16." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2035 msgid "" "Filter chain. Note that most of the options used at compression time cannot " "be known, because only the options that are needed for decompression are " "stored in the B<.xz> headers." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2041 msgid "The columns of the B lines:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2048 msgid "" "Amount of memory (in bytes) required to decompress this file with this B " "version" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2054 ../src/xz/xz.1:2112 msgid "" "B or B indicating if all block headers have both compressed size " "and uncompressed size stored in them" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2058 ../src/xz/xz.1:2116 msgid "I B I<5.1.2alpha:>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2062 ../src/xz/xz.1:2120 msgid "Minimum B version required to decompress the file" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2068 msgid "The columns of the B line:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2072 msgid "Number of streams" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2074 msgid "Number of blocks" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2076 msgid "Compressed size" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2080 msgid "Average compression ratio" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2083 msgid "Comma-separated list of integrity check names that were present in the files" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2085 msgid "Stream padding size" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2091 msgid "" "Number of files. This is here to keep the order of the earlier columns the " "same as on B lines." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2099 msgid "" "If B<--verbose> was specified twice, additional columns are included on the " "B line:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2106 msgid "" "Maximum amount of memory (in bytes) required to decompress the files with " "this B version" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2126 msgid "" "Future versions may add new line types and new columns can be added to the " "existing line types, but the existing columns won't be changed." msgstr "" #. type: SH #: ../src/xz/xz.1:2127 ../src/xzdec/xzdec.1:104 ../src/lzmainfo/lzmainfo.1:44 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: TP #: ../src/xz/xz.1:2128 ../src/xzdec/xzdec.1:105 ../src/lzmainfo/lzmainfo.1:45 #, no-wrap msgid "B<0>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2131 ../src/lzmainfo/lzmainfo.1:48 msgid "All is good." msgstr "" #. type: TP #: ../src/xz/xz.1:2131 ../src/xzdec/xzdec.1:108 ../src/lzmainfo/lzmainfo.1:48 #, no-wrap msgid "B<1>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2134 ../src/xzdec/xzdec.1:111 ../src/lzmainfo/lzmainfo.1:51 msgid "An error occurred." msgstr "" #. type: TP #: ../src/xz/xz.1:2134 #, no-wrap msgid "B<2>" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2138 msgid "Something worth a warning occurred, but no actual errors occurred." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2141 msgid "" "Notices (not warnings or errors) printed on standard error don't affect the " "exit status." msgstr "" #. type: SH #: ../src/xz/xz.1:2142 ../src/scripts/xzgrep.1:80 ../src/scripts/xzless.1:52 #, no-wrap msgid "ENVIRONMENT" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2155 msgid "" "B parses space-separated lists of options from the environment variables " "B and B, in this order, before parsing the options from " "the command line. Note that only options are parsed from the environment " "variables; all non-options are silently ignored. Parsing is done with " "B(3) which is used also for the command line arguments." msgstr "" #. type: TP #: ../src/xz/xz.1:2155 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2164 msgid "" "User-specific or system-wide default options. Typically this is set in a " "shell initialization script to enable B's memory usage limiter by " "default. Excluding shell initialization scripts and similar special cases, " "scripts must never set or unset B." msgstr "" #. type: TP #: ../src/xz/xz.1:2164 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2175 msgid "" "This is for passing options to B when it is not possible to set the " "options directly on the B command line. This is the case e.g. when " "B is run by a script or tool, e.g. GNU B(1):" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2181 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2194 msgid "" "Scripts may use B e.g. to set script-specific default compression " "options. It is still recommended to allow users to override B if " "that is reasonable, e.g. in B(1) scripts one may use something like " "this:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2201 #, no-wrap msgid "" "CW\n" msgstr "" #. type: SH #: ../src/xz/xz.1:2206 #, no-wrap msgid "LZMA UTILS COMPATIBILITY" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2219 msgid "" "The command line syntax of B is practically a superset of B, " "B, and B as found from LZMA Utils 4.32.x. In most cases, it " "is possible to replace LZMA Utils with XZ Utils without breaking existing " "scripts. There are some incompatibilities though, which may sometimes cause " "problems." msgstr "" #. type: SS #: ../src/xz/xz.1:2220 #, no-wrap msgid "Compression preset levels" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2227 msgid "" "The numbering of the compression level presets is not identical in B and " "LZMA Utils. The most important difference is how dictionary sizes are " "mapped to different presets. Dictionary size is roughly equal to the " "decompressor memory usage." msgstr "" #. type: tbl table #: ../src/xz/xz.1:2233 ../src/xz/xz.1:2258 #, no-wrap msgid "Level" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2233 ../src/xz/xz.1:2258 #, no-wrap msgid "xz" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2233 #, no-wrap msgid "LZMA Utils" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2234 ../src/xz/xz.1:2259 #, no-wrap msgid "N/A" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2235 #, no-wrap msgid "64 KiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2237 #, no-wrap msgid "512 KiB" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2252 msgid "" "The dictionary size differences affect the compressor memory usage too, but " "there are some other differences between LZMA Utils and XZ Utils, which make " "the difference even bigger:" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2258 #, no-wrap msgid "LZMA Utils 4.32.x" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2261 ../src/xz/xz.1:2262 #, no-wrap msgid "12 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2264 #, no-wrap msgid "26 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2265 #, no-wrap msgid "45 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2266 #, no-wrap msgid "83 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2267 #, no-wrap msgid "159 MiB" msgstr "" #. type: tbl table #: ../src/xz/xz.1:2268 #, no-wrap msgid "311 MiB" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2277 msgid "" "The default preset level in LZMA Utils is B<-7> while in XZ Utils it is " "B<-6>, so both use an 8 MiB dictionary by default." msgstr "" #. type: SS #: ../src/xz/xz.1:2278 #, no-wrap msgid "Streamed vs. non-streamed .lzma files" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2288 msgid "" "The uncompressed size of the file can be stored in the B<.lzma> header. " "LZMA Utils does that when compressing regular files. The alternative is to " "mark that uncompressed size is unknown and use end-of-payload marker to " "indicate where the decompressor should stop. LZMA Utils uses this method " "when uncompressed size isn't known, which is the case for example in pipes." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2309 msgid "" "B supports decompressing B<.lzma> files with or without end-of-payload " "marker, but all B<.lzma> files created by B will use end-of-payload " "marker and have uncompressed size marked as unknown in the B<.lzma> header. " "This may be a problem in some uncommon situations. For example, a B<.lzma> " "decompressor in an embedded device might work only with files that have " "known uncompressed size. If you hit this problem, you need to use LZMA " "Utils or LZMA SDK to create B<.lzma> files with known uncompressed size." msgstr "" #. type: SS #: ../src/xz/xz.1:2310 #, no-wrap msgid "Unsupported .lzma files" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2333 msgid "" "The B<.lzma> format allows I values up to 8, and I values up to 4. " "LZMA Utils can decompress files with any I and I, but always creates " "files with B and B. Creating files with other I and I " "is possible with B and with LZMA SDK." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2344 msgid "" "The implementation of the LZMA1 filter in liblzma requires that the sum of " "I and I must not exceed 4. Thus, B<.lzma> files, which exceed this " "limitation, cannot be decompressed with B." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2359 msgid "" "LZMA Utils creates only B<.lzma> files which have a dictionary size of " "2^I (a power of 2) but accepts files with any dictionary size. liblzma " "accepts only B<.lzma> files which have a dictionary size of 2^I or 2^I " "+ 2^(I-1). This is to decrease false positives when detecting B<.lzma> " "files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2364 msgid "" "These limitations shouldn't be a problem in practice, since practically all " "B<.lzma> files have been compressed with settings that liblzma will accept." msgstr "" #. type: SS #: ../src/xz/xz.1:2365 #, no-wrap msgid "Trailing garbage" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2375 msgid "" "When decompressing, LZMA Utils silently ignore everything after the first " "B<.lzma> stream. In most situations, this is a bug. This also means that " "LZMA Utils don't support decompressing concatenated B<.lzma> files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2385 msgid "" "If there is data left after the first B<.lzma> stream, B considers the " "file to be corrupt unless B<--single-stream> was used. This may break " "obscure scripts which have assumed that trailing garbage is ignored." msgstr "" #. type: SH #: ../src/xz/xz.1:2386 ../src/xzdec/xzdec.1:117 #, no-wrap msgid "NOTES" msgstr "" #. type: SS #: ../src/xz/xz.1:2388 #, no-wrap msgid "Compressed output may vary" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2399 msgid "" "The exact compressed output produced from the same uncompressed input file " "may vary between XZ Utils versions even if compression options are " "identical. This is because the encoder can be improved (faster or better " "compression) without affecting the file format. The output can vary even " "between different builds of the same XZ Utils version, if different build " "options are used." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2409 msgid "" "The above means that once B<--rsyncable> has been implemented, the resulting " "files won't necessarily be rsyncable unless both old and new files have been " "compressed with the same xz version. This problem can be fixed if a part of " "the encoder implementation is frozen to keep rsyncable output stable across " "xz versions." msgstr "" #. type: SS #: ../src/xz/xz.1:2410 #, no-wrap msgid "Embedded .xz decompressors" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2427 msgid "" "Embedded B<.xz> decompressor implementations like XZ Embedded don't " "necessarily support files created with integrity I types other than " "B and B. Since the default is B<--check=crc64>, you must use " "B<--check=none> or B<--check=crc32> when creating files for embedded " "systems." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2437 msgid "" "Outside embedded systems, all B<.xz> format decompressors support all the " "I types, or at least are able to decompress the file without " "verifying the integrity check if the particular I is not supported." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2440 msgid "XZ Embedded supports BCJ filters, but only with the default start offset." msgstr "" #. type: SH #: ../src/xz/xz.1:2441 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: SS #: ../src/xz/xz.1:2443 #, no-wrap msgid "Basics" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2453 msgid "" "Compress the file I into I using the default compression level " "(B<-6>), and remove I if compression is successful:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2458 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2469 msgid "" "Decompress I into I and don't remove I even if " "decompression is successful:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2474 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2487 msgid "" "Create I with the preset B<-4e> (B<-4 --extreme>), which is " "slower than e.g. the default B<-6>, but needs less memory for compression " "and decompression (48\\ MiB and 5\\ MiB, respectively):" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2492 #, no-wrap msgid "CW baz.tar.xz>\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2498 msgid "" "A mix of compressed and uncompressed files can be decompressed to standard " "output with a single command:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2503 #, no-wrap msgid "CW abcd.txt>\n" msgstr "" #. type: SS #: ../src/xz/xz.1:2507 #, no-wrap msgid "Parallel compression of many files" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2513 msgid "" "On GNU and *BSD, B(1) and B(1) can be used to parallelize " "compression of many files:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2519 #, no-wrap msgid "" "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2541 msgid "" "The B<-P> option to B(1) sets the number of parallel B " "processes. The best value for the B<-n> option depends on how many files " "there are to be compressed. If there are only a couple of files, the value " "should probably be 1; with tens of thousands of files, 100 or even more may " "be appropriate to reduce the number of B processes that B(1) " "will eventually create." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2549 msgid "" "The option B<-T1> for B is there to force it to single-threaded mode, " "because B(1) is used to control the amount of parallelization." msgstr "" #. type: SS #: ../src/xz/xz.1:2550 #, no-wrap msgid "Robot mode" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2553 msgid "" "Calculate how many bytes have been saved in total after compressing multiple " "files:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2558 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2573 msgid "" "A script may want to know that it is using new enough B. The following " "B(1) script checks that the version number of the B tool is at " "least 5.0.0. This method is compatible with old beta versions, which didn't " "support the B<--robot> option:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2582 #, no-wrap msgid "" "CW /dev/null)\" ||\n" " [ \"$XZ_VERSION\" -lt 50000002 ]; then\n" " echo \"Your xz is too old.\"\n" "fi\n" "unset XZ_VERSION LIBLZMA_VERSION>\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2589 msgid "" "Set a memory usage limit for decompression using B, but if a limit " "has already been set, don't increase it:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2599 #, no-wrap msgid "" "CWE 20)) # 123 MiB\n" "OLDLIM=$(xz --robot --info-memory | cut -f3)\n" "if [ $OLDLIM -eq 0 -o $OLDLIM -gt $NEWLIM ]; then\n" " XZ_OPT=\"$XZ_OPT --memlimit-decompress=$NEWLIM\"\n" " export XZ_OPT\n" "fi>\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2609 msgid "" "The simplest use for custom filter chains is customizing a LZMA2 preset. " "This can be useful, because the presets cover only a subset of the " "potentially useful combinations of compression settings." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2617 msgid "" "The CompCPU columns of the tables from the descriptions of the options B<-0> " "... B<-9> and B<--extreme> are useful when customizing LZMA2 presets. Here " "are the relevant parts collected from those two tables:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2642 msgid "" "If you know that a file requires somewhat big dictionary (e.g. 32 MiB) to " "compress well, but you want to compress it quicker than B would do, a " "preset with a low CompCPU value (e.g. 1) can be modified to use a bigger " "dictionary:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2647 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2663 msgid "" "With certain files, the above command may be faster than B while " "compressing significantly better. However, it must be emphasized that only " "some files benefit from a big dictionary while keeping the CompCPU value " "low. The most obvious situation, where a big dictionary can help a lot, is " "an archive containing very similar files of at least a few megabytes each. " "The dictionary size has to be significantly bigger than any individual file " "to allow LZMA2 to take full advantage of the similarities between " "consecutive files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2670 msgid "" "If very high compressor and decompressor memory usage is fine, and the file " "being compressed is at least several hundred megabytes, it may be useful to " "use an even bigger dictionary than the 64 MiB that B would use:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2675 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2688 msgid "" "Using B<-vv> (B<--verbose --verbose>) like in the above example can be " "useful to see the memory requirements of the compressor and decompressor. " "Remember that using a dictionary bigger than the size of the uncompressed " "file is waste of memory, so the above command isn't useful for small files." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2701 msgid "" "Sometimes the compression time doesn't matter, but the decompressor memory " "usage has to be kept low e.g. to make it possible to decompress the file on " "an embedded system. The following command uses B<-6e> (B<-6 --extreme>) as " "a base and sets the dictionary to only 64\\ KiB. The resulting file can be " "decompressed with XZ Embedded (that's why there is B<--check=crc32>) using " "about 100\\ KiB of memory." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2706 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2729 msgid "" "If you want to squeeze out as many bytes as possible, adjusting the number " "of literal context bits (I) and number of position bits (I) can " "sometimes help. Adjusting the number of literal position bits (I) " "might help too, but usually I and I are more important. E.g. a " "source code archive contains mostly US-ASCII text, so something like the " "following might give slightly (like 0.1\\ %) smaller file than B " "(try also without B):" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2734 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2742 msgid "" "Using another filter together with LZMA2 can improve compression with " "certain file types. E.g. to compress a x86-32 or x86-64 shared library " "using the x86 BCJ filter:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2747 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2761 msgid "" "Note that the order of the filter options is significant. If B<--x86> is " "specified after B<--lzma2>, B will give an error, because there cannot " "be any filter after LZMA2, and also because the x86 BCJ filter cannot be " "used as the last filter in the chain." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2767 msgid "" "The Delta filter together with LZMA2 can give good results with bitmap " "images. It should usually beat PNG, which has a few more advanced filters " "than simple delta but uses Deflate for the actual compression." msgstr "" #. type: Plain text #: ../src/xz/xz.1:2777 msgid "" "The image has to be saved in uncompressed format, e.g. as uncompressed " "TIFF. The distance parameter of the Delta filter is set to match the number " "of bytes per pixel in the image. E.g. 24-bit RGB bitmap needs B, " "and it is also good to pass B to LZMA2 to accommodate the three-byte " "alignment:" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2782 #, no-wrap msgid "CW\n" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2790 msgid "" "If multiple images have been put into a single archive (e.g.\\& B<.tar>), " "the Delta filter will work on that too as long as all images have the same " "number of bytes per pixel." msgstr "" #. type: SH #: ../src/xz/xz.1:2791 ../src/xzdec/xzdec.1:143 ../src/lzmainfo/lzmainfo.1:59 ../src/scripts/xzdiff.1:64 ../src/scripts/xzgrep.1:92 ../src/scripts/xzless.1:65 ../src/scripts/xzmore.1:51 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2800 msgid "" "B(1), B(1), B(1), B(1), B(1), " "B(1), B(1), B<7z>(1)" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2802 msgid "XZ Utils: Ehttps://tukaani.org/xz/E" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2804 ../src/xzdec/xzdec.1:146 msgid "XZ Embedded: Ehttps://tukaani.org/xz/embedded.htmlE" msgstr "" #. type: Plain text #: ../src/xz/xz.1:2805 msgid "LZMA SDK: Ehttp://7-zip.org/sdk.htmlE" msgstr "" #. type: TH #: ../src/xzdec/xzdec.1:7 #, no-wrap msgid "XZDEC" msgstr "" #. type: TH #: ../src/xzdec/xzdec.1:7 #, no-wrap msgid "2017-04-19" msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:10 msgid "xzdec, lzmadec - Small .xz and .lzma decompressors" msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:14 msgid "B [I] [I]" msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:18 msgid "B [I] [I]" msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:44 msgid "" "B is a liblzma-based decompression-only tool for B<.xz> (and only " "B<.xz>) files. B is intended to work as a drop-in replacement for " "B(1) in the most common situations where a script has been written to " "use B (and possibly a few other commonly used " "options) to decompress B<.xz> files. B is identical to B " "except that B supports B<.lzma> files instead of B<.xz> files." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:61 msgid "" "To reduce the size of the executable, B doesn't support " "multithreading or localization, and doesn't read options from B " "and B environment variables. B doesn't support displaying " "intermediate progress information: sending B to B does " "nothing, but sending B terminates the process instead of displaying " "progress information." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:69 msgid "Ignored for B(1) compatibility. B supports only decompression." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:76 msgid "" "Ignored for B(1) compatibility. B never creates or removes any " "files." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:83 msgid "" "Ignored for B(1) compatibility. B always writes the " "decompressed data to standard output." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:89 msgid "" "Specifying this once does nothing since B never displays any warnings " "or notices. Specify this twice to suppress errors." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:96 msgid "Ignored for B(1) compatibility. B never uses the exit status 2." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:99 msgid "Display a help message and exit successfully." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:104 msgid "Display the version number of B and liblzma." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:108 msgid "All was good." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:117 msgid "" "B doesn't have any warning messages like B(1) has, thus the exit " "status 2 is not used by B." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:131 msgid "" "Use B(1) instead of B or B for normal everyday use. " "B or B are meant only for situations where it is important " "to have a smaller decompressor than the full-featured B(1)." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:143 msgid "" "B and B 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 distributions. If you need a truly small " "B<.xz> decompressor, consider using XZ Embedded." msgstr "" #. type: Plain text #: ../src/xzdec/xzdec.1:145 ../src/lzmainfo/lzmainfo.1:60 msgid "B(1)" msgstr "" #. type: TH #: ../src/lzmainfo/lzmainfo.1:7 #, no-wrap msgid "LZMAINFO" msgstr "" #. type: TH #: ../src/lzmainfo/lzmainfo.1:7 ../src/scripts/xzmore.1:7 #, no-wrap msgid "2013-06-30" msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:10 msgid "lzmainfo - show information stored in the .lzma file header" msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:15 msgid "B [B<--help>] [B<--version>] [I]" msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:31 msgid "" "B shows information stored in the B<.lzma> file header. It reads " "the first 13 bytes from the specified I, decodes the header, and " "prints it to standard output in human readable format. If no I are " "given or I is B<->, standard input is read." msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:40 msgid "" "Usually the most interesting information is the uncompressed size and the " "dictionary size. Uncompressed size can be shown only if the file is in the " "non-streamed B<.lzma> format variant. The amount of memory required to " "decompress the file is a few dozen kilobytes plus the dictionary size." msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:44 msgid "" "B is included in XZ Utils primarily for backward compatibility " "with LZMA Utils." msgstr "" #. type: SH #: ../src/lzmainfo/lzmainfo.1:51 ../src/scripts/xzdiff.1:72 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: ../src/lzmainfo/lzmainfo.1:59 msgid "" "B uses B while the correct suffix would be B (2^20 " "bytes). This is to keep the output compatible with LZMA Utils." msgstr "" #. type: TH #: ../src/scripts/xzdiff.1:9 #, no-wrap msgid "XZDIFF" msgstr "" #. type: TH #: ../src/scripts/xzdiff.1:9 ../src/scripts/xzgrep.1:9 #, no-wrap msgid "2011-03-19" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:12 msgid "xzcmp, xzdiff, lzcmp, lzdiff - compare compressed files" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:15 msgid "B [I] I [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:18 msgid "B [I] I [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:21 msgid "B [I] I [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:24 msgid "B [I] I [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:58 msgid "" "B and B invoke B(1) or B(1) on files compressed " "with B(1), B(1), B(1), B(1), or B(1). All " "options specified are passed directly to B(1) or B(1). If only " "one file is specified, then the files compared are I (which must have " "a suffix of a supported compression format) and I from which the " "compression format suffix has been stripped. If two files are specified, " "then they are uncompressed if necessary and fed to B(1) or " "B(1). The exit status from B(1) or B(1) is preserved." msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:64 msgid "" "The names B and B are provided for backward compatibility " "with LZMA Utils." msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:72 msgid "" "B(1), B(1), B(1), B(1), B(1), B(1), " "B(1)" msgstr "" #. type: Plain text #: ../src/scripts/xzdiff.1:77 msgid "" "Messages from the B(1) or B(1) programs refer to temporary " "filenames instead of those specified." msgstr "" #. type: TH #: ../src/scripts/xzgrep.1:9 #, no-wrap msgid "XZGREP" msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:12 msgid "xzgrep - search compressed files for a regular expression" msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:18 msgid "B [I] [B<-e>] I I..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:21 msgid "B ..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:24 msgid "B ..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:27 msgid "B ..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:30 msgid "B ..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:33 msgid "B ..." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:48 msgid "" "B invokes B(1) on I which may be either uncompressed " "or compressed with B(1), B(1), B(1), B(1), or " "B(1). All options specified are passed directly to B(1)." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:60 msgid "" "If no I is specified, then standard input is decompressed if necessary " "and fed to B(1). When reading from standard input, B(1), " "B(1), and B(1) compressed files are not supported." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:79 msgid "" "If B is invoked as B or B then B(1) or " "B(1) is used instead of B(1). The same applies to names " "B, B, and B, which are provided for backward " "compatibility with LZMA Utils." msgstr "" #. type: TP #: ../src/scripts/xzgrep.1:81 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:92 msgid "" "If the B environment variable is set, B uses it instead of " "B(1), B(1), or B(1)." msgstr "" #. type: Plain text #: ../src/scripts/xzgrep.1:98 msgid "B(1), B(1), B(1), B(1), B(1), B(1)" msgstr "" #. type: TH #: ../src/scripts/xzless.1:10 #, no-wrap msgid "XZLESS" msgstr "" #. type: TH #: ../src/scripts/xzless.1:10 #, no-wrap msgid "2010-09-27" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:13 msgid "xzless, lzless - view xz or lzma compressed (text) files" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:16 msgid "B [I...]" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:19 msgid "B [I...]" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:31 msgid "" "B is a filter that displays text from compressed files to a " "terminal. It works on files compressed with B(1) or B(1). If no " "I are given, B reads from standard input." msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:48 msgid "" "B uses B(1) to present its output. Unlike B, its " "choice of pager cannot be altered by setting an environment variable. " "Commands are based on both B(1) and B(1) and allow back and " "forth movement and searching. See the B(1) manual for more " "information." msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:52 msgid "" "The command named B is provided for backward compatibility with LZMA " "Utils." msgstr "" #. type: TP #: ../src/scripts/xzless.1:53 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:59 msgid "" "A list of characters special to the shell. Set by B unless it is " "already set in the environment." msgstr "" #. type: TP #: ../src/scripts/xzless.1:59 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:65 msgid "" "Set to a command line to invoke the B(1) decompressor for preprocessing " "the input files to B(1)." msgstr "" #. type: Plain text #: ../src/scripts/xzless.1:69 msgid "B(1), B(1), B(1), B(1)" msgstr "" #. type: TH #: ../src/scripts/xzmore.1:7 #, no-wrap msgid "XZMORE" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:10 msgid "xzmore, lzmore - view xz or lzma compressed (text) files" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:13 msgid "B [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:16 msgid "B [I]" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:24 msgid "" "B is a filter which allows examination of B(1) or B(1) " "compressed text files one screenful at a time on a soft-copy terminal." msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:33 msgid "" "To use a pager other than the default B set environment variable " "B to the name of the desired program. The name B is provided " "for backward compatibility with LZMA Utils." msgstr "" #. type: TP #: ../src/scripts/xzmore.1:33 #, no-wrap msgid "B or B" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:40 msgid "" "When the prompt --More--(Next file: I) is printed, this command " "causes B to exit." msgstr "" #. type: TP #: ../src/scripts/xzmore.1:40 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:47 msgid "" "When the prompt --More--(Next file: I) is printed, this command " "causes B to skip the next file and continue." msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:51 msgid "" "For list of keyboard commands supported while actually viewing the content " "of a file, refer to manual of the pager you use, usually B(1)." msgstr "" #. type: Plain text #: ../src/scripts/xzmore.1:55 msgid "B(1), B(1), B(1), B(1)" msgstr ""