Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 2021.1
  • 12/04/2020
  • Public Content
Contents

mkl_disable_fast_mm

Turns off the
Intel® oneAPI Math Kernel Library
 Memory Allocator for
Intel® oneAPI Math Kernel Library
 functions to directly use the system
malloc
/
free
 functions.

Syntax

int
mkl_disable_fast_mm
(
void
);
Include Files
  • mkl.h
Description
The
mkl_disable_fast_mm
function turns the
Intel® oneAPI Math Kernel Library
 Memory Allocator off for
Intel® oneAPI Math Kernel Library
 functions to directly use the system
malloc
/
free
functions.
Intel® oneAPI Math Kernel Library
 Memory Allocator uses per-thread memory pools where buffers may be collected for fast reuse. The Memory Allocator is turned on by default for better performance. To turn it off, you can use the
mkl_disable_fast_mm
 function or the
MKL_DISABLE_FAST_MM
 environment variable (See the
Intel® oneAPI Math Kernel Library
 Developer Guide
 for details.) Call
mkl_disable_fast_mm
before calling any
Intel® oneAPI Math Kernel Library
 functions that require allocation of memory buffers.
Turning the Memory Allocator off negatively impacts performance of some
Intel® oneAPI Math Kernel Library
 routines, especially for small problem sizes.
Return Values
Name
Type
Description
mm
int
1 - The Memory Allocator is successfully turned off.
0 - Turning the Memory Allocator off failed.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.