199767f8919635c4928607450d9e0abb932109ceToomas SoomeZLIB DATA COMPRESSION LIBRARY
199767f8919635c4928607450d9e0abb932109ceToomas Soomezlib 1.2.8 is a general purpose data compression library. All the code is
199767f8919635c4928607450d9e0abb932109ceToomas Soomethread safe. The data format used by the zlib library is described by RFCs
199767f8919635c4928607450d9e0abb932109ceToomas Soome(Request for Comments) 1950 to 1952 in the files
199767f8919635c4928607450d9e0abb932109ceToomas Soomehttp://tools.ietf.org/html/rfc1950 (zlib format), rfc1951 (deflate format) and
199767f8919635c4928607450d9e0abb932109ceToomas Soomerfc1952 (gzip format).
199767f8919635c4928607450d9e0abb932109ceToomas SoomeAll functions of the compression library are documented in the file zlib.h
199767f8919635c4928607450d9e0abb932109ceToomas Soome(volunteer to write man pages welcome, contact zlib@gzip.org). A usage example
199767f8919635c4928607450d9e0abb932109ceToomas Soomeof the library is given in the file test/example.c which also tests that
199767f8919635c4928607450d9e0abb932109ceToomas Soomethe library is working correctly. Another example is given in the file
199767f8919635c4928607450d9e0abb932109ceToomas Soometest/minigzip.c. The compression library itself is composed of all source
199767f8919635c4928607450d9e0abb932109ceToomas Soomefiles in the root directory.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeTo compile all files and run the test program, follow the instructions given at
199767f8919635c4928607450d9e0abb932109ceToomas Soomethe top of Makefile.in. In short "./configure; make test", and if that goes
199767f8919635c4928607450d9e0abb932109ceToomas Soomewell, "make install" should work for most flavors of Unix. For Windows, use
199767f8919635c4928607450d9e0abb932109ceToomas Soomeone of the special makefiles in win32/ or contrib/vstudio/ . For VMS, use
199767f8919635c4928607450d9e0abb932109ceToomas SoomeQuestions about zlib should be sent to <zlib@gzip.org>, or to Gilles Vollant
199767f8919635c4928607450d9e0abb932109ceToomas Soome<info@winimage.com> for the Windows DLL version. The zlib home page is
199767f8919635c4928607450d9e0abb932109ceToomas Soomehttp://zlib.net/ . Before reporting a problem, please check this site to
199767f8919635c4928607450d9e0abb932109ceToomas Soomeverify that you have the latest version of zlib; otherwise get the latest
199767f8919635c4928607450d9e0abb932109ceToomas Soomeversion and check whether the problem still exists or not.
199767f8919635c4928607450d9e0abb932109ceToomas SoomePLEASE read the zlib FAQ http://zlib.net/zlib_faq.html before asking for help.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeMark Nelson <markn@ieee.org> wrote an article about zlib for the Jan. 1997
199767f8919635c4928607450d9e0abb932109ceToomas Soomeissue of Dr. Dobb's Journal; a copy of the article is available at
199767f8919635c4928607450d9e0abb932109ceToomas SoomeThe changes made in version 1.2.8 are documented in the file ChangeLog.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeUnsupported third party contributions are provided in directory contrib/ .
199767f8919635c4928607450d9e0abb932109ceToomas Soomezlib is available in Java using the java.util.zip package, documented at
199767f8919635c4928607450d9e0abb932109ceToomas Soomehttp://java.sun.com/developer/technicalArticles/Programming/compression/ .
199767f8919635c4928607450d9e0abb932109ceToomas SoomeA Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is available
199767f8919635c4928607450d9e0abb932109ceToomas Soomeat CPAN (Comprehensive Perl Archive Network) sites, including
199767f8919635c4928607450d9e0abb932109ceToomas Soomehttp://search.cpan.org/~pmqs/IO-Compress-Zlib/ .
199767f8919635c4928607450d9e0abb932109ceToomas SoomeA Python interface to zlib written by A.M. Kuchling <amk@amk.ca> is
199767f8919635c4928607450d9e0abb932109ceToomas Soomeavailable in Python 1.5 and later versions, see
199767f8919635c4928607450d9e0abb932109ceToomas Soomezlib is built into tcl: http://wiki.tcl.tk/4610 .
199767f8919635c4928607450d9e0abb932109ceToomas SoomeAn experimental package to read and write files in .zip format, written on top
199767f8919635c4928607450d9e0abb932109ceToomas Soomeof zlib by Gilles Vollant <info@winimage.com>, is available in the
199767f8919635c4928607450d9e0abb932109ceToomas Soomecontrib/minizip directory of zlib.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeNotes for some targets:
199767f8919635c4928607450d9e0abb932109ceToomas Soome- For Windows DLL versions, please see win32/DLL_FAQ.txt
199767f8919635c4928607450d9e0abb932109ceToomas Soome- For 64-bit Irix, deflate.c must be compiled without any optimization. With
199767f8919635c4928607450d9e0abb932109ceToomas Soome -O, one libpng test fails. The test works in 32 bit mode (with the -n32
199767f8919635c4928607450d9e0abb932109ceToomas Soome compiler flag). The compiler bug has been reported to SGI.
199767f8919635c4928607450d9e0abb932109ceToomas Soome- zlib doesn't work with gcc 2.6.3 on a DEC 3000/300LX under OSF/1 2.1 it works
199767f8919635c4928607450d9e0abb932109ceToomas Soome when compiled with cc.
199767f8919635c4928607450d9e0abb932109ceToomas Soome- On Digital Unix 4.0D (formely OSF/1) on AlphaServer, the cc option -std1 is
199767f8919635c4928607450d9e0abb932109ceToomas Soome necessary to get gzprintf working correctly. This is done by configure.
199767f8919635c4928607450d9e0abb932109ceToomas Soome- zlib doesn't work on HP-UX 9.05 with some versions of /bin/cc. It works with
199767f8919635c4928607450d9e0abb932109ceToomas Soome other compilers. Use "make test" to check your compiler.
199767f8919635c4928607450d9e0abb932109ceToomas Soome- gzdopen is not supported on RISCOS or BEOS.
199767f8919635c4928607450d9e0abb932109ceToomas Soome- For PalmOs, see http://palmzlib.sourceforge.net/
199767f8919635c4928607450d9e0abb932109ceToomas SoomeAcknowledgments:
199767f8919635c4928607450d9e0abb932109ceToomas Soome The deflate format used by zlib was defined by Phil Katz. The deflate and
199767f8919635c4928607450d9e0abb932109ceToomas Soome zlib specifications were written by L. Peter Deutsch. Thanks to all the
199767f8919635c4928607450d9e0abb932109ceToomas Soome people who reported problems and suggested various improvements in zlib; they
199767f8919635c4928607450d9e0abb932109ceToomas Soome are too numerous to cite here.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeCopyright notice:
199767f8919635c4928607450d9e0abb932109ceToomas Soome (C) 1995-2013 Jean-loup Gailly and Mark Adler
199767f8919635c4928607450d9e0abb932109ceToomas Soome This software is provided 'as-is', without any express or implied
199767f8919635c4928607450d9e0abb932109ceToomas Soome warranty. In no event will the authors be held liable for any damages
199767f8919635c4928607450d9e0abb932109ceToomas Soome arising from the use of this software.
199767f8919635c4928607450d9e0abb932109ceToomas Soome Permission is granted to anyone to use this software for any purpose,
199767f8919635c4928607450d9e0abb932109ceToomas Soome including commercial applications, and to alter it and redistribute it
199767f8919635c4928607450d9e0abb932109ceToomas Soome freely, subject to the following restrictions:
199767f8919635c4928607450d9e0abb932109ceToomas Soome 1. The origin of this software must not be misrepresented; you must not
199767f8919635c4928607450d9e0abb932109ceToomas Soome claim that you wrote the original software. If you use this software
199767f8919635c4928607450d9e0abb932109ceToomas Soome in a product, an acknowledgment in the product documentation would be
199767f8919635c4928607450d9e0abb932109ceToomas Soome appreciated but is not required.
199767f8919635c4928607450d9e0abb932109ceToomas Soome 2. Altered source versions must be plainly marked as such, and must not be
199767f8919635c4928607450d9e0abb932109ceToomas Soome misrepresented as being the original software.
199767f8919635c4928607450d9e0abb932109ceToomas Soome 3. This notice may not be removed or altered from any source distribution.
199767f8919635c4928607450d9e0abb932109ceToomas Soome Jean-loup Gailly Mark Adler
199767f8919635c4928607450d9e0abb932109ceToomas Soome jloup@gzip.org madler@alumni.caltech.edu
199767f8919635c4928607450d9e0abb932109ceToomas SoomeIf you use the zlib library in a product, we would appreciate *not* receiving
199767f8919635c4928607450d9e0abb932109ceToomas Soomelengthy legal documents to sign. The sources are provided for free but without
199767f8919635c4928607450d9e0abb932109ceToomas Soomewarranty of any kind. The library has been entirely written by Jean-loup
199767f8919635c4928607450d9e0abb932109ceToomas SoomeGailly and Mark Adler; it does not include third-party code.
199767f8919635c4928607450d9e0abb932109ceToomas SoomeIf you redistribute modified sources, we would appreciate that you include in
199767f8919635c4928607450d9e0abb932109ceToomas Soomethe file ChangeLog history information documenting your changes. Please read
199767f8919635c4928607450d9e0abb932109ceToomas Soomethe FAQ for more information on the distribution of modified source versions.