5
by ymnk@jcraft.com, JCraft,Inc.
7
http://www.jcraft.com/jzlib/
9
Last modified: Wed Dec 20 05:47:39 UTC 2000
13
JZlib is a re-implementation of zlib in pure Java.
14
The first and final aim for hacking this stuff is
15
to add the packet compression support to pure Java SSH systems.
20
* README files all over the source tree have info related to the stuff
22
* ChangeLog: what changed from the previous version?
25
Directories & Files in the Source Tree
26
======================================
27
* com/ has source trees of JZlib.
28
* example/ has some samples, which demonstrate the usages.
29
* misc/ has some stuffs. At present, this directory includes
30
a patch file for MindTerm v.1.2.1, which adds the packet compression
36
* Needless to say, JZlib can inflate data, which is deflated by zlib and
37
JZlib can generate deflated data, which is acceptable and inflated by zlib.
38
* JZlib supports all compression level and all flushing mode in zlib.
39
* JZlib does not support gzip file handling supports.
40
* The performance has not been estimated yet, but it will be not so bad
41
in deflating/inflating data stream on the low bandwidth network.
42
* JZlib is under LGPL.
43
* Any invention has not been done in developing JZlib.
44
So, if zlib is patent free, JZlib is also not covered by any patents.
49
Java Platform API provides packages 'java.util.zip.*' for
50
accessing to zlib, but that support is very limited
51
if you need to use the essence of zlib. For example,
52
we needed to full access to zlib to add the packet compression
53
support to pure Java SSH system, but they are useless for our requirements.
54
The Internet draft, SSH Transport Layer Protocol, says in the section '4.2 Compression' as follows,
56
The following compression methods are currently defined:
57
none REQUIRED no compression
58
zlib OPTIONAL GNU ZLIB (LZ77) compression
59
The "zlib" compression is described in [RFC-1950] and in [RFC-1951]. The
60
compression context is initialized after each key exchange, and is
61
passed from one packet to the next with only a partial flush being
62
performed at the end of each packet. A partial flush means that all data
63
will be output, but the next packet will continue using compression
64
tables from the end of the previous packet.
66
To implement this functionality, the Z_PARTIAL_FLUSH mode of zlib must be
67
used, however JDK does not permit us to do so. It seems that this problem has
68
been well known and some people have already reported to
69
JavaSoft's BugParade(for example, BugId:4255743),
70
but any positive response has not been returned from JavaSoft,
71
so this problem will not be solved forever.
72
This is our motivation to hack JZlib.
75
A unofficial patch for MindTerm v.1.2.1
76
=======================================
77
A unofficial patch file for MindTerm v.1.2.1 has included in 'misc' directory.
78
It adds the packet compression support to MindTerm.
79
Please refer to 'misc/README' file.
82
Copyrights & Disclaimers
83
========================
84
JZlib is copyrighted by JCraft,Inc. and is licensed through the
85
GNU Library General Public License.
86
Read the COPYING file for the complete license.
91
JZlib has been developed by ymnk@jcraft.com,
92
but he has just re-implemented zlib in pure Java.
93
So, all credit should go to authors
94
Jean-loup Gailly(jloup@gzip.org) and Mark Adler(madler@alumni.caltech.edu)
95
and contributors of zlib.
98
If you have any comments, suggestions and questions, write us
102
``SSH is a registered trademark and Secure Shell is a trademark of
103
SSH Communications Security Corp (www.ssh.com)''.