PRISTINE-XZ(1)

🌸 PRISTINE-XZ 💅

okay bestie, welcome to pristine-xz, section 1 of the manual pages. this is a lil helper that regenerates pristine xz files, and yes it's as iconic as it sounds ✨

---

✨ NAME ✨

pristine-xz — regenerate pristine xz files 🦋

---

🎀 SYNOPSIS 🎀

pristine-xz [OPTIONS] gendelta file.xz delta

pristine-xz [OPTIONS] genxz delta file

like, two whole modes. pick your fighter 💅

---

💖 DESCRIPTION 💖

so this is a complement to the pristine-tar(1) command, which is its whole thing. and ngl, normally you don't even need to run it by hand — pristine-tar just calls it whenever it needs to handle .tar.xz files. it's giving "background character who's actually carrying the whole plot" 😭

pristine-xz gendelta takes the xz file you specified and generates a small binary delta file that can later be used by pristine-xz genxz to recreate the original file. tiny file, big destiny fr fr ✨

pristine-xz genxz takes the delta file you specified, and compresses the input file you specified (which must be identical to the contents of the original xz file). the resulting file will be identical to the original gz file used to create the delta. yes bestie, that's what it says 💀

the approach used to regenerate the original xz file is to figure out how it was produced — like, what compression level was used, etc. currently support is poor for xz files produced with unusual compression options. so if your xz was made weird, this is lowkey not gonna eat 🙈

if the delta filename is -, pristine-xz reads or writes it to stdio. cute, right? 🍓

---

🌈 OPTIONS 🌈

• -v — Verbose mode, show each command that is run. so you can watch every single step like it's a vlog 👀
• -d — Debug mode. for when you need the tea 🫖
• -k — Don't clean up the temporary directory on exit. leave the mess, it's fine, it's a vibe 💅
• -t — Try harder to determine how to generate deltas of difficult xz files. main character energy: it's gonna try 🧚

---

🌸 ENVIRONMENT 🌸

TMPDIR

Specifies a location to place temporary files, other than the default. so like, if you want your temp files somewhere else, this is your girl ✨

---

👑 AUTHOR 👑

Joey Hess <joeyh@debian.org>, Faidon Liambotis <paravoid@debian.org>, Cyril Brulebois <cyril.brulebois@enst-bretagne.fr> 🫶

Licensed under the GPL, version 2. periodt 💜

---

and that's the whole page bestie, no cap 💖 this one's from perl v5.38.2, dated 2024-04-01, and it lives in the PRISTINE-XZ(1) section. slay, go regenerate something ✨🌈🎀