Ubuntu Manpage: zp - ZPAQ open standard maximum compressor with prebuilt compression levels

NAME

       zp - ZPAQ open standard maximum compressor with prebuilt compression levels

SYNOPSIS

         create : zp cN archive.zpaq file [file ...]
         append : zp aN archive.zpaq file [file ...]
         list   : zp l archive.zpaq
         extract: zp [ex][N] archive.zpaq

DESCRIPTION

General
PAQ family was a series of open source data compression archivers that have evolved
through collaborative development to top rankings on several benchmarks measuring
compression ratio although at the expense of speed and memory usage.

ZPAQ ia a proposed standard format for highly compressed data that allows new compression
algorithms to be developed without breaking compatibility with older programs. Zp is based
on PAQ-like context mixing algorithms which are top ranked on many benchmarks. The format
supports archivers, single file compressors, and memory to memory compression.

Zp's goal is a high compression ratio in an open format without loss of compatibility
between versions as advanced compression techniques are discovered.

If you compress in Windows and extract in Linux, then the program will change "\" to "/"
during extraction and vice versa. Slashes can be stored with either convention. The
program guesses the operating system by counting "/" and "\" in the PATH environment
variable. If this heuristic fails (PATH not defined) then no slash translation is done.

Paths must be relative to the current directory. The program will warn if you store an
absolute path. You can only extract such files with command e or by overriding the
filename.

zp c archive.zpaq /dir/file (Warning: starts with "/")
zp x archive.zpaq (Error: bad filename)
zp e archive.zpaq (OK: extracts file1 to current directory)
zp x archive.zpaq newfile (OK: extracts newfile to current directory)
zp x archive.zpaq /dir/file (OK: creates /dir if needed)

Also, the same rule applies to file names containing control characters, or longer than
511 characters, or that start with a drive letter like "C:" or contain relative ".."
paths.

If this program is run in Linux or UNIX or compiled with g++ in Windows then it will
interpret wildcards on the command line in the usual way. A * matches any string and ?
matches any character.

zp c archive.zpaq *

will compress all files in the current directory to "archive.zpaq". However, it will not
recurse directories. You need to specify the files in each directory that you want to add.

The program does not save file timestamps or permissions like some other archivers do.
Extracted files are dated from the time of extraction with default permissions. If you
need these capabilities, then create a tar file and compress that instead.

The compression option 1, 2, or 3 means compress fast, medium, or best respectively.
Better compression requires more time and memory. Decompression speed and memory are the
same as for compression. Speed (T3200, 2.0 GHz) and memory usage are as follows. The
following table shows comparison to "zip -9" compression All modes compress better but
slower than zip.

Memory Speed Calgary corpus
------ ----------- ---------------
1 (fast) 38 MB 0.7 sec/MB 807,214 bytes
2 (default) 111 MB 2.3 sec/MB 699,586 bytes
3 (small) 246 MB 6.4 sec/MB 644,545 bytes
zip -9 <1 MB 0.13 sec/MB 1,020,719 bytes

zp(1) uses compiled ZPAQL (generated by "zpaq oc") to compress and extract in each of the
3 modes about twice as fast as using interpreted code. It automatically recognizes these
configurations even if they are produced by other programs. The default compression is the
same as the default produced by zpaq(1) and zpipe(1). If another program produces a
different configuration, then this program will still correctly decompress it by
interpreting the code, which is slower. Also, zpaq(1), unzpaq(1), and zpipe(1) can
decompress archives produced by this program.

The program stores a filename, comment, and SHA-1 checksum for each file. Other programs
may omit these, but this program will still be able to decompress them. This program
follows the convention that if the name is omitted, then the contents should be appended
to the previous file. If the first filename is omitted, then you must supply it on the
command line during extraction. Each filename on the command line replaces one named file
in the archive.

head2 Commands

a[N]
Append to archive.

Value N regulates the speed of compression using the specified digit: 1 (fast, less
compression), 2 (medium, default), 3 (best, highest compression).

c[N]
Create archive.

Value N regulates the speed of compression using the specified digit: 1 (fast, less
compression), 2 (medium, default), 3 (best, highest compression).

e[N]
Extract to current directory.

With N, extract only block N (1, 2, 3...), where 1 is the first block. Otherwise all
blocks are extracted. The l command shows which files are in each block.

l List contents of archive.

x[N]
Extract with full path names (files... overrides stored names).

With N, extract only block N (1, 2, 3...), where 1 is the first block. Otherwise all
blocks are extracted. The l command shows which files are in each block.

OPTIONS

       None.

EXAMPLES

Create
The archive name must end with .zpaq. All commands will add the extension automatically if
you don't specify it.

To create an archive:

zp c3 archive.zpaq files ...

File names are stored in the archive as they appear on the command line. If you specify a
path to a different directory, the path is stored, and created during extraction. The e
command extracts to the current directory.

Append
To (a)ppend to an existing archive. If the archive does not exist then it is created as
with the c command. The files are grouped into blocks (solid archive) for each command
(see l command).

zp a3 archive.zpaq files ...

List
To list the contents of an archive. Files are listed in the same block order they were
added:

zp l archive.zpaq

Extract
To extract the contents of the archive:

zp x archive.zpaq

To extract specific block (see l command output):

zp x1 archive.zpaq

Blocks are "solid" which means you cannot extract files within a block without extracting
the earlier files. To extract first file in block under another name:

zp x1 archive.zpaq other-name

Program will not overwrite existing files during extraction unless you specify the
filenames on the command line:

zp x archive.zpaq (Error: file1 exists)
zp x archive.zpaq file1 file2 (Overwrite file1, file2)

ENVIRONMENT

       PATH is checked for detecting if slash conversions are required. An empty value will
       disable conversions.

FILES

       None.

STANDARDS

       See zpaq*.pdf (ZPAQ Level 1 and later) in section AVAILABILITY. It is anticipated that
       future levels (ZPAQ-2, ZPAQ-3, etc.) will be backward compatible, such that newer levels
       can read archives produced by older programs.

AVAILABILITY

       http://mattmahoney.net/dc

AUTHORS

       Program was written by Matt Mahoney <matmahoney@yahoo.com>

       This manual page was written by Jari Aalto <jari.aalto@cante.net>.  Released under license
       GNU GPL version 3 or (at your option) any later version. For more information about
       license, visit <http://www.gnu.org/copyleft/gpl.html>.