Manpages

NOME

xz, unxz, xzcat, lzma, unlzma, lzcat - Compacta ou descompacta arquivos .xz e .lzma

SINOPSE

xz [opção...] [arquivo...]

COMANDOS APELIDOS

unxz é equivalente a xz --decompress.
xzcat é equivalente a xz --decompress --stdout.
lzma é equivalente a xz --format=lzma.
unlzma é equivalente a xz --format=lzma --decompress.
lzcat é equivalente a xz --format=lzma --decompress --stdout.

Ao escrever scripts que precisam descompactar arquivos, é recomendável sempre usar o nome xz com os argumentos apropriados (xz -d ou xz -dc) em vez dos nomes unxz e xzcat.

DESCRIÇÃO

xz é uma ferramenta de compactação de dados de uso geral com sintaxe de linha de comando semelhante ao gzip(1) e ao bzip2(1). O formato de arquivo nativo é o formato .xz, mas o formato legado .lzma usado por LZMA Utils e fluxos compactados brutos sem cabeçalhos de formato de contêiner também são suportados. Além disso, a descompactação do formato .lz usado por lzip é suportada.

xz compacta ou descompacta cada arquivo de acordo com o modo de operação selecionado. Se nenhum arquivo for fornecido ou arquivo for -, xz lê da entrada padrão e grava os dados processados na saída padrão. xz recusará (exibirá um erro e ignorará o arquivo) para gravar dados compactados na saída padrão se for um terminal. Da mesma forma, xz se recusará a ler dados compactados da entrada padrão se for um terminal.

A menos que --stdout seja especificado, arquivos diferentes de - são gravados em um novo arquivo cujo nome é derivado do nome arquivo de origem:

Se o arquivo de destino já existir, um erro será exibido e arquivo será ignorado.

A menos que grave na saída padrão, xz exibirá um aviso e pulará o arquivo se qualquer um dos seguintes se aplicar:

Depois de compactar ou descompactar com êxito o arquivo, o xz copia o dono, grupo, permissões, horário de acesso e horário de modificação do arquivo de origem para o arquivo de destino. Se a cópia do grupo falhar, as permissões serão modificadas para que o arquivo de destino não se torne acessível a usuários que não têm permissão para acessar o arquivo de origem. xz ainda não oferece suporte à cópia de outros metadados, como listas de controle de acesso ou atributos estendidos.

Depois que o arquivo de destino for fechado com êxito, o arquivo de origem será removido, a menos que --keep tenha sido especificado. O arquivo de origem nunca é removido se a saída for gravada na saída padrão ou se ocorrer um erro.

O envio de SIGINFO ou SIGUSR1 para o processo do xz faz com que ele imprima informações de andamento para erro padrão. Isso tem uso limitado, pois quando o erro padrão é um terminal, usar --verbose exibirá um indicador de progresso de atualização automática.

Uso de memória
O uso de memória de xz varia de algumas centenas de kilobytes a vários gigabytes, dependendo das configurações de compactação. As configurações usadas ao compactar um arquivo determinam os requisitos de memória do descompactador. Normalmente, o descompactador precisa de 5 % a 20 % da quantidade de memória que o compactador precisou ao criar o arquivo. Por exemplo, descompactar um arquivo criado com xz -9 atualmente requer 65 MiB de memória. Ainda assim, é possível ter arquivos .xz que requerem vários gigabytes de memória para descompactar.

Especialmente os usuários de sistemas mais antigos podem achar irritante a possibilidade de uso de memória muito grande. Para evitar surpresas desconfortáveis, o xz possui um limitador de uso de memória embutido, que está desabilitado por padrão. Embora alguns sistemas operacionais forneçam maneiras de limitar o uso de memória dos processos, confiar nele não foi considerado flexível o suficiente (por exemplo, usar ulimit(1) para limitar a memória virtual tende a prejudicar mmap(2)).

O limitador de uso de memória pode ser ativado com a opção de linha de comando --memlimit=limite. Geralmente é mais conveniente habilitar o limitador por padrão definindo a variável de ambiente XZ_DEFAULTS, por exemplo, XZ_DEFAULTS=--memlimit=150MiB. É possível definir os limites separadamente para compactação e descompactação usando --memlimit-compress=limite e --memlimit-decompress=limite. Usar essas duas opções fora de XZ_DEFAULTS raramente é útil porque uma única execução de xz não pode fazer compactação e descompactação e --memlimit=limite (ou -M limite ) é mais curto para digitar na linha de comando.

Se o limite de uso de memória especificado for excedido durante a descompactação, xz exibirá um erro e a descompactação do arquivo falhará. Se o limite for excedido durante a compactação, xz tentará reduzir as configurações para que o limite não seja mais excedido (exceto ao usar --format=raw ou --no-adjust). Dessa forma, a operação não falhará, a menos que o limite seja muito pequeno. A escala das configurações é feita em etapas que não correspondem às predefinições do nível de compactação, por exemplo, se o limite for apenas um pouco menor que o valor necessário para xz -9, as configurações serão reduzidas apenas um pouco , não até xz -8.

Concatenação e preenchimento com arquivos .xz
É possível concatenar arquivos .xz como estão. xz irá descompactar tais arquivos como se fossem um único arquivo .xz.

É possível inserir preenchimento entre as partes concatenadas ou após a última parte. O preenchimento deve consistir em bytes nulos e o tamanho do preenchimento deve ser um múltiplo de quatro bytes. Isso pode ser útil, por exemplo, se o arquivo .xz for armazenado em uma mídia que mede tamanhos de arquivo em blocos de 512 bytes.

Concatenação e preenchimento não são permitidos com arquivos .lzma ou fluxos brutos.

OPÇÕES

Sufixos inteiros e valores especiais
Na maioria dos lugares onde um argumento inteiro é esperado, um sufixo opcional é suportado para indicar facilmente números inteiros grandes. Não deve haver espaço entre o número inteiro e o sufixo.

O valor especial max pode ser usado para indicar o valor inteiro máximo suportado pela opção.

Modo de operação
Se várias opções de modo de operação forem dadas, a última entrará em vigor.
-z, --compress

Compacta. Este é o modo de operação padrão quando nenhuma opção de modo de operação é especificada e nenhum outro modo de operação está implícito no nome do comando (por exemplo, unxz implica em --decompress).

-d, --decompress, --uncompress

Descompacta.

-t, --test

Testa a integridade de arquivos compactados. Esta opção é equivalente a --decompress --stdout exceto que os dados descompactados são descartados em vez de serem gravados na saída padrão. Nenhum arquivo é criado ou removido.

-l, --list

Imprime informações sobre arquivos compactados. Nenhuma saída descompactada é produzida e nenhum arquivo é criado ou removido. No modo de lista, o programa não pode ler os dados compactados da entrada padrão ou de outras fontes não pesquisáveis.

Modificadores de operação
-k, --keep

Não exclui os arquivos de entrada.

-f, --force

Esta opção tem vários efeitos:

-c, --stdout, --to-stdout

Grava os dados compactados ou descompactados na saída padrão em vez de em um arquivo. Isso implica em --keep.

--single-stream

Descompacta apenas o primeiro fluxo de .xz e ignora silenciosamente possíveis dados de entrada restantes após o fluxo. Normalmente, esse restante posterior sem uso faz com que xz exiba um erro.

--no-sparse

Desativa a criação de arquivos esparsos. Por padrão, ao descompactar em um arquivo normal, xz tenta tornar o arquivo esparso se os dados descompactados contiverem longas sequências de zeros binários. Ele também funciona ao gravar na saída padrão, desde que a saída padrão esteja conectada a um arquivo normal e certas condições adicionais sejam atendidas para torná-la segura. A criação de arquivos esparsos pode economizar espaço em disco e acelerar a descompactação, reduzindo a quantidade de E/S do disco.

-S .suf, --suffix=.suf

Ao compactar, usa .suf como sufixo para o arquivo de destino em vez de .xz ou .lzma. Se não estiver gravando na saída padrão e o arquivo de origem já tiver o sufixo .suf, um aviso será exibido e o arquivo será ignorado.

--files[=arquivo]

Lê os nomes dos arquivos a serem processados em arquivo; se arquivo for omitido, os nomes dos arquivos serão lidos da entrada padrão. Os nomes de arquivo devem terminar com o caractere de nova linha. Um traço (-) é considerado um nome de arquivo regular; não significa entrada padrão. Se os nomes de arquivo forem fornecidos também como argumentos de linha de comando, eles serão processados antes da leitura dos nomes de arquivo de arquivo.

--files0[=arquivo]

Isso é idêntico a --files[=arquivo], exceto que cada nome de arquivo deve ser finalizado com o caractere nulo.

Opções básicas de formato de arquivo e de compactação
-F formato, --format=formato

Especifica o formato de arquivo para compactar ou descompactar:

lzma, alone

Compacta no formato de arquivo legado .lzma ou aceite apenas arquivos .lzma ao descompactar. O nome alternativo alone é fornecido para compatibilidade com versões anteriores do LZMA Utils.

-C verificação, --check=verificação

Especifica o tipo de verificação de integridade. A verificação é calculada a partir dos dados descompactados e armazenados no arquivo .xz. Esta opção tem efeito somente ao compactar no formato .xz; o formato .lzma não oferece suporte a verificações de integridade. A verificação de integridade (se for o caso) é verificada quando o arquivo .xz é descompactado.

none

A integridade dos cabeçalhos de .xz é sempre verificada com CRC32. Não é possível alterá-la ou desativá-la.

--ignore-check

Não confere a verificação de integridade dos dados compactados ao descompactar. Os valores CRC32 nos cabeçalhos .xz ainda serão conferidos normalmente.

•

-0 ... -9

Seleciona um nível de predefinição de compactação. O padrão é -6. Se vários níveis de predefinição forem especificados, o último terá efeito. Se uma cadeia de filtro personalizada já foi especificada, especificar um nível de predefinição de compactação limpa a cadeia de filtro personalizada.

-0 ... -3

Estas são predefinições um tanto rápidas. -0 às vezes é mais rápida que gzip -9 ao mesmo tempo que compacta muito melhor. As mais altas geralmente têm velocidade comparável ao bzip2(1) com taxa de compactação comparável ou melhor, embora os resultados dependam muito do tipo de dados que estão sendo compactados.

-4 ... -6

Compactação boa a muito boa, mantendo o uso de memória do descompactador razoável mesmo para sistemas antigos. -6 é o padrão, que geralmente é uma boa escolha para distribuir arquivos que precisam ser descompactáveis, mesmo em sistemas com apenas 16 MiB de RAM. (-5e ou -6e também vale a pena considerar. Veja --extreme.)

-7 ... -9

Eles são como -6, mas com requisitos de memória de compressor e descompressor mais altos. Eles são úteis apenas ao compactar arquivos maiores que 8 MiB, 16 MiB e 32 MiB, respectivamente.

•

Memory requirements of the multi-threaded mode are significantly higher than that of the single-threaded mode. With the default value of --block-size, each thread needs 3*3*DictSize plus CompMem or DecMem. For example, four threads with preset -6 needs 660–670 MiB of memory.

-e, --extreme

Usa uma variante mais lenta do nível de predefinição de compactação selecionado (-0 ... -9) para obter uma taxa de compactação um pouco melhor, mas, com azar, isso também pode piorar. O uso da memória do descompressor não é afetado, mas o uso da memória do compactador aumenta um pouco nos níveis de predefinição -0 ... -3.

--block-size=tamanho

Ao compactar para o formato .xz, divida os dados de entrada em blocos de tamanho bytes. Os blocos são compactados independentemente uns dos outros, o que ajuda no multi-threading e torna possível a descompactação limitada de acesso aleatório. Essa opção normalmente é usada para substituir o tamanho de bloco padrão no modo multi-thread, mas também pode ser usada em thread única.

--block-list=items

When compressing to the .xz format, start a new block with an optional custom filter chain after the given intervals of uncompressed data.

•

If one specifies a size that exceeds the encoder’s block size (either the default value in threaded mode or the value specified with --block-size=size), the encoder will create additional blocks while keeping the boundaries specified in items. For example, if one specifies --block-size=10MiB --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.

--flush-timeout=tempo_limite

Ao compactar, se mais de tempo_limite milissegundos (um número inteiro positivo) se passaram desde a liberação anterior e a leitura de mais entrada seria bloqueada, todos os dados de entrada pendentes serão liberados do codificador e disponibilizados no fluxo de saída. Isso pode ser útil se xz for usado para compactar dados transmitidos por uma rede. Valores tempo_limite pequenos tornam os dados disponíveis na extremidade receptora com um pequeno atraso, mas valores tempo_limite grandes oferecem melhor taxa de compactação.

--memlimit-compress=limite

Define um limite de uso de memória para compactação. Se esta opção for especificada várias vezes, a última entrará em vigor.

•

Para xz de 32 bits, há um caso especial: se o limite estiver acima de 4020 MiB, o limite é definido como 4020 MiB. No MIPS32 2000 MiB é usado em seu lugar. (Os valores 0 e max não são afetados por isso. Um recurso semelhante não existe para descompactação.) Isso pode ser útil quando um executável de 32 bits tem acesso a espaço de endereço de 4 GiB (2 GiB no MIPS32) enquanto espero não causar danos em outras situações.

--memlimit-decompress=limite

Define um limite de uso de memória para descompactação. Isso também afeta o modo --list. Se a operação não for possível sem exceder o limite, xz exibirá um erro e a descompactação do arquivo falhará. Consulte --memlimit-compress=limite para possíveis maneiras de especificar o limite.

--memlimit-mt-decompress=limite

Define um limite de uso de memória para descompactação multi-thread. Isso pode afetar apenas o número de threads; isso nunca fará com que xz se recuse a descompactar um arquivo. Se limite for muito baixo para permitir qualquer multi-thread, o limite será ignorado e xz continuará no modo de thread única. Observe que se --memlimit-decompress também for usado, ele sempre se aplicará aos modos de thread única e multi-thread e, portanto, o limite efetivo para multi-threading nunca será maior que o limite definido com --memlimit-decompress.

-M limite, --memlimit=limite, --memory=limite

Isso é equivalente a especificar --memlimit-compress=limite --memlimit-decompress=limite --memlimit-mt-decompress=limite.

--no-adjust

Exibe um erro e saia se o limite de uso de memória não puder ser atendido sem ajustar as configurações que afetam a saída compactada. Ou seja, isso evita que xz alterne o codificador do modo multi-thread para o modo encadeado único e reduza o tamanho do dicionário LZMA2. Mesmo quando esta opção é usada, o número de threads pode ser reduzido para atender ao limite de uso de memória, pois isso não afetará a saída compactada.

-T threads, --threads=threads

Especifica o número de threads de trabalho a serem usados. Definir threads para um valor especial 0 faz com que xz use tantos threads quanto o(s) processador(es) no suporte do sistema. O número real de encadeamentos pode ser menor que threads se o arquivo de entrada não for grande o suficiente para subdividir em threads com as configurações fornecidas ou se o uso de mais threads exceder o limite de uso de memória.

Cadeias de filtro de compressor personalizadas
Uma cadeia de filtro personalizada permite especificar as configurações de compactação em detalhes, em vez de confiar nas configurações associadas às predefinições. Quando uma cadeia de filtro personalizada é especificada, as opções predefinidas (-0 ... -9 e --extreme) anteriores na linha de comando são esquecidas. Se uma opção predefinida for especificada após uma ou mais opções de cadeia de filtros personalizados, a nova predefinição entrará em vigor e as opções de cadeia de filtros personalizados especificadas anteriormente serão esquecidas.

Uma cadeia de filtro é comparável à tubulação na linha de comando. Ao compactar, a entrada descompactada vai para o primeiro filtro, cuja saída vai para o próximo filtro (se houver). A saída do último filtro é gravada no arquivo compactado. O número máximo de filtros na cadeia é quatro, mas normalmente uma cadeia de filtros tem apenas um ou dois filtros.

Muitos filtros têm limitações sobre onde podem estar na cadeia de filtros: alguns filtros podem funcionar apenas como o último filtro na cadeia, alguns apenas como filtro não-último e alguns funcionam em qualquer posição na cadeia. Dependendo do filtro, essa limitação é inerente ao projeto do filtro ou existe para evitar problemas de segurança.

A custom filter chain can be specified in two different ways. The options --filters=filters and --filters1=filters ... --filters9=filters allow specifying an entire filter chain in one option using the liblzma filter string syntax. Alternatively, a filter chain can be specified by using one or more individual filter options in the order they are wanted in the filter chain. That is, the order of the individual filter options is significant! When decoding raw streams (--format=raw), the filter chain must be specified in the same order as it was specified when compressing. Any individual filter or preset options specified before the full chain option (--filters=filters) will be forgotten. Individual filters specified after the full chain option will reset the filter chain.

Both the full and individual filter options take filter-specific options as a comma-separated list. Extra commas in options are ignored. Every option has a default value, so specify those you want to change.

Para ver toda a cadeia de filtros e opções, use xz -vv (isto é, use --verbose duas vezes). Isso também funciona para visualizar as opções da cadeia de filtros usadas pelas predefinições.
--filters=filters

Specify the full filter chain or a preset in a single option. Each filter can be separated by spaces or two dashes (--). filters may need to be quoted on the shell command line so it is parsed as a single option. To denote options, use : or =. A preset can be prefixed with a - and followed with zero or more flags. The only supported flag is e to apply the same options as --extreme.

--filters1=filters ... --filters9=filters

Specify up to nine additional filter chains that can be used with --block-list.

--filters-help

Display a help message describing how to specify presets and custom filter chains in the --filters and --filters1=filters ... --filters9=filters options, and exit successfully.

--lzma1[=opções]
--lzma2[=opções]

Adiciona o filtro LZMA1 ou LZMA2 à cadeia de filtros. Esses filtros podem ser usados apenas como o último filtro na cadeia.

preset=predefinição

Redefine todas as opções de LZMA1 ou LZMA2 para predefinição. Predefinição consiste em um número inteiro, que pode ser seguido por modificadores de predefinição de uma única letra. O inteiro pode ser de 0 a 9, correspondendo às opções de linha de comando -0 ... -9. O único modificador suportado atualmente é e, que corresponde a --extreme. Se nenhum preset for especificado, os valores padrão das opções LZMA1 ou LZMA2 serão obtidos da predefinição 6.

dict=tamanho

O tamanho do dicionário (buffer de histórico) indica quantos bytes dos dados não compactados processados recentemente são mantidos na memória. O algoritmo tenta encontrar sequências de bytes repetidos (correspondências) nos dados não compactados e substituí-los por referências aos dados atualmente no dicionário. Quanto maior o dicionário, maior a chance de encontrar uma correspondência. Portanto, aumentar o dicionário tamanho geralmente melhora a taxa de compactação, mas um dicionário maior que o arquivo não compactado é um desperdício de memória.

hc3

Valor mínimo para nice: 3
Uso de memória:
dict * 7.5 (if dict <= 16 MiB);
dict * 5.5 + 64 MiB (if dict > 16 MiB)

Valor mínimo para nice: 4
Uso de memória:
dict * 7.5 (if dict <= 32 MiB);
dict * 6.5 (if dict > 32 MiB)

Valor mínimo para nice: 2
Uso de memória: dict * 9.5

Valor mínimo para nice: 3
Uso de memória:
dict * 11.5 (if dict <= 16 MiB);
dict * 9.5 + 64 MiB (if dict > 16 MiB)

Valor mínimo para nice: 4
Uso de memória:
dict * 11.5 (if dict <= 32 MiB);
dict * 10.5 (if dict > 32 MiB)

mode=modo

O modo de compactação especifica o método para analisar os dados produzidos pelo localizador de correspondência. Os modos suportados são fast e normal. O padrão é fast para predefinições 0–3 e normal para predefinições 4–9.

nice=nice

Especifica o que é considerado um bom comprimento para uma correspondência. Uma vez que uma correspondência de pelo menos nice bytes é encontrada, o algoritmo para de procurar correspondências possivelmente melhores.

depth=profundidade

Especifica a profundidade máxima de pesquisa no localizador de correspondências. O padrão é o valor especial de 0, que faz com que o compressor determine um profundidade razoável de mf e nice.

--x86[=opções]
--arm[=opções]
--armthumb[=opções]
--arm64[=opções]
--powerpc[=opções]
--ia64[=opções]
--sparc[=opções]
--riscv[=opções]

Adiciona um filtro de ramificação/chamada/salto (BCJ) à cadeia de filtros. Esses filtros podem ser usados apenas como um filtro não último na cadeia de filtros.

•

Conjuntos de instruções diferentes têm alinhamento diferente: o arquivo executável deve ser alinhado a um múltiplo desse valor nos dados de entrada para fazer o filtro funcionar.

•

Todos os filtros BCJ suportam as mesmas opções:
start=deslocamento

Especifica o deslocamento inicial que é usado na conversão entre endereços relativos e absolutos. O deslocamento deve ser um múltiplo do alinhamento do filtro (ver tabela acima). O padrão é zero. Na prática, o padrão é bom; especificar um deslocamento personalizado quase nunca é útil.

--delta[=opções]

Adiciona o filtro Delta à cadeia de filtros. O filtro Delta só pode ser usado como filtro não-último na cadeia de filtros.

dist=distância

Especifica a distância do cálculo delta em bytes. distância deve ser 1–256. O padrão é 1.

Outras opções
-q, --quiet

Suprime avisos e avisos. Especifique isso duas vezes para suprimir erros também. Esta opção não tem efeito no status de saída. Ou seja, mesmo que um aviso tenha sido suprimido, o status de saída para indicar um aviso ainda é usado.

-v, --verbose

Ser detalhado. Se o erro padrão estiver conectado a um terminal, xz exibirá um indicador de progresso. Especifique --verbose duas vezes dará uma saída ainda mais detalhada.

•

Quando o erro padrão não é um terminal, --verbose fará com que xz imprima o nome do arquivo, tamanho compactado, tamanho não compactado, taxa de compactação e possivelmente também a velocidade e o tempo decorrido em uma única linha para o erro padrão após a compactação ou descompactando o arquivo. A velocidade e o tempo decorrido são incluídos apenas quando a operação leva pelo menos alguns segundos. Se a operação não foi concluída, por exemplo, devido à interrupção do usuário, também é impressa a porcentagem de conclusão se o tamanho do arquivo de entrada for conhecido.

-Q, --no-warn

Não define o status de saída como 2, mesmo que uma condição digna de um aviso tenha sido detectada. Esta opção não afeta o nível de detalhamento, portanto, tanto --quiet quanto --no-warn devem ser usados para não exibir avisos e não alterar o status de saída.

--robot

Imprime mensagens em um formato analisável por máquina. Isso visa facilitar a criação de frontends que desejam usar xz em vez de liblzma, o que pode ser o caso de vários scripts. A saída com esta opção habilitada deve ser estável em versões xz. Consulte a seção MODO ROBÔ para obter detalhes.

--info-memory

Exibe, em formato legível por humanos, quanta memória física (RAM) e quantos threads de processador xz acredita que o sistema possui e os limites de uso de memória para compactação e descompactação e saia com êxito.

-h, --help

Exibe uma mensagem de ajuda descrevendo as opções mais usadas e sai com sucesso.

-H, --long-help

Exibe uma mensagem de ajuda descrevendo todos os recursos de xz e sai com sucesso

-V, --version

Exibe o número da versão de xz e liblzma em formato legível por humanos. Para obter uma saída analisável por máquina, especifique --robot antes de --version.

MODO ROBÔ

The robot mode is activated with the --robot option. It makes the output of xz easier to parse by other programs. Currently --robot is supported only together with --list, --filters-help, --info-memory, and --version. It will be supported for compression and decompression in the future.

Modo lista
xz --robot --list usa saída separada por tabulações. A primeira coluna de cada linha possui uma string que indica o tipo de informação encontrada naquela linha:

summary

Este tipo de linha é usado apenas quando --verbose foi especificado duas vezes. Esta linha é impressa após todas as linhas de block. Assim como a linha arquivo, a linha summary contém informações gerais sobre o arquivo .xz.

As colunas das linhas file:

As colunas das linhas stream:

As colunas das linhas block:

Se --verbose for especificado duas vezes, colunas adicionais serão incluídas nas linhas block. Eles não são exibidos com um único --verbose, porque obter essas informações requer muitas buscas e, portanto, pode ser lento:

As colunas das linhas summary:

Desde xz 5.1.2alpha:

As colunas da linha totals:

Se --verbose for especificado duas vezes, colunas adicionais serão incluídas na linha totals:

Desde xz 5.1.2alpha:

Versões futuras podem adicionar novos tipos de linha e novas colunas podem ser adicionadas aos tipos de linha existentes, mas as colunas existentes não serão alteradas.

Filters help
xz --robot --filters-help prints the supported filters in the following format:

filter:option=<value>,option=<value>...

Each filter is printed on its own line.

Informações de limite de memória
xz --robot --info-memory prints a single line with multiple tab-separated columns:

No futuro, a saída de xz --robot --info-memory pode ter mais colunas, mas nunca mais do que uma única linha.

Versão
xz --robot --version prints the version number of xz and liblzma in the following format:

XZ_VERSION=XYYYZZZS
LIBLZMA_VERSION=XYYYZZZS

XYYYZZZS são iguais em ambas as linhas se xz e liblzma forem da mesma versão do XZ Utils.

Exemplos: 4.999.9beta é 49990091 e 5.0.0 é 50000002.

STATUS DE SAÍDA

Observações (não avisos ou erros) impressas no erro padrão não afetam o status de saída.

AMBIENTE

xz analisa listas de opções separadas por espaços das variáveis de ambiente XZ_DEFAULTS e XZ_OPT, nesta ordem, antes de analisar as opções da linha de comando. Observe que apenas as opções são analisadas a partir das variáveis de ambiente; todas as não opções são silenciosamente ignoradas. A análise é feita com getopt_long(3) que também é usado para os argumentos da linha de comando.
XZ_DEFAULTS

Opções padrão específicas do usuário ou de todo o sistema. Normalmente, isso é definido em um script de inicialização do shell para habilitar o limitador de uso de memória do xz por padrão. Excluindo scripts de inicialização de shell e casos especiais semelhantes, os scripts nunca devem definir ou remover a definição de XZ_DEFAULTS.

XZ_OPT=-2v tar caf foo.tar.xz foo

XZ_OPT=${XZ_OPT-"-7e"}
export XZ_OPT

COMPATIBILIDADE COM LZMA UTILS

A sintaxe da linha de comando do xz é praticamente um superconjunto de lzma, unlzma e lzcat conforme encontrado no LZMA Utils 4.32.x. Na maioria dos casos, é possível substituir LZMA Utils por XZ Utils sem interromper os scripts existentes. Existem algumas incompatibilidades, porém, que às vezes podem causar problemas.

Níveis de predefinição de compactação
A numeração das predefinições de nível de compactação não é idêntica em xz e LZMA Utils. A diferença mais importante é como os tamanhos dos dicionários são mapeados para diferentes predefinições. O tamanho do dicionário é aproximadamente igual ao uso de memória do descompactador.

As diferenças de tamanho do dicionário também afetam o uso da memória do compressor, mas existem algumas outras diferenças entre LZMA Utils e XZ Utils, que tornam a diferença ainda maior:

O nível de predefinição padrão no LZMA Utils é -7 enquanto no XZ Utils é -6, então ambos usam um dicionário de 8 MiB por padrão.

Arquivos .lzma em um fluxo versus sem ser em um fluxo
O tamanho descompactado do arquivo pode ser armazenado no cabeçalho de .lzma. O LZMA Utils faz isso ao compactar arquivos comuns. A alternativa é marcar que o tamanho não compactado é desconhecido e usar o marcador de fim de carga útil para indicar onde o descompactador deve parar. O LZMA Utils usa este método quando o tamanho não compactado não é conhecido, como é o caso, por exemplo, de encadeamentos (pipes).

xz oferece suporte à descompactação de arquivos .lzma com ou sem marcador de fim de carga útil, mas todos os arquivos .lzma criados por xz usarão marcador de fim de carga útil e terão o tamanho descompactado marcado como desconhecido no cabeçalho de .lzma. Isso pode ser um problema em algumas situações incomuns. Por exemplo, um descompactador de .lzma em um dispositivo embarcado pode funcionar apenas com arquivos que tenham tamanho descompactado conhecido. Se você encontrar esse problema, precisará usar o LZMA Utils ou o LZMA SDK para criar arquivos .lzma com tamanho descompactado conhecido.

Arquivos .lzma não suportados
O formato .lzma permite valores lc até 8 e valores lp até 4. LZMA Utils pode descompactar arquivos com qualquer lc e lp, mas sempre cria arquivos com lc=3 e lp=0. Criar arquivos com outros lc e lp é possível com xz e com LZMA SDK.

A implementação do filtro LZMA1 em liblzma requer que a soma de lc e lp não exceda 4. Assim, arquivos .lzma, que excedam esta limitação, não podem ser descompactados com xz.

LZMA Utils cria apenas arquivos .lzma que possuem um tamanho de dicionário de 2^n (uma potência de 2), mas aceita arquivos com qualquer tamanho de dicionário. liblzma aceita apenas arquivos .lzma que tenham um tamanho de dicionário de 2^n ou 2^n + 2^(n-1). Isso é para diminuir os falsos positivos ao detectar arquivos .lzma.

Essas limitações não devem ser um problema na prática, já que praticamente todos os arquivos .lzma foram compactados com configurações que o liblzma aceitará.

Lixo à direita
Ao descompactar, o LZMA Utils silenciosamente ignora tudo após o primeiro fluxo .lzma. Na maioria das situações, isso é um bug. Isso também significa que o LZMA Utils não oferece suporte a descompactação de arquivos .lzma concatenados.

Se houver dados restantes após o primeiro fluxo de .lzma, xz considera o arquivo corrompido, a menos que --single-stream tenha sido usado. Isso pode quebrar scripts obscuros que presumiram que o lixo à direita é ignorado.

NOTAS

A saída compactada pode variar
A saída compactada exata produzida a partir do mesmo arquivo de entrada não compactado pode variar entre as versões do XZ Utils, mesmo se as opções de compactação forem idênticas. Isso ocorre porque o codificador pode ser aprimorado (compactação mais rápida ou melhor) sem afetar o formato do arquivo. A saída pode variar mesmo entre diferentes compilações da mesma versão do XZ Utils, se diferentes opções de compilação forem usadas.

A informação acima significa que, uma vez que --rsyncable tenha sido implementado, os arquivos resultantes não serão necessariamente "rsyncáveis", a menos que os arquivos antigos e novos tenham sido compactados com a mesma versão xz. Esse problema pode ser corrigido se uma parte da implementação do codificador for congelada para manter a saída de rsyncable estável nas versões do xz.

Descompactadores .xz embarcados
As implementações do descompactador .xz embarcados, como o XZ Embedded, não oferecem necessariamente suporte a arquivos criados com tipos de verificações de integridade diferentes de none e crc32. Como o padrão é --check=crc64, você deve usar --check=none ou --check=crc32 ao criar arquivos para sistemas embarcados.

Fora dos sistemas embarcados, todos os descompactadores de formato .xz oferecem suporte a todos os tipos de verificação ou, pelo menos, são capazes de descompactar o arquivo sem verificar a verificação de integridade se a verificação específica não for suportada.

XZ Embedded oferece suporte a filtros BCJ, mas apenas com o deslocamento inicial padrão.

EXEMPLOS

Básico
Compactar o arquivo foo em foo.xz usando o nível de compactação padrão (-6) e remover foo se a compactação for bem-sucedida:

xz foo

Descompactar bar.xz em bar e não remover bar.xz mesmo se a descompactação for bem-sucedida:

xz -dk bar.xz

Criar baz.tar.xz com a predefinição -4e (-4 --extreme), que é mais lenta que o padrão -6, mas precisa de menos memória para compactação e descompactação (48  MiB e 5 MiB, respectivamente):

tar cf - baz | xz -4e > baz.tar.xz

Uma mistura de arquivos compactados e descompactados pode ser descompactada para a saída padrão com um único comando:

xz -dcf a.txt b.txt.xz c.txt d.txt.lzma > abcd.txt

Compactação paralela de muitos arquivos
No GNU e *BSD, find(1) e xargs(1) podem ser usados para paralelizar a compactação de muitos arquivos:

find . -type f \! -name ’*.xz’ -print0 \
| xargs -0r -P4 -n16 xz -T1

A opção -P para xargs(1) define o número de processos paralelos do xz. O melhor valor para a opção -n depende de quantos arquivos devem ser compactados. Se houver apenas alguns arquivos, o valor provavelmente deve ser 1; com dezenas de milhares de arquivos, 100 ou até mais podem ser apropriados para reduzir o número de processos de xz que xargs(1) eventualmente criará.

A opção -T1 para xz existe para forçá-lo ao modo de thread única, porque xargs(1) é usado para controlar a quantidade de paralelização.

Modo robô
Calcular quantos bytes foram salvos no total depois de compactar vários arquivos:

xz --robot --list *.xz | awk ’/^totals/{print $5-$4}’

Um script pode querer saber que está usando xz novo o suficiente. O seguinte script sh(1) verifica se o número da versão da ferramenta xz é pelo menos 5.0.0. Este método é compatível com versões beta antigas, que não suportavam a opção --robot:

if ! eval "$(xz --robot --version 2> /dev/null)" ||
[ "$XZ_VERSION" -lt 50000002 ]; then
echo "Your xz is too old."
fi
unset XZ_VERSION LIBLZMA_VERSION

Definir um limite de uso de memória para descompactação usando XZ_OPT, mas se um limite já tiver sido definido, não o aumentar:

NEWLIM=$((123 << 20))  # 123 MiB
OLDLIM=$(xz --robot --info-memory | cut -f3)
if [ $OLDLIM -eq 0 -o $OLDLIM -gt $NEWLIM ]; then
XZ_OPT="$XZ_OPT --memlimit-decompress=$NEWLIM"
export XZ_OPT
fi

Cadeias de filtro de compressor personalizadas
O uso mais simples para cadeias de filtro personalizadas é personalizar uma predefinição LZMA2. Isso pode ser útil, porque as predefinições abrangem apenas um subconjunto das combinações potencialmente úteis de configurações de compactação.

As colunas CompCPU das tabelas das descrições das opções -0 ... -9 e --extreme são úteis ao personalizar as predefinições LZMA2. Aqui estão as partes relevantes coletadas dessas duas tabelas:

Se você sabe que um arquivo requer um dicionário um tanto grande (por exemplo, 32 MiB) para compactar bem, mas deseja comprimi-lo mais rapidamente do que xz -8 faria, uma predefinição com um valor CompCPU baixo (por exemplo, 1) pode ser modificado para usar um dicionário maior:

xz --lzma2=preset=1,dict=32MiB foo.tar

Com certos arquivos, o comando acima pode ser mais rápido que xz -6 enquanto compacta significativamente melhor. No entanto, deve-se enfatizar que apenas alguns arquivos se beneficiam de um grande dicionário, mantendo o valor CompCPU baixo. A situação mais óbvia, onde um grande dicionário pode ajudar muito, é um arquivo contendo arquivos muito semelhantes de pelo menos alguns megabytes cada. O tamanho do dicionário deve ser significativamente maior do que qualquer arquivo individual para permitir que o LZMA2 aproveite ao máximo as semelhanças entre arquivos consecutivos.

Se o uso muito alto de memória do compactador e do descompactador for bom e o arquivo que está sendo compactado tiver pelo menos várias centenas de megabytes, pode ser útil usar um dicionário ainda maior do que os 64 MiB que o xz -9 usaria:

xz -vv --lzma2=dict=192MiB big_foo.tar

Usar -vv (--verbose --verbose) como no exemplo acima pode ser útil para ver os requisitos de memória do compactador e do descompactador. Lembre-se que usar um dicionário maior que o tamanho do arquivo descompactado é desperdício de memória, então o comando acima não é útil para arquivos pequenos.

Às vezes, o tempo de compactação não importa, mas o uso de memória do descompactador deve ser mantido baixo, por exemplo, para possibilitar a descompactação do arquivo em um sistema embarcado. O comando a seguir usa -6e (-6 --extreme) como base e define o dicionário como apenas 64 KiB. O arquivo resultante pode ser descompactado com XZ Embedded (é por isso que existe --check=crc32) usando cerca de 100 KiB de memória.

xz --check=crc32 --lzma2=preset=6e,dict=64KiB foo

Se você deseja espremer o máximo de bytes possível, ajustar o número de bits de contexto literal (lc) e o número de bits de posição (pb) às vezes pode ajudar. Ajustar o número de bits de posição literal (lp) também pode ajudar, mas geralmente lc e pb são mais importantes. Por exemplo, um arquivo de código-fonte contém principalmente texto US-ASCII, então algo como o seguinte pode fornecer um arquivo ligeiramente (como 0,1 %) menor que xz -6e (tente também sem lc=4):

xz --lzma2=preset=6e,pb=0,lc=4 source_code.tar

O uso de outro filtro junto com o LZMA2 pode melhorar a compactação com determinados tipos de arquivo. Por exemplo, para compactar uma biblioteca compartilhada x86-32 ou x86-64 usando o filtro x86 BCJ:

xz --x86 --lzma2 libfoo.so

Observe que a ordem das opções de filtro é significativa. Se --x86 for especificado após --lzma2, xz dará um erro, porque não pode haver nenhum filtro após LZMA2 e também porque o filtro x86 BCJ não pode ser usado como o último filtro em a corrente.

O filtro Delta junto com LZMA2 pode dar bons resultados com imagens bitmap. Ele geralmente deve superar o PNG, que possui alguns filtros mais avançados do que o delta simples, mas usa Deflate para a compactação real.

A imagem deve ser salva em formato não compactado, por exemplo, como TIFF não compactado. O parâmetro de distância do filtro Delta é definido para corresponder ao número de bytes por pixel na imagem. Por exemplo, bitmap RGB de 24 bits precisa de dist=3, e também é bom passar pb=0 para LZMA2 para acomodar o alinhamento de três bytes:

xz --delta=dist=3 --lzma2=pb=0 foo.tiff

Se várias imagens foram colocadas em um único arquivo (por exemplo, .tar), o filtro Delta também funcionará, desde que todas as imagens tenham o mesmo número de bytes por pixel.

VEJA TAMBÉM

xzdec(1), xzdiff(1), xzgrep(1), xzless(1), xzmore(1), gzip(1), bzip2(1), 7z(1)

XZ Utils: <https://tukaani.org/xz/>;
XZ Embedded: <https://tukaani.org/xz/embedded.html>;
LZMA SDK: <https://7-zip.org/sdk.html>;