1999-08-28 23:10:20 +00:00
|
|
|
.\" $FreeBSD$
|
|
|
|
|
.\"
|
2002-03-11 22:36:26 +00:00
|
|
|
.TH ZLIB 3 "11 March 2002"
|
1998-02-28 06:04:26 +00:00
|
|
|
.SH NAME
|
|
|
|
|
zlib \- compression/decompression library
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
[see
|
|
|
|
|
.I zlib.h
|
|
|
|
|
for full description]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.I zlib
|
|
|
|
|
library is a general purpose data compression library.
|
|
|
|
|
The code is thread safe.
|
|
|
|
|
It provides in-memory compression and decompression functions,
|
|
|
|
|
including integrity checks of the uncompressed data.
|
|
|
|
|
This version of the library supports only one compression method (deflation)
|
|
|
|
|
but other algorithms will be added later and will have the same stream interface.
|
|
|
|
|
.LP
|
|
|
|
|
Compression can be done in a single step if the buffers are large enough
|
|
|
|
|
(for example if an input file is mmap'ed),
|
|
|
|
|
or can be done by repeated calls of the compression function.
|
|
|
|
|
In the latter case,
|
|
|
|
|
the application must provide more input and/or consume the output
|
|
|
|
|
(providing more output space) before each call.
|
|
|
|
|
.LP
|
|
|
|
|
The library also supports reading and writing files in
|
|
|
|
|
.I gzip
|
|
|
|
|
(.gz) format
|
|
|
|
|
with an interface similar to that of stdio.
|
|
|
|
|
.LP
|
2000-03-02 09:14:21 +00:00
|
|
|
The library does not install any signal handler.
|
|
|
|
|
The decoder checks
|
1998-02-28 06:04:26 +00:00
|
|
|
the consistency of the compressed data, so the library should never
|
|
|
|
|
crash even in case of corrupted input.
|
|
|
|
|
.LP
|
|
|
|
|
All functions of the compression library are documented in the file
|
|
|
|
|
.IR zlib.h.
|
|
|
|
|
The distribution source includes examples of use of the library
|
|
|
|
|
the files
|
|
|
|
|
.I example.c
|
|
|
|
|
and
|
|
|
|
|
.IR minigzip.c .
|
|
|
|
|
.LP
|
|
|
|
|
A Java implementation of
|
|
|
|
|
.IR zlib
|
|
|
|
|
is available in the Java Development Kit 1.1
|
|
|
|
|
.IP
|
|
|
|
|
http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html
|
|
|
|
|
.LP
|
|
|
|
|
A Perl interface to
|
|
|
|
|
.IR zlib ,
|
|
|
|
|
written by Paul Marquess (pmarquess@bfsec.bt.co.uk)
|
|
|
|
|
is available at CPAN (Comprehensive Perl Archive Network) sites,
|
|
|
|
|
such as:
|
|
|
|
|
.IP
|
|
|
|
|
ftp://ftp.cis.ufl.edu/pub/perl/CPAN/modules/by-module/Compress/Compress-Zlib*
|
|
|
|
|
.LP
|
|
|
|
|
A Python interface to
|
|
|
|
|
.IR zlib
|
|
|
|
|
written by A.M. Kuchling <amk@magnet.com>
|
|
|
|
|
is available from the Python Software Association sites, such as:
|
|
|
|
|
.IP
|
|
|
|
|
ftp://ftp.python.org/pub/python/contrib/Encoding/zlib*.tar.gz
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
Questions about zlib should be sent to:
|
|
|
|
|
.IP
|
|
|
|
|
zlib@quest.jpl.nasa.gov
|
|
|
|
|
or, if this fails, to the author addresses given below.
|
|
|
|
|
The zlib home page is:
|
|
|
|
|
.IP
|
2003-06-26 20:05:47 +00:00
|
|
|
http://www.gzip.org/zlib/
|
1998-02-28 06:04:26 +00:00
|
|
|
.LP
|
|
|
|
|
The data format used by the zlib library is described by RFC
|
2001-07-15 07:53:42 +00:00
|
|
|
(Request for Comments) 1950 to 1952 in the files:
|
1998-02-28 06:04:26 +00:00
|
|
|
.IP
|
|
|
|
|
ftp://ds.internic.net/rfc/rfc1950.txt (zlib format)
|
|
|
|
|
.br
|
|
|
|
|
rfc1951.txt (deflate format)
|
|
|
|
|
.br
|
|
|
|
|
rfc1952.txt (gzip format)
|
|
|
|
|
.LP
|
|
|
|
|
These documents are also available in other formats from:
|
|
|
|
|
.IP
|
|
|
|
|
ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html
|
|
|
|
|
.SH AUTHORS
|
2002-03-11 22:36:26 +00:00
|
|
|
Version 1.1.4
|
|
|
|
|
Copyright (C) 1995-2002 Jean-loup Gailly (jloup@gzip.org)
|
1998-02-28 06:04:26 +00:00
|
|
|
and Mark Adler (madler@alumni.caltech.edu).
|
|
|
|
|
.LP
|
|
|
|
|
This software is provided "as-is,"
|
|
|
|
|
without any express or implied warranty.
|
|
|
|
|
In no event will the authors be held liable for any damages
|
|
|
|
|
arising from the use of this software.
|
|
|
|
|
See the distribution directory with respect to requirements
|
|
|
|
|
governing redistribution.
|
|
|
|
|
The deflate format used by
|
|
|
|
|
.I zlib
|
|
|
|
|
was defined by Phil Katz.
|
|
|
|
|
The deflate and
|
|
|
|
|
.I zlib
|
1999-01-10 09:47:00 +00:00
|
|
|
specifications were written by L. Peter Deutsch.
|
1998-02-28 06:04:26 +00:00
|
|
|
Thanks to all the people who reported problems and suggested various
|
|
|
|
|
improvements in
|
|
|
|
|
.IR zlib ;
|
|
|
|
|
who are too numerous to cite here.
|
|
|
|
|
.LP
|
|
|
|
|
UNIX manual page by R. P. C. Rodgers,
|
|
|
|
|
U.S. National Library of Medicine (rodgers@nlm.nih.gov).
|
|
|
|
|
.\" end of man page
|
