Developer Guide and Reference for Intel® Integrated Performance Primitives Cryptography
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-58987767-15D3-4F52-9275-189592C8B602
Visible to Intel only — GUID: GUID-58987767-15D3-4F52-9275-189592C8B602
Support Functions
There are several general purpose functions that simplify using the library and report information on how it is working:
GetCpuFeatures/ SetCpuFeatures/GetEnabledCpuFeatures
GetStatusString
GetLibVersion
GetCpuFeatures/ SetCpuFeatures/GetEnabledCpuFeatures
In some cases like debugging and performance analysis, you may want to get the data on the difference between various processor-specific codes on the same machine. Use the ippcpSetCpuFeatures function for this. This function sets the dispatcher to use the processor-specific code according to the specified set of CPU features. You can obtain features supported by CPU using ippcpGetCpuFeatures and obtain features supported by the currently dispatched Intel IPP Cryptography code using ippcpGetEnabledCpuFeatures. If you need to enable support of some CPU features without querying the system (without using the CPUID instruction call), you must set the ippCPUID_NOCHECK bit for ippcpSetCpuFeatures, otherwise, only the features supported by the current CPU are set.
The ippcpGetCpuFeatures, ippcpGetEnabledCpuFeatures, and ippcpSetCpuFeatures functions are a part of the ippCP library.
GetStatusString
The ippcpGetStatusString function decodes the numeric status return value of Intel® IPP Cryptography functions and converts them to a human-readable text:
Ipp64u mask; status = ippcpGetCpuFeatures(&mask); if( status != ippStsNoErr ) { printf("ippcpGetCpuFeatures() Error:\n"); printf("%s\n", ippcpGetStatusString(status) ); return -1; }
The ippcpGetStatusString function is a part of the ippCP library.
GetLibVersion
The GetLibVersion function returns information about the library layer in use from the dispatcher. The code snippet below demonstrates the usage of the ippcpGetLibVersion:
const IppLibraryVersion* lib = ippcpGetLibVersion(); printf("%s %s %d.%d.%d.%d\n", lib->Name, lib->Version, lib->major, lib->minor, lib->majorBuild, lib->build);
For more information about the Intel IPP Cryptography functions see the Developer Reference for Intel® Integrated Performance Primitives Cryptography.