Introduction:
We Introduced verbose mode support for BLAS and LAPACK domains in latest Intel® Math Kernel Library (MKL), which allow developer to get information like what MKL version, what MKL functions are called, what parameters are passed to them, and how much time is spent to execute the function etc, so better understand the usage status of MKL in the their program.
Using Intel® MKL Verbose Mode
To enable the Intel MKL Verbose mode for an application, do one of the following:
• Set the environment variable MKL_VERBOSE to 1.
• Call the support function mkl_verbose(1).
Default the verbose mode is disabled. When it is on, every call of a verbose-enabled function finishes with printing verbose log, including the list of version Information, the name of function, Values of the arguments, Time taken by the function and others.
Example
The following is an example of calling MKL dgemm() function in C. (Please see the source code in MKL User Guide )
The version information line:
MKL_VERBOSE Intel(R) MKL 11.2 Beta build 20140312 for Intel(R) 64 architecture Intel(R) Advanced Vector Extensions (Intel(R) AVX) enabled processors, Lnx 2.70GHz lp64 intel_thread NMICDev:0
The information tell current MKL version is 11.2 Beta , the type of processor: Intel(R) AVX enabled , OS:Linux , CPU Frequency: 2.70GHz, Using lp64 interface and thread MKL library, No coprocessor.
And call description line:
MKL_VERBOSE DGEMM(N,N,1000,1000,1000,0x7fff10ff6560,0x7f9d09f20010,1000,0x7f9d0a6c2010,1000,0x7fff10ff6568,0x7f9d0977e010,1000) 15.79ms CNR:OFF Dyn:1 FastMM:1 TID:0 NThr:16 WDiv:HOST:+0.000
The line show, the program is using DGEMM with the input parameter: N,N,1000,1000,1000,0x7fff10ff6560,0x7f9d09f20010,1000,0x7f9d0a6c2010,1000,0x7fff10ff6568,0x7f9d0977e010,1000. It takes 15.79ms. The environment MKL_CBWR is OFF and MKL_DYNAMIC and FastMemory Manager is on. The print thread ID is 0. And the total used 16 threads. Ignore the WDiv:HOST:+0.000 as it is for coprocessor.
Some Limitation
Because every call to a verbose-enabled function requires an output operation, the performance of the application may degrade with the verbose mode enabled.
Besides of this, MKL Verbose mode has the following limitations:
• Input values of parameters passed by reference are not printed if the values were changed by the function.
For example, if a LAPACK function is called with a workspace query, that is, the value of the lwork parameter equals -1 on input, the call description line prints the result of the query and not -1.
• Return values of functions are not printed.
For example, the value returned by the function ilaenv is not printed.
• Floating-point scalars passed by reference are not printed.
Please see the MKL user guide for more details about the verbose mode of MKL.