Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pixz (1)

Name

pixz - parallel, indexing version of XZ

Synopsis

/usr/bin/pixz input output.pxz


/usr/bin/pixz -d input.pxz output


/usr/bin/pixz -l input.tpxz


/usr/bin/pixz -x /path/to/file < input.tpxz

Description

pixz(1)                     General Commands Manual                    pixz(1)



NAME
       pixz - parallel, indexing version of XZ


SYNOPSIS
       /usr/bin/pixz input output.pxz


       /usr/bin/pixz -d input.pxz output


       /usr/bin/pixz -l input.tpxz


       /usr/bin/pixz -x /path/to/file < input.tpxz


DESCRIPTION
       The existing XZ Utils ( http://tukaani.org/xz/ ) provide great compres-
       sion in the .xz file format, but they have two significant problems:


           o      They are single-threaded, while  most  users  nowadays  have
                  multi-core computers.

           o      The  .xz  files  they produce are just one big block of com-
                  pressed data, rather than a collection  of  smaller  blocks.
                  This makes random access to the original data impossible.


       With pixz, both these problems are solved.


EXAMPLES
       Specifying input and output:

       $ pixz < foo.tar > foo.tpxz

           Same as 'pixz foo.tar foo.tpxz'


       $ pixz -i foo.tar -o foo.tpxz

           Ditto. These both work for -x, -d and -l too, eg:


       $ pixz -x -i foo.tpxz -o foo.tar file1 file2 ...

           # Extract the files from foo.tpxz into foo.tar


       $ pixz foo.tar

           Compress it to foo.tpxz, removing the original


       $ pixz -d foo.tpxz

           Extract it to foo.tar, removing the original


OPTIONS
       -1     Faster, worse compression.

       -9     Better, slower compression.

       -p <number>
              Cap the number of threads at <number>.

       -t     Compress but don't treat it as a tarball (don't index it).

       -d     Decompress, don't check that contents match index.

       -l     List the xz blocks instead of files.


WARNING
       Running pixz without the -t flag will cause it to treat the input as a
       tarball, as long as it looks vaguely tarball-like. This means if the
       file starts with at least 1024 zero bytes, pixz will assume it's empty,
       and truncate the output! If your input files aren't tarballs, run with
       -t or face possible data-loss.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | compress/pixz    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from  https://github.com/vasi/pixz/releases/down-
       load/v1.0.7/pixz-1.0.7.tar.gz.

       Further information about this software can be found on the open source
       community website at https://github.com/vasi/pixz/.



                                                                       pixz(1)