ZUPDATE(1)

✨ ZUPDATE(1) ✨ β€” like, the user commands corner of the manual, but make it cute πŸŽ€

okay bestie, so this is the page for zupdate, and ngl it's lowkey a glow-up artist for your compressed files πŸ’…


🌸 NAME 🌸

zupdate β€” recompress bzip2, gzip, xz, zstd files to lzip format πŸ¦‹


🌈 SYNOPSIS 🌈

zupdate [options] [files]

periodt, that's the whole vibe.


πŸ’– DESCRIPTION πŸ’–

so zupdate recompresses files from bzip2, gzip, xz, and zstd formats into lzip format. each original gets compared with the new file and then deleted (unless you say otherwise, more on that below πŸ‘€). only regular files with standard file name extensions get recompressed β€” everything else is just ignored, no biggie, it's not their moment.

compressed files are decompressed and then recompressed on the fly ✨, so no temporary files are ever created. not one. zero. iconic behavior honestly.

and why lzip as the destination? because it's the most appropriate format for long-term archiving, that's why πŸ‘‘ iykyk.

if you don't specify any files, recursive searches examine the current working directory, and nonrecursive searches... do nothing. literally nothing. the vibes are just sitting there 🫢

if the lzip-compressed version of a file already exists, that file gets skipped β€” unless you pass the option --force. and if you do pass --force, and the comparison with the existing lzip version fails, then an error is returned and the original file is not deleted. the whole operation of zupdate is meant to be safe and not cause any data loss. so listen: existing lzip-compressed files are never overwritten nor deleted. never ever. no cap πŸ’€

the names of the original files must have one of these extensions:

  • '.bz2', '.gz', '.xz', '.zst', or '.Z' β€” these get recompressed to '.lz' πŸ’–
  • '.tbz', '.tbz2', '.tgz', '.txz', or '.tzst' β€” these get recompressed to '.tlz' 🌸

✨ OPTIONS ✨

  • -h, --help β€” display this help and exit πŸ₯°
  • -V, --version β€” output version information and exit πŸ’«
  • -d, --destdir=<dir> β€” write recompressed files into <dir> πŸ“
  • -e, --expand-extensions β€” expand combined extensions; tgz --> tar.lz 🧚
  • -f, --force β€” don't skip a file even if the .lz exists πŸ’ͺ
  • -i, --ignore-errors β€” ignore non-fatal errors πŸ™ˆ
  • -k, --keep β€” keep (don't delete) input files 🫢
  • -l, --lzip-verbose β€” pass one option -v to the lzip compressor πŸ—£οΈ
  • -M, --format=<list> β€” process only the formats in <list> 🎯
  • -N, --no-rcfile β€” don't read runtime configuration file 🚫
  • -q, --quiet β€” suppress all messages 🀫
  • -r, --recursive β€” operate recursively on directories πŸ”
  • -R, --dereference-recursive β€” recursively follow symbolic links πŸ”—
  • -v, --verbose β€” be verbose (a 2nd -v gives more) πŸ“’
  • -x, --exclude=<pattern> β€” exclude files matching a shell pattern 🚫🌸
  • -0 .. -9 β€” set compression level [default 9] πŸ”₯
  • --bz2=<command> β€” set compressor and options for bzip2 format πŸ“
  • --gz=<command> β€” set compressor and options for gzip format πŸ“
  • --lz=<command> β€” set compressor and options for lzip format πŸ“
  • --xz=<command> β€” set compressor and options for xz format πŸ“
  • --zst=<command> β€” set compressor and options for zstd format πŸ“

valid formats for option '-M' are 'bz2', 'gz', 'xz', and 'zst'. that's the list, bestie, memorize it πŸ’…


πŸ‘‘ EXIT STATUS πŸ‘‘

  • 0 β€” if all the compressed files were successfully recompressed (if needed), compared, and deleted (if requested) βœ… slay
  • 1 β€” if a non-fatal error occurred (file not found or not regular, or has invalid format, or can't be deleted) 😬
  • 2 β€” if a fatal error occurred (invalid command-line options, compressor can't be run, or comparison fails) πŸ’€

πŸ› REPORTING BUGS πŸ›

found a bug? spill it to zutils-bug@nongnu.org πŸ“§

Zutils home page: http://www.nongnu.org/zutils/zutils.html 🏠


Copyright Β© 2026 Antonio Diaz Diaz. License GPLv2+: GNU GPL version 2 or later http://gnu.org/licenses/gpl.html

this is free software: you are free to change and redistribute it. there is NO WARRANTY, to the extent permitted by law. (say it with me: no warranty, no cap 😭)


πŸ¦‹ SEE ALSO πŸ¦‹

the full documentation for zupdate is maintained as a Texinfo manual πŸ“š. if the info and zupdate programs are properly installed at your site, the command

info zutils

should give you access to the complete manual ✨


and that's the whole page, bestie πŸŽ€ this was zutils version 1.16, dated February 2026 β€” written by the zupdate girlies, for the zupdate girlies πŸ’– mwah, go compress something iconic πŸ¦‹πŸ’…

πŸ“¦ where this page comes from