cannam@128: .TH ZLIB 3 "28 Apr 2013"
cannam@128: .SH NAME
cannam@128: zlib \- compression/decompression library
cannam@128: .SH SYNOPSIS
cannam@128: [see
cannam@128: .I zlib.h
cannam@128: for full description]
cannam@128: .SH DESCRIPTION
cannam@128: The
cannam@128: .I zlib
cannam@128: library is a general purpose data compression library.
cannam@128: The code is thread safe, assuming that the standard library functions
cannam@128: used are thread safe, such as memory allocation routines.
cannam@128: It provides in-memory compression and decompression functions,
cannam@128: including integrity checks of the uncompressed data.
cannam@128: This version of the library supports only one compression method (deflation)
cannam@128: but other algorithms may be added later
cannam@128: with the same stream interface.
cannam@128: .LP
cannam@128: Compression can be done in a single step if the buffers are large enough
cannam@128: or can be done by repeated calls of the compression function.
cannam@128: In the latter case,
cannam@128: the application must provide more input and/or consume the output
cannam@128: (providing more output space) before each call.
cannam@128: .LP
cannam@128: The library also supports reading and writing files in
cannam@128: .IR gzip (1)
cannam@128: (.gz) format
cannam@128: with an interface similar to that of stdio.
cannam@128: .LP
cannam@128: The library does not install any signal handler.
cannam@128: The decoder checks the consistency of the compressed data,
cannam@128: so the library should never crash even in the case of corrupted input.
cannam@128: .LP
cannam@128: All functions of the compression library are documented in the file
cannam@128: .IR zlib.h .
cannam@128: The distribution source includes examples of use of the library
cannam@128: in the files
cannam@128: .I test/example.c
cannam@128: and
cannam@128: .IR test/minigzip.c,
cannam@128: as well as other examples in the
cannam@128: .IR examples/
cannam@128: directory.
cannam@128: .LP
cannam@128: Changes to this version are documented in the file
cannam@128: .I ChangeLog
cannam@128: that accompanies the source.
cannam@128: .LP
cannam@128: .I zlib
cannam@128: is available in Java using the java.util.zip package:
cannam@128: .IP
cannam@128: http://java.sun.com/developer/technicalArticles/Programming/compression/
cannam@128: .LP
cannam@128: A Perl interface to
cannam@128: .IR zlib ,
cannam@128: written by Paul Marquess (pmqs@cpan.org),
cannam@128: is available at CPAN (Comprehensive Perl Archive Network) sites,
cannam@128: including:
cannam@128: .IP
cannam@128: http://search.cpan.org/~pmqs/IO-Compress-Zlib/
cannam@128: .LP
cannam@128: A Python interface to
cannam@128: .IR zlib ,
cannam@128: written by A.M. Kuchling (amk@magnet.com),
cannam@128: is available in Python 1.5 and later versions:
cannam@128: .IP
cannam@128: http://docs.python.org/library/zlib.html
cannam@128: .LP
cannam@128: .I zlib
cannam@128: is built into
cannam@128: .IR tcl:
cannam@128: .IP
cannam@128: http://wiki.tcl.tk/4610
cannam@128: .LP
cannam@128: An experimental package to read and write files in .zip format,
cannam@128: written on top of
cannam@128: .I zlib
cannam@128: by Gilles Vollant (info@winimage.com),
cannam@128: is available at:
cannam@128: .IP
cannam@128: http://www.winimage.com/zLibDll/minizip.html
cannam@128: and also in the
cannam@128: .I contrib/minizip
cannam@128: directory of the main
cannam@128: .I zlib
cannam@128: source distribution.
cannam@128: .SH "SEE ALSO"
cannam@128: The
cannam@128: .I zlib
cannam@128: web site can be found at:
cannam@128: .IP
cannam@128: http://zlib.net/
cannam@128: .LP
cannam@128: The data format used by the zlib library is described by RFC
cannam@128: (Request for Comments) 1950 to 1952 in the files:
cannam@128: .IP
cannam@128: http://tools.ietf.org/html/rfc1950 (for the zlib header and trailer format)
cannam@128: .br
cannam@128: http://tools.ietf.org/html/rfc1951 (for the deflate compressed data format)
cannam@128: .br
cannam@128: http://tools.ietf.org/html/rfc1952 (for the gzip header and trailer format)
cannam@128: .LP
cannam@128: Mark Nelson wrote an article about
cannam@128: .I zlib
cannam@128: for the Jan. 1997 issue of  Dr. Dobb's Journal;
cannam@128: a copy of the article is available at:
cannam@128: .IP
cannam@128: http://marknelson.us/1997/01/01/zlib-engine/
cannam@128: .SH "REPORTING PROBLEMS"
cannam@128: Before reporting a problem,
cannam@128: please check the
cannam@128: .I zlib
cannam@128: web site to verify that you have the latest version of
cannam@128: .IR zlib ;
cannam@128: otherwise,
cannam@128: obtain the latest version and see if the problem still exists.
cannam@128: Please read the
cannam@128: .I zlib
cannam@128: FAQ at:
cannam@128: .IP
cannam@128: http://zlib.net/zlib_faq.html
cannam@128: .LP
cannam@128: before asking for help.
cannam@128: Send questions and/or comments to zlib@gzip.org,
cannam@128: or (for the Windows DLL version) to Gilles Vollant (info@winimage.com).
cannam@128: .SH AUTHORS
cannam@128: Version 1.2.8
cannam@128: Copyright (C) 1995-2013 Jean-loup Gailly (jloup@gzip.org)
cannam@128: and Mark Adler (madler@alumni.caltech.edu).
cannam@128: .LP
cannam@128: This software is provided "as-is,"
cannam@128: without any express or implied warranty.
cannam@128: In no event will the authors be held liable for any damages
cannam@128: arising from the use of this software.
cannam@128: See the distribution directory with respect to requirements
cannam@128: governing redistribution.
cannam@128: The deflate format used by
cannam@128: .I zlib
cannam@128: was defined by Phil Katz.
cannam@128: The deflate and
cannam@128: .I zlib
cannam@128: specifications were written by L. Peter Deutsch.
cannam@128: Thanks to all the people who reported problems and suggested various
cannam@128: improvements in
cannam@128: .IR zlib ;
cannam@128: who are too numerous to cite here.
cannam@128: .LP
cannam@128: UNIX manual page by R. P. C. Rodgers,
cannam@128: U.S. National Library of Medicine (rodgers@nlm.nih.gov).
cannam@128: .\" end of man page