1 /* deflate.c -- compress data using the deflation algorithm
2 * Copyright (C) 1995-2003 Jean-loup Gailly.
3 * For conditions of distribution and use, see copyright notice in zlib.h
9 * The "deflation" process depends on being able to identify portions
10 * of the input text which are identical to earlier input (within a
11 * sliding window trailing behind the input currently being processed).
13 * The most straightforward technique turns out to be the fastest for
14 * most input files: try all possible matches and select the longest.
15 * The key feature of this algorithm is that insertions into the string
16 * dictionary are very simple and thus fast, and deletions are avoided
17 * completely. Insertions are performed at each input character, whereas
18 * string matches are performed only when the previous match ends. So it
19 * is preferable to spend more time in matches to allow very fast string
20 * insertions and avoid deletions. The matching algorithm for small
21 * strings is inspired from that of Rabin & Karp. A brute force approach
22 * is used to find longer strings when a small match has been found.
23 * A similar algorithm is used in comic (by Jan-Mark Wams) and freeze
24 * (by Leonid Broukhis).
25 * A previous version of this file used a more sophisticated algorithm
26 * (by Fiala and Greene) which is guaranteed to run in linear amortized
27 * time, but has a larger average cost, uses more memory and is patented.
28 * However the F&G algorithm may be faster for some highly redundant
29 * files if the parameter max_chain_length (described below) is too large.
33 * The idea of lazy evaluation of matches is due to Jan-Mark Wams, and
34 * I found it in 'freeze' written by Leonid Broukhis.
35 * Thanks to many people for bug reports and testing.
39 * Deutsch, L.P.,"DEFLATE Compressed Data Format Specification".
40 * Available in http://www.ietf.org/rfc/rfc1951.txt
42 * A description of the Rabin and Karp algorithm is given in the book
43 * "Algorithms" by R. Sedgewick, Addison-Wesley, p252.
45 * Fiala,E.R., and Greene,D.H.
46 * Data Compression with Finite Windows, Comm.ACM, 32,4 (1989) 490-595
54 const char deflate_copyright[] =
55 " deflate 1.2.0.2 Copyright 1995-2003 Jean-loup Gailly ";
57 If you use the zlib library in a product, an acknowledgment is welcome
58 in the documentation of your product. If for some reason you cannot
59 include such an acknowledgment, I would appreciate that you keep this
60 copyright string in the executable of your product.
63 /* ===========================================================================
64 * Function prototypes.
67 need_more, /* block not completed, need more input or more output */
68 block_done, /* block flush performed */
69 finish_started, /* finish started, need only more output at next deflate */
70 finish_done /* finish done, accept no more input or output */
73 typedef block_state (*compress_func) OF((deflate_state *s, int flush));
74 /* Compression function. Returns the block state after the call. */
76 local void fill_window OF((deflate_state *s));
77 local block_state deflate_stored OF((deflate_state *s, int flush));
78 local block_state deflate_fast OF((deflate_state *s, int flush));
80 local block_state deflate_slow OF((deflate_state *s, int flush));
82 local void lm_init OF((deflate_state *s));
83 local void putShortMSB OF((deflate_state *s, uInt b));
84 local void flush_pending OF((z_streamp strm));
85 local int read_buf OF((z_streamp strm, Bytef *buf, unsigned size));
88 void match_init OF((void)); /* asm code initialization */
89 uInt longest_match OF((deflate_state *s, IPos cur_match));
91 local uInt longest_match OF((deflate_state *s, IPos cur_match));
94 local uInt longest_match_fast OF((deflate_state *s, IPos cur_match));
97 local void check_match OF((deflate_state *s, IPos start, IPos match,
101 /* ===========================================================================
106 /* Tail of hash chains */
109 # define TOO_FAR 4096
111 /* Matches of length 3 are discarded if their distance exceeds TOO_FAR */
113 #define MIN_LOOKAHEAD (MAX_MATCH+MIN_MATCH+1)
114 /* Minimum amount of lookahead, except at the end of the input file.
115 * See deflate.c for comments about the MIN_MATCH+1.
118 /* Values for max_lazy_match, good_match and max_chain_length, depending on
119 * the desired pack level (0..9). The values given below have been tuned to
120 * exclude worst case performance for pathological files. Better values may be
121 * found for specific files.
123 typedef struct config_s {
124 ush good_length; /* reduce lazy search above this match length */
125 ush max_lazy; /* do not perform lazy search above this match length */
126 ush nice_length; /* quit search above this match length */
132 local const config configuration_table[2] = {
133 /* good lazy nice chain */
134 /* 0 */ {0, 0, 0, 0, deflate_stored}, /* store only */
135 /* 1 */ {4, 4, 8, 4, deflate_fast}}; /* maximum speed, no lazy matches */
137 local const config configuration_table[10] = {
138 /* good lazy nice chain */
139 /* 0 */ {0, 0, 0, 0, deflate_stored}, /* store only */
140 /* 1 */ {4, 4, 8, 4, deflate_fast}, /* maximum speed, no lazy matches */
141 /* 2 */ {4, 5, 16, 8, deflate_fast},
142 /* 3 */ {4, 6, 32, 32, deflate_fast},
144 /* 4 */ {4, 4, 16, 16, deflate_slow}, /* lazy matches */
145 /* 5 */ {8, 16, 32, 32, deflate_slow},
146 /* 6 */ {8, 16, 128, 128, deflate_slow},
147 /* 7 */ {8, 32, 128, 256, deflate_slow},
148 /* 8 */ {32, 128, 258, 1024, deflate_slow},
149 /* 9 */ {32, 258, 258, 4096, deflate_slow}}; /* maximum compression */
152 /* Note: the deflate() code requires max_lazy >= MIN_MATCH and max_chain >= 4
153 * For deflate_fast() (levels <= 3) good is ignored and lazy has a different
158 /* result of memcmp for equal strings */
160 #ifndef NO_DUMMY_DECL
161 struct static_tree_desc_s {int dummy;}; /* for buggy compilers */
164 /* ===========================================================================
165 * Update a hash value with the given input byte
166 * IN assertion: all calls to to UPDATE_HASH are made with consecutive
167 * input characters, so that a running hash key can be computed from the
168 * previous key instead of complete recalculation each time.
170 #define UPDATE_HASH(s,h,c) (h = (((h)<<s->hash_shift) ^ (c)) & s->hash_mask)
173 /* ===========================================================================
174 * Insert string str in the dictionary and set match_head to the previous head
175 * of the hash chain (the most recent string with same hash key). Return
176 * the previous length of the hash chain.
177 * If this file is compiled with -DFASTEST, the compression level is forced
178 * to 1, and no hash chains are maintained.
179 * IN assertion: all calls to to INSERT_STRING are made with consecutive
180 * input characters and the first MIN_MATCH bytes of str are valid
181 * (except for the last MIN_MATCH-1 bytes of the input file).
184 #define INSERT_STRING(s, str, match_head) \
185 (UPDATE_HASH(s, s->ins_h, s->window[(str) + (MIN_MATCH-1)]), \
186 match_head = s->head[s->ins_h], \
187 s->head[s->ins_h] = (Pos)(str))
189 #define INSERT_STRING(s, str, match_head) \
190 (UPDATE_HASH(s, s->ins_h, s->window[(str) + (MIN_MATCH-1)]), \
191 s->prev[(str) & s->w_mask] = match_head = s->head[s->ins_h], \
192 s->head[s->ins_h] = (Pos)(str))
195 /* ===========================================================================
196 * Initialize the hash table (avoiding 64K overflow for 16 bit systems).
197 * prev[] will be initialized on the fly.
199 #define CLEAR_HASH(s) \
200 s->head[s->hash_size-1] = NIL; \
201 zmemzero((Bytef *)s->head, (unsigned)(s->hash_size-1)*sizeof(*s->head));
203 /* ========================================================================= */
204 int ZEXPORT deflateInit_(strm, level, version, stream_size)
210 return deflateInit2_(strm, level, Z_DEFLATED, MAX_WBITS, DEF_MEM_LEVEL,
211 Z_DEFAULT_STRATEGY, version, stream_size);
212 /* To do: ignore strm->next_in if we use it as window */
215 /* ========================================================================= */
216 int ZEXPORT deflateInit2_(strm, level, method, windowBits, memLevel, strategy,
217 version, stream_size)
229 static const char my_version[] = ZLIB_VERSION;
232 /* We overlay pending_buf and d_buf+l_buf. This works since the average
233 * output size for (length,distance) codes is <= 24 bits.
236 if (version == Z_NULL || version[0] != my_version[0] ||
237 stream_size != sizeof(z_stream)) {
238 return Z_VERSION_ERROR;
240 if (strm == Z_NULL) return Z_STREAM_ERROR;
243 if (strm->zalloc == Z_NULL) {
244 strm->zalloc = zcalloc;
245 strm->opaque = (voidpf)0;
247 if (strm->zfree == Z_NULL) strm->zfree = zcfree;
250 if (level != 0) level = 1;
252 if (level == Z_DEFAULT_COMPRESSION) level = 6;
255 if (windowBits < 0) { /* undocumented feature: suppress zlib header */
257 windowBits = -windowBits;
259 if (memLevel < 1 || memLevel > MAX_MEM_LEVEL || method != Z_DEFLATED ||
260 windowBits < 8 || windowBits > 15 || level < 0 || level > 9 ||
261 strategy < 0 || strategy > Z_RLE) {
262 return Z_STREAM_ERROR;
264 if (windowBits == 8) windowBits = 9; /* until 256-byte window bug fixed */
265 s = (deflate_state *) ZALLOC(strm, 1, sizeof(deflate_state));
266 if (s == Z_NULL) return Z_MEM_ERROR;
267 strm->state = (struct internal_state FAR *)s;
270 s->noheader = noheader;
271 s->w_bits = windowBits;
272 s->w_size = 1 << s->w_bits;
273 s->w_mask = s->w_size - 1;
275 s->hash_bits = memLevel + 7;
276 s->hash_size = 1 << s->hash_bits;
277 s->hash_mask = s->hash_size - 1;
278 s->hash_shift = ((s->hash_bits+MIN_MATCH-1)/MIN_MATCH);
280 s->window = (Bytef *) ZALLOC(strm, s->w_size, 2*sizeof(Byte));
281 s->prev = (Posf *) ZALLOC(strm, s->w_size, sizeof(Pos));
282 s->head = (Posf *) ZALLOC(strm, s->hash_size, sizeof(Pos));
284 s->lit_bufsize = 1 << (memLevel + 6); /* 16K elements by default */
286 overlay = (ushf *) ZALLOC(strm, s->lit_bufsize, sizeof(ush)+2);
287 s->pending_buf = (uchf *) overlay;
288 s->pending_buf_size = (ulg)s->lit_bufsize * (sizeof(ush)+2L);
290 if (s->window == Z_NULL || s->prev == Z_NULL || s->head == Z_NULL ||
291 s->pending_buf == Z_NULL) {
292 s->status = FINISH_STATE;
293 strm->msg = (char*)ERR_MSG(Z_MEM_ERROR);
297 s->d_buf = overlay + s->lit_bufsize/sizeof(ush);
298 s->l_buf = s->pending_buf + (1+sizeof(ush))*s->lit_bufsize;
301 s->strategy = strategy;
302 s->method = (Byte)method;
304 return deflateReset(strm);
307 /* ========================================================================= */
308 int ZEXPORT deflateSetDictionary (strm, dictionary, dictLength)
310 const Bytef *dictionary;
314 uInt length = dictLength;
318 if (strm == Z_NULL || strm->state == Z_NULL || dictionary == Z_NULL ||
319 (!strm->state->noheader && strm->state->status != INIT_STATE))
320 return Z_STREAM_ERROR;
324 strm->adler = adler32(strm->adler, dictionary, dictLength);
326 if (length < MIN_MATCH) return Z_OK;
327 if (length > MAX_DIST(s)) {
328 length = MAX_DIST(s);
329 #ifndef USE_DICT_HEAD
330 dictionary += dictLength - length; /* use the tail of the dictionary */
333 zmemcpy(s->window, dictionary, length);
334 s->strstart = length;
335 s->block_start = (long)length;
337 /* Insert all strings in the hash table (except for the last two bytes).
338 * s->lookahead stays null, so s->ins_h will be recomputed at the next
339 * call of fill_window.
341 s->ins_h = s->window[0];
342 UPDATE_HASH(s, s->ins_h, s->window[1]);
343 for (n = 0; n <= length - MIN_MATCH; n++) {
344 INSERT_STRING(s, n, hash_head);
346 if (hash_head) hash_head = 0; /* to make compiler happy */
350 /* ========================================================================= */
351 int ZEXPORT deflateReset (strm)
356 if (strm == Z_NULL || strm->state == Z_NULL ||
357 strm->zalloc == Z_NULL || strm->zfree == Z_NULL) return Z_STREAM_ERROR;
359 strm->total_in = strm->total_out = 0;
360 strm->msg = Z_NULL; /* use zfree if we ever allocate msg dynamically */
361 strm->data_type = Z_UNKNOWN;
363 s = (deflate_state *)strm->state;
365 s->pending_out = s->pending_buf;
367 if (s->noheader < 0) {
368 s->noheader = 0; /* was set to -1 by deflate(..., Z_FINISH); */
370 s->status = s->noheader ? BUSY_STATE : INIT_STATE;
372 s->last_flush = Z_NO_FLUSH;
380 /* ========================================================================= */
381 int ZEXPORT deflateParams(strm, level, strategy)
390 if (strm == Z_NULL || strm->state == Z_NULL) return Z_STREAM_ERROR;
394 if (level != 0) level = 1;
396 if (level == Z_DEFAULT_COMPRESSION) level = 6;
398 if (level < 0 || level > 9 || strategy < 0 || strategy > Z_RLE) {
399 return Z_STREAM_ERROR;
401 func = configuration_table[s->level].func;
403 if (func != configuration_table[level].func && strm->total_in != 0) {
404 /* Flush the last buffer: */
405 err = deflate(strm, Z_PARTIAL_FLUSH);
407 if (s->level != level) {
409 s->max_lazy_match = configuration_table[level].max_lazy;
410 s->good_match = configuration_table[level].good_length;
411 s->nice_match = configuration_table[level].nice_length;
412 s->max_chain_length = configuration_table[level].max_chain;
414 s->strategy = strategy;
418 /* =========================================================================
419 * For the default windowBits of 15 and memLevel of 8, this function returns
420 * a close to exact, as well as small, upper bound on the compressed size.
421 * They are coded as constants here for a reason--if the #define's are
422 * changed, then this function needs to be changed as well. The return
423 * value for 15 and 8 only works for those exact settings.
425 * For any setting other than those defaults for windowBits and memLevel,
426 * the value returned is a conservative worst case for the maximum expansion
427 * resulting from using fixed blocks instead of stored blocks, which deflate
428 * can emit on compressed data for some combinations of the parameters.
430 * This function could be more sophisticated to provide closer upper bounds
431 * for every combination of windowBits and memLevel, as well as noheader.
432 * But even the conservative upper bound of about 14% expansion does not
433 * seem onerous for output buffer allocation.
435 uLong ZEXPORT deflateBound(strm, sourceLen)
442 /* conservative upper bound */
443 destLen = sourceLen +
444 ((sourceLen + 7) >> 3) + ((sourceLen + 63) >> 6) + 11;
446 /* if can't get parameters, return conservative bound */
447 if (strm == Z_NULL || strm->state == Z_NULL)
450 /* if not default parameters, return conservative bound */
452 if (s->w_bits != 15 || s->hash_bits != 8 + 7)
455 /* default settings: return tight bound for that case */
456 return compressBound(sourceLen);
459 /* =========================================================================
460 * Put a short in the pending buffer. The 16-bit value is put in MSB order.
461 * IN assertion: the stream state is correct and there is enough room in
464 local void putShortMSB (s, b)
468 put_byte(s, (Byte)(b >> 8));
469 put_byte(s, (Byte)(b & 0xff));
472 /* =========================================================================
473 * Flush as much pending output as possible. All deflate() output goes
474 * through this function so some applications may wish to modify it
475 * to avoid allocating a large strm->next_out buffer and copying into it.
476 * (See also read_buf()).
478 local void flush_pending(strm)
481 unsigned len = strm->state->pending;
483 if (len > strm->avail_out) len = strm->avail_out;
484 if (len == 0) return;
486 zmemcpy(strm->next_out, strm->state->pending_out, len);
487 strm->next_out += len;
488 strm->state->pending_out += len;
489 strm->total_out += len;
490 strm->avail_out -= len;
491 strm->state->pending -= len;
492 if (strm->state->pending == 0) {
493 strm->state->pending_out = strm->state->pending_buf;
497 /* ========================================================================= */
498 int ZEXPORT deflate (strm, flush)
502 int old_flush; /* value of flush param for previous deflate call */
505 if (strm == Z_NULL || strm->state == Z_NULL ||
506 flush > Z_FINISH || flush < 0) {
507 return Z_STREAM_ERROR;
511 if (strm->next_out == Z_NULL ||
512 (strm->next_in == Z_NULL && strm->avail_in != 0) ||
513 (s->status == FINISH_STATE && flush != Z_FINISH)) {
514 ERR_RETURN(strm, Z_STREAM_ERROR);
516 if (strm->avail_out == 0) ERR_RETURN(strm, Z_BUF_ERROR);
518 s->strm = strm; /* just in case */
519 old_flush = s->last_flush;
520 s->last_flush = flush;
522 /* Write the zlib header */
523 if (s->status == INIT_STATE) {
525 uInt header = (Z_DEFLATED + ((s->w_bits-8)<<4)) << 8;
528 if (s->strategy >= Z_HUFFMAN_ONLY || s->level < 2)
530 else if (s->level < 6)
532 else if (s->level == 6)
536 header |= (level_flags << 6);
537 if (s->strstart != 0) header |= PRESET_DICT;
538 header += 31 - (header % 31);
540 s->status = BUSY_STATE;
541 putShortMSB(s, header);
543 /* Save the adler32 of the preset dictionary: */
544 if (s->strstart != 0) {
545 putShortMSB(s, (uInt)(strm->adler >> 16));
546 putShortMSB(s, (uInt)(strm->adler & 0xffff));
551 /* Flush as much pending output as possible */
552 if (s->pending != 0) {
554 if (strm->avail_out == 0) {
555 /* Since avail_out is 0, deflate will be called again with
556 * more output space, but possibly with both pending and
557 * avail_in equal to zero. There won't be anything to do,
558 * but this is not an error situation so make sure we
559 * return OK instead of BUF_ERROR at next call of deflate:
565 /* Make sure there is something to do and avoid duplicate consecutive
566 * flushes. For repeated and useless calls with Z_FINISH, we keep
567 * returning Z_STREAM_END instead of Z_BUF_ERROR.
569 } else if (strm->avail_in == 0 && flush <= old_flush &&
571 ERR_RETURN(strm, Z_BUF_ERROR);
574 /* User must not provide more input after the first FINISH: */
575 if (s->status == FINISH_STATE && strm->avail_in != 0) {
576 ERR_RETURN(strm, Z_BUF_ERROR);
579 /* Start a new block or continue the current one.
581 if (strm->avail_in != 0 || s->lookahead != 0 ||
582 (flush != Z_NO_FLUSH && s->status != FINISH_STATE)) {
585 bstate = (*(configuration_table[s->level].func))(s, flush);
587 if (bstate == finish_started || bstate == finish_done) {
588 s->status = FINISH_STATE;
590 if (bstate == need_more || bstate == finish_started) {
591 if (strm->avail_out == 0) {
592 s->last_flush = -1; /* avoid BUF_ERROR next call, see above */
595 /* If flush != Z_NO_FLUSH && avail_out == 0, the next call
596 * of deflate should use the same flush parameter to make sure
597 * that the flush is complete. So we don't have to output an
598 * empty block here, this will be done at next call. This also
599 * ensures that for a very small output buffer, we emit at most
603 if (bstate == block_done) {
604 if (flush == Z_PARTIAL_FLUSH) {
606 } else { /* FULL_FLUSH or SYNC_FLUSH */
607 _tr_stored_block(s, (char*)0, 0L, 0);
608 /* For a full flush, this empty block will be recognized
609 * as a special marker by inflate_sync().
611 if (flush == Z_FULL_FLUSH) {
612 CLEAR_HASH(s); /* forget history */
616 if (strm->avail_out == 0) {
617 s->last_flush = -1; /* avoid BUF_ERROR at next call, see above */
622 Assert(strm->avail_out > 0, "bug2");
624 if (flush != Z_FINISH) return Z_OK;
625 if (s->noheader) return Z_STREAM_END;
627 /* Write the zlib trailer (adler32) */
628 putShortMSB(s, (uInt)(strm->adler >> 16));
629 putShortMSB(s, (uInt)(strm->adler & 0xffff));
631 /* If avail_out is zero, the application will call deflate again
634 s->noheader = -1; /* write the trailer only once! */
635 return s->pending != 0 ? Z_OK : Z_STREAM_END;
638 /* ========================================================================= */
639 int ZEXPORT deflateEnd (strm)
644 if (strm == Z_NULL || strm->state == Z_NULL) return Z_STREAM_ERROR;
646 status = strm->state->status;
647 if (status != INIT_STATE && status != BUSY_STATE &&
648 status != FINISH_STATE) {
649 return Z_STREAM_ERROR;
652 /* Deallocate in reverse order of allocations: */
653 TRY_FREE(strm, strm->state->pending_buf);
654 TRY_FREE(strm, strm->state->head);
655 TRY_FREE(strm, strm->state->prev);
656 TRY_FREE(strm, strm->state->window);
658 ZFREE(strm, strm->state);
659 strm->state = Z_NULL;
661 return status == BUSY_STATE ? Z_DATA_ERROR : Z_OK;
664 /* =========================================================================
665 * Copy the source state to the destination state.
666 * To simplify the source, this is not supported for 16-bit MSDOS (which
667 * doesn't have enough memory anyway to duplicate compression states).
669 int ZEXPORT deflateCopy (dest, source)
674 return Z_STREAM_ERROR;
681 if (source == Z_NULL || dest == Z_NULL || source->state == Z_NULL) {
682 return Z_STREAM_ERROR;
689 ds = (deflate_state *) ZALLOC(dest, 1, sizeof(deflate_state));
690 if (ds == Z_NULL) return Z_MEM_ERROR;
691 dest->state = (struct internal_state FAR *) ds;
695 ds->window = (Bytef *) ZALLOC(dest, ds->w_size, 2*sizeof(Byte));
696 ds->prev = (Posf *) ZALLOC(dest, ds->w_size, sizeof(Pos));
697 ds->head = (Posf *) ZALLOC(dest, ds->hash_size, sizeof(Pos));
698 overlay = (ushf *) ZALLOC(dest, ds->lit_bufsize, sizeof(ush)+2);
699 ds->pending_buf = (uchf *) overlay;
701 if (ds->window == Z_NULL || ds->prev == Z_NULL || ds->head == Z_NULL ||
702 ds->pending_buf == Z_NULL) {
706 /* following zmemcpy do not work for 16-bit MSDOS */
707 zmemcpy(ds->window, ss->window, ds->w_size * 2 * sizeof(Byte));
708 zmemcpy(ds->prev, ss->prev, ds->w_size * sizeof(Pos));
709 zmemcpy(ds->head, ss->head, ds->hash_size * sizeof(Pos));
710 zmemcpy(ds->pending_buf, ss->pending_buf, (uInt)ds->pending_buf_size);
712 ds->pending_out = ds->pending_buf + (ss->pending_out - ss->pending_buf);
713 ds->d_buf = overlay + ds->lit_bufsize/sizeof(ush);
714 ds->l_buf = ds->pending_buf + (1+sizeof(ush))*ds->lit_bufsize;
716 ds->l_desc.dyn_tree = ds->dyn_ltree;
717 ds->d_desc.dyn_tree = ds->dyn_dtree;
718 ds->bl_desc.dyn_tree = ds->bl_tree;
721 #endif /* MAXSEG_64K */
724 /* ===========================================================================
725 * Read a new buffer from the current input stream, update the adler32
726 * and total number of bytes read. All deflate() input goes through
727 * this function so some applications may wish to modify it to avoid
728 * allocating a large strm->next_in buffer and copying from it.
729 * (See also flush_pending()).
731 local int read_buf(strm, buf, size)
736 unsigned len = strm->avail_in;
738 if (len > size) len = size;
739 if (len == 0) return 0;
741 strm->avail_in -= len;
743 if (!strm->state->noheader) {
744 strm->adler = adler32(strm->adler, strm->next_in, len);
746 zmemcpy(buf, strm->next_in, len);
747 strm->next_in += len;
748 strm->total_in += len;
753 /* ===========================================================================
754 * Initialize the "longest match" routines for a new zlib stream
756 local void lm_init (s)
759 s->window_size = (ulg)2L*s->w_size;
763 /* Set the default configuration parameters:
765 s->max_lazy_match = configuration_table[s->level].max_lazy;
766 s->good_match = configuration_table[s->level].good_length;
767 s->nice_match = configuration_table[s->level].nice_length;
768 s->max_chain_length = configuration_table[s->level].max_chain;
773 s->match_length = s->prev_length = MIN_MATCH-1;
774 s->match_available = 0;
777 match_init(); /* initialize the asm code */
782 /* ===========================================================================
783 * Set match_start to the longest match starting at the given string and
784 * return its length. Matches shorter or equal to prev_length are discarded,
785 * in which case the result is equal to prev_length and match_start is
787 * IN assertions: cur_match is the head of the hash chain for the current
788 * string (strstart) and its distance is <= MAX_DIST, and prev_length >= 1
789 * OUT assertion: the match length is not greater than s->lookahead.
792 /* For 80x86 and 680x0, an optimized version will be provided in match.asm or
793 * match.S. The code will be functionally equivalent.
795 local uInt longest_match(s, cur_match)
797 IPos cur_match; /* current match */
799 unsigned chain_length = s->max_chain_length;/* max hash chain length */
800 register Bytef *scan = s->window + s->strstart; /* current string */
801 register Bytef *match; /* matched string */
802 register int len; /* length of current match */
803 int best_len = s->prev_length; /* best match length so far */
804 int nice_match = s->nice_match; /* stop if match long enough */
805 IPos limit = s->strstart > (IPos)MAX_DIST(s) ?
806 s->strstart - (IPos)MAX_DIST(s) : NIL;
807 /* Stop when cur_match becomes <= limit. To simplify the code,
808 * we prevent matches with the string of window index 0.
810 Posf *prev = s->prev;
811 uInt wmask = s->w_mask;
814 /* Compare two bytes at a time. Note: this is not always beneficial.
815 * Try with and without -DUNALIGNED_OK to check.
817 register Bytef *strend = s->window + s->strstart + MAX_MATCH - 1;
818 register ush scan_start = *(ushf*)scan;
819 register ush scan_end = *(ushf*)(scan+best_len-1);
821 register Bytef *strend = s->window + s->strstart + MAX_MATCH;
822 register Byte scan_end1 = scan[best_len-1];
823 register Byte scan_end = scan[best_len];
826 /* The code is optimized for HASH_BITS >= 8 and MAX_MATCH-2 multiple of 16.
827 * It is easy to get rid of this optimization if necessary.
829 Assert(s->hash_bits >= 8 && MAX_MATCH == 258, "Code too clever");
831 /* Do not waste too much time if we already have a good match: */
832 if (s->prev_length >= s->good_match) {
835 /* Do not look for matches beyond the end of the input. This is necessary
836 * to make deflate deterministic.
838 if ((uInt)nice_match > s->lookahead) nice_match = s->lookahead;
840 Assert((ulg)s->strstart <= s->window_size-MIN_LOOKAHEAD, "need lookahead");
843 Assert(cur_match < s->strstart, "no future");
844 match = s->window + cur_match;
846 /* Skip to next match if the match length cannot increase
847 * or if the match length is less than 2:
849 #if (defined(UNALIGNED_OK) && MAX_MATCH == 258)
850 /* This code assumes sizeof(unsigned short) == 2. Do not use
851 * UNALIGNED_OK if your compiler uses a different size.
853 if (*(ushf*)(match+best_len-1) != scan_end ||
854 *(ushf*)match != scan_start) continue;
856 /* It is not necessary to compare scan[2] and match[2] since they are
857 * always equal when the other bytes match, given that the hash keys
858 * are equal and that HASH_BITS >= 8. Compare 2 bytes at a time at
859 * strstart+3, +5, ... up to strstart+257. We check for insufficient
860 * lookahead only every 4th comparison; the 128th check will be made
861 * at strstart+257. If MAX_MATCH-2 is not a multiple of 8, it is
862 * necessary to put more guard bytes at the end of the window, or
863 * to check more often for insufficient lookahead.
865 Assert(scan[2] == match[2], "scan[2]?");
868 } while (*(ushf*)(scan+=2) == *(ushf*)(match+=2) &&
869 *(ushf*)(scan+=2) == *(ushf*)(match+=2) &&
870 *(ushf*)(scan+=2) == *(ushf*)(match+=2) &&
871 *(ushf*)(scan+=2) == *(ushf*)(match+=2) &&
873 /* The funny "do {}" generates better code on most compilers */
875 /* Here, scan <= window+strstart+257 */
876 Assert(scan <= s->window+(unsigned)(s->window_size-1), "wild scan");
877 if (*scan == *match) scan++;
879 len = (MAX_MATCH - 1) - (int)(strend-scan);
880 scan = strend - (MAX_MATCH-1);
882 #else /* UNALIGNED_OK */
884 if (match[best_len] != scan_end ||
885 match[best_len-1] != scan_end1 ||
887 *++match != scan[1]) continue;
889 /* The check at best_len-1 can be removed because it will be made
890 * again later. (This heuristic is not always a win.)
891 * It is not necessary to compare scan[2] and match[2] since they
892 * are always equal when the other bytes match, given that
893 * the hash keys are equal and that HASH_BITS >= 8.
896 Assert(*scan == *match, "match[2]?");
898 /* We check for insufficient lookahead only every 8th comparison;
899 * the 256th check will be made at strstart+258.
902 } while (*++scan == *++match && *++scan == *++match &&
903 *++scan == *++match && *++scan == *++match &&
904 *++scan == *++match && *++scan == *++match &&
905 *++scan == *++match && *++scan == *++match &&
908 Assert(scan <= s->window+(unsigned)(s->window_size-1), "wild scan");
910 len = MAX_MATCH - (int)(strend - scan);
911 scan = strend - MAX_MATCH;
913 #endif /* UNALIGNED_OK */
915 if (len > best_len) {
916 s->match_start = cur_match;
918 if (len >= nice_match) break;
920 scan_end = *(ushf*)(scan+best_len-1);
922 scan_end1 = scan[best_len-1];
923 scan_end = scan[best_len];
926 } while ((cur_match = prev[cur_match & wmask]) > limit
927 && --chain_length != 0);
929 if ((uInt)best_len <= s->lookahead) return (uInt)best_len;
935 /* ---------------------------------------------------------------------------
936 * Optimized version for level == 1 or strategy == Z_RLE only
938 local uInt longest_match_fast(s, cur_match)
940 IPos cur_match; /* current match */
942 register Bytef *scan = s->window + s->strstart; /* current string */
943 register Bytef *match; /* matched string */
944 register int len; /* length of current match */
945 register Bytef *strend = s->window + s->strstart + MAX_MATCH;
947 /* The code is optimized for HASH_BITS >= 8 and MAX_MATCH-2 multiple of 16.
948 * It is easy to get rid of this optimization if necessary.
950 Assert(s->hash_bits >= 8 && MAX_MATCH == 258, "Code too clever");
952 Assert((ulg)s->strstart <= s->window_size-MIN_LOOKAHEAD, "need lookahead");
954 Assert(cur_match < s->strstart, "no future");
956 match = s->window + cur_match;
958 /* Return failure if the match length is less than 2:
960 if (match[0] != scan[0] || match[1] != scan[1]) return MIN_MATCH-1;
962 /* The check at best_len-1 can be removed because it will be made
963 * again later. (This heuristic is not always a win.)
964 * It is not necessary to compare scan[2] and match[2] since they
965 * are always equal when the other bytes match, given that
966 * the hash keys are equal and that HASH_BITS >= 8.
968 scan += 2, match += 2;
969 Assert(*scan == *match, "match[2]?");
971 /* We check for insufficient lookahead only every 8th comparison;
972 * the 256th check will be made at strstart+258.
975 } while (*++scan == *++match && *++scan == *++match &&
976 *++scan == *++match && *++scan == *++match &&
977 *++scan == *++match && *++scan == *++match &&
978 *++scan == *++match && *++scan == *++match &&
981 Assert(scan <= s->window+(unsigned)(s->window_size-1), "wild scan");
983 len = MAX_MATCH - (int)(strend - scan);
985 if (len < MIN_MATCH) return MIN_MATCH - 1;
987 s->match_start = cur_match;
988 return (uInt)len <= s->lookahead ? (uInt)len : s->lookahead;
992 /* ===========================================================================
993 * Check that the match at match_start is indeed a match.
995 local void check_match(s, start, match, length)
1000 /* check that the match is indeed a match */
1001 if (zmemcmp(s->window + match,
1002 s->window + start, length) != EQUAL) {
1003 fprintf(stderr, " start %u, match %u, length %d\n",
1004 start, match, length);
1006 fprintf(stderr, "%c%c", s->window[match++], s->window[start++]);
1007 } while (--length != 0);
1008 z_error("invalid match");
1010 if (z_verbose > 1) {
1011 fprintf(stderr,"\\[%d,%d]", start-match, length);
1012 do { putc(s->window[start++], stderr); } while (--length != 0);
1016 # define check_match(s, start, match, length)
1019 /* ===========================================================================
1020 * Fill the window when the lookahead becomes insufficient.
1021 * Updates strstart and lookahead.
1023 * IN assertion: lookahead < MIN_LOOKAHEAD
1024 * OUT assertions: strstart <= window_size-MIN_LOOKAHEAD
1025 * At least one byte has been read, or avail_in == 0; reads are
1026 * performed for at least two bytes (required for the zip translate_eol
1027 * option -- not supported here).
1029 local void fill_window(s)
1032 register unsigned n, m;
1034 unsigned more; /* Amount of free space at the end of the window. */
1035 uInt wsize = s->w_size;
1038 more = (unsigned)(s->window_size -(ulg)s->lookahead -(ulg)s->strstart);
1040 /* Deal with !@#$% 64K limit: */
1041 if (sizeof(int) <= 2) {
1042 if (more == 0 && s->strstart == 0 && s->lookahead == 0) {
1045 } else if (more == (unsigned)(-1)) {
1046 /* Very unlikely, but possible on 16 bit machine if
1047 * strstart == 0 && lookahead == 1 (input done one byte at time)
1053 /* If the window is almost full and there is insufficient lookahead,
1054 * move the upper half to the lower one to make room in the upper half.
1056 if (s->strstart >= wsize+MAX_DIST(s)) {
1058 zmemcpy(s->window, s->window+wsize, (unsigned)wsize);
1059 s->match_start -= wsize;
1060 s->strstart -= wsize; /* we now have strstart >= MAX_DIST */
1061 s->block_start -= (long) wsize;
1063 /* Slide the hash table (could be avoided with 32 bit values
1064 at the expense of memory usage). We slide even when level == 0
1065 to keep the hash table consistent if we switch back to level > 0
1066 later. (Using level 0 permanently is not an optimal usage of
1067 zlib, so we don't care about this pathological case.)
1073 *p = (Pos)(m >= wsize ? m-wsize : NIL);
1081 *p = (Pos)(m >= wsize ? m-wsize : NIL);
1082 /* If n is not on any hash chain, prev[n] is garbage but
1083 * its value will never be used.
1089 if (s->strm->avail_in == 0) return;
1091 /* If there was no sliding:
1092 * strstart <= WSIZE+MAX_DIST-1 && lookahead <= MIN_LOOKAHEAD - 1 &&
1093 * more == window_size - lookahead - strstart
1094 * => more >= window_size - (MIN_LOOKAHEAD-1 + WSIZE + MAX_DIST-1)
1095 * => more >= window_size - 2*WSIZE + 2
1096 * In the BIG_MEM or MMAP case (not yet supported),
1097 * window_size == input_size + MIN_LOOKAHEAD &&
1098 * strstart + s->lookahead <= input_size => more >= MIN_LOOKAHEAD.
1099 * Otherwise, window_size == 2*WSIZE so more >= 2.
1100 * If there was sliding, more >= WSIZE. So in all cases, more >= 2.
1102 Assert(more >= 2, "more < 2");
1104 n = read_buf(s->strm, s->window + s->strstart + s->lookahead, more);
1107 /* Initialize the hash value now that we have some input: */
1108 if (s->lookahead >= MIN_MATCH) {
1109 s->ins_h = s->window[s->strstart];
1110 UPDATE_HASH(s, s->ins_h, s->window[s->strstart+1]);
1112 Call UPDATE_HASH() MIN_MATCH-3 more times
1115 /* If the whole input has less than MIN_MATCH bytes, ins_h is garbage,
1116 * but this is not important since only literal bytes will be emitted.
1119 } while (s->lookahead < MIN_LOOKAHEAD && s->strm->avail_in != 0);
1122 /* ===========================================================================
1123 * Flush the current block, with given end-of-file flag.
1124 * IN assertion: strstart is set to the end of the current match.
1126 #define FLUSH_BLOCK_ONLY(s, eof) { \
1127 _tr_flush_block(s, (s->block_start >= 0L ? \
1128 (charf *)&s->window[(unsigned)s->block_start] : \
1130 (ulg)((long)s->strstart - s->block_start), \
1132 s->block_start = s->strstart; \
1133 flush_pending(s->strm); \
1134 Tracev((stderr,"[FLUSH]")); \
1137 /* Same but force premature exit if necessary. */
1138 #define FLUSH_BLOCK(s, eof) { \
1139 FLUSH_BLOCK_ONLY(s, eof); \
1140 if (s->strm->avail_out == 0) return (eof) ? finish_started : need_more; \
1143 /* ===========================================================================
1144 * Copy without compression as much as possible from the input stream, return
1145 * the current block state.
1146 * This function does not insert new strings in the dictionary since
1147 * uncompressible data is probably not useful. This function is used
1148 * only for the level=0 compression option.
1149 * NOTE: this function should be optimized to avoid extra copying from
1150 * window to pending_buf.
1152 local block_state deflate_stored(s, flush)
1156 /* Stored blocks are limited to 0xffff bytes, pending_buf is limited
1157 * to pending_buf_size, and each stored block has a 5 byte header:
1159 ulg max_block_size = 0xffff;
1162 if (max_block_size > s->pending_buf_size - 5) {
1163 max_block_size = s->pending_buf_size - 5;
1166 /* Copy as much as possible from input to output: */
1168 /* Fill the window as much as possible: */
1169 if (s->lookahead <= 1) {
1171 Assert(s->strstart < s->w_size+MAX_DIST(s) ||
1172 s->block_start >= (long)s->w_size, "slide too late");
1175 if (s->lookahead == 0 && flush == Z_NO_FLUSH) return need_more;
1177 if (s->lookahead == 0) break; /* flush the current block */
1179 Assert(s->block_start >= 0L, "block gone");
1181 s->strstart += s->lookahead;
1184 /* Emit a stored block if pending_buf will be full: */
1185 max_start = s->block_start + max_block_size;
1186 if (s->strstart == 0 || (ulg)s->strstart >= max_start) {
1187 /* strstart == 0 is possible when wraparound on 16-bit machine */
1188 s->lookahead = (uInt)(s->strstart - max_start);
1189 s->strstart = (uInt)max_start;
1192 /* Flush if we may have to slide, otherwise block_start may become
1193 * negative and the data will be gone:
1195 if (s->strstart - (uInt)s->block_start >= MAX_DIST(s)) {
1199 FLUSH_BLOCK(s, flush == Z_FINISH);
1200 return flush == Z_FINISH ? finish_done : block_done;
1203 /* ===========================================================================
1204 * Compress as much as possible from the input stream, return the current
1206 * This function does not perform lazy evaluation of matches and inserts
1207 * new strings in the dictionary only for unmatched strings or for short
1208 * matches. It is used only for the fast compression options.
1210 local block_state deflate_fast(s, flush)
1214 IPos hash_head = NIL; /* head of the hash chain */
1215 int bflush; /* set if current block must be flushed */
1218 /* Make sure that we always have enough lookahead, except
1219 * at the end of the input file. We need MAX_MATCH bytes
1220 * for the next match, plus MIN_MATCH bytes to insert the
1221 * string following the next match.
1223 if (s->lookahead < MIN_LOOKAHEAD) {
1225 if (s->lookahead < MIN_LOOKAHEAD && flush == Z_NO_FLUSH) {
1228 if (s->lookahead == 0) break; /* flush the current block */
1231 /* Insert the string window[strstart .. strstart+2] in the
1232 * dictionary, and set hash_head to the head of the hash chain:
1234 if (s->lookahead >= MIN_MATCH) {
1235 INSERT_STRING(s, s->strstart, hash_head);
1238 /* Find the longest match, discarding those <= prev_length.
1239 * At this point we have always match_length < MIN_MATCH
1241 if (hash_head != NIL && s->strstart - hash_head <= MAX_DIST(s)) {
1242 /* To simplify the code, we prevent matches with the string
1243 * of window index 0 (in particular we have to avoid a match
1244 * of the string with itself at the start of the input file).
1247 if ((s->strategy < Z_HUFFMAN_ONLY) ||
1248 (s->strategy == Z_RLE && s->strstart - hash_head == 1)) {
1249 s->match_length = longest_match_fast (s, hash_head);
1252 if (s->strategy < Z_HUFFMAN_ONLY) {
1253 s->match_length = longest_match (s, hash_head);
1254 } else if (s->strategy == Z_RLE && s->strstart - hash_head == 1) {
1255 s->match_length = longest_match_fast (s, hash_head);
1258 /* longest_match() or longest_match_fast() sets match_start */
1260 if (s->match_length >= MIN_MATCH) {
1261 check_match(s, s->strstart, s->match_start, s->match_length);
1263 _tr_tally_dist(s, s->strstart - s->match_start,
1264 s->match_length - MIN_MATCH, bflush);
1266 s->lookahead -= s->match_length;
1268 /* Insert new strings in the hash table only if the match length
1269 * is not too large. This saves time but degrades compression.
1272 if (s->match_length <= s->max_insert_length &&
1273 s->lookahead >= MIN_MATCH) {
1274 s->match_length--; /* string at strstart already in hash table */
1277 INSERT_STRING(s, s->strstart, hash_head);
1278 /* strstart never exceeds WSIZE-MAX_MATCH, so there are
1279 * always MIN_MATCH bytes ahead.
1281 } while (--s->match_length != 0);
1286 s->strstart += s->match_length;
1287 s->match_length = 0;
1288 s->ins_h = s->window[s->strstart];
1289 UPDATE_HASH(s, s->ins_h, s->window[s->strstart+1]);
1291 Call UPDATE_HASH() MIN_MATCH-3 more times
1293 /* If lookahead < MIN_MATCH, ins_h is garbage, but it does not
1294 * matter since it will be recomputed at next deflate call.
1298 /* No match, output a literal byte */
1299 Tracevv((stderr,"%c", s->window[s->strstart]));
1300 _tr_tally_lit (s, s->window[s->strstart], bflush);
1304 if (bflush) FLUSH_BLOCK(s, 0);
1306 FLUSH_BLOCK(s, flush == Z_FINISH);
1307 return flush == Z_FINISH ? finish_done : block_done;
1311 /* ===========================================================================
1312 * Same as above, but achieves better compression. We use a lazy
1313 * evaluation for matches: a match is finally adopted only if there is
1314 * no better match at the next window position.
1316 local block_state deflate_slow(s, flush)
1320 IPos hash_head = NIL; /* head of hash chain */
1321 int bflush; /* set if current block must be flushed */
1323 /* Process the input block. */
1325 /* Make sure that we always have enough lookahead, except
1326 * at the end of the input file. We need MAX_MATCH bytes
1327 * for the next match, plus MIN_MATCH bytes to insert the
1328 * string following the next match.
1330 if (s->lookahead < MIN_LOOKAHEAD) {
1332 if (s->lookahead < MIN_LOOKAHEAD && flush == Z_NO_FLUSH) {
1335 if (s->lookahead == 0) break; /* flush the current block */
1338 /* Insert the string window[strstart .. strstart+2] in the
1339 * dictionary, and set hash_head to the head of the hash chain:
1341 if (s->lookahead >= MIN_MATCH) {
1342 INSERT_STRING(s, s->strstart, hash_head);
1345 /* Find the longest match, discarding those <= prev_length.
1347 s->prev_length = s->match_length, s->prev_match = s->match_start;
1348 s->match_length = MIN_MATCH-1;
1350 if (hash_head != NIL && s->prev_length < s->max_lazy_match &&
1351 s->strstart - hash_head <= MAX_DIST(s)) {
1352 /* To simplify the code, we prevent matches with the string
1353 * of window index 0 (in particular we have to avoid a match
1354 * of the string with itself at the start of the input file).
1356 if (s->strategy < Z_HUFFMAN_ONLY) {
1357 s->match_length = longest_match (s, hash_head);
1358 } else if (s->strategy == Z_RLE && s->strstart - hash_head == 1) {
1359 s->match_length = longest_match_fast (s, hash_head);
1361 /* longest_match() or longest_match_fast() sets match_start */
1363 if (s->match_length <= 5 && (s->strategy == Z_FILTERED
1365 || (s->match_length == MIN_MATCH &&
1366 s->strstart - s->match_start > TOO_FAR)
1370 /* If prev_match is also MIN_MATCH, match_start is garbage
1371 * but we will ignore the current match anyway.
1373 s->match_length = MIN_MATCH-1;
1376 /* If there was a match at the previous step and the current
1377 * match is not better, output the previous match:
1379 if (s->prev_length >= MIN_MATCH && s->match_length <= s->prev_length) {
1380 uInt max_insert = s->strstart + s->lookahead - MIN_MATCH;
1381 /* Do not insert strings in hash table beyond this. */
1383 check_match(s, s->strstart-1, s->prev_match, s->prev_length);
1385 _tr_tally_dist(s, s->strstart -1 - s->prev_match,
1386 s->prev_length - MIN_MATCH, bflush);
1388 /* Insert in hash table all strings up to the end of the match.
1389 * strstart-1 and strstart are already inserted. If there is not
1390 * enough lookahead, the last two strings are not inserted in
1393 s->lookahead -= s->prev_length-1;
1394 s->prev_length -= 2;
1396 if (++s->strstart <= max_insert) {
1397 INSERT_STRING(s, s->strstart, hash_head);
1399 } while (--s->prev_length != 0);
1400 s->match_available = 0;
1401 s->match_length = MIN_MATCH-1;
1404 if (bflush) FLUSH_BLOCK(s, 0);
1406 } else if (s->match_available) {
1407 /* If there was no match at the previous position, output a
1408 * single literal. If there was a match but the current match
1409 * is longer, truncate the previous match to a single literal.
1411 Tracevv((stderr,"%c", s->window[s->strstart-1]));
1412 _tr_tally_lit(s, s->window[s->strstart-1], bflush);
1414 FLUSH_BLOCK_ONLY(s, 0);
1418 if (s->strm->avail_out == 0) return need_more;
1420 /* There is no previous match to compare with, wait for
1421 * the next step to decide.
1423 s->match_available = 1;
1428 Assert (flush != Z_NO_FLUSH, "no flush?");
1429 if (s->match_available) {
1430 Tracevv((stderr,"%c", s->window[s->strstart-1]));
1431 _tr_tally_lit(s, s->window[s->strstart-1], bflush);
1432 s->match_available = 0;
1434 FLUSH_BLOCK(s, flush == Z_FINISH);
1435 return flush == Z_FINISH ? finish_done : block_done;
1437 #endif /* FASTEST */