OS Manuals

/usr/bin/pigz

Parallel implementation of gzip

From pigz 2.8-r10 (os), captured 2026-11-05 by running pigz --help (exit 0). permalink

Usage: pigz [options] [files ...]
  will compress files in place, adding the suffix '.gz'. If no files are
  specified, stdin will be compressed to stdout. pigz does what gzip does,
  but spreads the work over multiple processors and cores when compressing.

Options:
  -0 to -9, -11        Compression level (level 11, zopfli, is much slower)
  --fast, --best       Compression levels 1 and 9 respectively
  -A, --alias xxx      Use xxx as the name for any --zip entry from stdin
  -b, --blocksize mmm  Set compression block size to mmmK (default 128K)
  -c, --stdout         Write all processed output to stdout (won't delete)
  -C, --comment ccc    Put comment ccc in the gzip or zip header
  -d, --decompress     Decompress the compressed input
  -f, --force          Force overwrite, compress .gz, links, and to terminal
  -F  --first          Do iterations first, before block split for -11
  -h, --help           Display a help screen and quit
  -H, --huffman        Use only Huffman coding for compression
  -i, --independent    Compress blocks independently for damage recovery
  -I, --iterations n   Number of iterations for -11 optimization
  -J, --maxsplits n    Maximum number of split blocks for -11
  -k, --keep           Do not delete original file after processing
  -K, --zip            Compress to PKWare zip (.zip) single entry format
  -l, --list           List the contents of the compressed input
  -L, --license        Display the pigz license and quit
  -m, --no-time        Do not store or restore mod time
  -M, --time           Store or restore mod time
  -n, --no-name        Do not store or restore file name or mod time
  -N, --name           Store or restore file name and mod time
  -O  --oneblock       Do not split into smaller blocks for -11
  -p, --processes n    Allow up to n compression threads (default is the
                       number of online processors, or 8 if unknown)
  -q, --quiet          Print no messages, even on error
  -r, --recursive      Process the contents of all subdirectories
  -R, --rsyncable      Input-determined block locations for rsync
  -S, --suffix .sss    Use suffix .sss instead of .gz (for compression)
  -t, --test           Test the integrity of the compressed input
  -U, --rle            Use run-length encoding for compression
  -v, --verbose        Provide more verbose output
  -V  --version        Show the version of pigz
  -Y  --synchronous    Force output file write to permanent storage
  -z, --zlib           Compress to zlib (.zz) instead of gzip format
  --                   All arguments after "--" are treated as files
Options (34)
OptionDescriptionSource
-0, -11 toCompression level (level 11, zopfli, is much slower)help
--fast, --bestCompression levels 1 and 9 respectivelyhelp
-A, --alias xxxUse xxx as the name for any --zip entry from stdinhelp
-b, --blocksize mmmSet compression block size to mmmK (default 128K)help
-c, --stdoutWrite all processed output to stdout (won't delete)help
-C, --comment cccPut comment ccc in the gzip or zip headerhelp
-d, --decompressDecompress the compressed inputhelp
-f, --forceForce overwrite, compress .gz, links, and to terminalhelp
-F--first Do iterations first, before block split for -11help
-h, --helpDisplay a help screen and quithelp
-H, --huffmanUse only Huffman coding for compressionhelp
-i, --independentCompress blocks independently for damage recoveryhelp
-I, --iterations nNumber of iterations for -11 optimizationhelp
-J, --maxsplits nMaximum number of split blocks for -11help
-k, --keepDo not delete original file after processinghelp
-K, --zipCompress to PKWare zip (.zip) single entry formathelp
-l, --listList the contents of the compressed inputhelp
-L, --licenseDisplay the pigz license and quithelp
-m, --no-timeDo not store or restore mod timehelp
-M, --timeStore or restore mod timehelp
-n, --no-nameDo not store or restore file name or mod timehelp
-N, --nameStore or restore file name and mod timehelp
-O--oneblock Do not split into smaller blocks for -11help
-p, --processes nAllow up to n compression threads (default is the number of online processors, or 8 if unknown)help
-q, --quietPrint no messages, even on errorhelp
-r, --recursiveProcess the contents of all subdirectorieshelp
-R, --rsyncableInput-determined block locations for rsynchelp
-S, --suffix .sssUse suffix .sss instead of .gz (for compression)help
-t, --testTest the integrity of the compressed inputhelp
-U, --rleUse run-length encoding for compressionhelp
-v, --verboseProvide more verbose outputhelp
-V--version Show the version of pigzhelp
-Y--synchronous Force output file write to permanent storagehelp
-z, --zlibCompress to zlib (.zz) instead of gzip formathelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.