Mercurial > hg > CbC > CbC_gcc

comparison zlib/zlib.3 @ 111:04ced10e8804

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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