Mercurial > hg > CbC > CbC_gcc
comparison zlib/zlib.3 @ 111:04ced10e8804
gcc 7
author | kono |
---|---|
date | Fri, 27 Oct 2017 22:46:09 +0900 |
parents | ae3a4bfb450b |
children |
comparison
equal
deleted
inserted
replaced
68:561a7518be6b | 111:04ced10e8804 |
---|---|
1 .TH ZLIB 3 "18 July 2005" | 1 .TH ZLIB 3 "15 Jan 2017" |
2 .SH NAME | 2 .SH NAME |
3 zlib \- compression/decompression library | 3 zlib \- compression/decompression library |
4 .SH SYNOPSIS | 4 .SH SYNOPSIS |
5 [see | 5 [see |
6 .I zlib.h | 6 .I zlib.h |
7 for full description] | 7 for full description] |
8 .SH DESCRIPTION | 8 .SH DESCRIPTION |
9 The | 9 The |
10 .I zlib | 10 .I zlib |
11 library is a general purpose data compression library. | 11 library is a general purpose data compression library. |
12 The code is thread safe. | 12 The code is thread safe, assuming that the standard library functions |
13 used are thread safe, such as memory allocation routines. | |
13 It provides in-memory compression and decompression functions, | 14 It provides in-memory compression and decompression functions, |
14 including integrity checks of the uncompressed data. | 15 including integrity checks of the uncompressed data. |
15 This version of the library supports only one compression method (deflation) | 16 This version of the library supports only one compression method (deflation) |
16 but other algorithms will be added later | 17 but other algorithms may be added later |
17 and will have the same stream interface. | 18 with the same stream interface. |
18 .LP | 19 .LP |
19 Compression can be done in a single step if the buffers are large enough | 20 Compression can be done in a single step if the buffers are large enough |
20 (for example if an input file is mmap'ed), | |
21 or can be done by repeated calls of the compression function. | 21 or can be done by repeated calls of the compression function. |
22 In the latter case, | 22 In the latter case, |
23 the application must provide more input and/or consume the output | 23 the application must provide more input and/or consume the output |
24 (providing more output space) before each call. | 24 (providing more output space) before each call. |
25 .LP | 25 .LP |
28 (.gz) format | 28 (.gz) format |
29 with an interface similar to that of stdio. | 29 with an interface similar to that of stdio. |
30 .LP | 30 .LP |
31 The library does not install any signal handler. | 31 The library does not install any signal handler. |
32 The decoder checks the consistency of the compressed data, | 32 The decoder checks the consistency of the compressed data, |
33 so the library should never crash even in case of corrupted input. | 33 so the library should never crash even in the case of corrupted input. |
34 .LP | 34 .LP |
35 All functions of the compression library are documented in the file | 35 All functions of the compression library are documented in the file |
36 .IR zlib.h . | 36 .IR zlib.h . |
37 The distribution source includes examples of use of the library | 37 The distribution source includes examples of use of the library |
38 in the files | 38 in the files |
39 .I example.c | 39 .I test/example.c |
40 and | 40 and |
41 .IR minigzip.c . | 41 .IR test/minigzip.c, |
42 as well as other examples in the | |
43 .IR examples/ | |
44 directory. | |
42 .LP | 45 .LP |
43 Changes to this version are documented in the file | 46 Changes to this version are documented in the file |
44 .I ChangeLog | 47 .I ChangeLog |
45 that accompanies the source, | 48 that accompanies the source. |
46 and are concerned primarily with bug fixes and portability enhancements. | |
47 .LP | 49 .LP |
48 A Java implementation of | |
49 .I zlib | 50 .I zlib |
50 is available in the Java Development Kit 1.1: | 51 is built in to many languages and operating systems, including but not limited to |
51 .IP | 52 Java, Python, .NET, PHP, Perl, Ruby, Swift, and Go. |
52 http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html | |
53 .LP | 53 .LP |
54 A Perl interface to | 54 An experimental package to read and write files in the .zip format, |
55 .IR zlib , | |
56 written by Paul Marquess (pmqs@cpan.org), | |
57 is available at CPAN (Comprehensive Perl Archive Network) sites, | |
58 including: | |
59 .IP | |
60 http://www.cpan.org/modules/by-module/Compress/ | |
61 .LP | |
62 A Python interface to | |
63 .IR zlib , | |
64 written by A.M. Kuchling (amk@magnet.com), | |
65 is available in Python 1.5 and later versions: | |
66 .IP | |
67 http://www.python.org/doc/lib/module-zlib.html | |
68 .LP | |
69 A | |
70 .I zlib | |
71 binding for | |
72 .IR tcl (1), | |
73 written by Andreas Kupries (a.kupries@westend.com), | |
74 is availlable at: | |
75 .IP | |
76 http://www.westend.com/~kupries/doc/trf/man/man.html | |
77 .LP | |
78 An experimental package to read and write files in .zip format, | |
79 written on top of | 55 written on top of |
80 .I zlib | 56 .I zlib |
81 by Gilles Vollant (info@winimage.com), | 57 by Gilles Vollant (info@winimage.com), |
82 is available at: | 58 is available at: |
83 .IP | 59 .IP |
84 http://www.winimage.com/zLibDll/unzip.html | 60 http://www.winimage.com/zLibDll/minizip.html |
85 and also in the | 61 and also in the |
86 .I contrib/minizip | 62 .I contrib/minizip |
87 directory of the main | 63 directory of the main |
88 .I zlib | 64 .I zlib |
89 web site. | 65 source distribution. |
90 .SH "SEE ALSO" | 66 .SH "SEE ALSO" |
91 The | 67 The |
92 .I zlib | 68 .I zlib |
93 web site can be found at either of these locations: | 69 web site can be found at: |
94 .IP | 70 .IP |
95 http://www.zlib.org | 71 http://zlib.net/ |
96 .br | |
97 http://www.gzip.org/zlib/ | |
98 .LP | 72 .LP |
99 The data format used by the zlib library is described by RFC | 73 The data format used by the |
74 .I zlib | |
75 library is described by RFC | |
100 (Request for Comments) 1950 to 1952 in the files: | 76 (Request for Comments) 1950 to 1952 in the files: |
101 .IP | 77 .IP |
102 http://www.ietf.org/rfc/rfc1950.txt (concerning zlib format) | 78 http://tools.ietf.org/html/rfc1950 (for the zlib header and trailer format) |
103 .br | 79 .br |
104 http://www.ietf.org/rfc/rfc1951.txt (concerning deflate format) | 80 http://tools.ietf.org/html/rfc1951 (for the deflate compressed data format) |
105 .br | 81 .br |
106 http://www.ietf.org/rfc/rfc1952.txt (concerning gzip format) | 82 http://tools.ietf.org/html/rfc1952 (for the gzip header and trailer format) |
107 .LP | 83 .LP |
108 These documents are also available in other formats from: | 84 Mark Nelson wrote an article about |
109 .IP | |
110 ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html | |
111 .LP | |
112 Mark Nelson (markn@ieee.org) wrote an article about | |
113 .I zlib | 85 .I zlib |
114 for the Jan. 1997 issue of Dr. Dobb's Journal; | 86 for the Jan. 1997 issue of Dr. Dobb's Journal; |
115 a copy of the article is available at: | 87 a copy of the article is available at: |
116 .IP | 88 .IP |
117 http://dogma.net/markn/articles/zlibtool/zlibtool.htm | 89 http://marknelson.us/1997/01/01/zlib-engine/ |
118 .SH "REPORTING PROBLEMS" | 90 .SH "REPORTING PROBLEMS" |
119 Before reporting a problem, | 91 Before reporting a problem, |
120 please check the | 92 please check the |
121 .I zlib | 93 .I zlib |
122 web site to verify that you have the latest version of | 94 web site to verify that you have the latest version of |
125 obtain the latest version and see if the problem still exists. | 97 obtain the latest version and see if the problem still exists. |
126 Please read the | 98 Please read the |
127 .I zlib | 99 .I zlib |
128 FAQ at: | 100 FAQ at: |
129 .IP | 101 .IP |
130 http://www.gzip.org/zlib/zlib_faq.html | 102 http://zlib.net/zlib_faq.html |
131 .LP | 103 .LP |
132 before asking for help. | 104 before asking for help. |
133 Send questions and/or comments to zlib@gzip.org, | 105 Send questions and/or comments to zlib@gzip.org, |
134 or (for the Windows DLL version) to Gilles Vollant (info@winimage.com). | 106 or (for the Windows DLL version) to Gilles Vollant (info@winimage.com). |
135 .SH AUTHORS | 107 .SH AUTHORS AND LICENSE |
136 Version 1.2.3 | 108 Version 1.2.11 |
137 Copyright (C) 1995-2005 Jean-loup Gailly (jloup@gzip.org) | |
138 and Mark Adler (madler@alumni.caltech.edu). | |
139 .LP | 109 .LP |
140 This software is provided "as-is," | 110 Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler |
141 without any express or implied warranty. | 111 .LP |
142 In no event will the authors be held liable for any damages | 112 This software is provided 'as-is', without any express or implied |
113 warranty. In no event will the authors be held liable for any damages | |
143 arising from the use of this software. | 114 arising from the use of this software. |
144 See the distribution directory with respect to requirements | 115 .LP |
145 governing redistribution. | 116 Permission is granted to anyone to use this software for any purpose, |
117 including commercial applications, and to alter it and redistribute it | |
118 freely, subject to the following restrictions: | |
119 .LP | |
120 .nr step 1 1 | |
121 .IP \n[step]. 3 | |
122 The origin of this software must not be misrepresented; you must not | |
123 claim that you wrote the original software. If you use this software | |
124 in a product, an acknowledgment in the product documentation would be | |
125 appreciated but is not required. | |
126 .IP \n+[step]. | |
127 Altered source versions must be plainly marked as such, and must not be | |
128 misrepresented as being the original software. | |
129 .IP \n+[step]. | |
130 This notice may not be removed or altered from any source distribution. | |
131 .LP | |
132 Jean-loup Gailly Mark Adler | |
133 .br | |
134 jloup@gzip.org madler@alumni.caltech.edu | |
135 .LP | |
146 The deflate format used by | 136 The deflate format used by |
147 .I zlib | 137 .I zlib |
148 was defined by Phil Katz. | 138 was defined by Phil Katz. |
149 The deflate and | 139 The deflate and |
150 .I zlib | 140 .I zlib |