Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.

AOCL-Compression - Release Notes - AOCL version 5.0
----------------------------------------------------

AOCL Compression is a software framework of various lossless compression and
decompression methods tuned and optimized for AMD Zen based CPUs.
The framework offers a single set of unified APIs for all the supported
compression and decompression methods which facilitate the applications to
easily integrate and use them.
AOCL Compression supports lz4, zlib/deflate, lzma, zstd, bzip2, snappy, and 
lz4hc based compression and decompression methods along with their native APIs.
The library offers openMP based multi-threaded implementation of lz4, zlib,
zstd and snappy compression methods. 
It supports a dynamic dispatcher feature that executes the most optimal
function variant implemented using Function Multi-versioning thereby offering
a single optimized library portable across different x86 CPU architectures.
AOCL Compression framework is developed in C for Unix and Windows based systems.
A test suite is provided for validation and performance benchmarking
of the supported compression and decompression methods. This suite also supports
the benchmarking of IPP compression methods, such as, lz4, lz4hc, zlib and bzip2. 
The library build framework offers CTest based testing of the test cases implemented 
using GTest and the library test suite.

Highlights of AOCL-Compression 5.0:
------------------------------------
Performance Improvements:
	- ZLIB and BZIP2 single-threaded compression performance improvements.
	- LZ4, ZSTD, ZLIB, and Snappy multi-threaded performance improvements.
	- AOCL_ZLIB_QUICK_MODE added in ZLIB for higher compression speeds.
	- AOCL_DECOMPRESS_FAST mode added in LZ4 and ZSTD for higher decompression speeds.
	- LZ4 optimizations extended to LZ4_compress_*, and LZ4_decompress_safe_* APIs.
Features:
	- LZ4HC multi- threaded support.
	- Support for asymmetric multi-threaded compression and decompression.
	- LZ4 baseline upgraded to version 1.9.4.
Testing:
	- Improved test coverage through gtest, fuzzer tests and third- party test benches.
Documentation, Usage guidelines:
	- Integrated Sphinx and Breathe documentation.
	- Examples added.
Bug Fixes:
	- Fixes to ensure reentrancy in single-threaded and multi-threaded builds.
	- Multiple bug fixes.

Please refer AOCL User Guide for supported Operating Systems and Compilers. 

The package contains AOCL-Compression libraries, binaries and header files
that are built with optimizations for AMD EPYC and Ryzen Processor family.
