Files
easy7zip/C/lz5/README.md
Tino Reichardt 5ff0657d9f Major changes, including Brotli and Lizard
- update of zstd-mt library
- add brotli v0.6.0
- add lizard v2.0
- xxhash is from zstd for lz4, lz5 and lizard now
- update also the documentation, where needed
2017-05-25 18:40:15 +02:00

1.5 KiB

LZ5 - Library Files

The lib directory contains several files, but you don't necessarily need them all.

To integrate fast LZ5 compression/decompression into your program, you basically just need "lz5.c" and "lz5.h".

For more compression at the cost of compression speed (while preserving decompression speed), use lz5hc on top of regular lz5. lz5hc only provides compression functions. It also needs lz5 to compile properly.

If you want to produce files or data streams compatible with lz5 command line utility, use lz5frame. This library encapsulates lz5-compressed blocks into the official interoperable frame format. In order to work properly, lz5frame needs lz5 and lz5hc, and also xxhash, which provides error detection algorithm. (Advanced stuff : It's possible to hide xxhash symbols into a local namespace. This is what liblz5 does, to avoid symbol duplication in case a user program would link to several libraries containing xxhash symbols.)

A more complex "lz5frame_static.h" is also provided, although its usage is not recommended. It contains definitions which are not guaranteed to remain stable within future versions. Use for static linking only.

The other files are not source code. There are :

  • LICENSE : contains the BSD license text
  • Makefile : script to compile or install lz5 library (static or dynamic)
  • liblz5.pc.in : for pkg-config (make install)