Mainline is now v3.3.

[libucw.git] / lib / lizard.h

diff --git a/lib/lizard.h b/lib/lizard.h
index 25ba4bcee29fc946a6b41e9c265b4b02770e0d46..fc3631ac1103f829263fced390c8281a3cffba8b 100644 (file)
--- a/lib/lizard.h
+++ b/lib/lizard.h
@@ -1,27 +1,40 @@
 /*
- *     LiZzaRd -- Fast compression method based on Lempel-Ziv 77
+ *     LiZaRd -- Fast compression method based on Lempel-Ziv 77
  *
  *     (c) 2004, Robert Spalek <robert@ucw.cz>
  *
- *     The file format is based on LZO1X and 
- *     the compression method is based on zlib.
+ *     This software may be freely distributed and used according to the terms
+ *     of the GNU Lesser General Public License.
  */
 
-#define        LIZZARD_NEEDS_CHARS     8
+#define        LIZARD_NEEDS_CHARS      8
   /* The compression routine needs input buffer 8 characters longer, because it
    * does not check the input bounds all the time.  */
-#define        LIZZARD_MAX_MULTIPLY    65LL/64
-#define        LIZZARD_MAX_ADD         4
+#define        LIZARD_MAX_MULTIPLY     23./22
+#define        LIZARD_MAX_ADD          4
   /* In the worst case, the compressed file will not be longer than its
-   * original length * 65/64 + 4.
+   * original length * 23/22 + 4.
    *
    * The additive constant is for EOF and the header of the file.
    *
-   * The multiplicative constant 129/128 comes from an incompressible string of
-   * length 256 that requires a 2-byte header.  However, if longer strings get
-   * interrupted by a sequence of length 3 compressed into 2 characters, the
-   * overlap is sligtly bigger.
-   * TODO: check */
+   * The multiplicative constant comes from 19-byte incompressible string
+   * followed by a 3-sequence that can be compressed into 2-byte link.  This
+   * breaks the copy-mode and it needs to be restarted with a new header.  The
+   * total length is 2(header) + 2(link) + 19(string) = 23.
+   */
 
-int lizzard_compress(byte *in, uns in_len, byte *out);
-int lizzard_decompress(byte *in, byte *out);
+/* lizard.c */
+int lizard_compress(byte *in, uns in_len, byte *out);
+int lizard_decompress(byte *in, byte *out);
+
+/* lizard-safe.c */
+struct sigaction;
+struct lizard_buffer {
+  uns len;
+  void *start, *ptr;
+  struct sigaction *old_sigsegv_handler;
+};
+
+struct lizard_buffer *lizard_alloc(uns max_len);
+void lizard_free(struct lizard_buffer *buf);
+int lizard_decompress_safe(byte *in, struct lizard_buffer *buf, uns expected_length);