AuroraMiddleware/zstd
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
8cebfd1d26
zstd/lib
History
Yann Collet 8cebfd1d26 fix attempt on test-zstd-speed
2016-07-31 01:59:23 +02:00
..
common fix attempt on test-zstd-speed 2016-07-31 01:59:23 +02:00
compress zstd_opt uses same tables as zstd_compress 2016-07-30 13:21:41 +02:00
decompress restore decompression speed on fizzle 2016-07-30 15:32:47 +02:00
dictBuilder fixed too large selectivity level, reported by Ilona Papava 2016-07-30 01:09:14 +02:00
legacy fixed --test on zero-length files, reported by @amnilsson 2016-07-26 15:49:24 +02:00
.gitignore Added "dictionary decompression" example 2016-07-07 14:08:00 +02:00
libzstd.pc.in Initial release 2015-01-24 01:58:16 +01:00
LICENSE Initial release 2015-01-24 01:58:16 +01:00
Makefile minor example variation 2016-07-27 19:53:19 +02:00
README.md minor doc clarifications 2016-07-18 03:52:47 +02:00
zstd.h slightly improved compression speed 2016-07-30 00:55:13 +02:00

README.md

zstd - library files

The lib directory contains several directories. Depending on target use case, it's enough to include only files from relevant directories.

API

Zstandard's stable API is exposed within zstd.h, at the root of lib directory.

Advanced API

Some additional API may be useful if you're looking into advanced features :

  • common/error_public.h : transforms size_t function results into an enum, for precise error handling.
  • ZSTD_STATIC_LINKING_ONLY : if you define this macro before including zstd.h, it will give access to advanced and experimental API. These APIs shall never be used with dynamic library ! They are not "stable", their definition may change in the future. Only static linking is allowed.

Modular build

Directory common/ is required in all circumstances. You can select to support compression only, by just adding files from the compress/ directory, In a similar way, you can build a decompressor-only library with the decompress/ directory.

Other optional functionalities provided are :

  • dictBuilder/ : source files to create dictionaries. The API can be consulted in dictBuilder/zdict.h. This module also depends on common/ and compress/ .

  • legacy/ : source code to decompress previous versions of zstd, starting from v0.1. This module also depends on common/ and decompress/ . Note that it's required to compile the library with ZSTD_LEGACY_SUPPORT = 1 . The main API can be consulted in legacy/zstd_legacy.h. Advanced API from each version can be found in its relevant header file. For example, advanced API for version v0.4 is in zstd_v04.h .

Streaming API

Streaming is currently provided by common/zbuff.h.

Miscellaneous

The other files are not source code. There are :

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