Using
oneMKL Verbose Mode
oneMKL
Verbose ModeWhen building applications that call functions, it may be useful to determine:
Intel® oneAPI Math Kernel Library
- which computational functions are called,
- what parameters are passed to them, and
- how much time is spent to execute the functions.
You can get an application to print this information to a standard output device by enabling
Verbose. Functions that can print this information are referred to as
Intel® oneAPI Math Kernel Library
verbose-enabled functions
.
When Verbose mode is activein an
domain, every call of a verbose-enabled function finishes with printing a human-readable line describing the call. However, if your application gets terminated for some reason during the function call, no information for that function will be printed. The first call to a verbose-enabled function also prints a version information line.
Intel® oneAPI Math Kernel Library
To enable the
Verbose mode for an application, do
Intel® oneAPI Math Kernel Library
one of the following:
- set the environment variableMKL_VERBOSEto 1, or
- call the support functionmkl_verbose(1).
To disable the
Verbose mode,call the Developer Reference for C or the Developer Reference for Fortran.Both references are available in the Intel® Software Documentation Library.
Intel® oneAPI Math Kernel Library
mkl_verbose
(0) function.Both enabling and disabling of the Verbose mode using the function call takes precedence over the environment setting. For a full description of the
mkl_verbose
function, see either the
Intel® oneAPI Math Kernel Library
Intel® oneAPI Math Kernel Library
You can enable
Verbose mode in these domains:
Intel® oneAPI Math Kernel Library
- BLAS
- LAPACK
- ScaLAPACK (selected functionality)
- FFT
Intel® oneAPI Math Kernel Library
The performance of an application may degrade with the Verbose mode enabled, especially when the number of calls to verbose-enabled functions is large, because every call to a verbose-enabled function requires an output operation.