5.3.2. Run Time Tuning - 5.2 English - 57404

AOCL User Guide (57404)

Document ID
57404
Release Date
2025-12-29
Version
5.2 English

Run time tuning is available through environment variables.

Following options are available to control library functionality at runtime:

Flag

Description

Use case

AOCL_ZLIB_QUICK_MODE (ZLIB)

Improves compression speed at the expense of compression ratio. Primarily for level 1. Improvements can be observed for levels 2, 3 and 5 as well. [Set environment variable: AOCL_ZLIB_QUICK_MODE Values: ON / OFF (default)]

Suitable for applications that need faster compression speeds for lower levels.

AOCL_DISABLE_OPT

Disable AOCL optimizations and run the reference implementation. [Set environment variable: AOCL_DISABLE_OPT Values: ON / OFF (default)]

Benchmarking performance improvements obtained by AOCL optimizations over reference.

OMP_NUM_THREADS

Environment variable based thread control provided by OpenMP. Library needs to be built with AOCL_ENABLE_THREADS=ON for this to be useful. [Set environment variable: OMP_NUM_THREADS Values: >= 1. Default: all threads that the implementation supports.]

To limit the number of threads used to run compression and decompression in multi-threaded mode.

Note: OMP_NUM_THREADS setting is not required by default as the algorithm automatically determines number of threads to use based on hardware and input file size.