Support Functions

This chapter describes Intel^® IPP support functions that are used to:

retrieve information about the current Intel IPP software version
allocate and free memory that is needed for the operation of other Intel IPP functions
retrieve information about the processor and perform specific auxiliary operations
functions for internationalization.

The full list of these functions is given in the table below.

Intel IPP Support Functions
Function Base Name	Operation
Version Information Functions
GetLibVersion	Returns information about the active library version.
Memory Allocation Functions
Malloc	Allocates memory aligned to 32-byte boundary.
Free	Frees memory allocated by the functionippsMalloc .
Common Functions
ippGetStatusString	Translates a status code into a message.
ippGetCpuType	Returns a processor type. See Optimization Notice below*)
ippGetCpuClocks	Returns a current value of the time stamp counter (TSC) register.
ippGetCpuFreqMhz	Estimates the processor frequency.
ippGetCpuFeatures	Retrieves the processor features.
ippGetEnabledCpuFeatures	Returns the enabled processor features for the loaded library.
ippGetNumCoresOnDie	Returns the number of cores.
ippGetMaxCacheSizeB	Returns maximum size of the L2 and L3 caches of the processor.
ippSetFlushToZero	Enables or disables flush-to-zero mode.
ippSetDenormAreZeros	Enables or disables denormals-are-zero mode.
ippAlignPtr	Aligns a pointer to the specified number of bytes.
ippSetNumThreads	Sets the number of threads in the multithread environment.
ippGetNumThreads	Returns the number of existing threads in the multithread environment.
ippSetAffinity	Binds OpenMP threads to OS processors.
ippMalloc	Allocates memory aligned to 32-byte boundary.
ippFree	Frees memory allocated by the function ippMalloc.
Dispatcher Control Functions
ippStaticInit	Automatically selects the most appropriate static code.
ippInit	Automatically initializes the version of the library code most appropriate for the current processor type.
ippStaticInitCpu	THIS FUNCTION IS DEPRECATED. Use the function ippInitCpu instead.
ippInitCpu	Initializes the specified version of the library code.
ippEnableCpu	Allows dispatching the processor-specific library
Internationalization Functions
ippMessageCatalogOpenI18n	Opens an i18n message catalog.
ippMessageCatalogCloseI18n	Closes the opened i18n message catalog.
ippGetMessageStatusI18n	Returns the translation of the status message.
ippStatusToMessageIdI18n	Transforms an Intel IPP status code to the message ID for the i18n message catalog.

Optimization Notice
Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice. Notice revision #20110804

Optimization Notice

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804