// // zlib.h -- interface of the 'zlib' general purpose compression library // version 1.1.3, July 9th, 1998 // // Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler // // This software is provided 'as-is', without any express or implied // warranty. In no event will the authors be held liable for any damages // arising from the use of this software. // // Permission is granted to anyone to use this software for any purpose, // including commercial applications, and to alter it and redistribute it // freely, subject to the following restrictions: // // 1. The origin of this software must not be misrepresented; you must not // claim that you wrote the original software. If you use this software // in a product, an acknowledgment in the product documentation would be // appreciated but is not required. // 2. Altered source versions must be plainly marked as such, and must not be // misrepresented as being the original software. // 3. This notice may not be removed or altered from any source distribution. // // Jean-loup Gailly Mark Adler // jloup@gzip.org madler@alumni.caltech.edu // // The data format used by the zlib library is described by RFCs (Request for // Comments) 1950 to 1952 in the files ftp://ds.internic.net/rfc/rfc1950.txt // (zlib format), rfc1951.txt (deflate format) and rfc1952.txt (gzip format). // // The 'zlib' compression library provides in-memory compression and // decompression functions, including integrity checks of the uncompressed // data. This version of the library supports only one compression method // (deflation) but other algorithms will be added later and will have the same // stream interface. // // Compression can be done in a single step if the buffers are large // enough (for example if an input file is mmap'ed), or can be done by // repeated calls of the compression function. In the latter case, the // application must provide more input and/or consume the output // (providing more output space) before each call. // // The library does not install any signal handler. The decoder checks // the consistency of the compressed data, so the library should never // crash even in case of corrupted input. // This particular implementation has been heavily modified by jscott@ravensoft.com // to increase inflate/deflate speeds on 32 bit machines. // for more info about .ZIP format, see // ftp://ftp.cdrom.com/pub/infozip/doc/appnote-970311-iz.zip // PkWare has also a specification at : // ftp://ftp.pkware.com/probdesc.zip // ======================================================================================== // External calls and defines required for the zlib // ======================================================================================== // The deflate compression method #define ZF_STORED 0 #define ZF_DEFLATED 8 // Compression levels typedef enum { Z_STORE_COMPRESSION, Z_FAST_COMPRESSION_LOW, Z_FAST_COMPRESSION, Z_FAST_COMPRESSION_HIGH, Z_SLOW_COMPRESSION_LOWEST, Z_SLOW_COMPRESSION_LOW, Z_DEFAULT_COMPRESSION, Z_SLOW_COMPRESSION_HIGH, Z_SLOW_COMPRESSION_HIGHEST, Z_MAX_COMPRESSION, } ELevel; // Allowed flush values typedef enum { Z_NEED_MORE = -1, // Special case when finishing up the stream Z_NO_FLUSH, Z_SYNC_FLUSH, // Sync up the stream ready for another call Z_FINISH // Finish up the stream } EFlush; // Return codes for the compression/decompression functions. Negative // values are errors, positive values are used for special but normal events. typedef enum { Z_STREAM_ERROR = -3, // Basic error from failed sanity checks Z_BUF_ERROR, // Not enough input or output Z_DATA_ERROR, // Invalid data in the stream Z_OK, Z_STREAM_END // End of stream } EStatus; // Maximum value for windowBits in deflateInit and inflateInit. // The memory requirements for inflate are (in bytes) 1 << windowBits // that is, 32K for windowBits=15 (default value) plus a few kilobytes // for small objects. #define MAX_WBITS 15 // 32K LZ77 window #define WINDOW_SIZE (1 << MAX_WBITS) #define BIG_WINDOW_SIZE (WINDOW_SIZE << 1) #define WINDOW_MASK (WINDOW_SIZE - 1) // The three kinds of block type #define STORED_BLOCK 0 #define STATIC_TREES 1 #define DYN_TREES 2 #define MODE_ILLEGAL 3 // The minimum and maximum match lengths #define MIN_MATCH 3 #define MAX_MATCH 258 // number of distance codes #define D_CODES 30 extern const uint32_t extra_dbits[D_CODES]; // Structure to be used by external applications // The application must update next_in and avail_in when avail_in has // dropped to zero. It must update next_out and avail_out when avail_out // has dropped to zero. All other fields are set by the // compression library and must not be updated by the application. typedef struct z_stream_s { byte *next_in; // next input unsigned char uint32_t avail_in; // number of unsigned chars available at next_in uint32_t total_in; // total number of bytes processed so far byte *next_out; // next output unsigned char should be put there uint32_t avail_out; // remaining free space at next_out uint32_t total_out; // total number of bytes output EStatus status; EStatus error; // error code struct inflate_state_s *istate; // not visible by applications struct deflate_state_s *dstate; // not visible by applications uint32_t quality; } z_stream; // Update a running crc with the bytes buf[0..len-1] and return the updated // crc. If buf is NULL, this function returns the required initial value // for the crc. Pre- and post-conditioning (one's complement) is performed // within this function so it shouldn't be done by the application. // Usage example: // // uint32_t crc = crc32(0L, NULL, 0); // // while (read_buffer(buffer, length) != EOF) { // crc = crc32(crc, buffer, length); // } // if (crc != original_crc) error(); unsigned long crc32(unsigned long crc, const byte *buf, unsigned int len); // Update a running Adler-32 checksum with the bytes buf[0..len-1] and // return the updated checksum. If buf is NULL, this function returns // the required initial value for the checksum. // An Adler-32 checksum is almost as reliable as a CRC32 but can be computed // much faster. Usage example: // // uint32_t adler = adler32(0L, NULL, 0); // // while (read_buffer(buffer, length) != EOF) { // adler = adler32(adler, buffer, length); // } // if (adler != original_adler) error(); unsigned long adler32(unsigned long adler, const byte *buf, unsigned int len); // External calls to the deflate code EStatus deflateInit(z_stream *strm, ELevel level, int noWrap = 0); EStatus deflateCopy(z_stream *dest, z_stream *source); EStatus deflate(z_stream *strm, EFlush flush); EStatus deflateEnd(z_stream *strm); const char *deflateError(void); // External calls to the deflate code EStatus inflateInit(z_stream *strm, EFlush flush, int noWrap = 0); EStatus inflate(z_stream *z); EStatus inflateEnd(z_stream *strm); const char *inflateError(void); // External calls to the zipfile code bool InflateFile(byte *src, uint32_t compressedSize, byte *dst, uint32_t uncompressedSize, int noWrap = 0); bool DeflateFile(byte *src, uint32_t uncompressedSize, byte *dst, uint32_t maxCompressedSize, uint32_t *compressedSize, ELevel level, int noWrap = 0); // end