1152521SpjdZLIB DATA COMPRESSION LIBRARY 2127412Sgad 3127412Sgadzlib 1.2.8 is a general purpose data compression library. All the code is 4127412Sgadthread safe. The data format used by the zlib library is described by RFCs 5152518Spjd(Request for Comments) 1950 to 1952 in the files 6127412Sgadhttp://tools.ietf.org/html/rfc1950 (zlib format), rfc1951 (deflate format) and 7127412Sgadrfc1952 (gzip format). 8127412Sgad 9127412SgadAll functions of the compression library are documented in the file zlib.h 10127412Sgad(volunteer to write man pages welcome, contact zlib@gzip.org). A usage example 11127412Sgadof the library is given in the file test/example.c which also tests that 12127412Sgadthe library is working correctly. Another example is given in the file 13127412Sgadtest/minigzip.c. The compression library itself is composed of all source 14127412Sgadfiles in the root directory. 15127412Sgad 16127412SgadTo compile all files and run the test program, follow the instructions given at 17127412Sgadthe top of Makefile.in. In short "./configure; make test", and if that goes 18127412Sgadwell, "make install" should work for most flavors of Unix. For Windows, use 19127412Sgadone of the special makefiles in win32/ or contrib/vstudio/ . For VMS, use 20127412Sgadmake_vms.com. 21127412Sgad 22127412SgadQuestions about zlib should be sent to <zlib@gzip.org>, or to Gilles Vollant 23127412Sgad<info@winimage.com> for the Windows DLL version. The zlib home page is 24127412Sgadhttp://zlib.net/ . Before reporting a problem, please check this site to 25127412Sgadverify that you have the latest version of zlib; otherwise get the latest 26127412Sgadversion and check whether the problem still exists or not. 27127412Sgad 28127412SgadPLEASE read the zlib FAQ http://zlib.net/zlib_faq.html before asking for help. 29127412Sgad 30127412SgadMark Nelson <markn@ieee.org> wrote an article about zlib for the Jan. 1997 31127412Sgadissue of Dr. Dobb's Journal; a copy of the article is available at 32127412Sgadhttp://marknelson.us/1997/01/01/zlib-engine/ . 33127412Sgad 34127412SgadThe changes made in version 1.2.8 are documented in the file ChangeLog. 35127412Sgad 36127412SgadUnsupported third party contributions are provided in directory contrib/ . 37127412Sgad 38127412Sgadzlib is available in Java using the java.util.zip package, documented at 39127412Sgadhttp://java.sun.com/developer/technicalArticles/Programming/compression/ . 40127412Sgad 41127412SgadA Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is available 42143878Spjdat CPAN (Comprehensive Perl Archive Network) sites, including 43127425Sgadhttp://search.cpan.org/~pmqs/IO-Compress-Zlib/ . 44127412Sgad 45203802SpjdA Python interface to zlib written by A.M. Kuchling <amk@amk.ca> is 46127412Sgadavailable in Python 1.5 and later versions, see 47127412Sgadhttp://docs.python.org/library/zlib.html . 48127412Sgad 49127425Sgadzlib is built into tcl: http://wiki.tcl.tk/4610 . 50127412Sgad 51127412SgadAn experimental package to read and write files in .zip format, written on top 52127412Sgadof zlib by Gilles Vollant <info@winimage.com>, is available in the 53127412Sgadcontrib/minizip directory of zlib. 54127412Sgad 55127425Sgad 56127412SgadNotes for some targets: 57127412Sgad 58127412Sgad- For Windows DLL versions, please see win32/DLL_FAQ.txt 59127412Sgad 60127412Sgad- For 64-bit Irix, deflate.c must be compiled without any optimization. With 61132198Stjr -O, one libpng test fails. The test works in 32 bit mode (with the -n32 62127412Sgad compiler flag). The compiler bug has been reported to SGI. 63127412Sgad 64127412Sgad- zlib doesn't work with gcc 2.6.3 on a DEC 3000/300LX under OSF/1 2.1 it works 65127412Sgad when compiled with cc. 66127412Sgad 67127412Sgad- On Digital Unix 4.0D (formely OSF/1) on AlphaServer, the cc option -std1 is 68143874Spjd necessary to get gzprintf working correctly. This is done by configure. 69143874Spjd 70143874Spjd- zlib doesn't work on HP-UX 9.05 with some versions of /bin/cc. It works with 71143877Spjd other compilers. Use "make test" to check your compiler. 72143877Spjd 73143877Spjd- gzdopen is not supported on RISCOS or BEOS. 74127425Sgad 75127412Sgad- For PalmOs, see http://palmzlib.sourceforge.net/ 76127412Sgad 77127412Sgad 78127412SgadAcknowledgments: 79127412Sgad 80127412Sgad The deflate format used by zlib was defined by Phil Katz. The deflate and 81164558Syar zlib specifications were written by L. Peter Deutsch. Thanks to all the 82254134Strasz people who reported problems and suggested various improvements in zlib; they 83254134Strasz are too numerous to cite here. 84127412Sgad 85127412SgadCopyright notice: 86127412Sgad 87127412Sgad (C) 1995-2013 Jean-loup Gailly and Mark Adler 88127412Sgad 89254134Strasz This software is provided 'as-is', without any express or implied 90127412Sgad warranty. In no event will the authors be held liable for any damages 91127412Sgad arising from the use of this software. 92127412Sgad 93127412Sgad Permission is granted to anyone to use this software for any purpose, 94152521Spjd including commercial applications, and to alter it and redistribute it 95152521Spjd freely, subject to the following restrictions: 96152521Spjd 97152521Spjd 1. The origin of this software must not be misrepresented; you must not 98152521Spjd claim that you wrote the original software. If you use this software 99152521Spjd in a product, an acknowledgment in the product documentation would be 100152521Spjd appreciated but is not required. 101152521Spjd 2. Altered source versions must be plainly marked as such, and must not be 102152521Spjd misrepresented as being the original software. 103152521Spjd 3. This notice may not be removed or altered from any source distribution. 104152521Spjd 105152521Spjd Jean-loup Gailly Mark Adler 106152521Spjd jloup@gzip.org madler@alumni.caltech.edu 107152521Spjd 108152521SpjdIf you use the zlib library in a product, we would appreciate *not* receiving 109203802Spjdlengthy legal documents to sign. The sources are provided for free but without 110152521Spjdwarranty of any kind. The library has been entirely written by Jean-loup 111152521SpjdGailly and Mark Adler; it does not include third-party code. 112127412Sgad 113201145SantoineIf you redistribute modified sources, we would appreciate that you include in 114201145Santoinethe file ChangeLog history information documenting your changes. Please read 115201145Santoinethe FAQ for more information on the distribution of modified source versions. 116201145Santoine