mirror of
https://github.com/MariaDB/server.git
synced 2025-01-16 12:02:42 +01:00
9fe0a2fa8d
usable for unix builds": zlib 1.2.1 imported BitKeeper/deleted/.del-Make_vms.com~95dd9cc7505c3153: Delete: zlib/Make_vms.com BitKeeper/deleted/.del-Makefile.riscos~f85c6493d3e51733: Delete: zlib/Makefile.riscos BitKeeper/deleted/.del-Makefile.pup~b0e9ed99224cc5f4: Delete: zlib/amiga/Makefile.pup BitKeeper/deleted/.del-Makefile.sas~be103e936c85b66a: Delete: zlib/amiga/Makefile.sas BitKeeper/deleted/.del-README.contrib~2924ba28ef1f9fab: Delete: zlib/contrib/README.contrib BitKeeper/deleted/.del-gvmat32.asm~edf721a2de30e964: Delete: zlib/contrib/asm386/gvmat32.asm BitKeeper/deleted/.del-visual-basic.txt~859fcbcb668ffbb3: Delete: zlib/contrib/visual-basic.txt BitKeeper/deleted/.del-gvmat32c.c~2e97d7d65dd59113: Delete: zlib/contrib/asm386/gvmat32c.c BitKeeper/deleted/.del-mkgvmt32.bat~5a92cf0febe3dc81: Delete: zlib/contrib/asm386/mkgvmt32.bat BitKeeper/deleted/.del-zlibvc.def~67961fa7815b9267: Delete: zlib/contrib/asm386/zlibvc.def BitKeeper/deleted/.del-zlibvc.dsp~a3323c77bcd12995: Delete: zlib/contrib/asm386/zlibvc.dsp BitKeeper/deleted/.del-match.s~51b8fef5136642ed: Delete: zlib/contrib/asm586/match.s BitKeeper/deleted/.del-readme.586~cb1bb7136b0803bb: Delete: zlib/contrib/asm586/readme.586 BitKeeper/deleted/.del-zlibvc.dsw~e3dca9d8f342e64e: Delete: zlib/contrib/asm386/zlibvc.dsw BitKeeper/deleted/.del-match.s~e4bbe1fa486d1c6c: Delete: zlib/contrib/asm686/match.s BitKeeper/deleted/.del-readme.686~98a220c13809fce5: Delete: zlib/contrib/asm686/readme.686 BitKeeper/deleted/.del-zlib.mak~70f7c5f6947fd807: Delete: zlib/contrib/delphi/zlib.mak BitKeeper/deleted/.del-d_zlib.bpr~cefb1beee520d6e8: Delete: zlib/contrib/delphi2/d_zlib.bpr BitKeeper/deleted/.del-d_zlib.cpp~62dff1931881afa6: Delete: zlib/contrib/delphi2/d_zlib.cpp BitKeeper/deleted/.del-zlibdef.pas~780244c8d12b6c53: Delete: zlib/contrib/delphi/zlibdef.pas BitKeeper/deleted/.del-readme.txt~8222e54ca00f2729: Delete: zlib/contrib/delphi2/readme.txt BitKeeper/deleted/.del-zlib.bpg~fbd9308275ad8e3: Delete: zlib/contrib/delphi2/zlib.bpg BitKeeper/deleted/.del-zlib.bpr~fe8bf5d1c4a2ce5a: Delete: zlib/contrib/delphi2/zlib.bpr BitKeeper/deleted/.del-zlib.cpp~bb0c3df062410f5c: Delete: zlib/contrib/delphi2/zlib.cpp BitKeeper/deleted/.del-zlib.pas~1d5285e2449b50a3: Delete: zlib/contrib/delphi2/zlib.pas BitKeeper/deleted/.del-zlib32.bpr~c2a9f0aa47a1d9ad: Delete: zlib/contrib/delphi2/zlib32.bpr BitKeeper/deleted/.del-test.cpp~4480297b204dc360: Delete: zlib/contrib/iostream/test.cpp BitKeeper/deleted/.del-zfstream.cpp~943ecbd558e86dde: Delete: zlib/contrib/iostream/zfstream.cpp BitKeeper/deleted/.del-zlib32.cpp~bbb4a200d2fe6497: Delete: zlib/contrib/delphi2/zlib32.cpp BitKeeper/deleted/.del-ChangeLogUnzip~a3ae0ba899cadd: Delete: zlib/contrib/minizip/ChangeLogUnzip BitKeeper/deleted/.del-zfstream.h~71ee057bdc6366ac: Delete: zlib/contrib/iostream/zfstream.h BitKeeper/deleted/.del-zstream.h~a6f6be5634962c81: Delete: zlib/contrib/iostream2/zstream.h BitKeeper/deleted/.del-zstream_test.cpp~e471b51e7fb553ec: Delete: zlib/contrib/iostream2/zstream_test.cpp BitKeeper/deleted/.del-miniunz.c~9da181975b3a48: Delete: zlib/contrib/minizip/miniunz.c BitKeeper/deleted/.del-minizip.c~4a49a0addb97272b: Delete: zlib/contrib/minizip/minizip.c BitKeeper/deleted/.del-readme.txt~174eb00680149f6b: Delete: zlib/contrib/minizip/readme.txt BitKeeper/deleted/.del-unzip.c~662c5ba4edbb3a19: Delete: zlib/contrib/minizip/unzip.c BitKeeper/deleted/.del-unzip.def~8a0ad6f745ee5cd4: Delete: zlib/contrib/minizip/unzip.def BitKeeper/deleted/.del-unzip.h~d5e800088a368c32: Delete: zlib/contrib/minizip/unzip.h BitKeeper/deleted/.del-zip.c~9750c19a123f3057: Delete: zlib/contrib/minizip/zip.c BitKeeper/deleted/.del-zip.def~4ffe888e9fd7b5aa: Delete: zlib/contrib/minizip/zip.def BitKeeper/deleted/.del-zip.h~4c72b8fcc492f055: Delete: zlib/contrib/minizip/zip.h BitKeeper/deleted/.del-zlibvc.def~dd272b3ed71647ba: Delete: zlib/contrib/minizip/zlibvc.def BitKeeper/deleted/.del-zlibvc.dsp~ad83fb048811e2d2: Delete: zlib/contrib/minizip/zlibvc.dsp BitKeeper/deleted/.del-zlibvc.dsw~c66b33a2d52f37c5: Delete: zlib/contrib/minizip/zlibvc.dsw BitKeeper/deleted/.del-makefile.w32~6507530fa1b017c: Delete: zlib/contrib/untgz/makefile.w32 BitKeeper/deleted/.del-untgz.c~4e8f1a3a2c145373: Delete: zlib/contrib/untgz/untgz.c BitKeeper/deleted/.del-Makefile.os2~8ab058477b24d1ff: Delete: zlib/os2/Makefile.os2 BitKeeper/deleted/.del-zlib.def~385b56ed82784ff3: Delete: zlib/os2/zlib.def BitKeeper/deleted/.del-Makefile.b32~10ffaac6cc41847a: Delete: zlib/msdos/Makefile.b32 BitKeeper/deleted/.del-Makefile.bor~121b2bc837b6367: Delete: zlib/msdos/Makefile.bor BitKeeper/deleted/.del-Makefile.dj2~a069623cad6ce7f4: Delete: zlib/msdos/Makefile.dj2 BitKeeper/deleted/.del-Makefile.emx~11a9e6c8a719ba60: Delete: zlib/msdos/Makefile.emx BitKeeper/deleted/.del-Makefile.msc~ba5ad7709ff22aab: Delete: zlib/msdos/Makefile.msc BitKeeper/deleted/.del-Makefile.tc~d1398368648e8836: Delete: zlib/msdos/Makefile.tc BitKeeper/deleted/.del-Makefile.w32~921a473e873d94d1: Delete: zlib/msdos/Makefile.w32 BitKeeper/deleted/.del-Makefile.wat~b2b51cbc2c2bc2f4: Delete: zlib/msdos/Makefile.wat BitKeeper/deleted/.del-zlib.def~189fba701e5e4b9c: Delete: zlib/msdos/zlib.def BitKeeper/deleted/.del-zlib.rc~e5ce22c7c915ec00: Delete: zlib/msdos/zlib.rc BitKeeper/deleted/.del-Makefile.emx~b5fa0633cbe6fe01: Delete: zlib/nt/Makefile.emx BitKeeper/deleted/.del-Makefile.gcc~7fcd3dd326341fa0: Delete: zlib/nt/Makefile.gcc BitKeeper/deleted/.del-Makefile.nt~9910c98f5da056de: Delete: zlib/nt/Makefile.nt BitKeeper/deleted/.del-zlib.dnt~8160c636eb3eeed7: Delete: zlib/nt/zlib.dnt BitKeeper/deleted/.del-zlib.dsp~a8abac2fb721276e: Delete: zlib/zlib.dsp BitKeeper/deleted/.del-zlib.html~2e74efd497dcd4d0: Delete: zlib/zlib.html BitKeeper/deleted/.del-minigzip.c~1f21a5863f457cb0: Delete: zlib/minigzip.c BitKeeper/deleted/.del-example.c~5ea43c929ccd2a4f: Delete: zlib/example.c BitKeeper/deleted/.del-descrip.mms~51cd5d1792d76b9c: Delete: zlib/descrip.mms BitKeeper/deleted/.del-infblock.h~7d4f40c3a1d4cdf8: Delete: zlib/infblock.h BitKeeper/deleted/.del-infblock.c~3c866934e0f44c43: Delete: zlib/infblock.c BitKeeper/deleted/.del-infutil.c~43d2340436244b52: Delete: zlib/infutil.c BitKeeper/deleted/.del-infutil.h~a6bd0dcbbdc187ac: Delete: zlib/infutil.h BitKeeper/deleted/.del-infcodes.h~c9f64a612c2cc56a: Delete: zlib/infcodes.h BitKeeper/deleted/.del-infcodes.c~7ed73df8a54d6d55: Delete: zlib/infcodes.c BitKeeper/deleted/.del-maketree.c~846b8b96ac6872d8: Delete: zlib/maketree.c VC++Files/zlib/zlib.dsp: Modified to suit zlib upgrade. mysys/my_crc32.c: Modified to suit zlib upgrade. zlib/ChangeLog: zlib 1.2.1 imported zlib/FAQ: zlib 1.2.1 imported zlib/INDEX: zlib 1.2.1 imported zlib/README: zlib 1.2.1 imported zlib/adler32.c: zlib 1.2.1 imported zlib/algorithm.txt: zlib 1.2.1 imported zlib/compress.c: zlib 1.2.1 imported zlib/crc32.c: zlib 1.2.1 imported zlib/deflate.c: zlib 1.2.1 imported zlib/deflate.h: zlib 1.2.1 imported zlib/gzio.c: zlib 1.2.1 imported zlib/inffast.c: zlib 1.2.1 imported zlib/inffast.h: zlib 1.2.1 imported zlib/inffixed.h: zlib 1.2.1 imported zlib/inflate.c: zlib 1.2.1 imported zlib/inftrees.c: zlib 1.2.1 imported zlib/inftrees.h: zlib 1.2.1 imported zlib/trees.c: zlib 1.2.1 imported zlib/uncompr.c: zlib 1.2.1 imported zlib/zconf.h: zlib 1.2.1 imported zlib/zlib.3: zlib 1.2.1 imported zlib/zlib.h: zlib 1.2.1 imported zlib/zutil.c: zlib 1.2.1 imported zlib/zutil.h: zlib 1.2.1 imported
209 lines
9.1 KiB
Text
209 lines
9.1 KiB
Text
1. Compression algorithm (deflate)
|
|
|
|
The deflation algorithm used by gzip (also zip and zlib) is a variation of
|
|
LZ77 (Lempel-Ziv 1977, see reference below). It finds duplicated strings in
|
|
the input data. The second occurrence of a string is replaced by a
|
|
pointer to the previous string, in the form of a pair (distance,
|
|
length). Distances are limited to 32K bytes, and lengths are limited
|
|
to 258 bytes. When a string does not occur anywhere in the previous
|
|
32K bytes, it is emitted as a sequence of literal bytes. (In this
|
|
description, `string' must be taken as an arbitrary sequence of bytes,
|
|
and is not restricted to printable characters.)
|
|
|
|
Literals or match lengths are compressed with one Huffman tree, and
|
|
match distances are compressed with another tree. The trees are stored
|
|
in a compact form at the start of each block. The blocks can have any
|
|
size (except that the compressed data for one block must fit in
|
|
available memory). A block is terminated when deflate() determines that
|
|
it would be useful to start another block with fresh trees. (This is
|
|
somewhat similar to the behavior of LZW-based _compress_.)
|
|
|
|
Duplicated strings are found using a hash table. All input strings of
|
|
length 3 are inserted in the hash table. A hash index is computed for
|
|
the next 3 bytes. If the hash chain for this index is not empty, all
|
|
strings in the chain are compared with the current input string, and
|
|
the longest match is selected.
|
|
|
|
The hash chains are searched starting with the most recent strings, to
|
|
favor small distances and thus take advantage of the Huffman encoding.
|
|
The hash chains are singly linked. There are no deletions from the
|
|
hash chains, the algorithm simply discards matches that are too old.
|
|
|
|
To avoid a worst-case situation, very long hash chains are arbitrarily
|
|
truncated at a certain length, determined by a runtime option (level
|
|
parameter of deflateInit). So deflate() does not always find the longest
|
|
possible match but generally finds a match which is long enough.
|
|
|
|
deflate() also defers the selection of matches with a lazy evaluation
|
|
mechanism. After a match of length N has been found, deflate() searches for
|
|
a longer match at the next input byte. If a longer match is found, the
|
|
previous match is truncated to a length of one (thus producing a single
|
|
literal byte) and the process of lazy evaluation begins again. Otherwise,
|
|
the original match is kept, and the next match search is attempted only N
|
|
steps later.
|
|
|
|
The lazy match evaluation is also subject to a runtime parameter. If
|
|
the current match is long enough, deflate() reduces the search for a longer
|
|
match, thus speeding up the whole process. If compression ratio is more
|
|
important than speed, deflate() attempts a complete second search even if
|
|
the first match is already long enough.
|
|
|
|
The lazy match evaluation is not performed for the fastest compression
|
|
modes (level parameter 1 to 3). For these fast modes, new strings
|
|
are inserted in the hash table only when no match was found, or
|
|
when the match is not too long. This degrades the compression ratio
|
|
but saves time since there are both fewer insertions and fewer searches.
|
|
|
|
|
|
2. Decompression algorithm (inflate)
|
|
|
|
2.1 Introduction
|
|
|
|
The key question is how to represent a Huffman code (or any prefix code) so
|
|
that you can decode fast. The most important characteristic is that shorter
|
|
codes are much more common than longer codes, so pay attention to decoding the
|
|
short codes fast, and let the long codes take longer to decode.
|
|
|
|
inflate() sets up a first level table that covers some number of bits of
|
|
input less than the length of longest code. It gets that many bits from the
|
|
stream, and looks it up in the table. The table will tell if the next
|
|
code is that many bits or less and how many, and if it is, it will tell
|
|
the value, else it will point to the next level table for which inflate()
|
|
grabs more bits and tries to decode a longer code.
|
|
|
|
How many bits to make the first lookup is a tradeoff between the time it
|
|
takes to decode and the time it takes to build the table. If building the
|
|
table took no time (and if you had infinite memory), then there would only
|
|
be a first level table to cover all the way to the longest code. However,
|
|
building the table ends up taking a lot longer for more bits since short
|
|
codes are replicated many times in such a table. What inflate() does is
|
|
simply to make the number of bits in the first table a variable, and then
|
|
to set that variable for the maximum speed.
|
|
|
|
For inflate, which has 286 possible codes for the literal/length tree, the size
|
|
of the first table is nine bits. Also the distance trees have 30 possible
|
|
values, and the size of the first table is six bits. Note that for each of
|
|
those cases, the table ended up one bit longer than the ``average'' code
|
|
length, i.e. the code length of an approximately flat code which would be a
|
|
little more than eight bits for 286 symbols and a little less than five bits
|
|
for 30 symbols.
|
|
|
|
|
|
2.2 More details on the inflate table lookup
|
|
|
|
Ok, you want to know what this cleverly obfuscated inflate tree actually
|
|
looks like. You are correct that it's not a Huffman tree. It is simply a
|
|
lookup table for the first, let's say, nine bits of a Huffman symbol. The
|
|
symbol could be as short as one bit or as long as 15 bits. If a particular
|
|
symbol is shorter than nine bits, then that symbol's translation is duplicated
|
|
in all those entries that start with that symbol's bits. For example, if the
|
|
symbol is four bits, then it's duplicated 32 times in a nine-bit table. If a
|
|
symbol is nine bits long, it appears in the table once.
|
|
|
|
If the symbol is longer than nine bits, then that entry in the table points
|
|
to another similar table for the remaining bits. Again, there are duplicated
|
|
entries as needed. The idea is that most of the time the symbol will be short
|
|
and there will only be one table look up. (That's whole idea behind data
|
|
compression in the first place.) For the less frequent long symbols, there
|
|
will be two lookups. If you had a compression method with really long
|
|
symbols, you could have as many levels of lookups as is efficient. For
|
|
inflate, two is enough.
|
|
|
|
So a table entry either points to another table (in which case nine bits in
|
|
the above example are gobbled), or it contains the translation for the symbol
|
|
and the number of bits to gobble. Then you start again with the next
|
|
ungobbled bit.
|
|
|
|
You may wonder: why not just have one lookup table for how ever many bits the
|
|
longest symbol is? The reason is that if you do that, you end up spending
|
|
more time filling in duplicate symbol entries than you do actually decoding.
|
|
At least for deflate's output that generates new trees every several 10's of
|
|
kbytes. You can imagine that filling in a 2^15 entry table for a 15-bit code
|
|
would take too long if you're only decoding several thousand symbols. At the
|
|
other extreme, you could make a new table for every bit in the code. In fact,
|
|
that's essentially a Huffman tree. But then you spend two much time
|
|
traversing the tree while decoding, even for short symbols.
|
|
|
|
So the number of bits for the first lookup table is a trade of the time to
|
|
fill out the table vs. the time spent looking at the second level and above of
|
|
the table.
|
|
|
|
Here is an example, scaled down:
|
|
|
|
The code being decoded, with 10 symbols, from 1 to 6 bits long:
|
|
|
|
A: 0
|
|
B: 10
|
|
C: 1100
|
|
D: 11010
|
|
E: 11011
|
|
F: 11100
|
|
G: 11101
|
|
H: 11110
|
|
I: 111110
|
|
J: 111111
|
|
|
|
Let's make the first table three bits long (eight entries):
|
|
|
|
000: A,1
|
|
001: A,1
|
|
010: A,1
|
|
011: A,1
|
|
100: B,2
|
|
101: B,2
|
|
110: -> table X (gobble 3 bits)
|
|
111: -> table Y (gobble 3 bits)
|
|
|
|
Each entry is what the bits decode as and how many bits that is, i.e. how
|
|
many bits to gobble. Or the entry points to another table, with the number of
|
|
bits to gobble implicit in the size of the table.
|
|
|
|
Table X is two bits long since the longest code starting with 110 is five bits
|
|
long:
|
|
|
|
00: C,1
|
|
01: C,1
|
|
10: D,2
|
|
11: E,2
|
|
|
|
Table Y is three bits long since the longest code starting with 111 is six
|
|
bits long:
|
|
|
|
000: F,2
|
|
001: F,2
|
|
010: G,2
|
|
011: G,2
|
|
100: H,2
|
|
101: H,2
|
|
110: I,3
|
|
111: J,3
|
|
|
|
So what we have here are three tables with a total of 20 entries that had to
|
|
be constructed. That's compared to 64 entries for a single table. Or
|
|
compared to 16 entries for a Huffman tree (six two entry tables and one four
|
|
entry table). Assuming that the code ideally represents the probability of
|
|
the symbols, it takes on the average 1.25 lookups per symbol. That's compared
|
|
to one lookup for the single table, or 1.66 lookups per symbol for the
|
|
Huffman tree.
|
|
|
|
There, I think that gives you a picture of what's going on. For inflate, the
|
|
meaning of a particular symbol is often more than just a letter. It can be a
|
|
byte (a "literal"), or it can be either a length or a distance which
|
|
indicates a base value and a number of bits to fetch after the code that is
|
|
added to the base value. Or it might be the special end-of-block code. The
|
|
data structures created in inftrees.c try to encode all that information
|
|
compactly in the tables.
|
|
|
|
|
|
Jean-loup Gailly Mark Adler
|
|
jloup@gzip.org madler@alumni.caltech.edu
|
|
|
|
|
|
References:
|
|
|
|
[LZ77] Ziv J., Lempel A., ``A Universal Algorithm for Sequential Data
|
|
Compression,'' IEEE Transactions on Information Theory, Vol. 23, No. 3,
|
|
pp. 337-343.
|
|
|
|
``DEFLATE Compressed Data Format Specification'' available in
|
|
http://www.ietf.org/rfc/rfc1951.txt
|