FAQ 10.8 KB
Newer Older
M
Mark Adler 已提交
1 2 3 4 5

		Frequently Asked Questions about zlib


If your question is not there, please check the zlib home page 
M
Mark Adler 已提交
6 7
http://www.zlib.org which may have more recent information.
The lastest zlib FAQ is at http://www.gzip.org/zlib/zlib_faq.html
M
Mark Adler 已提交
8 9


M
Mark Adler 已提交
10
 1. Is zlib Y2K-compliant?
M
Mark Adler 已提交
11

M
Mark Adler 已提交
12
    Yes. zlib doesn't handle dates.
M
Mark Adler 已提交
13

M
Mark Adler 已提交
14
 2. Where can I get a Windows DLL version?
M
Mark Adler 已提交
15

M
Mark Adler 已提交
16 17 18
    The zlib sources can be compiled without change to produce a DLL. If you
    want a precompiled DLL, see http://www.winimage.com/zLibDll/ . Questions
    about the zlib DLL should be sent to Gilles Vollant (info@winimage.com).
M
Mark Adler 已提交
19

M
Mark Adler 已提交
20
 3. Where can I get a Visual Basic interface to zlib?
M
Mark Adler 已提交
21

M
Mark Adler 已提交
22 23 24 25
    See
        * http://www.winimage.com/zLibDll/cmp-z-it.zip
        * http://www.dogma.net/markn/articles/zlibtool/zlibtool.htm
        * contrib/visual-basic.txt in the zlib distribution
M
Mark Adler 已提交
26

M
Mark Adler 已提交
27
 4. compress() returns Z_BUF_ERROR
M
Mark Adler 已提交
28

M
Mark Adler 已提交
29 30 31 32
    Make sure that before the call of compress, the length of the compressed
    buffer is equal to the total size of the compressed buffer and not
    zero. For Visual Basic, check that this parameter is passed by reference
    ("as any"), not by value ("as long").
M
Mark Adler 已提交
33

M
Mark Adler 已提交
34
 5. deflate() or inflate() returns Z_BUF_ERROR
M
Mark Adler 已提交
35

M
Mark Adler 已提交
36 37 38
    Before making the call, make sure that avail_in and avail_out are not
    zero. When setting the parameter flush equal to Z_FINISH, also make sure
    that avail_out is big enough to allow processing all pending input.
M
Mark Adler 已提交
39 40 41 42 43
    Note that a Z_BUF_ERROR is not fatal--another call to deflate() or
    inflate() can be made with more input or output space. A Z_BUF_ERROR
    may in fact be unavoidable depending on how the functions are used, since
    it is not possible to tell whether or not there is more output pending
    when strm.avail_out returns with zero.
M
Mark Adler 已提交
44

M
Mark Adler 已提交
45
 6. Where's the zlib documentation (man pages, etc.)?
M
Mark Adler 已提交
46

M
Mark Adler 已提交
47 48 49 50
    It's in zlib.h for the moment, and Francis S. Lin has converted it to a
    web page zlib.html. Volunteers to transform this to Unix-style man pages,
    please contact Jean-loup Gailly (jloup@gzip.org). Examples of zlib usage
    are in the files example.c and minigzip.c.
M
Mark Adler 已提交
51

M
Mark Adler 已提交
52
 7. Why don't you use GNU autoconf or libtool or ...?
M
Mark Adler 已提交
53

M
Mark Adler 已提交
54 55
    Because we would like to keep zlib as a very small and simple
    package. zlib is rather portable and doesn't need much configuration.
M
Mark Adler 已提交
56

M
Mark Adler 已提交
57
 8. I found a bug in zlib.
M
Mark Adler 已提交
58

M
Mark Adler 已提交
59 60 61 62
    Most of the time, such problems are due to an incorrect usage of
    zlib. Please try to reproduce the problem with a small program and send
    the corresponding source to us at zlib@gzip.org . Do not send
    multi-megabyte data files without prior agreement.
M
Mark Adler 已提交
63

M
Mark Adler 已提交
64
 9. Why do I get "undefined reference to gzputc"?
M
Mark Adler 已提交
65

M
Mark Adler 已提交
66
    If "make test" produces something like
M
Mark Adler 已提交
67

M
Mark Adler 已提交
68 69 70 71
       example.o(.text+0x154): undefined reference to `gzputc'
      
    check that you don't have old files libz.* in /usr/lib, /usr/local/lib or
    /usr/X11R6/lib. Remove any old versions, then do "make install".
M
Mark Adler 已提交
72

M
Mark Adler 已提交
73
10. I need a Delphi interface to zlib.
M
Mark Adler 已提交
74

M
Mark Adler 已提交
75 76
    See the directories contrib/delphi and contrib/delphi2 in the zlib
    distribution.
M
Mark Adler 已提交
77

M
Mark Adler 已提交
78
11. Can zlib handle .zip archives?
M
Mark Adler 已提交
79

M
Mark Adler 已提交
80
    See the directory contrib/minizip in the zlib distribution.
M
Mark Adler 已提交
81

M
Mark Adler 已提交
82
12. Can zlib handle .Z files?
M
Mark Adler 已提交
83

M
Mark Adler 已提交
84 85
    No, sorry. You have to spawn an uncompress or gunzip subprocess, or adapt
    the code of uncompress on your own.
M
Mark Adler 已提交
86

M
Mark Adler 已提交
87 88 89 90 91 92 93 94 95
13. How can I make a Unix shared library?

    make clean
    ./configure -s
    make

14. Why does "make test" fail on Mac OS X?

    Mac OS X already includes zlib as a shared library, and so -lz links the
M
Mark Adler 已提交
96 97 98 99
    shared library instead of the one that the "make" compiled. The two are
    incompatible due to different compile-time options. Simply change the -lz
    in the Makefile to libz.a, and it will use the compiled library instead
    of the shared one and the "make test" will succeed.
M
Mark Adler 已提交
100 101 102 103 104

15. I have a question about OttoPDF

    We are not the authors of OttoPDF. The real author is on the OttoPDF web
    site Joel Hainley jhainley@myndkryme.com.
M
Mark Adler 已提交
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263

16. Why does gzip give an error on a file I make with compress/deflate?

    The compress and deflate functions produce data in the zlib format, which
    is different and incompatible with the gzip format. The gz* functions in
    zlib on the other hand use the gzip format. Both the zlib and gzip
    formats use the same compressed data format, but have different headers
    and trailers.

17. Ok, so why are there two different formats?

    The gzip format was designed to retain the directory information about
    a single file, such as the name and last modification date. The zlib
    format on the other hand was designed for in-memory and communication
    channel applications, and has a much more compact header and trailer and
    uses a faster integrity check than gzip.

18. Well that's nice, but how do I make a gzip file in memory?

    Read RFC 1952 for the gzip header and trailer format, and roll your own
    gzip formatted data using raw deflate and crc32().

19. Is zlib thread-safe?

    Yes. However any library routines that zlib uses and any application-
    provided memory allocation routines must also be thread-safe. Of course,
    you should only operate on any given zlib or gzip stream from a single
    thread. zlib's gz* functions use stdio library routines, and most of
    zlib's functions use the library memory allocation routines by default.
    zlib's Init functions allow for the application to provide custom memory
    allocation routines.

20. Can I use zlib in my commercial application?

    Yes. Please read the license in zlib.h.

21. Is zlib under the GNU license?

    No. Please read the license in zlib.h.

22. Will zlib work on a big-endian or little-endian architecture, and can I
    exchange compressed data between them?

    Yes and yes.

23. Will zlib work on a 64-bit machine?

    It should. It has been tested on 64-bit machines, and has no dependence
    on any data types being limited to 32-bits in length. If you have any
    difficulties, please provide a complete problem report to zlib@gzip.org

24. Will zlib decompress data from the PKWare Data Compression Library?

    No. The PKWare DCL uses a completely different compressed data format
    than does PKZIP and zlib. However, you can look in zlib's contrib/blast
    directory for a possible solution to your problem.

25. Can I access data randomly in a compressed stream?

    No, not without some preparation. If when compressing you periodically
    use Z_FULL_FLUSH, carefully write all the pending data at those points,
    and keep an index of those locations, then you can start decompression
    at those points. You have to be careful to not use Z_FULL_FLUSH too
    often, since it can significantly degrade compression.

26. Does zlib work on MVS, OS/390, CICS, etc.?

    We don't know for sure. We have heard occasional reports of success on
    these systems. If you do use it on one of these, please provide us with
    a report, instructions, and patches that we can reference when we get
    these questions. Thanks.

27. Is there some simpler, easier to read version of inflate I can look at
    to understand the deflate format?

    First off, you should read RFC 1951. Second, yes. Look in zlib's
    contrib/puff directory.

28. Does zlib infringe on any patents?

    As far as we know, no. In fact, that was originally the whole point behind
    zlib. Look here for some more information:

    http://www.gzip.org/#faq11

29. Can zlib work with greater than 4 GB of data?

    Yes. inflate() and deflate() will process any amount of data correctly.
    However the strm.total_in and strm_total_out counters may be limited to
    4 GB. The user can easily set up their own counters updated after each
    call of inflate() or deflate() to count beyond 4 GB. compress() and
    uncompress() may be limited to 4 GB, since they operate in a single
    call using unsigned long lengths. gzseek() may be limited to 4 GB
    depending on how zlib is compiled.

30. Does zlib have any security vulnerabilities?

    The only one that we are aware of is potentially in gzprintf(). If zlib
    is compiled to use sprintf() or vsprintf(), then there is no protection
    against a buffer overflow of a 4K string space, other than the caller of
    gzprintf() assuring that the output will not exceed 4K. On the other
    hand, if zlib is compiled to use snprintf() or vsnprintf(), then there is
    no vulnerability.

    Note that you should be using the most recent version of zlib. Versions
    1.1.3 and before were subject to a double-free vulnerability.

31. Is there a Java version of zlib?

    Probably what you want is to use zlib in Java. zlib is already included
    as part of the Java SDK in the java.util.zip class. If you really want
    a version of zlib written in the Java language, look on the zlib home
    page for links: http://www.zlib.org/

32. I get this or that compiler or source-code scanner warning. Can't you guys
    write proper code?

    Many years ago, we gave up attempting to avoid warnings on every compiler
    in the universe. It just got to be a waste of time, and some compilers
    were downright silly. So now, we simply make sure that the code always
    works.

33. Will zlib read the (insert any ancient or arcane format here) compressed
    data format?

    Probably not. Look in the comp.compression FAQ for pointers to various
    formats and associated software.

34. How can I encrypt/decrypt zip files with zlib?

    zlib doesn't support encryption. PKZIP encryption is very weak and can be
    broken with freely available programs. To get strong encryption, use gpg
    which already includes zlib compression.

35. What's the difference between the "gzip" and "deflate" HTTP 1.1 encodings?

    "gzip" is the gzip format, and "deflate" is the zlib format. They should
    probably have called the second one "zlib" instead to avoid confusion
    with the raw deflate compressed data format. While the HTTP 1.1 RFC 2616
    correctly points to the zlib specification in RFC 1950 for the "deflate"
    transfer encoding, there have been reports of servers and browsers that
    incorrectly produce or expect raw deflate data per the deflate
    specficiation in RFC 1951, most notably Microsoft. So even though the
    "deflate" transfer encoding using the zlib format would be the more
    efficient approach (and in fact exactly what the zlib format was designed
    for), using the "gzip" transfer encoding is probably more reliable due to
    an unfortunate choice of name on the part of the HTTP 1.1 authors.

36. Does zlib support the new "Deflate64" format introduced by PKWare?

    No. PKWare has apparently decided to keep that format proprietary, since
    they have not documented it as they have previous compression formats.
    In any case, the compression improvements are so modest compared to other
    more modern approaches, that it's not worth the effort to implement.

37. Can you please sign these lengthy legal documents and fax them back to us
    so that we can use your software in our product?

    No.