home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue6 / SDL.ZIP / !LibU / man / zlib.3 < prev   
Encoding:
Text File  |  2006-09-20  |  6.3 KB  |  181 lines
  1. <!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
  2. <!-- available at http://polyglotman.sourceforge.net/ -->
  3.  
  4. <html>
  5. <head>
  6. <title>ZLIB(3) manual page</title>
  7. </head>
  8. <body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
  9. <a href='#toc'>Table of Contents</a><p>
  10.  
  11. <h2><a name='sect0' href='#toc0'>Name</a></h2>
  12. zlib - compression/decompression library 
  13. <h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
  14. [see <i>zlib.h</i> for full
  15. description] 
  16. <h2><a name='sect2' href='#toc2'>Description</a></h2>
  17. The <i>zlib</i> library is a general purpose data compression
  18. library. The code is thread safe. It provides in-memory compression and decompression
  19. functions, including integrity checks of the uncompressed data. This version
  20. of the library supports only one compression method (deflation) but other
  21. algorithms will be added later and will have the same stream interface.
  22. <p>
  23. Compression can be done in a single step if the buffers are large enough
  24. (for example if an input file is mmap'ed), or can be done by repeated calls
  25. of the compression function. In the latter case, the application must provide
  26. more input and/or consume the output (providing more output space) before
  27. each call. <p>
  28. The library also supports reading and writing files in <a href='gzip.1.html'><i>gzip</i>(1)</a>
  29.  
  30. (.gz) format with an interface similar to that of stdio. <p>
  31. The library does
  32. not install any signal handler. The decoder checks the consistency of the
  33. compressed data, so the library should never crash even in case of corrupted
  34. input. <p>
  35. All functions of the compression library are documented in the file
  36. <i>zlib.h</i>. The distribution source includes examples of use of the library in
  37. the files <i>example.c</i> and <i>minigzip.c</i>. <p>
  38. Changes to this version are documented
  39. in the file <i>ChangeLog</i> that accompanies the source, and are concerned primarily
  40. with bug fixes and portability enhancements. <p>
  41. A Java implementation of <i>zlib</i>
  42. is available in the Java Development Kit 1.1: 
  43. <dl>
  44.  
  45. <dt><a href='http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html'>http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html</a>
  46.  
  47. </dt>
  48. <dd></dd>
  49. </dl>
  50. <p>
  51. A Perl interface to <i>zlib</i>, written by Paul Marquess (pmqs@cpan.org), is available
  52. at CPAN (Comprehensive Perl Archive Network) sites, including: 
  53. <dl>
  54.  
  55. <dt><a href='http://www.cpan.org/modules/by-module/Compress/'><a href='http://www.cpan.org/modules/by-module/Compress/'>http://www.cpan.org/modules/by-module/Compress/</a>
  56. </a>
  57.  
  58. </dt>
  59. <dd></dd>
  60. </dl>
  61. <p>
  62. A Python interface to <i>zlib</i>, written by A.M. Kuchling (amk@magnet.com), is
  63. available in Python 1.5 and later versions: 
  64. <dl>
  65.  
  66. <dt><a href='http://www.python.org/doc/lib/module-zlib.html'>http://www.python.org/doc/lib/module-zlib.html</a>
  67.  
  68. </dt>
  69. <dd></dd>
  70. </dl>
  71. <p>
  72. A <i>zlib</i> binding for <a href='tcl.1.html'><i>tcl</i>(1)</a>
  73. , written by Andreas Kupries (a.kupries@westend.com),
  74. is availlable at: 
  75. <dl>
  76.  
  77. <dt><a href='http://www.westend.com/~kupries/doc/trf/man/man.html'>http://www.westend.com/~kupries/doc/trf/man/man.html</a>
  78.  </dt>
  79. <dd></dd>
  80. </dl>
  81. <p>
  82. An
  83. experimental package to read and write files in .zip format, written on
  84. top of <i>zlib</i> by Gilles Vollant (info@winimage.com), is available at: 
  85. <dl>
  86.  
  87. <dt><a href='http://www.winimage.com/zLibDll/unzip.html'>http://www.winimage.com/zLibDll/unzip.html</a>
  88.  
  89. </dt>
  90. <dd>and also in the <i>contrib/minizip</i> directory of the main <i>zlib</i> web site. </dd>
  91. </dl>
  92.  
  93. <h2><a name='sect3' href='#toc3'>See
  94. Also</a></h2>
  95. The <i>zlib</i> web site can be found at either of these locations: 
  96. <dl>
  97.  
  98. <dt><a href='http://www.zlib.org'>http://www.zlib.org</a>
  99.  
  100. </dt>
  101. <dd><br>
  102. <a href='http://www.gzip.org/zlib/'>http://www.gzip.org/zlib/</a>
  103.  </dd>
  104. </dl>
  105. <p>
  106. The data format used by the zlib library is described
  107. by RFC (Request for Comments) 1950 to 1952 in the files: 
  108. <dl>
  109.  
  110. <dt>http://www.ietf.org/rfc/rfc1950.txt
  111. (concerning zlib format) </dt>
  112. <dd><br>
  113. http://www.ietf.org/rfc/rfc1951.txt (concerning deflate format) <br>
  114. http://www.ietf.org/rfc/rfc1952.txt (concerning gzip format) </dd>
  115. </dl>
  116. <p>
  117. These documents
  118. are also available in other formats from: 
  119. <dl>
  120.  
  121. <dt>ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html
  122. </dt>
  123. <dd></dd>
  124. </dl>
  125. <p>
  126. Mark Nelson (markn@ieee.org) wrote an article about <i>zlib</i> for the Jan. 1997
  127. issue of  Dr. Dobb's Journal; a copy of the article is available at: 
  128. <dl>
  129.  
  130. <dt><a href='http://dogma.net/markn/articles/zlibtool/zlibtool.htm'>http://dogma.net/markn/articles/zlibtool/zlibtool.htm</a>
  131.  
  132. </dt>
  133. <dd></dd>
  134. </dl>
  135.  
  136. <h2><a name='sect4' href='#toc4'>Reporting Problems</a></h2>
  137. Before reporting a problem, please check the <i>zlib</i> web
  138. site to verify that you have the latest version of <i>zlib</i>; otherwise, obtain
  139. the latest version and see if the problem still exists. Please read the
  140. <i>zlib</i> FAQ at: 
  141. <dl>
  142.  
  143. <dt><a href='http://www.gzip.org/zlib/zlib_faq.html'>http://www.gzip.org/zlib/zlib_faq.html</a>
  144.  </dt>
  145. <dd></dd>
  146. </dl>
  147. <p>
  148. before asking for help.
  149. Send questions and/or comments to zlib@gzip.org, or (for the Windows DLL
  150. version) to Gilles Vollant (info@winimage.com). 
  151. <h2><a name='sect5' href='#toc5'>Authors</a></h2>
  152. Version 1.2.3 Copyright
  153. (C) 1995-2005 Jean-loup Gailly (jloup@gzip.org) and Mark Adler (madler@alumni.caltech.edu).
  154. <p>
  155. This software is provided "as-is," without any express or implied warranty.
  156. In no event will the authors be held liable for any damages arising from
  157. the use of this software. See the distribution directory with respect to
  158. requirements governing redistribution. The deflate format used by <i>zlib</i> was
  159. defined by Phil Katz. The deflate and <i>zlib</i> specifications were written by
  160. L. Peter Deutsch. Thanks to all the people who reported problems and suggested
  161. various improvements in <i>zlib</i>; who are too numerous to cite here. <p>
  162. UNIX manual
  163. page by R. P. C. Rodgers, U.S. National Library of Medicine (rodgers@nlm.nih.gov).
  164.  
  165. <!--
  166.   end of man page
  167.  <p>
  168.  
  169. <hr><p>
  170. <a name='toc'><b>Table of Contents</b></a><p>
  171. <ul>
  172. <li><a name='toc0' href='#sect0'>Name</a></li>
  173. <li><a name='toc1' href='#sect1'>Synopsis</a></li>
  174. <li><a name='toc2' href='#sect2'>Description</a></li>
  175. <li><a name='toc3' href='#sect3'>See Also</a></li>
  176. <li><a name='toc4' href='#sect4'>Reporting Problems</a></li>
  177. <li><a name='toc5' href='#sect5'>Authors</a></li>
  178. </ul>
  179. </body>
  180. </html>
  181.