| 1 | 
 1. Compression algorithm (deflate) | 
 
 
 
 
 
 | 2 | 
  | 
 
 
 
 
 
 | 3 | 
 The deflation algorithm used by gzip (also zip and zlib) is a variation of | 
 
 
 
 
 
 | 4 | 
 LZ77 (Lempel-Ziv 1977, see reference below). It finds duplicated strings in | 
 
 
 
 
 
 | 5 | 
 the input data.  The second occurrence of a string is replaced by a | 
 
 
 
 
 
 | 6 | 
 pointer to the previous string, in the form of a pair (distance, | 
 
 
 
 
 
 | 7 | 
 length).  Distances are limited to 32K bytes, and lengths are limited | 
 
 
 
 
 
 | 8 | 
 to 258 bytes. When a string does not occur anywhere in the previous | 
 
 
 
 
 
 | 9 | 
 32K bytes, it is emitted as a sequence of literal bytes.  (In this | 
 
 
 
 
 
 | 10 | 
 description, `string' must be taken as an arbitrary sequence of bytes, | 
 
 
 
 
 
 | 11 | 
 and is not restricted to printable characters.) | 
 
 
 
 
 
 | 12 | 
  | 
 
 
 
 
 
 | 13 | 
 Literals or match lengths are compressed with one Huffman tree, and | 
 
 
 
 
 
 | 14 | 
 match distances are compressed with another tree. The trees are stored | 
 
 
 
 
 
 | 15 | 
 in a compact form at the start of each block. The blocks can have any | 
 
 
 
 
 
 | 16 | 
 size (except that the compressed data for one block must fit in | 
 
 
 
 
 
 | 17 | 
 available memory). A block is terminated when deflate() determines that | 
 
 
 
 
 
 | 18 | 
 it would be useful to start another block with fresh trees. (This is | 
 
 
 
 
 
 | 19 | 
 somewhat similar to the behavior of LZW-based _compress_.) | 
 
 
 
 
 
 | 20 | 
  | 
 
 
 
 
 
 | 21 | 
 Duplicated strings are found using a hash table. All input strings of | 
 
 
 
 
 
 | 22 | 
 length 3 are inserted in the hash table. A hash index is computed for | 
 
 
 
 
 
 | 23 | 
 the next 3 bytes. If the hash chain for this index is not empty, all | 
 
 
 
 
 
 | 24 | 
 strings in the chain are compared with the current input string, and | 
 
 
 
 
 
 | 25 | 
 the longest match is selected. | 
 
 
 
 
 
 | 26 | 
  | 
 
 
 
 
 
 | 27 | 
 The hash chains are searched starting with the most recent strings, to | 
 
 
 
 
 
 | 28 | 
 favor small distances and thus take advantage of the Huffman encoding. | 
 
 
 
 
 
 | 29 | 
 The hash chains are singly linked. There are no deletions from the | 
 
 
 
 
 
 | 30 | 
 hash chains, the algorithm simply discards matches that are too old. | 
 
 
 
 
 
 | 31 | 
  | 
 
 
 
 
 
 | 32 | 
 To avoid a worst-case situation, very long hash chains are arbitrarily | 
 
 
 
 
 
 | 33 | 
 truncated at a certain length, determined by a runtime option (level | 
 
 
 
 
 
 | 34 | 
 parameter of deflateInit). So deflate() does not always find the longest | 
 
 
 
 
 
 | 35 | 
 possible match but generally finds a match which is long enough. | 
 
 
 
 
 
 | 36 | 
  | 
 
 
 
 
 
 | 37 | 
 deflate() also defers the selection of matches with a lazy evaluation | 
 
 
 
 
 
 | 38 | 
 mechanism. After a match of length N has been found, deflate() searches for | 
 
 
 
 
 
 | 39 | 
 a longer match at the next input byte. If a longer match is found, the | 
 
 
 
 
 
 | 40 | 
 previous match is truncated to a length of one (thus producing a single | 
 
 
 
 
 
 | 41 | 
 literal byte) and the process of lazy evaluation begins again. Otherwise, | 
 
 
 
 
 
 | 42 | 
 the original match is kept, and the next match search is attempted only N | 
 
 
 
 
 
 | 43 | 
 steps later. | 
 
 
 
 
 
 | 44 | 
  | 
 
 
 
 
 
 | 45 | 
 The lazy match evaluation is also subject to a runtime parameter. If | 
 
 
 
 
 
 | 46 | 
 the current match is long enough, deflate() reduces the search for a longer | 
 
 
 
 
 
 | 47 | 
 match, thus speeding up the whole process. If compression ratio is more | 
 
 
 
 
 
 | 48 | 
 important than speed, deflate() attempts a complete second search even if | 
 
 
 
 
 
 | 49 | 
 the first match is already long enough. | 
 
 
 
 
 
 | 50 | 
  | 
 
 
 
 
 
 | 51 | 
 The lazy match evaluation is not performed for the fastest compression | 
 
 
 
 
 
 | 52 | 
 modes (level parameter 1 to 3). For these fast modes, new strings | 
 
 
 
 
 
 | 53 | 
 are inserted in the hash table only when no match was found, or | 
 
 
 
 
 
 | 54 | 
 when the match is not too long. This degrades the compression ratio | 
 
 
 
 
 
 | 55 | 
 but saves time since there are both fewer insertions and fewer searches. | 
 
 
 
 
 
 | 56 | 
  | 
 
 
 
 
 
 | 57 | 
  | 
 
 
 
 
 
 | 58 | 
 2. Decompression algorithm (inflate) | 
 
 
 
 
 
 | 59 | 
  | 
 
 
 
 
 
 | 60 | 
 2.1 Introduction | 
 
 
 
 
 
 | 61 | 
  | 
 
 
 
 
 
 | 62 | 
 The key question is how to represent a Huffman code (or any prefix code) so | 
 
 
 
 
 
 | 63 | 
 that you can decode fast.  The most important characteristic is that shorter | 
 
 
 
 
 
 | 64 | 
 codes are much more common than longer codes, so pay attention to decoding the | 
 
 
 
 
 
 | 65 | 
 short codes fast, and let the long codes take longer to decode. | 
 
 
 
 
 
 | 66 | 
  | 
 
 
 
 
 
 | 67 | 
 inflate() sets up a first level table that covers some number of bits of | 
 
 
 
 
 
 | 68 | 
 input less than the length of longest code.  It gets that many bits from the | 
 
 
 
 
 
 | 69 | 
 stream, and looks it up in the table.  The table will tell if the next | 
 
 
 
 
 
 | 70 | 
 code is that many bits or less and how many, and if it is, it will tell | 
 
 
 
 
 
 | 71 | 
 the value, else it will point to the next level table for which inflate() | 
 
 
 
 
 
 | 72 | 
 grabs more bits and tries to decode a longer code. | 
 
 
 
 
 
 | 73 | 
  | 
 
 
 
 
 
 | 74 | 
 How many bits to make the first lookup is a tradeoff between the time it | 
 
 
 
 
 
 | 75 | 
 takes to decode and the time it takes to build the table.  If building the | 
 
 
 
 
 
 | 76 | 
 table took no time (and if you had infinite memory), then there would only | 
 
 
 
 
 
 | 77 | 
 be a first level table to cover all the way to the longest code.  However, | 
 
 
 
 
 
 | 78 | 
 building the table ends up taking a lot longer for more bits since short | 
 
 
 
 
 
 | 79 | 
 codes are replicated many times in such a table.  What inflate() does is | 
 
 
 
 
 
 | 80 | 
 simply to make the number of bits in the first table a variable, and  then | 
 
 
 
 
 
 | 81 | 
 to set that variable for the maximum speed. | 
 
 
 
 
 
 | 82 | 
  | 
 
 
 
 
 
 | 83 | 
 For inflate, which has 286 possible codes for the literal/length tree, the size | 
 
 
 
 
 
 | 84 | 
 of the first table is nine bits.  Also the distance trees have 30 possible | 
 
 
 
 
 
 | 85 | 
 values, and the size of the first table is six bits.  Note that for each of | 
 
 
 
 
 
 | 86 | 
 those cases, the table ended up one bit longer than the ``average'' code | 
 
 
 
 
 
 | 87 | 
 length, i.e. the code length of an approximately flat code which would be a | 
 
 
 
 
 
 | 88 | 
 little more than eight bits for 286 symbols and a little less than five bits | 
 
 
 
 
 
 | 89 | 
 for 30 symbols. | 
 
 
 
 
 
 | 90 | 
  | 
 
 
 
 
 
 | 91 | 
  | 
 
 
 
 
 
 | 92 | 
 2.2 More details on the inflate table lookup | 
 
 
 
 
 
 | 93 | 
  | 
 
 
 
 
 
 | 94 | 
 Ok, you want to know what this cleverly obfuscated inflate tree actually | 
 
 
 
 
 
 | 95 | 
 looks like.  You are correct that it's not a Huffman tree.  It is simply a | 
 
 
 
 
 
 | 96 | 
 lookup table for the first, let's say, nine bits of a Huffman symbol.  The | 
 
 
 
 
 
 | 97 | 
 symbol could be as short as one bit or as long as 15 bits.  If a particular | 
 
 
 
 
 
 | 98 | 
 symbol is shorter than nine bits, then that symbol's translation is duplicated | 
 
 
 
 
 
 | 99 | 
 in all those entries that start with that symbol's bits.  For example, if the | 
 
 
 
 
 
 | 100 | 
 symbol is four bits, then it's duplicated 32 times in a nine-bit table.  If a | 
 
 
 
 
 
 | 101 | 
 symbol is nine bits long, it appears in the table once. | 
 
 
 
 
 
 | 102 | 
  | 
 
 
 
 
 
 | 103 | 
 If the symbol is longer than nine bits, then that entry in the table points | 
 
 
 
 
 
 | 104 | 
 to another similar table for the remaining bits.  Again, there are duplicated | 
 
 
 
 
 
 | 105 | 
 entries as needed.  The idea is that most of the time the symbol will be short | 
 
 
 
 
 
 | 106 | 
 and there will only be one table look up.  (That's whole idea behind data | 
 
 
 
 
 
 | 107 | 
 compression in the first place.)  For the less frequent long symbols, there | 
 
 
 
 
 
 | 108 | 
 will be two lookups.  If you had a compression method with really long | 
 
 
 
 
 
 | 109 | 
 symbols, you could have as many levels of lookups as is efficient.  For | 
 
 
 
 
 
 | 110 | 
 inflate, two is enough. | 
 
 
 
 
 
 | 111 | 
  | 
 
 
 
 
 
 | 112 | 
 So a table entry either points to another table (in which case nine bits in | 
 
 
 
 
 
 | 113 | 
 the above example are gobbled), or it contains the translation for the symbol | 
 
 
 
 
 
 | 114 | 
 and the number of bits to gobble.  Then you start again with the next | 
 
 
 
 
 
 | 115 | 
 ungobbled bit. | 
 
 
 
 
 
 | 116 | 
  | 
 
 
 
 
 
 | 117 | 
 You may wonder: why not just have one lookup table for how ever many bits the | 
 
 
 
 
 
 | 118 | 
 longest symbol is?  The reason is that if you do that, you end up spending | 
 
 
 
 
 
 | 119 | 
 more time filling in duplicate symbol entries than you do actually decoding. | 
 
 
 
 
 
 | 120 | 
 At least for deflate's output that generates new trees every several 10's of | 
 
 
 
 
 
 | 121 | 
 kbytes.  You can imagine that filling in a 2^15 entry table for a 15-bit code | 
 
 
 
 
 
 | 122 | 
 would take too long if you're only decoding several thousand symbols.  At the | 
 
 
 
 
 
 | 123 | 
 other extreme, you could make a new table for every bit in the code.  In fact, | 
 
 
 
 
 
 | 124 | 
 that's essentially a Huffman tree.  But then you spend too much time | 
 
 
 
 
 
 | 125 | 
 traversing the tree while decoding, even for short symbols. | 
 
 
 
 
 
 | 126 | 
  | 
 
 
 
 
 
 | 127 | 
 So the number of bits for the first lookup table is a trade of the time to | 
 
 
 
 
 
 | 128 | 
 fill out the table vs. the time spent looking at the second level and above of | 
 
 
 
 
 
 | 129 | 
 the table. | 
 
 
 
 
 
 | 130 | 
  | 
 
 
 
 
 
 | 131 | 
 Here is an example, scaled down: | 
 
 
 
 
 
 | 132 | 
  | 
 
 
 
 
 
 | 133 | 
 The code being decoded, with 10 symbols, from 1 to 6 bits long: | 
 
 
 
 
 
 | 134 | 
  | 
 
 
 
 
 
 | 135 | 
 A: 0 | 
 
 
 
 
 
 | 136 | 
 B: 10 | 
 
 
 
 
 
 | 137 | 
 C: 1100 | 
 
 
 
 
 
 | 138 | 
 D: 11010 | 
 
 
 
 
 
 | 139 | 
 E: 11011 | 
 
 
 
 
 
 | 140 | 
 F: 11100 | 
 
 
 
 
 
 | 141 | 
 G: 11101 | 
 
 
 
 
 
 | 142 | 
 H: 11110 | 
 
 
 
 
 
 | 143 | 
 I: 111110 | 
 
 
 
 
 
 | 144 | 
 J: 111111 | 
 
 
 
 
 
 | 145 | 
  | 
 
 
 
 
 
 | 146 | 
 Let's make the first table three bits long (eight entries): | 
 
 
 
 
 
 | 147 | 
  | 
 
 
 
 
 
 | 148 | 
 000: A,1 | 
 
 
 
 
 
 | 149 | 
 001: A,1 | 
 
 
 
 
 
 | 150 | 
 010: A,1 | 
 
 
 
 
 
 | 151 | 
 011: A,1 | 
 
 
 
 
 
 | 152 | 
 100: B,2 | 
 
 
 
 
 
 | 153 | 
 101: B,2 | 
 
 
 
 
 
 | 154 | 
 110: -> table X (gobble 3 bits) | 
 
 
 
 
 
 | 155 | 
 111: -> table Y (gobble 3 bits) | 
 
 
 
 
 
 | 156 | 
  | 
 
 
 
 
 
 | 157 | 
 Each entry is what the bits decode as and how many bits that is, i.e. how | 
 
 
 
 
 
 | 158 | 
 many bits to gobble.  Or the entry points to another table, with the number of | 
 
 
 
 
 
 | 159 | 
 bits to gobble implicit in the size of the table. | 
 
 
 
 
 
 | 160 | 
  | 
 
 
 
 
 
 | 161 | 
 Table X is two bits long since the longest code starting with 110 is five bits | 
 
 
 
 
 
 | 162 | 
 long: | 
 
 
 
 
 
 | 163 | 
  | 
 
 
 
 
 
 | 164 | 
 00: C,1 | 
 
 
 
 
 
 | 165 | 
 01: C,1 | 
 
 
 
 
 
 | 166 | 
 10: D,2 | 
 
 
 
 
 
 | 167 | 
 11: E,2 | 
 
 
 
 
 
 | 168 | 
  | 
 
 
 
 
 
 | 169 | 
 Table Y is three bits long since the longest code starting with 111 is six | 
 
 
 
 
 
 | 170 | 
 bits long: | 
 
 
 
 
 
 | 171 | 
  | 
 
 
 
 
 
 | 172 | 
 000: F,2 | 
 
 
 
 
 
 | 173 | 
 001: F,2 | 
 
 
 
 
 
 | 174 | 
 010: G,2 | 
 
 
 
 
 
 | 175 | 
 011: G,2 | 
 
 
 
 
 
 | 176 | 
 100: H,2 | 
 
 
 
 
 
 | 177 | 
 101: H,2 | 
 
 
 
 
 
 | 178 | 
 110: I,3 | 
 
 
 
 
 
 | 179 | 
 111: J,3 | 
 
 
 
 
 
 | 180 | 
  | 
 
 
 
 
 
 | 181 | 
 So what we have here are three tables with a total of 20 entries that had to | 
 
 
 
 
 
 | 182 | 
 be constructed.  That's compared to 64 entries for a single table.  Or | 
 
 
 
 
 
 | 183 | 
 compared to 16 entries for a Huffman tree (six two entry tables and one four | 
 
 
 
 
 
 | 184 | 
 entry table).  Assuming that the code ideally represents the probability of | 
 
 
 
 
 
 | 185 | 
 the symbols, it takes on the average 1.25 lookups per symbol.  That's compared | 
 
 
 
 
 
 | 186 | 
 to one lookup for the single table, or 1.66 lookups per symbol for the | 
 
 
 
 
 
 | 187 | 
 Huffman tree. | 
 
 
 
 
 
 | 188 | 
  | 
 
 
 
 
 
 | 189 | 
 There, I think that gives you a picture of what's going on.  For inflate, the | 
 
 
 
 
 
 | 190 | 
 meaning of a particular symbol is often more than just a letter.  It can be a | 
 
 
 
 
 
 | 191 | 
 byte (a "literal"), or it can be either a length or a distance which | 
 
 
 
 
 
 | 192 | 
 indicates a base value and a number of bits to fetch after the code that is | 
 
 
 
 
 
 | 193 | 
 added to the base value.  Or it might be the special end-of-block code.  The | 
 
 
 
 
 
 | 194 | 
 data structures created in inftrees.c try to encode all that information | 
 
 
 
 
 
 | 195 | 
 compactly in the tables. | 
 
 
 
 
 
 | 196 | 
  | 
 
 
 
 
 
 | 197 | 
  | 
 
 
 
 
 
 | 198 | 
 Jean-loup Gailly        Mark Adler | 
 
 
 
 
 
 | 199 | 
 jloup@gzip.org          madler@alumni.caltech.edu | 
 
 
 
 
 
 | 200 | 
  | 
 
 
 
 
 
 | 201 | 
  | 
 
 
 
 
 
 | 202 | 
 References: | 
 
 
 
 
 
 | 203 | 
  | 
 
 
 
 
 
 | 204 | 
 [LZ77] Ziv J., Lempel A., ``A Universal Algorithm for Sequential Data | 
 
 
 
 
 
 | 205 | 
 Compression,'' IEEE Transactions on Information Theory, Vol. 23, No. 3, | 
 
 
 
 
 
 | 206 | 
 pp. 337-343. | 
 
 
 
 
 
 | 207 | 
  | 
 
 
 
 
 
 | 208 | 
 ``DEFLATE Compressed Data Format Specification'' available in | 
 
 
 
 
 
 | 209 | 
 http://tools.ietf.org/html/rfc1951 |