4.2.5. AOCL-BLAS Utility APIs - 5.2 English

4.2.5. AOCL-BLAS Utility APIs - 5.2 English - 57404

AOCL User Guide (57404)

Document ID

57404

Release Date

2025-12-29

Version

5.2 English

This section explains some of the AOCL-BLAS APIs used to get the AOCL-BLAS library configuration information and for configuring optimization tuning parameters.

Table 4.9 **AOCL-BLAS Utility APIs**#
API	Usage
`bli_info_get_version_str()`	Returns the version string in the form of `AOCL-BLAS 5.0.0 Build yyyyddmm`.
`bli_info_get_info_value()`	Returns the value of `INFO` from the previous call by this user thread to a BLAS2 or BLAS3 routine. For more information, refer to Error Handling in AOCL-BLAS
`bli_info_get_enable_openmp()` `bli_info_get_enable_pthreads()` `bli_info_get_enable_threading()`	Returns true if OpenMP/pthreads are enabled and false otherwise.
`bli_thread_get_num_threads()`	Returns the default number of threads used for the subsequent BLAS calls.
`bli_thread_set_num_threads(dim_t n_threads)`	Sets the number of threads used by AOCL-BLAS only for the current thread. Other threads will continue using the default or previously set values.
`bli_thread_set_ways(dim_t jc, dim_t pc, dim_t ic, dim_t jr, dim_t ir)`	Sets the number of threads for different levels of parallelization as per GotoBLAS five loops architecture.
`bli_thread_reset()`	Undo any changes to internal threading settings from calls to `bli_thread_set_num_threads()` or `bli_thread_set_ways()`.

For more details on the threading-related APIs, see Section 2.1 of AOCL Performance Tuning Guide and see amd/blis