1275793eaSopenharmony_ciThis directory contains examples of the use of zlib and other relevant
2275793eaSopenharmony_ciprograms and documentation.
3275793eaSopenharmony_ci
4275793eaSopenharmony_cienough.c
5275793eaSopenharmony_ci    calculation and justification of ENOUGH parameter in inftrees.h
6275793eaSopenharmony_ci    - calculates the maximum table space used in inflate tree
7275793eaSopenharmony_ci      construction over all possible Huffman codes
8275793eaSopenharmony_ci
9275793eaSopenharmony_cifitblk.c
10275793eaSopenharmony_ci    compress just enough input to nearly fill a requested output size
11275793eaSopenharmony_ci    - zlib isn't designed to do this, but fitblk does it anyway
12275793eaSopenharmony_ci
13275793eaSopenharmony_cigun.c
14275793eaSopenharmony_ci    uncompress a gzip file
15275793eaSopenharmony_ci    - illustrates the use of inflateBack() for high speed file-to-file
16275793eaSopenharmony_ci      decompression using call-back functions
17275793eaSopenharmony_ci    - is approximately twice as fast as gzip -d
18275793eaSopenharmony_ci    - also provides Unix uncompress functionality, again twice as fast
19275793eaSopenharmony_ci
20275793eaSopenharmony_cigzappend.c
21275793eaSopenharmony_ci    append to a gzip file
22275793eaSopenharmony_ci    - illustrates the use of the Z_BLOCK flush parameter for inflate()
23275793eaSopenharmony_ci    - illustrates the use of deflatePrime() to start at any bit
24275793eaSopenharmony_ci
25275793eaSopenharmony_cigzjoin.c
26275793eaSopenharmony_ci    join gzip files without recalculating the crc or recompressing
27275793eaSopenharmony_ci    - illustrates the use of the Z_BLOCK flush parameter for inflate()
28275793eaSopenharmony_ci    - illustrates the use of crc32_combine()
29275793eaSopenharmony_ci
30275793eaSopenharmony_cigzlog.c
31275793eaSopenharmony_cigzlog.h
32275793eaSopenharmony_ci    efficiently and robustly maintain a message log file in gzip format
33275793eaSopenharmony_ci    - illustrates use of raw deflate, Z_PARTIAL_FLUSH, deflatePrime(),
34275793eaSopenharmony_ci      and deflateSetDictionary()
35275793eaSopenharmony_ci    - illustrates use of a gzip header extra field
36275793eaSopenharmony_ci
37275793eaSopenharmony_cigznorm.c
38275793eaSopenharmony_ci    normalize a gzip file by combining members into a single member
39275793eaSopenharmony_ci    - demonstrates how to concatenate deflate streams using Z_BLOCK
40275793eaSopenharmony_ci
41275793eaSopenharmony_cizlib_how.html
42275793eaSopenharmony_ci    painfully comprehensive description of zpipe.c (see below)
43275793eaSopenharmony_ci    - describes in excruciating detail the use of deflate() and inflate()
44275793eaSopenharmony_ci
45275793eaSopenharmony_cizpipe.c
46275793eaSopenharmony_ci    reads and writes zlib streams from stdin to stdout
47275793eaSopenharmony_ci    - illustrates the proper use of deflate() and inflate()
48275793eaSopenharmony_ci    - deeply commented in zlib_how.html (see above)
49275793eaSopenharmony_ci
50275793eaSopenharmony_cizran.c
51275793eaSopenharmony_cizran.h
52275793eaSopenharmony_ci    index a zlib or gzip stream and randomly access it
53275793eaSopenharmony_ci    - illustrates the use of Z_BLOCK, inflatePrime(), and
54275793eaSopenharmony_ci      inflateSetDictionary() to provide random access
55