Provided by: xz-utils_5.8.1-1build1_amd64 
NOME
xz, unxz, xzcat, lzma, unlzma, lzcat - Comprime o decomprime file .xz e .lzma
SINOSSI
xz [OPZIONE...] [FILE...]
ALIAS DEI COMANDI
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.
Quando si scrivono script che richiedono di decomprimere file, si raccomanda di utilizzare sempre il
comando xz con argomenti appropriati (xz -d o xz -dc) al posto degli alias unxz e xzcat.
DESCRIZIONE
xz è uno strumento di compressione dati generico con sintassi della riga di comando simile a gzip(1) e
bzip2(1). Il formato file nativo è .xz, ma sono supportati anche il formato tradizionale .lzma usato
dalle LZMA Utils e i flussi grezzi (raw) compressi senza intestazioni di formato contenitore. In più, è
supportata la decompressione del formato .lzusato da lzip.
xz comprime o decomprime ogni FILE a seconda della modalità di funzionamento selezionata. Se nessun FILE
è indicato o se FILE è -, xz legge dallo standard input e scrive i dati processati sullo standard output.
xz si rifiuterà (stamperà un errore e salterà il FILE) di scrivere dati compressi sullo standard output
se è il terminale. Analogamente, xz si rifiuterà di leggere dati compressi dallo standard input se è il
terminale.
A meno che non sia specificato --stdout, i FILE diversi da - vengono scritti in un nuovo file il cui nome
deriva dal nome del FILE sorgente:
• Quando si comprime, il suffisso del file destinazione (.xz or .lzma) viene accodato al nome del file
sorgente per ottenere il nome del file destinazione.
• Quando si decomprime, i suffissi .xz, .lzma, o .lz vengono rimossi dal nome del file per ottenere il
nome del file destinazione. xz riconosce anche i suffissi .txz e .tlz, e li sostituisce con il
suffisso .tar.
Se il file di destinazione esiste già, viene visualizzato un errore e FILE viene saltato.
A meno che non si scriva nello standard output, xz visualizzerà un avvertimento e salterà il FILE se si
verifica una delle seguenti condizioni:
• FILE non è un file regolare. I collegamenti simbolici non vengono seguiti, quindi non sono considerati
file regolari.
• FILE ha più di un collegamento "hard".
• FILE ha impostati i bit setuid, setgid, o sticky.
• La modalità di funzionamento è impostata sulla compressione e il FILE ha già un suffisso del formato
di file di destinazione (.xz o .txz quando si comprime nel formato .xz e .lzma o .tlz quando si
comprime nel formato .lzma).
• La modalità di funzionamento è impostata sulla decompressione e il FILE non ha un suffisso di nessuno
dei formati di file supportati (.xz, .txz, .lzma, .tlz, o .lz).
Dopo aver compresso o decompresso correttamente il FILE, xz copia il proprietario, il gruppo, le
autorizzazioni, l'ora di accesso e l'ora di modifica dal FILE di origine al file di destinazione. Se la
copia del gruppo fallisce, le autorizzazioni vengono modificate in modo che il file di destinazione non
diventi accessibile agli utenti che non disponevano dell'autorizzazione per accedere al FILE di origine.
xz non supporta ancora la copia di altri metadati, ad esempio elenchi di controllo degli accessi o
attributi estesi.
Una volta che il file di destinazione è stato chiuso con successo, il FILE sorgente viene rimosso, a meno
che sia stato specificato --keep. Il FILE sorgente non viene mai rimosso se l'output è scritto sullo
standard output, né se si verifica un errore.
L'invio di SIGINFO o SIGUSR1 al processo xz comporta la stampa delle informazioni sullo stato di
avanzamento sullo standard error. Questo ha solo un uso limitato poiché quando lo standard error è un
terminale, utilizzando --verbose verrà visualizzato un indicatore di avanzamento che si aggiorna
automaticamente.
Utilizzo memoria
L'utilizzo della memoria di xz varia da poche centinaia di kilobyte a diversi gigabyte a seconda delle
impostazioni di compressione. Le impostazioni utilizzate durante la compressione di un file determinano i
requisiti di memoria del decompressore. In genere il decompressore richiede dal 5 al 20 della quantità di
memoria necessaria al compressore durante la creazione del file. Ad esempio, la decompressione di un file
creato con xz -9 al momento richiede 65 MiB di memoria. Ancora, è possibile avere file .xz che richiedono
diversi gigabyte di memoria per la decompressione.
Soprattutto gli utenti di sistemi più vecchi possono trovare fastidiosa l'eventualità di un utilizzo
molto elevato di memoria. Per evitare spiacevoli sorprese, xz dispone di un limitatore di utilizzo della
memoria incorporato, che è disabilitato per impostazione predefinita. Anche se alcuni sistemi operativi
forniscono modi per limitare l'utilizzo della memoria dei processi, fare affidamento su questi non è
stato ritenuto sufficientemente flessibile (ad esempio, l'uso di ulimit(1) per limitare la memoria
virtuale tende a paralizzare mmap(2)).
Il limitatore di utilizzo della memoria può essere abilitato con l'opzione della riga di comando
--memlimit=LIMITE. Spesso è più conveniente abilitare il limitatore per impostazione predefinita
impostando la variabile d'ambiente XZ_DEFAULTS, ad esempio, XZ_DEFAULTS=--memlimit=150MiB. È possibile
impostare separatamente i limiti per la compressione e la decompressione utilizzando
--memlimit-compress=LIMITE and --memlimit-decompress=LIMITE. L'uso di queste due opzioni al di fuori di
XZ_DEFAULTS è raramente utile perché una singola esecuzione di xz non può eseguire sia la compressione
che la decompressione e --memlimit=LIMITE (or -M LIMITE) è più breve da digitare sulla riga di comando.
Se il limite di utilizzo della memoria specificato viene superato durante la decompressione, xz
visualizzerà un errore e la decompressione del file fallirà. Se il limite viene superato durante la
compressione, xz tenterà di ridimensionare le impostazioni in modo che il limite non venga più superato
(tranne quando si usa --format=raw o --no-adjust). In questo modo l'operazione non fallirà a meno che il
limite sia molto basso. Il ridimensionamento delle impostazioni viene eseguito in piccole differenze che
non corrispondono ai livelli di compressione preimpostati, ad esempio, se il limite è solo leggermente
inferiore alla quantità richiesta per xz -9, le impostazioni saranno ridimensionate solo un poco, non
proprio fino a xz -8.
Concatenazione e padding con file .xz
È possibile concatenare i file .xz così come sono. xz decomprimerà tali file come se fossero un singolo
file .xz.
È possibile inserire un padding tra le parti concatenate o dopo l'ultima parte. Il padding deve essere
costituito da byte "null" e la dimensione del padding deve essere un multiplo di quattro byte. Questo può
essere utile, ad esempio, se il file .xz è memorizzato su un supporto che misura le dimensioni dei file
in blocchi di 512 byte.
Concatenazione e padding non sono permessi con file .lzma o con flussi grezzi.
OPZIONI
Suffissi interi e valori speciali
Nella maggior parte dei casi in cui è previsto un argomento intero, è supportato un suffisso facoltativo
per indicare facilmente numeri interi di grandi dimensioni. Non deve esserci alcuno spazio tra il numero
intero e il suffisso.
KiB Moltiplica l'intero per 1024 (2^10). Ki, k, kB, K, e KB sono accettati come sinonimi di KiB.
MiB Moltiplica l'intero per 1.048.576 (2^20). Mi, m, M, e MB sono accettati come sinonimi di MiB.
GiB Moltiplica l'intero per 1.073.741.824 (2^30). Gi, g, G, e GB sono accettati come sinonimi di GiB.
Il valore speciale max può essere utilizzato per indicare il valore intero massimo supportato
dall'opzione.
Modalità operativa
Se vengono fornite più opzioni di modalità operativa, l'ultima ha effetto.
-z, --compress
Compressione. Questa è la modalità operativa predefinita quando non viene specificata alcuna
opzione della modalità operativa e non è determinata nessun'altra modalità operativa dal nome del
comando (ad esempio, unxz implica --decompress).
Dopo che la compressione è terminata con successo, il file origine viene rimosso a meno che si
stia scrivendo su standard output o che venga specificato --keep.
-d, --decompress, --uncompress
Decompressione. Dopo che la decompressione è terminata con successo, il file origine viene rimosso
a meno che si stia scrivendo su standard output o che venga specificato --keep.
-t, --test
Testa l'integrità dei FILE compressi. Questa opzione è equivalente a --decompress --stdout tranne
per il fatto che i dati decompressi vengono scartati invece di essere scritti nello standard
output. Nessun file viene creato o rimosso.
-l, --list
Stampa le informazioni sul FILE compresso. Non viene prodotto alcun output non compresso e non
viene creato o rimosso alcun file. In modalità elenco, il programma non è in grado di leggere i
dati compressi dallo standard input o da altre fonti che non permettano la ricerca.
Il tracciato predefinito mostra le informazioni di base sui FILE, un file per riga. Per ottenere
informazioni più dettagliate, usare anche l'opzione --verbose. Per avere ancora più informazioni,
usare --verbose due volte, ma si noti che questo può essere lento, perché ottenere tutte le
informazioni extra richiede molte estrazioni. La larghezza dell'output dettagliato supera gli 80
caratteri, quindi il reindirizzamento dell'output, ad esempio, a less -S può essere utile se il
terminale non è sufficientemente ampio.
L'output esatto può variare tra le versioni di xz e le diverse impostazioni locali. Per un output
leggibile dalla macchina si dovrebbe utilizzare --robot --list.
Modificatori dell'operazione
-k, --keep
Non elimina i file input.
A partire da xz 5.2.6, questa opzione fa sì che xz comprima o decomprima anche se l'input è un
collegamento simbolico a un file regolare, ha più di un collegamento fisico o ha il bit setuid,
setgid o sticky impostato. I bit setuid, setgid e sticky non vengono copiati nel file di
destinazione. Nelle versioni precedenti questo veniva fatto solo con --force.
-f, --force
Questa opzione ha diverse conseguenze:
• Se il file di destinazione esiste già, lo elimina prima di comprimere o decomprimere.
• Comprime o decomprime anche se l'input è un collegamento simbolico a un file regolare, ha più
di un collegamento "hard", o ha il bit setuid, setgid o sticky impostato. I bit setuid, setgid
e sticky non sono copiati sul file destinazione.
• Quando usato con --decompress --stdout e xz non riesce a riconoscere il tipo di file sorgente,
copia il file sorgente così com'è sullo standard output. Questo permette a xzcat --force di
essere usato come cat(1) per file che non siano stati compressi con xz. Si noti che in futuro
xz potrebbe supportare nuovi formati di file compressi, il che potrebbe portare xz a
decomprimere più tipi di file anziché copiarli come sono sullo standard output.
--format=FORMATO può essere usato per forzare xz a decomprimere solo un singolo formato di
file.
-c, --stdout, --to-stdout
Scrive i dati compressi o decompressi nello standard output anziché in un file. Implica --keep.
--single-stream
Decomprime solo il primo flusso .xz, e ignora automaticamente i possibili dati di input rimanenti
che seguono il flusso. Normalmente questi dati sporchi finali portano xz a visualizzare un errore.
xz non decomprime mai più di un flusso dai file .lzma o dai flussi grezzi, ma questa opzione fa
comunque in modo che xz ignori i possibili dati finali dopo il file .lzma o il flusso grezzo.
Questa opzione non ha effetto se la modalità operativa non è --decompress o --test.
Dalla versione xz 5.7.1alpha, --single-stream implica --keep.
--no-sparse
Disabilita la creazione di file sparsi. Per impostazione predefinita, se si esegue la
decompressione in un file regolare, xz tenta di rendere il file sparso se i dati decompressi
contengono lunghe sequenze di zeri binari. Funziona anche quando si scrive su standard output,
purché lo standard output sia collegato a un file regolare e siano soddisfatte alcune condizioni
aggiuntive per renderlo sicuro. La creazione di file sparsi può risparmiare spazio su disco e
velocizzare la decompressione riducendo la quantità di I/O su disco.
-S .SUFFISSO, --suffix=.SUFFISSO
Durante la compressione, utilizzare .suf come suffisso per il file di destinazione anziché .xz o
.lzma. Se non si scrive nello standard output e il file di origine ha già il suffisso .suf, viene
visualizzato un avvertimento e il file viene ignorato.
Quando si decomprime, accetta i file con suffisso .suf in aggiunta a quelli con suffisso .xz,
.txz, .lzma, .tlz, o .lz. Se il file sorgente ha suffisso .suf, il suffisso viene rimosso per
ottenere il nome del file destinazione.
Quando si comprimono o decomprimono flussi grezzi (--format=raw), il suffisso deve sempre essere
specificato, a meno che si scriva sullo standard output, perché non esiste un suffisso predefinito
per i flussi grezzi.
--files[=FILE]
Legge i nomi dei file da processare da FILE; se FILE è omesso, i nomi dei file vengono letti dallo
standard input. I nomi dei file devono essere terminati da un carattere "a capo". Un trattino (-)
è considerato come un nome di file regolare; non indica lo standard input. Se vengono forniti
anche dei nomi di file come argomenti della riga di comando, questi sono processati prima di
quelli letti da FILE.
--files0[=FILE]
Questo è identico a --files[=FILE] tranne per il fatto che ogni nome di file deve terminare con il
carattere null.
Formato file di base e opzioni di compressione
-F FORMATO, --format=FORMATO
Specifica il FORMATO del file da comprimere o decomprimere:
auto Questa è l'impostazione predefinita. Quando si comprime, auto è equivalente a xz. Quando si
decomprime, il formato del file input viene rilevato automaticamente. Si noti che per i
flussi grezzi (creati con --format=raw) non è possibile il rilevamento automatico.
xz Comprime nel formato di file .xz, oppure accetta solo file .xz durante la decompressione.
lzma, alone
Comprime nel formato tradizionale .lzma, oppure accetta solo file .lzma per la
decompressione. Il nome alternativo alone è fornito per retrocompatibilità con le LZMA
Utils.
lzip Accetta solo file .lz per la decompressione. La compressione non è supportata.
Sono supportati il formato .lz versione 0 e la versione 1 non estesa. I file della versione
0 sono stati prodotti da lzip 1.3 e precedenti. Tali file non sono comuni, ma possono
essere trovati negli archivi di file poiché alcuni pacchetti sorgente sono stati rilasciati
in questo formato. Anche alcune persone potrebbero avere vecchi file personali in questo
formato. Il supporto alla decompressione per il formato versione 0 è stato rimosso in lzip
1.18.
lzip 1.4 e successivi creano file nel formato v1. L'estensione del marcatore di
scaricamento sincronizzazione al formato v1 è stata aggiunta in lzip 1.6. Questa estensione
è utilizzata raramente e non è supportata da xz(viene segnalata come input corrotto).
raw Comprime o decomprime un flusso grezzo (senza intestazione). Questo è inteso solamente per
utenti avanzati. Per decodificare flussi grezzi, occorre usare --format=raw e specificare
esplicitamente la catena dei filtri, che normalmente sarebbero conservati
nell'intestazione.
-C CONTROLLO, --check=CONTROLLO
Specifica il tipo di controllo di integrità. Il controllo viene calcolato dai dati non compressi e
memorizzato nel file .xz. Questa opzione ha effetto solo quando si comprime nel formato .xz; il
formato .lzma non supporta i controlli di integrità. Il controllo di integrità (se presente) viene
verificato quando il file .xz viene decompresso.
Tipi di CONTROLLI supportati:
none Non calcola proprio il controllo di integrità. Questo in genere è una pessima idea. Può
essere utile quando l'integrità dei dati viene comunque verificata con altri mezzi.
crc32 Calcola la firma CRC32 usando il polinomio di IEEE-802.3 (Ethernet).
crc64 Calcola la firma CRC64 usando il polinomio di ECMA-182. Questa è l'impostazione
predefinita, perché è leggermente migliore della CRC32 nel rilevare i file danneggiati e la
differenza di velocità è trascurabile.
sha256 Calcola la firma SHA-256. Questo è un po' più lento che CRC32 e CRC64.
L'integrità delle intestazioni .xz viene sempre verificata con CRC32. Non è possibile modificarlo
o disabilitarlo.
--ignore-check
Non verifica il controllo di integrità dei dati compressi durante la decompressione. Il valore
CRC3 nelle intestazioni .xz sarà ancora verificata normalmente.
Non usare questa opzione se non si è consci di cosa si sta facendo. Possibili ragioni per
utilizzare questa opzione:
• Tentativo di recupero dei dati da un file .xz corrotto.
• Accelerazione della decompressione. Questo è importante soprattutto con SHA-256 o con i file
che sono stati compressi molto bene. Si consiglia di non utilizzare questa opzione per questo
scopo, a meno che l'integrità del file non venga verificata esternamente in altro modo.
-0 ... -9
Selezionare un livello di compressione preimpostato. Il valore predefinito è -6. Se vengono
specificati più livelli preimpostati, l'ultimo ha effetto. Se è già stata specificata una catena
di filtri personalizzata, l'impostazione di un livelli preimpostati cancella la catena di filtri
personalizzata.
Le differenze tra i livelli preimpostati sono più significative rispetto a gzip(1) e bzip2(1). Le
impostazioni di compressione selezionate determinano i requisiti di memoria del decompressore,
quindi l'utilizzo di un livello preimpostato troppo alto potrebbe rendere difficile la
decompressione del file su un vecchio sistema con poca RAM. Specificamente, non è una buona idea
utilizzare ciecamente -9 per tutto come spesso accade per gzip(1) e bzip2(1).
-0 ... -3
Questi sono livelli preimpostati piuttosto veloci. -0- a volte è più veloce di gzip -9 e
comprime molto meglio. Quelli più alti hanno spesso una velocità paragonabile a bzip2(1)
con un rapporto di compressione comparabile o migliore, anche se i risultati dipendono
molto dal tipo di dati che vengono compressi.
-4 ... -6
Compressione da buona a molto buona, mantenendo l'utilizzo della memoria del decompressore
ragionevole anche per vecchi sistemi. -6 è il valore predefinito, che di solito è una buona
scelta per distribuire file che debbano essere decompressi anche su sistemi con solo 16 MiB
di RAM. (Potrebbe valere la pena di considerare anche -5e o -6e. Si veda --extreme.)
-7 ... -9
Questi sono come -6 ma con requisiti di memoria di compressore e decompressore più elevati.
Sono utili solo quando si comprimono file di dimensioni superiori a 8 MiB, 16 MiB e 32 MiB,
rispettivamente.
A parità di hardware, la velocità di decompressione è approssimativamente un numero costante di
byte di dati compressi al secondo. In altre parole, migliore è la compressione, più veloce sarà di
solito la decompressione. Ciò significa anche che la quantità di output non compresso prodotta al
secondo può variare notevolmente.
La tabella seguente riassume le caratteristiche dei livelli preimpostati:
Livello preimpostato DictSize CompCPU CompMem DecMem
-0 256 KiB 0 3 MiB 1 MiB
-1 1 MiB 1 9 MiB 2 MiB
-2 2 MiB 2 17 MiB 3 MiB
-3 4 MiB 3 32 MiB 5 MiB
-4 4 MiB 4 48 MiB 5 MiB
-5 8 MiB 5 94 MiB 9 MiB
-6 8 MiB 6 94 MiB 9 MiB
-7 16 MiB 6 186 MiB 17 MiB
-8 32 MiB 6 370 MiB 33 MiB
-9 64 MiB 6 674 MiB 65 MiB
Descrizioni delle colonne:
• DictSize è la dimensione del dizionario LZMA2. È uno spreco di memoria usare un dizionario più
grande della dimensione del file non compresso. Ecco perché è una buona cosa evitare di usare i
livelli preimpostati -7 ... -9 quando non c'è reale necessità. Con -6 e inferiori, la quantità
di memoria sprecata in genere è sufficientemente bassa da essere trascurabile.
• CompCPU è una rappresentazione semplificata delle impostazioni di LZMA2 che influenzano la
velocità di compressione. Anche la dimensione del dizionario influenza la velocità, quindi
mentre CompCPU è lo stesso per i livelli -6 ... -9, i livelli più alti tendono ancora ad essere
un po' più lenti. Per avere una compressione ancora più lenta e quindi potenzialmente migliore,
utilizzare --extreme.
• CompMem contiene i requisiti di memoria del compressore in modalità a singola thread. Può
variare leggermente tra le versioni di xz.
• DecMem contiene i requisiti di memoria del decompressore. In altre parole, le impostazioni di
compressione determinano i requisiti di memoria del decompressore. L'utilizzo esatto della
memoria del decompressore è leggermente superiore alla dimensione del dizionario LZMA2, ma i
valori nella tabella sono stati arrotondati per eccesso al successivo MiB completo.
I requisiti di memoria per la modalità a thread multiple sono significativamente più alti che per
la modalità thread singola. Con il valore predefinito di --block-size, ogni thread richiede
3*3*dimensione del dizionario più CompMem oppure DecMem. Ad esempio, 4 thread con il livello
preimpostato -6 hanno bisogno di 660–670 MiB di memoria.
-e, --extreme
Utilizzare una variante più lenta del livello preimpostato selezionato (-0 ... -9) nella speranza
di ottenere un rapporto di compressione leggermente migliore, ma con un po' di sfortuna questo
potrebbe anche renderlo peggiore. L'utilizzo della memoria del decompressore non è influenzato, ma
l'utilizzo della memoria del compressore aumenta leggermente ai livelli preimpostati -0 ... -3.
Dal momento che ci sono due livelli preimpostati con dimensione del dizionario di 4 MiB e 8 MiB, i
livelli preimpostati -3e e -5e usano impostazioni leggermente più veloci (minore CompCPU) di -4e e
-6e, rispettivamente. In questo modo non ci sono due livelli preimpostati identici.
Livello preimpostato DictSize CompCPU CompMem DecMem
-0e 256 KiB 8 4 MiB 1 MiB
-1e 1 MiB 8 13 MiB 2 MiB
-2e 2 MiB 8 25 MiB 3 MiB
-3e 4 MiB 7 48 MiB 5 MiB
-4e 4 MiB 8 48 MiB 5 MiB
-5e 8 MiB 7 94 MiB 9 MiB
-6e 8 MiB 8 94 MiB 9 MiB
-7e 16 MiB 8 186 MiB 17 MiB
-8e 32 MiB 8 370 MiB 33 MiB
-9e 64 MiB 8 674 MiB 65 MiB
Ad esempio, ci sono un totale di quattro livelli preimpostati che utilizzano un dizionario da
8 MiB, il cui ordine dal più veloce al più lento è -5, -6, -5e, e -6e.
--fast
--best Questi sono alias in qualche modo fuorvianti per -0 e -9, rispettivamente. Sono forniti solo per
retrocompatibilità con le LZMA Utils. Evitare di utilizzare queste opzioni.
--block-size=DIMENSIONE
Quando si comprime in formato .xz, divide i dati input in blocchi da DIMENSIONE byte. I blocchi
vengo compressi indipendentemente l'uno dall'altro, cosa che aiuta con le thread multiple e rende
possibile la decompressione con accessi casuali limitati. Questa opzione viene usata tipicamente
per sovrascrivere la dimensione predefinita dei blocchi in modalità a thread multiple, ma può
essere utilizzata anche in modalità thread singola.
In modalità a thread multiple verranno allocati circa il triplo di DIMENSIONE di byte in ogni
thread per il buffering dell'input e dell'output. La DIMENSIONE predefinita è tre volte la
dimensione del dizionario LZMA2 e comunque almeno 1 MiB. Tipicamente un buon valore è 2–4 volte la
dimensione del dizionario LZMA2 oppure almeno 1 MiB. Usare una DIMENSIONE inferiore della
dimensione del dizionario LZMA2 causa uno spreco di RAM, in quanto il buffer del dizionario LZMA2
non verrà mai riempito completamente. In modalità a thread multiple, la dimensione dei blocchi è
conservata nelle intestazioni dei blocchi. L'informazione sulla dimensione è richiesta per la
decompressione a thread multiple.
Nella modalità a thread singola, per impostazione predefinita non viene eseguita alcuna
suddivisione in blocchi. L'impostazione di questa opzione non influisce sull'utilizzo della
memoria. Nessuna informazione sulle dimensioni viene memorizzata nelle intestazioni di blocco,
quindi i file creati in modalità a thread singola non saranno identici ai file creati in modalità
a thread multiple. La mancanza di informazioni sulle dimensioni significa anche che xz non sarà in
grado di decomprimere i file in modalità a thread multiple.
--block-list=ELEMENTI
Quando si comprime nel formato .xz, inizia un nuovo blocco con una catena di filtri personalizzata
dopo gli intervalli indicati di dati non compressi.
Gli ELEMENTI sono un elenco separato da virgole. Ogni elemento è costituito da un numero di catena
di filtri opzionale compreso tra 0 e 9 seguito da due punti (:) e da una dimensione richiesta di
dati non compressi. L'omissione di un elemento (due o più virgole consecutive) è una scorciatoia
per utilizzare le dimensioni e i filtri dell'elemento precedente.
Se il file di input è più grande della somma delle dimensioni in ELEMENTI, l'ultimo elemento viene
ripetuto fino alla fine del file. Il valore speciale 0 può essere utilizzato come ultima
dimensione per indicare che il resto del file deve essere codificato come un singolo blocco.
È possibile specificare una catena di filtri alternativa per ogni blocco in combinazione con le
opzioni --filters1=FILTRI ... --filters9=FILTRI. Queste opzioni definiscono catene di filtri con
un identificatore compreso tra 1–9. La catena di filtri 0 può essere utilizzata per indicare la
catena di filtri predefinita, che equivale a non specificare una catena di filtri.
L'identificatore della catena di filtri può essere utilizzato prima della dimensione non
compressa, seguita da due punti (:). Ad esempio, se si specifica
--block-list=1:2MiB,3:2MiB,2:4MiB,,2MiB,0:4MiB allora i blocchi verranno creati utilizzando:
• La catena dei filtri specificata da --filters1 e un input di 2 MiB
• La catena dei filtri specificata da --filters3 e un input di 2 MiB
• La catena dei filtri specificata da --filters2 e un input di 4 MiB
• La catena dei filtri specificata da --filters2 e un input di 4 MiB
• La catena di filtri predefinita e l'input di 2 MiB
• La catena di filtri predefinita e l'input di 4 MiB per ogni blocco fino alla fine dell'input.
Se si specifica una dimensione che supera la dimensione del blocco del codificatore (il valore
predefinito in modalità thread oppure il valore specificato con --block-size=DIMENSIONE), il
codificatore creerà blocchi aggiuntivi mantenendo i limiti specificati in ELEMENTI. Ad esempio, se
si indica --block-size=10MiB --block-list=5MiB,10MiB,8MiB,12MiB,24MiB e il file input è di 80 MiB,
si otterranno 11 blocchi: 5, 10, 8, 10, 2, 10, 10, 4, 10, 10, and 1 MiB.
In modalità a thread multiple, le dimensioni dei blocchi vengono memorizzate nelle intestazioni
dei blocchi. Questo non avviene in modalità thread singola, quindi l'output codificato non sarà
identico a quello della modalità a thread multiple.
--flush-timeout=TIMEOUT
Quando si comprime, se sono passati più di TIMEOUT millisecondi (un intero positivo) dallo
scaricamento precedente e la lettura di ulteriori input si bloccherebbe, tutti i dati di input in
sospeso vengono scaricati dal codificatore e resi disponibili nel flusso di output. Questo può
essere utile se xz viene usato per comprimere dati in streaming dalla rete. Piccoli valori del
TIMEOUT rendono disponibili i dati al ricevente con un ritardo minimo, mentre valori di TIMEOUT
grandi danno un miglior rapporto di compressione.
Questa funzionalità è disabilitata per impostazione predefinita. Se questa opzione viene
specificata più di una volta, l'ultima ha effetto. Il valore speciale TIMEOUT di 0 può essere
utilizzato per disabilitare esplicitamente questa funzionalità.
Questa funzionalità non è disponibile sui sistemi non-POSIX.
Questa funzionalità è sperimentale. Attualmente xz non è adatto per decomprimere il flusso in
tempo reale, a causa di come effettua il buffering.
--no-sync
Non sincronizzare il file target e la sua directory sull'unità di archiviazione prima di rimuovere
il file sorgente. Questo può migliorare le performance se si sta comprimendo o decomprimendo tanti
piccoli file. Tuttavia, se il sistema dovesse andare in crash subito dopo l'eliminazione, è
possibile che il file destinazione non sia ancora stato scritto sull'unità di archiviazione mentre
l'operazione di eliminazione sì. In questo caso non saranno più disponibili né il file sorgente
originale né il file di destinazione.
Questa opzione ha effetto solamente quando xz deve rimuovere il file sorgente. Negli altri casi la
sincronizzazione non viene eseguita.
La sincronizzazione e --no-sync sono stati aggiunti nella versione xz 5.7.1alpha.
--memlimit-compress=LIMITE
Imposta un limite di utilizzo della memoria per la compressione. Se questa opzione viene
specificata più volte, ha effetto l'ultima.
Se le impostazioni di compressione superano il valore LIMITE, xz tenterà di regolare le
impostazioni verso il basso in modo che il limite non venga più superato e visualizzerà un avviso
che indica che è stata eseguita una regolazione automatica. Le regolazioni vengono eseguite in
questo ordine: riduzione del numero di thread, passaggio alla modalità a thread singola se anche
un solo thread in modalità a thread multiple supera il LIMITE, e infine riducendo la dimensione
del dizionario LZMA2.
Quando si comprime con --format=raw oppure se si è specificato --no-adjust, è possibile ridurre
solo il numero di thread, poiché questo può essere fatto senza influire sull'output compresso.
Se non è possibile soddisfare il LIMITE anche con le regolazioni sopra descritte, viene
visualizzato un errore e xz uscirà con lo stato di uscita 1.
Il LIMITE può essere specificato in diversi modi:
• Il LIMITE può essere un valore assoluto in byte. Usare un suffisso intero come MiB può essere
utile. Ad esempio: --memlimit-compress=80MiB
• Il LIMITE può essere specificato come percentuale della memoria fisica (RAM) totale. Questo può
essere utile specialmente quando si imposta la variabile di ambiente XZ_DEFAULTS in uno script
di inizializzazione di shell che è condiviso tra computer diversi. In questo modo il limite è
automaticamente più grande sui sistemi con più memoria. Ad esempio: --memlimit-compress=70%
• Il LIMITE può essere reimpostato al suo valore predefinito impostandolo a 0.Questo attualmente
equivale a impostare il LIMITE a max (nessun limite nell'utilizzo di memoria).
Per xz a 32-bit esiste un caso particolare: se il LIMITE fosse oltre 4020 MiB, il LIMITE viene
impostato a 4020 MiB. Su MIPS32 invece viene usato 2000 MiB. (I valori 0 e max non sono
influenzati da questo. Un comportamento simile non esiste per la decompressione). Questo può
essere utile quando un eseguibile a 32 bit ha accesso a uno spazio di indirizzi da 4 GiB (2 GiB su
MIPS32), e si spera che non faccia danni in altre situazioni.
Vedere anche la sezione Utilizzo memoria
--memlimit-decompress=LIMITE
Imposta un limite di utilizzo della memoria per la decompressione. Questo influisce anche sulla
modalità --list. Se l'operazione non è possibile senza oltrepassare il LIMITE, xz mostrerà un
errore e la decompressione del file fallirà. Si veda --memlimit-compress=LIMITE per possibili modi
per specificare il LIMITE.
--memlimit-mt-decompress=LIMITE
Imposta un limite di utilizzo della memoria per la decompressione multi-thread. Questo può
influire solo sul numero di thread; non indurrà mai xz a rifiutarsi di decomprimere un file. Se
LIMITE è troppo basso per consentire le thread multiple, il LIMITE viene ignorato e xz continuerà
in modalità a thread singola. Si noti che se viene utilizzato anche --memlimit-decompress, si
applicherà sempre sia alla modalità a thread singola che a quella a thread multiple, e quindi il
LIMITE effettivo per le thread multiple non sarà mai superiore a quello impostato con
--memlimit-decompress.
In contrasto con le altre opzioni di limite di utilizzo della memoria,
--memlimit-mt-decompress=LIMITE ha un LIMITE predefinito specifico per il sistema. xz
--info-memory può essere utilizzato per vedere il valore corrente.
Questa opzione e il suo valore predefinito esistono perché, senza un limite, il decompressore a
thread multiple potrebbe finire per allocare una quantità folle di memoria per alcuni file input.
Se il valore predefinito LIMITE è troppo basso sul proprio sistema, è possibile aumentarlo
liberamente, ma non deve essere mai impostato a un valore più grande della quantità di RAM
utilizzabile, in quanto con file di input appropriati xz cercherà di utilizzare quella quantità di
memoria anche con un basso numero di thread. Esaurire la memoria o fare swap non migliorerà le
performance della decompressione.
Vedi --memlimit-compress=LIMITE per possibili modi per specificare il LIMITE. Impostando LIMITE su
0 si ripristina il valore predefinito LIMITE specifico del sistema.
-M LIMITE, --memlimit=LIMITE, --memory=LIMITE
Questo equivale a specificare --memlimit-compress=LIMITE --memlimit-decompress=LIMITE
--memlimit-mt-decompress=LIMITE.
--no-adjust
Visualizza un errore e esce se non è possibile soddisfare il limite di utilizzo della memoria
senza regolare le impostazioni che influiscono sull'output compresso. In altre parole, ciò
impedisce a xz di passare il codificatore dalla modalità multi-thread alla modalità a thread
singola e di ridurre le dimensioni del dizionario LZMA2. Anche quando viene usata questa opzione,
il numero di thread può essere ridotto per soddisfare il limite di utilizzo della memoria, in
quanto ciò non influirà sull'output compresso.
La regolazione automatica è sempre disabilitata quando si creano flussi raw (--format=raw).
-T THREADS, --threads=THREADS
Specifica il numero di thread di lavoro da utilizzare. L'impostazione di THREADS al valore
speciale 0 fa sì che xz utilizzi fino a un numero di thread che il processore/i del sistema
supportano. Il numero effettivo di thread può essere inferiore a THREADS se il file di input non è
sufficientemente grande per il threading con le impostazioni specificate o se l'utilizzo di più
thread supera il limite di utilizzo della memoria.
I compressori a thread singola e a thread multiple producono output diversi. Il compressore a
thread singola produrrà la dimensione del file più piccola, ma solo l'output del compressore a
thread multiple può essere decompresso utilizzando più thread. Impostando THREADS su 1 verrà
utilizzata la modalità a thread singola. L'impostazione di THREADS su qualsiasi altro valore,
incluso 0, utilizzerà il compressore a thread multiple anche se il sistema supporta un solo thread
hardware. (xz 5.2.x utilizzava la modalità a thread singola in questa situazione.)
Per utilizzare la modalità a thread multiple con un solo thread, impostare THREADS su +1. Il
prefisso + non ha alcun effetto con valori diversi da 1. Un limite di utilizzo della memoria può
comunque far passare xz alla modalità a thread singola a meno che non venga utilizzato
--no-adjust. Il supporto per il prefisso + è stato aggiunto in xz 5.4.0.
Se è stato richiesto un numero automatico di thread e non è stato specificato alcun limite di
utilizzo della memoria, verrà utilizzato un limite "soft" predefinito, specifico del sistema, per
limitare eventualmente il numero di thread. È un limite "soft" nel senso che viene ignorato se il
numero di thread diventa uno, quindi un limite soft non impedirà mai a xz di comprimere o
decomprimere. Questo limite soft predefinito non farà passare xz dalla modalità a thread multiple
alla modalità thread singola. I limiti attivi possono essere visualizzati con xz --info-memory.
Attualmente l'unico metodo di threading consiste nel dividere l'input in blocchi e comprimerli
indipendentemente l'uno dall'altro. La dimensione predefinita del blocco dipende dal livello di
compressione e può essere sovrascritta con l'opzione --block-size=DIMENSIONE.
La decompressione a thread multiple funziona solo su file che contengano più blocchi con
l'informazione della dimensione nelle intestazioni del blocco. Tutti i file sufficientemente
grandi compressi in modalità a thread multiple soddisfano questa condizione, mentre i file
compressi in modalità thread singola no, neanche se si è utilizzato --block-size= DIMENSIONE.
Il valore predefinito per THREADS è 0. In xz 5.4.x e precedenti il valore predefinito era 1.
Catene di filtri di compressione personalizzate
Una catena di filtri personalizzata consente di specificare in dettaglio le impostazioni di compressione
invece di fare affidamento sulle impostazioni associate ai livelli preimpostati. Quando viene specificata
una catena di filtri personalizzata, le opzioni relative ai livelli preimpostati (-0 ... -9 e --extreme)
specificate in precedenza sulla riga di comando vengono dimenticate. Se un'opzione livello preimpostato
viene specificata dopo una o più opzioni della catena di filtri personalizzata, il nuovo livello
preimpostato ha effetto e le opzioni della catena di filtri personalizzate specificate in precedenza
vengono dimenticate.
Una catena di filtri è paragonabile a una pipe sulla riga di comando. Durante la compressione, l'input
non compresso va al primo filtro, il cui output va al filtro successivo (se presente). L'output
dell'ultimo filtro viene scritto nel file compresso. Il numero massimo di filtri nella catena è quattro,
ma in genere una catena di filtri ha solo uno o due filtri.
Molti filtri hanno limitazioni su dove possono trovarsi nella catena di filtri: alcuni filtri possono
funzionare solo come ultimo filtro della catena, altri solo come filtro non ultimo e alcuni funzionano in
qualsiasi posizione nella catena. A seconda del filtro, questa limitazione è inerente alla struttura del
filtro oppure esiste per evitare problemi di sicurezza.
Una catena di filtri personalizzata può essere specificata in due modi diversi. Le opzioni
--filters=FILTRI and --filters1=FILTRI ... --filters9=FILTRI permettono di specificare un'intera catena
di filtri in una opzione utilizzando la sintassi della stringa del filtro di lzma. In alternativa, una
catena di filtri può essere specificata utilizzando una o più singole opzioni di filtro nell'ordine
desiderato nella catena di filtri. Questo significa che l'ordine delle singole opzioni di filtro è
importante! Quando si decodificano i flussi grezzi (--format=raw), la catena di filtri deve essere
specificata nello stesso ordine in cui è stata specificata durante la compressione. Qualsiasi filtro
individuale o opzione livello preimpostato specificata prima dell'opzione della catena completa
(--filters=FILTRI) verrà dimenticata. I singoli filtri specificati dopo l'opzione della catena completa
reimposteranno la catena di filtri.
Sia l'opzione di filtro completo che quella individuale accettano OPZIONI specifiche del filtro come un
elenco separato da virgole. Virgole in eccesso nelle OPZIONI vengono ignorate. Ogni opzione ha un valore
di default, quindi occorre specificare solamente quelle che si desidera modificare.
Per vedere l'intera catena di filtri e OPZIONI, usa xz -vv (ossia, usa --verbose due volte). Questo
funziona anche per visualizzare le opzioni della catena di filtri utilizzate dai livelli preimpostati.
--filters=FILTRI
Specifica l'intera catena dei filtri oppure un livello preimpostato in una singola opzione. Ogni
filtro può essere separato da spazi o da due trattini (--). Potrebbe essere necessario mettere tra
virgolette i FILTRI sulla riga di comando della shell in modo che vengano analizzati come una
singola opzione. Per indicare OPZIONI, usa : o =. Un livello preimpostato può essere preceduto da
un - e seguito da zero o più flag. L'unico flag supportato è e per applicare le stesse opzioni di
--extreme.
--filters1=FILTRI ... --filters9=FILTRI
Specifica fino a nove catene di filtri aggiuntive che possono essere utilizzate con --block-list.
Ad esempio, quando si comprime un archivio con file eseguibili seguiti da file di testo, la parte
eseguibile potrebbe utilizzare una catena di filtri con un filtro BCJ e la parte di testo solo il
filtro LZMA2.
--filters-help
Mostra un messaggio di aiuto che descrive come specificare livelli preimpostati e catene di filtri
personalizzati nelle opzioni --filters e --filters1=FILTRI ... --filters9=FILTRI, e termina con
successo.
--lzma1[=OPZIONI]
--lzma2[=OPZIONI]
Aggiunge un filtro LZMA1 o LZMA2 alla catena dei filtri. Questi filtri possono essere usati solo
come ultimo filtro della catena.
LZMA1 è un filtro obsoleto, supportato quasi esclusivamente a causa del formato obsoleto di file
.lzma, che supporta solo LZMA1. LZMA2 è una versione aggiornata di LZMA1 che risolve alcuni
problemi pratici di LZMA1. Il formato .xz utilizza LZMA2 e non supporta LZMA1. La velocità e i
rapporti di compressione di LZMA1 e LZMA2 sono praticamente gli stessi.
LZMA1 e LZMA2 condividono lo stesso insieme di OPZIONI:
preset=PRESET
Reimposta tutte le OPZIONI LZMA1 o LZMA2 a PRESET. Il PRESET (livello preimpostato)
consiste di un numero intero, che può essere seguito da modificatori costituiti da una
singola lettera. Il numero intero può andare da 0 a 9, corrispondenti alle opzioni della
riga di comando -0 ... -9. L'unico modificatore attualmente supportato è e, che corrisponde
a --extreme. Se non viene specificato alcun PRESET, i valori predefiniti delle OPZIONI
LZMA1 o LZMA2 sono presi dal livello preimpostato 6.
dict=DIMENSIONE
La DIMENSIONEdel dizionario (buffer di cronologia) indica quanti byte dei dati non
compressi elaborati di recente vengono mantenuti in memoria. L'algoritmo tenta di trovare
sequenze di byte ripetute (corrispondenze) nei dati non compressi e di sostituirle con
riferimenti ai dati attualmente presenti nel dizionario. Più grande è il dizionario,
maggiore è la possibilità di trovare una corrispondenza. Quindi, l'aumento della DIMENSIONE
del dizionario di solito migliora il rapporto di compressione, ma un dizionario più grande
del file non compresso è uno spreco di memoria.
Una DIMENSIONE tipica per un dizionario è da 64 KiB a 64 MiB. Il minimo è 4 KiB. Il massimo
per la compressione è attualmente 1.5 GiB (1536 MiB). La decompressione supporta già
dizionari fino a 4 GiB meno 1 byte, che è il massimo per i formati di flusso LZMA1 e LZMA2.
La DIMENSIONE del dizionario e il cercatore di corrispondenze (CERCATORE) insieme
determinano l'utilizzo della memoria del codificatore LZMA1 o LZMA2. Per la decompressione
è necessaria la stessa DIMENSIONE del dizionario utilizzata durante la compressione (o più
grande), quindi l'utilizzo della memoria del decodificatore è determinato dalla dimensione
del dizionario utilizzato durante la compressione. Le intestazioni .xz memorizzano la
DIMENSIONE del dizionario come 2^n o 2^n + 2^( n-1), quindi queste DIMENSIONI sono in
qualche modo preferite per la compressione. Altre DIMENSIONI verranno arrotondate per
eccesso quando memorizzate nelle intestazioni .xz.
lc=lc Specificare il numero di bit di contesto letterali. Il minimo è 0 e il massimo è 4; Il
valore predefinito è 3. Inoltre, la somma di lc e lp non deve superare 4.
Tutti i byte che non possono essere codificati come corrispondenze vengono codificati come
valori letterali. In altre parole, i valori letterali sono semplicemente byte a 8 bit
codificati uno alla volta.
La codifica letterale presuppone che i bit di lc più alti del byte non compresso precedente
siano correlati al byte successivo. Ad esempio, in un tipico testo inglese, una lettera
maiuscola è spesso seguita da una lettera minuscola e una lettera minuscola è solitamente
seguita da un'altra lettera minuscola. Nel set di caratteri US-ASCII, i tre bit più alti
sono 010 per le lettere maiuscole e 011 per le lettere minuscole. Quando lc è almeno 3, la
codifica letterale può sfruttare questa proprietà nei dati non compressi.
Il valore predefinito (3) solitamente è buono. Se si desidera la compressione massima,
provare con lc=4. A volte aiuta un po', e a volte rende la compressione peggiore. Se la
rende peggiore, provare anche lc=2.
lp=lp Specificare il numero di bit di posizione letterale. Il minimo è 0 e il massimo è 4; Il
valore predefinito è 0.
Il parametro lp influisce sul tipo di allineamento nei dati non compressi presunto durante
la codifica dei valori letterali. Vedi pb di seguito per ulteriori informazioni
sull'allineamento.
pb=pb Specificare il numero di bit di posizione. Il minimo è 0 e il massimo è 4; Il valore
predefinito è 2.
Il parametro pb influisce su quale tipo di allineamento nei dati non compressi sia assunto
in generale. L'impostazione predefinita indica un allineamento a quattro byte (2^pb
=2^2=4), che è spesso una buona scelta se non c'è un'ipotesi migliore.
Quando l'allineamento è noto, impostare pb concordemente può ridurre un po' le dimensioni
del file. Ad esempio, con file di testo con 1 byte di allineamento (US-ASCII, ISO-8859-*,
UTF-8), impostare pb=0 può migliorare leggermente la compressione. Per il testo UTF-16,
pb=1 è una buona scelta. Se l'allineamento è un numero dispari, come 3 byte, pb=0 potrebbe
essere la scelta migliore.
Anche se l'allineamento assunto può essere regolato con pb e lp, LZMA1 e LZMA2 favoriscono
ancora leggermente l'allineamento a 16 byte. Potrebbe valere la pena tenerlo in
considerazione quando si progettano formati di file che possono essere spesso compressi con
LZMA1 o LZMA2.
mf=CERCATORE
Il cercatore di corrispondenze ha un effetto importante sulla velocità del codificatore,
sull'utilizzo della memoria e sul rapporto di compressione. Di solito i cercatori di
corrispondenze a catena hash sono più veloci dei cercatori di corrispondenze ad albero
binario. Il valore predefinito dipende da PRESET : 0 usa hc3, 1–3 usa hc4 e il resto usa
bt4.
Sono supportati i seguenti cercatori di corrispondenze. Le formule di utilizzo della
memoria riportate di seguito sono approssimazioni, che sono le più vicine alla realtà
quando DIZIONARIO è una potenza di due.
hc3 Catena hash con hashing da 2 e 3 byte
Minimo valore per NICE: 3
Utilizzo memoria:
DIZIONARIO * 7.5 (se DIZIONARIO <= 16 MiB);
DIZIONARIO * 5.5 + 64 MiB (se DIZIONARIO > 16 MiB)
hc4 Catena hash con hash da 2, 3 e 4 byte
Minimo valore per NICE: 4
Utilizzo memoria:
DIZIONARIO * 7.5 (se DIZIONARIO <= 32 MiB);
DIZIONARIO * 6.5 (se DIZIONARIO > 32 MiB)
bt2 Albero binario con hashing da 2 byte
Valore minimo per NICE: 2
Utilizzo di memoria: DIZIONARIO * 9.5
bt3 Albero binario con hashing da 2 e 3 byte
Minimo valore per NICE: 3
Utilizzo memoria:
DIZIONARIO * 11.5 (se DIZIONARIO <= 16 MiB);
DIZIONARIO * 9.5 + 64 MiB (se DIZIONARIO > 16 MiB)
bt4 Albero binario con hashing da 2, 3 e 4 byte
Minimo valore per NICE: 4
Utilizzo memoria:
DIZIONARIO * 11.5 (se DIZIONARIO <= 32 MiB);
DIZIONARIO * 10.5 (se DIZIONARIO > 32 MiB)
mode=MODALITÀ
La MODALITÀ di compressione specifica il metodo per analizzare i dati prodotti dal
cercatore di corrispondenze. Le MODALITÀ supportate sono fast e normal. Il predefinito è
fast per i PRESET 0–3 e normal per i PRESET 4–9.
Di solito fast viene utilizzato con i cercatori di corrispondenze a catena hash e normal
con i cercatori di corrispondenze a albero binario. Questo è anche quello che fanno i
PRESET.
nice=NICE
Specifica quella che si considera una lunghezza accettabile ("nice") per una
corrispondenza. Una volta trovata una corrispondenza di almeno NICE byte, l'algoritmo
smette di cercare corrispondenze potenzialmente migliori.
NICE può valere 2–273 byte. Valori più alti tendono a dare un miglior rapporto di
compressione ai danni della velocità. Il valore predefinito dipende dal PRESET.
depth=PROFONDITÀ
Specificare la profondità di ricerca massima nel cercatore di corrispondenze. Il valore
predefinito è il valore speciale 0, che dice al compressore di determinare una PROFONDITÀ
ragionevole da CERCATORE e NICE.
Una PROFONDITÀ ragionevole per le catene hash è 4–100 e 16–1000 per gli alberi binari.
Utilizzando valori di PROFONDITÀ molto alti si può rendere il codificatore estremamente
lento con alcuni file. Evitare di impostare la PROFONDITÀ oltre 1000 a meno che si sia
preparati a interrompere la compressione nel caso in cui richieda troppo tempo.
Quando si decomprime un flusso grezzo (--format=raw), LZMA2 ha bisogno solamente della DIMENSIONE
del dizionario. LZMA1 ha anche bisogno di lc, lp, e pb.
--x86[=OPZIONI]
--arm[=OPZIONI]
--armthumb[=OPZIONI]
--arm64[=OPZIONI]
--powerpc[=OPZIONI]
--ia64[=OPZIONI]
--sparc[=OPZIONI]
--riscv[=OPZIONI]
Aggiunge un filtro branch/call/jump (BCJ) alla catena dei filtri. Questi filtri non possono essere
utilizzati come ultimo filtro nella catena di filtri.
Un filtro BCJ converte gli indirizzi relativi in codice macchina nelle loro controparti assolute.
Questo non cambia la dimensione dei dati ma aumenta la ridondanza, cosa che può aiutare LZMA2 a
produrre .xz file 0–15 % più piccoli. I filtri BCJ sono sempre reversibili, quindi usare un filtro
BCJ per il tipo di dati sbagliato non causa perdita di dati, al massimo può determinare un
rapporto di compressione leggermente peggiore. I filtri BCJ sono molto veloci e usano una quantità
di memoria minima.
Questi filtri BCJ presentano problemi noti relativi al rapporto di compressione:
• Alcuni tipi di file contenenti codice eseguibile (ad esempio, file oggetto, librerie statiche e
moduli del kernel Linux) hanno gli indirizzi nelle istruzioni riempiti con valori di
riempimento. Questi filtri BCJ eseguiranno comunque la conversione degli indirizzi, il che
peggiorerà la compressione con questi file.
• Se un filtro BCJ viene applicato a un archivio, è possibile che renda il rapporto di
compressione peggiore rispetto a non usare un filtro BCJ. Ad esempio, se ci sono eseguibili
simili o addirittura identici, il filtraggio probabilmente renderà i file meno simili e quindi
la compressione sarà peggiore. Anche il contenuto dei file non eseguibili nello stesso archivio
può essere importante. In pratica bisogna provare con e senza filtro BCJ per vedere quale sia
il migliore in ogni situazione.
Insiemi diversi di istruzioni hanno diversi allineamenti: il file eseguibile deve essere allineato
a un multiplo di questo valore nei dati di input per far funzionare il filtro.
Filtro Allineamento Note
x86 1 32-bit o 64-bit x86
ARM 4
ARM-Thumb 2
ARM64 4 L'allineamento migliore è a 4096 byte
PowerPC 4 Solo big-endian
IA-64 16 Itanium
SPARC 4
RISC-V 2
Dal momento che i dati filtrati da BCJ solitamente sono compressi con LZMA2, il rapporto di
compressione può essere migliorato leggermente se le opzioni LZMA2 sono impostate in modo che
corrispondano all'allineamento del filtro BCJ selezionato. Esempi:
• Il filtro IA-64 ha un allineamento a 16 byte, quindi pb=4,lp=4,lc=0 è una buona scelta per
LZMA2 (2^4=16).
• Il codice RISC-V ha un allineamento a 2 o 4 byte a seconda che il file contenga o meno
istruzioni 16 bit compresse (cosiddetta estensione C). Quando sono usate istruzioni a 16 bit,
va bene pb=2,lp=1,lc=3 o pb=1,lp=1,lc=3. Quando le istruzioni a 16 bit non sono presenti, è
meglio pb=2,lp=2,lc=2. Si può usare readelf -h per controllare se "RVC" appare sulla riga del
"Flag".
• ARM64 è sempre allineato a 4 byte, quindi pb=2,lp=2,lc=2 è la scelta migliore.
• Il filtro x86 è un'eccezione. Di solito è bene attenersi alle impostazioni predefinite di LZMA2
(pb=2,lp=0,lc=3) quando si comprimono gli eseguibili x86.
Tutti i filtri BCJ supportano le stesse OPZIONI:
start=OFFSET
Specifica l'OFFSET iniziale utilizzato per la conversione tra indirizzi relativi e
assoluti. L'OFFSET deve essere un multiplo dell'allineamento del filtro (vedere la tabella
sopra). Il valore predefinito è zero. In pratica, l'impostazione predefinita è buona;
specificare un OFFSET personalizzato non è quasi mai utile.
--delta[=OPZIONI]
Aggiunge un filtro Delta alla catena dei filtri. I filtri Delta non possono essere utilizzati come
ultimo filtro nella catena di filtri.
Al momento è supportato solo un semplice calcolo delta byte-per-byte. Può essere utile quando si
comprime, per esempio, immagini bitmap non compresse o file audio PCM non compressi. Tuttavia,
speciali algoritmi ad-hoc potrebbero dare risultati significativamente migliori che Delta + LZMA2.
Questo è vero specialmente per l'audio, che comprime più velocemente e meglio, ad esempio, con
flac(1).
OPZIONI supportate:
dist=DISTANZA
Specifica la DISTANZA del calcolo delta in byte. DISTANZA deve essere nel range 1–256. Il
valore predefinito è 1.
Per esempio, con dist=2 e un input di 8 byte A1 B1 A2 B3 A3 B5 A4 B7, l'output sarà A1 B1
01 02 01 02 01 02.
Altre opzioni
-q, --quiet
Sopprime avvertimenti e avvisi. Specificarlo due volte per eliminare anche gli errori. Questa
opzione non ha alcun effetto sullo stato di uscita. In altre parole, anche se un avvertimento è
stato eliminato, lo stato di uscita che indica un avvertimento viene comunque utilizzato.
-v, --verbose
Sii prolisso. Se lo standard error è collegato a un terminale, xz visualizzerà un indicatore di
avanzamento. Specificando --verbose due volte si otterrà un output ancora più dettagliato.
L'indicatore di avanzamento mostra le seguenti informazioni:
• La percentuale di avanzamento è mostrata se la dimensione del file input è nota. Quindi, la
percentuale non può essere mostrata nei pipe.
• Quantità di dati compressi prodotti (in compressione) o utilizzati (in decompressione).
• Quantità di dati non compressi consumati (in compressione) o prodotti (in decompressione).
• Rapporto di compressione, calcolato dividendo la quantità di dati compressi processati finora
con la quantità di dati non compressi processati finora.
• Velocità di compressione o decompressione. Questa è misurata come la quantità di dati non
compressi consumati (in compressione) o prodotti (in decompressione) al secondo. Viene mostrata
dopo che è trascorso qualche secondo da quando xz ha iniziato a processare il file.
• Tempo trascorso nel formato M:SS o H:MM:SS.
• Il tempo residuo stimato è mostrato solo quando la dimensione del file in ingresso è nota e
sono già passati un paio di secondi da quando xz ha iniziato a processare il file. Il tempo è
mostrato in un formato meno preciso che non ha mai i due punti, ad esempio 2 min 30 s.
Quando lo standard error non è un terminale, --verbose farà stampare a xz il nome del file, la
dimensione compressa, la dimensione non compressa, il rapporto di compressione, e potendo anche la
velocità e il tempo trascorso, su una singola riga dello standard error, dopo aver compresso o
decompresso il file. La velocità e il tempo trascorso sono inclusi solo se l'operazione è durata
almeno un paio di secondi. Se l'operazione non è conclusa, ad esempio a causa dell'interruzione da
parte dell'utente, viene stampata anche la percentuale di completamento, a patto che la dimensione
del file input sia nota.
-Q, --no-warn
Non impostare lo stato di uscita a 2 anche se è stata rilevata una condizione che merita un
avvertimento. Questa opzione non influisce sul livello di dettaglio, quindi sia --quiet che
--no-warn devono essere utilizzati per non visualizzare avvertimenti e per non alterare lo stato
di uscita.
--robot
Stampa i messaggi in un formato analizzabile dal computer. Questo ha lo scopo di facilitare la
scrittura dei frontend che vogliono usare xz invece di liblzma, che potrebbe essere il caso di
vari script. Si intende che con questa opzione abilitata l'output dovrebbe rimanere stabile tra le
versioni di xz. Per ulteriori informazioni, vedere la sezione MODALITÀ ROBOT.
--info-memory
Mostra, in un formato leggibile da umani, quanta memoria fisica (RAM) e quante thread xz pensa che
il sistema abbia e i limiti di utilizzo di memoria per la compressione e la decompressione, quindi
termina con successo.
-h, --help
Mostra un messaggio di aiuto che descrive le opzioni usate più comunemente, e termina con
successo.
-H, --long-help
Mostra un messaggio di aiuto che descrive tutte le funzionalità di xz, e termina con successo
-V, --version
Mostra il numero di versione di xz e liblzma in un formato leggibile dagli umani. Per ottenere un
output analizzabile da una macchina specificare --robot prima di --version.
MODALITÀ ROBOT
La "modalità robot" viene attivata con l'opzione --robot. Rende l'output di xz più facile da analizzare
da altri programmi. Attualmente --robot è supportato solo insieme a --list, --filters-help, --info-memory
e --version. In futuro sarà supportato per la compressione e la decompressione.
Modalità stampa
xz --robot --list usa un output separato da tabulazione. La prima colonna di ogni riga contiene una
stringa che indica il tipo di informazione contenuta in quella riga:
name Questa è sempre la prima riga quando si inizia a elencare un file. La seconda colonna della riga è
il nome del file.
file Questa riga contiene informazioni generali sul file .xz. Questa riga viene sempre stampata dopo la
riga name.
stream Questo tipo di riga viene utilizzato solo quando è stato specificato --verbose. Sono presenti
tante righe stream quanti sono i flussi nel file .xz.
block Questo tipo di riga viene utilizzato solo quando è stato specificato --verbose. Ci sono tante
righe block quanti sono i blocchi nel file .xz. Le righe block vengono visualizzate dopo tutte le
righe stream; i diversi tipi di riga non vengono interlacciati.
summary
Questo tipo di riga viene utilizzato solo quando --verbose è stato specificato due volte. Questa
riga viene stampata dopo tutte le righe block. Come la riga file, la riga summary contiene
informazioni generali sul file .xz.
totals Questa riga è sempre l'ultima riga dell'output dell'elenco. Mostra i conteggi totali e le
dimensioni.
Le colonne delle righe file:
2. Numero di flussi nel file
3. Numero totale di blocchi nel flusso/i.
4. Dimensione compressa del file
5. Dimensione non compressa del file
6. Rapporto di compressione, es. 0.123. Se il rapporto è oltre 9999, al posto del rapporto
vengono mostrati tre trattini (---).
7. Elenco separato da virgole dei nomi dei controlli di integrità. Le stringhe seguenti vengono
utilizzate per i tipi di controllo conosciuti: None, CRC32, CRC64, e SHA-256. Per i tipi di
controllo non conosciuti viene utilizzato Unknown-N, dove N è l'ID del controllo come numero
decimale (una o due cifre).
8. Dimensione totale del padding del flusso nel file
Le colonne delle righe stream:
2. Numero di flusso (il primo è 1)
3. Numero di blocchi nel flusso
4. Offset iniziale compressione
5. Offset iniziale decompressione
6. Dimensione compressa (non include il padding del flusso)
7. Dimensione non compressa
8. Rapporto di compressione
9. Nome del controllo di integrità
10. Dimensione del padding del flusso
Le colonne delle righe block:
2. Numero di flussi che contengono questo blocco
3. Numero del blocco relativo all'inizio del flusso (il primo blocco è 1)
4. Numero del blocco relativo all'inizio del file
5. Offset iniziale compressione relativo all'inizio del file
6. Offset iniziale decompressione relativo all'inizio del file
7. Dimensione totale compressa del blocco (incluse le intestazioni)
8. Dimensione non compressa
9. Rapporto di compressione
10. Nome del controllo di integrità
Se --verbose viene specificato due volte, sono incluse colonne aggiuntive nelle righe block. Queste non
sono mostrate con un --verbose singolo, perché recuperare queste informazioni richiede molte ricerche e
quindi può essere lento:
11. Valore del controllo di integrità in formato esadecimale
12. Dimensione intestazione blocco
13. Flag del blocco: cindica che è presente la dimensione compressa, u indica che è presente la
dimensione non compressa. Se il flag non è impostato, viene mostrato un trattino (-) per
mantenere fissa la lunghezza della stringa. Nuovi flag potrebbero essere aggiunti alla fine
della stringa in futuro.
14. Dimensione dei dati compressi effettivi nel blocco (sono esclusi l'intestazione del blocco, il
padding del blocco e i campi di controllo)
15. Quantità di memoria (in byte) necessaria per decomprimere questo blocco con questa versione xz
16. Catena di filtri. Si noti che la maggior parte delle opzioni utilizzate al momento della
compressione non è nota, perché solo le opzioni necessarie per la decompressione sono
memorizzate nelle intestazioni .xz.
Le colonne delle righe summary:
2. Quantità di memoria (in byte) necessaria per decomprimere questo file con questa versione xz
3. yes o no indica se tutte le intestazioni di blocco contengono all'interno sia dimensioni
compresse che dimensioni non compresse
A partire da xz 5.1.2alpha:
4. Versione minima di xz richiesta per decomprimere il file
Le colonne delle righe totali:
2. Numero di flussi
3. Numero di blocchi
4. Dimensione compressa
5. Dimensione non compressa
6. Rapporto di compressione medio
7. Elenco separato da virgole dei nomi dei controlli di integrità presenti nei file
8. Dimensione del padding dello stream
9. Numero di file. Questo serve a mantenere l'ordine delle colonne precedenti uguale a quello
delle righe del file.
Se --verbose viene specificato due volte, sono incluse colonne aggiuntive nella riga totali:
10. Quantità massima di memoria (in byte) necessaria per decomprimere i file con questa versione
xz
11. yes o no indica se tutte le intestazioni di blocco contengono all'interno sia dimensioni
compresse che dimensioni non compresse
A partire da xz 5.1.2alpha:
12. Versione minima di xz richiesta per decomprimere il file
Versioni future potrebbero aggiungere nuovi tipi di riga e nuove colonne possono essere aggiunte ai tipi
di riga esistenti, ma le colonne esistenti non verranno modificate.
Aiuto sui filtri
xz --robot --filters-help stampa i filtri supportati nel seguente formato:
FILTRO:OPZIONE=<VALORE>,OPZIONE=<VALORE>...
FILTRO Nome del filtro
OPZIONE
Nome di un'opzione specifica del filtro
VALORE Gli intervalli del VALORE numerico appaiono come <MIN-MAX>. Le scelte per i VALORI stringa sono
mostrati in < > e separati dal carattere |.
Ogni filtro è mostrato su una riga dedicata.
Informazione limite memoria
xz --robot --info-memory stampa una singola riga con più colonne separate da tabulazione:
1. Quantità totale di memoria fisica (RAM) in byte.
2. Limite utilizzo memoria per la compressione in byte (--memlimit-compress). Il valore speciale 0
indica l'impostazione predefinita, che in modalità thread singola equivale a nessun limite.
3. Limite utilizzo memoria per la decompressione in byte (--memlimit-decompress). Il valore speciale 0
indica l'impostazione predefinita, che in modalità thread singola equivale a nessun limite.
4. A partire da xz 5.3.4alpha: Utilizzo della memoria per la decompressione a thread multiple in byte
(--memlimit-mt-decompress). Questo valore non è mai zero perché viene utilizzato un valore
predefinito specifico del sistema mostrato nella colonna 5, se non è stato specificato alcun limite
in modo esplicito. Inoltre, non è mai maggiore del valore nella colonna 3, anche se è stato
specificato un valore maggiore con --memlimit-mt-decompress.
5. A partire da xz 5.3.4alpha: un limite di utilizzo della memoria predefinito specifico del sistema,
che viene utilizzato per limitare il numero di thread durante la compressione con un numero
automatico di thread (--threads=0) e non è stato specificato alcun limite di utilizzo della memoria
(--memlimit-compress). Questo viene utilizzato anche come valore predefinito per
--memlimit-mt-decompress.
6. A partire da xz 5.3.4alpha: Numero di thread del processore disponibili.
In futuro, l'output di xz --robot --info-memory potrebbe avere più colonne, ma mai più di una singola
riga.
Versione
xz --robot --version stampa il numero di versione di xz e liblzma nel seguente formato:
XZ_VERSION=XYYYZZZS
LIBLZMA_VERSION=XYYYZZZS
X Versione major.
YYY Versione minor. I numeri pari sono stabili. I numeri dispari sono versioni alfa o beta.
ZZZ Livello di patch per le versioni stabili o solo un contatore per le versioni di sviluppo.
S Stabilità. 0 è alfa, 1 è beta e 2 è stabile. S dovrebbe essere sempre 2 quando YYY è pari.
XYYYZZZS sono uguali su entrambe le righe se xz e liblzma appartengono allo stesso rilascio delle XZ
Utils.
Esempi: 4.999.9beta è 49990091 e 5.0.0 è 50000002.
CODICE DI USCITA
0 Tutto bene.
1 È avvenuto un errore.
2 Si è verificato qualcosa che merita un avvertimento, ma non si sono verificati errori effettivi.
Gli avvisi (non gli avvertimenti o gli errori) stampati sullo standard error non influiscono sullo stato
di uscita.
AMBIENTE
xz analizza elenchi di opzioni separate da spazi dalle variabili d'ambiente XZ_DEFAULTS e XZ_OPT, in
questo ordine, analizzando prima le opzioni dalla riga di comando. Si noti che solo le opzioni vengono
analizzate dalle variabili d'ambiente; tutte le non-opzioni vengono ignorate silenziosamente. L'analisi
viene eseguita con getopt_long(3) che viene utilizzato anche per gli argomenti della riga di comando.
Attenzione: Impostando queste variabili di ambiente, si sta di fatto modificando programmi e script che
lanciano xz. La maggior parte delle volte va bene impostare i limiti di utilizzo della memoria, il numero
di thread e le opzioni di compressione tramite variabili d'ambiente. Tuttavia, alcune opzioni possono
rompere degli script. Un esempio banale è --help che forza xz a mostrare la pagina di aiuto anziché
comprimere o decomprimere file. Esempi meno ovvi sono --quiet e --verbose. In molti casi funziona bene
abilitare l'indicatore di avanzamento usando --verbose, ma in alcune situazioni i messaggi extra creano
problemi. Il livello di prolissità influisce anche sul comportamento di --list.
XZ_DEFAULTS
Opzioni predefinite specifiche dell'utente o a livello di sistema. In genere questo viene
impostato in uno script di inizializzazione della shell per abilitare il valore predefinito del
limitatore di utilizzo della memoria di xz, o per impostare il numero di thread predefinito.
Escludendo gli script di inizializzazione della shell e analoghi casi particolari, gli script non
dovrebbero mai impostare o annullare l'impostazione di XZ_DEFAULTS.
XZ_OPT Questo serve per passare le opzioni a xz quando non sia possibile impostare le opzioni
direttamente sulla riga di comando di xz. Questo è il caso quando xz viene eseguito da uno script
o da uno strumento, ad esempio GNU tar(1):
XZ_OPT=-2v tar caf foo.tar.xz foo
Gli script possono usare XZ_OPT, per esempio, per impostare opzioni di compressione predefinite
specifiche per lo script. Si raccomanda comunque di permettere agli utenti di sovrascrivere
XZ_OPTse questo è ragionevole. Ad esempio, negli script sh(1) si può usare qualcosa come questo:
XZ_OPT=${XZ_OPT-"-7e"}
export XZ_OPT
COMPATIBILITÀ LZMA UTILS
La sintassi della riga di comando di xz è essenzialmente un sopra-insieme di lzma, unlzma, e lzcat come
trovati nelle LZMA Utils 4.32.x. Nella maggior parte dei casi è possibili sostituire le LZMA Utils con le
XZ Utils senza rompere gli script esistenti. Ci sono però alcune incompatibilità, che in alcuni casi
potrebbero causare problemi.
Livelli di compressione preimpostati
La numerazione dei livelli di compressione preimpostati non è identica in xz e nelle LZMA Utils. La
differenza più importante è il modo in cui le dimensioni del dizionario vengono mappate sulle diverse
preimpostazioni. La dimensione del dizionario è approssimativamente uguale all'utilizzo della memoria del
decompressore.
Livello xz LZMA Utils
-0 256 KiB N/A
-1 1 MiB 64 KiB
-2 2 MiB 1 MiB
-3 4 MiB 512 KiB
-4 4 MiB 1 MiB
-5 8 MiB 2 MiB
-6 8 MiB 4 MiB
-7 16 MiB 8 MiB
-8 32 MiB 16 MiB
-9 64 MiB 32 MiB
Le differenze di dimensione del dizionario influiscono anche sull'utilizzo della memoria del compressore,
ma ci sono alcune altre differenze tra le LZMA Utils e le XZ Utils, che rendono la differenza ancora più
grande:
Livello xz LZMA Utils 4.32.x
-0 3 MiB N/A
-1 9 MiB 2 MiB
-2 17 MiB 12 MiB
-3 32 MiB 12 MiB
-4 48 MiB 16 MiB
-5 94 MiB 26 MiB
-6 94 MiB 45 MiB
-7 186 MiB 83 MiB
-8 370 MiB 159 MiB
-9 674 MiB 311 MiB
Il livello preimpostato predefinito nelle LZMA Utils è -7 mentre nelle XZ Utils è -6, quindi entrambi
utilizzano un dizionario da 8 MiB per impostazione predefinita.
File .lzma con flussi vs. senza flussi
La dimensione non compressa del file può essere memorizzata nell'intestazione .lzma. Le LZMA Utils lo
fanno durante la compressione di file regolari. L'alternativa consiste nel memorizzare che la dimensione
non compressa è sconosciuta e utilizzare l'indicatore di fine carico utile per indicare il punto in cui
il decompressore deve fermarsi. Le LZMA Utils utilizzano questo metodo quando le dimensioni non compresse
non sono note, come nel caso, ad esempio, delle pipe.
xz supporta la decompressione di file .lzma con o senza il marcatore di fine payload, ma tutti i file
.lzma creati da xz utilizzeranno il marcatore di fine payload e avranno dimensioni non compresse
contrassegnate come sconosciute nell'intestazione .lzma. Questo può essere un problema in alcune
situazioni non comuni. Ad esempio, un decompressore .lzma in un dispositivo embedded potrebbe funzionare
solo con file con dimensioni non compresse note. Se si incorre in questo problema, occorre utilizzare le
LZMA Utils oppure l'LZMA SDK per creare dei file .lzma con dimensioni non compresse note.
File .lzma non supportati
Il formato .lzma permette valori lc fino a 8, e valori lp fino a 4. Le LZMA Utils possono decomprimere
file con qualunque lc e lp, ma creeranno sempre file con lc=3 e lp=0. Creare file con altri lc e lp è
possibile con xz e con l'LZMA SDK.
L'implementazione del filtro LZMA1 in liblzma richiede che la somma di lc e lp non debba superare 4.
Pertanto, i file .lzma che superano questa limitazione non possono essere decompressi con xz.
Le LZMA Utils creano solo file .lzma con dimensione del dizionario 2^n (una potenza di 2) ma accettano
file con qualsiasi dimensione di dizionario. liblzma accetta solo file .lzma con dimensione del
dizionario 2^n o 2^n + 2^(n-1). Questo serve a limitare i falsi positivi quando si cerca di identificare
i file .lzma.
All'atto pratico queste limitazioni non dovrebbero essere un problema, perché praticamente tutti i file
.lzma sono stati compressi con impostazioni che liblzma accetterà.
Dati sporchi finali
Quando si decomprime, le LZMA Utils ignorano automaticamente tutto quello che c'è dopo il primo flusso
.lzma. Nella maggior parte delle situazioni questo è un baco. Questo significa anche che le LZMA Utils
non supportano la decompressione di file .lzma concatenati.
Se sono rimasti dati dopo il primo flusso .lzma, xz considera il file corrotto a meno che sia stato
utilizzato --single-stream. Questo può far rompere script incomprensibili che hanno assunto che i dati
sporchi finali vengano ignorati.
NOTE
L'output compresso può variare
L'esatto output compresso prodotto dallo stesso file di input non compresso può variare tra le versioni
delle XZ Utils, anche se le opzioni di compressione sono le stesse. Questo perché il codificatore può
essere stato migliorato (compressione più veloce o migliore) senza influire sul formato del file.
L'output può variare anche tra diverse build della stessa versione delle XZ Utils, se vengono utilizzate
opzioni di build differenti.
Quanto sopra significa che una volta che --rsyncable è stato implementato, i file risultanti non saranno
necessariamente rsync-abili a meno che sia i vecchi che i nuovi file non siano stati compressi con la
stessa versione di xz. Questo problema può essere risolto se una parte dell'implementazione del
codificatore viene congelata per mantenere stabile l'output rsync-abile tra le versioni di xz.
Abilita i decompressori .xz
Le implementazioni dei decompressori .xz embedded, come XZ Embedded, non necessariamente supportano file
creati con tipi di integrità CONTROLLO diversi da none e crc32. Dal momento che il valore predefinito è
--check=crc64, occorre specificare --check=none o --check=crc32 quando si creano file per sistemi
embedded.
Al di fuori dei sistemi embedded, tutti i decompressori in formato .xz supportano tutti i tipi di
CONTROLLO, o almeno sono in grado di decomprimere il file senza verificare il controllo di integrità se
il particolare CONTROLLO non è supportato.
XZ Embedded supporta i filtri BCJ, ma solo con offset iniziale predefinito.
ESEMPI
Informazioni di base
Comprime il file foo in foo.xz utilizzando il livello di compressione predefinito (-6) e rimuove foo se
la compressione ha esito positivo:
xz foo
Decomprime bar.xz in bar e non rimuove bar.xz anche se la decompressione ha successo:
xz -dk bar.xz
Crea baz.tar.xz con il preset -4e (-4 --extreme), che è più lenta della predefinita -6, ma ha bisogno di
meno memoria per la compressione e decompressione (48 MiB e 5 MiB, rispettivamente):
tar cf - baz | xz -4e > baz.tar.xz
Una combinazione di file compressi e non compressi può essere decompressa sullo output standard con un
singolo comando:
xz -dcf a.txt b.txt.xz c.txt d.txt.lzma > abcd.txt
Compressione parallela di più file
Su GNU e *BSD, find(1) e xargs(1) possono essere usati per parallelizzare la compressione di più file:
find . -type f \! -name '*.xz' -print0 \
| xargs -0r -P4 -n16 xz -T1
L'opzione -p di xargs(1) imposta il numero di processi xz paralleli. Il valore migliore per l'opzione -n
dipende dal numero di file da comprimere. Se sono presenti solo un paio di file, il valore dovrebbe
probabilmente essere 1; con decine di migliaia di file, 100 o anche di più può essere appropriato per
ridurre il numero di processi xz che xargs(1) alla fine creerà.
L'opzione -T1 per xz serve a forzare la modalità a thread singola, perché xargs (1) viene utilizzato per
controllare la quantità di parallelizzazione.
Modalità robot
Calcola quanti byte sono stati salvati in totale dopo la compressione di più file:
xz --robot --list *.xz | awk '/^totals/{print $5-$4}'
Uno script potrebbe voler sapere se si sta utilizzando una versione di xz sufficientemente recente. Il
seguente script sh(1) controlla che il numero di versione dello strumento xz sia almeno 5.0.0. Questo
metodo è compatibile con le vecchie versioni beta, che non supportavano l'opzione --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
Imposta un limite di utilizzo della memoria per la decompressione utilizzando XZ_OPT, ma se è già stato
impostato un limite, non lo aumenta:
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
Catene di filtri di compressione personalizzate
L'uso più semplice delle catene di filtri personalizzate è la personalizzazione di un preset di LZMA2.
Questo può essere utile, perché i preset coprono solamente un sottoinsieme di tutte le combinazioni di
impostazioni di compressione potenzialmente utili.
Le colonne CompCPU delle tabelle dalle descrizioni delle opzioni -0 ... -9 e --extreme sono utili quando
si personalizzano i preset di LZMA2. Di seguito sono riportate le parti rilevanti raccolte da queste due
tabelle:
Livello preimpostato CompCPU
-0 0
-1 1
-2 2
-3 3
-4 4
-5 5
-6 6
-5e 7
-6e 8
Se si sa che un file richiede un dizionario piuttosto grande (ad esempio, 32 MiB) per essere compresso
bene, ma si desidera comprimerlo più velocemente di quanto farebbe xz -8, è possibile modificare un
preset con un basso valore CompCPU (ad esempio, 1) per utilizzare un dizionario più grande:
xz --lzma2=preset=1,dict=32MiB foo.tar
Con alcuni file, il comando sopra potrebbe essere più veloce di xz -6 e la compressione
significativamente migliore. Tuttavia, si deve sottolineare che solo alcuni file traggono beneficio da un
dizionario grande e mantengono basso il valore di CompCPU. La situazione più ovvia in cui un dizionario
grande può aiutare molto è un archivio contenente file molto simili di almeno un paio di megabyte
ciascuno. La dimensione del dizionario deve essere significativamente più grande di ogni singolo file per
permettere a LZMA2 di trarre pieno vantaggio dalle somiglianze tra file consecutivi.
Se l'utilizzo molto elevato della memoria del compressore e del decompressore è accettabile, e il file da
comprimere è almeno di diverse centinaia di megabyte, potrebbe essere utile utilizzare un dizionario
ancora più grande dei 64 MiB che xz -9 utilizzerebbe:
xz -vv --lzma2=dict=192MiB big_foo.tar
L'uso di -vv (--verbose --verbose) come nell'esempio precedente può essere utile per vedere i requisiti
di memoria del compressore e del decompressore. Tenere presente che l'utilizzo di un dizionario più
grande della dimensione del file non compresso è uno spreco di memoria, quindi il comando precedente non
è utile per i file di piccole dimensioni.
A volte il tempo di compressione non importa, ma l'utilizzo di memoria del decompressore deve essere
tenuta bassa, per esempio, per permettere di decomprimere il file in un sistema embedded. Il comando
seguente usa -6e (-6 --extreme) come base e imposta il dizionario a soli 64 KiB. Il file risultante può
essere decompresso con XZ Embedded (ecco perché c'è --check=crc32) usando circa 100 KiB di memoria.
xz --check=crc32 --lzma2=preset=6e,dict=64KiB foo
Se si desidera spremere il maggior numero possibile di byte, a volte può essere utile regolare il numero
di bit di contesto letterale (lc) e il numero di bit di posizione (pb). Anche la regolazione del numero
di bit di posizione letterale (lp) potrebbe essere d'aiuto, ma di solito lc e pb sono più importanti. Per
esempio, un archivio di codici sorgente contiene principalmente testo US-ASCII, quindi qualcosa come il
seguente potrebbe produrre un file leggermente (0,1 %) più piccolo di xz -6e (provare anche senza lc=4):
xz --lzma2=preset=6e,pb=0,lc=4 source_code.tar
Usare un altro filtro insieme a LZMA2 può migliorare la compressione per alcuni tipi di file. Ad esempio,
per comprimere una libreria condivisa x86-32 o x86-64 usare il filtro BCJ:
xz --x86 --lzma2 libfoo.so
Si noti che l'ordine delle opzioni di filtro è significativo. Se viene specificato --x86 dopo --lzma2, xz
darà un errore, perché non può esserci alcun filtro dopo LZMA2 e anche perché il filtro BCJ x86 non può
essere utilizzato come ultimo filtro della catena.
Il filtro Delta insieme con LZMA2 può dare buoni risultati sulle immagini bitmap. Di solito dovrebbe
battere il PNG, il quale ha alcuni filtri più avanzati rispetto al semplice delta ma utilizza Deflate per
la compressione effettiva.
L'immagine deve essere salvata in un formato non compresso, ad esempio un TIFF non compresso. Il
parametro distanza del filtro Delta è impostato in modo che corrisponda al numero di byte per pixel
nell'immagine. Per esempio, un bitmap a 24 bit richiede dist=3, e va anche bene passare pb=0 a LZMA2 per
adattarsi all'allineamento a tre byte:
xz --delta=dist=3 --lzma2=pb=0 foo.tiff
Se più immagini sono state inserite in un singolo archivio (ad esempio, .tar), il filtro Delta funzionerà
anche su questo purché tutte le immagini abbiano lo stesso numero di byte per pixel.
VEDERE ANCHE
xzdec(1), xzdiff(1), xzgrep(1), xzless(1), xzmore(1), gzip(1), bzip2(1), 7z(1)
XZ Utils: <https://xz.tukaani.org/xz-utils/>
XZ Embedded: <https://xz.tukaani.org/xz-embedded/>
LZMA SDK: <https://7-zip.org/sdk.html>
Tukaani 08/03/2025 XZ(1)