GetCacheParams
GetCacheParams
Retrieves cache type, level, and size.
Syntax
IppStatus ippGetCacheParams(IppCache**
ppCacheInfo
);
Include Files
ippcore.h
Parameters
- ppCacheInfo
- Pointer to an array of structures describing CPU cache, which are defined inipptypes.h:typedef struct { int type; int level; int size } IppCache;where
- typecan have the following values:
- 0
- NULL- no more caches
- 1
- Data cache
- 2
- Instruction cache
- 3
- Unified cache
- levelstarts with 1
- sizeis in bytes
Description
The
ippGetCacheParams
function retrieves the following cache parameters for the CPU on which it is executed: type of cache (instruction, data, unified), cache level in cache hierarchy, and cache size, in bytes. The function is based on function #4 of the CPUID instruction, and therefore works only for the CPUs that support this function. For old and non-Intel CPUs that do not support this CPUID extension, the function returns the ippStsCpuNotSupportedErr
status. It means that cache parameters cannot be obtained with the ippGetCacheParams
function and you should use other methods based on a particular CPU specification.Product and Performance Information
|
---|
Performance varies by use, configuration and other factors. Learn more at
www.Intel.com/PerformanceIndex.
Notice revision #20201201
|
Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error condition when theppCacheInfopointer isNULL.
- ippStsNotSupportedCpu
- Indicates that the processor is not supported.
Example
/*******************************************************************************
* Copyright 2015-2021 Intel Corporation.
*
* This software and the related documents are Intel copyrighted materials, and
* your use of them is governed by the express license under which they were
* provided to you (License). Unless the License provides otherwise, you may not
* use, modify, copy, publish, distribute, disclose or transmit this software or
* the related documents without Intel's prior written permission.
*
* This software and the related documents are provided as is, with no express
* or implied warranties, other than those that are expressly stated in the
* License.
*******************************************************************************/
#include <stdio.h>
#include "ipp.h"
static char* cacheType[] = {
"Data Cache",
"Instruction Cache",
"Unified Cache"
};
int main(){
IppCache* pCacheInfo;
int i;
IppStatus sts;
sts = ippGetCacheParams( &pCacheInfo );
if( sts != ippStsNoErr ){
printf("Intel(R) Integrated Primitives (Intel(R) IPP) function returned error %s\n", ippGetStatusString( sts ));
return 0;
}
i = 0;
do{
printf("cache type = %s\n", cacheType[pCacheInfo[i].type-1] );
printf("cache level = %d\n", pCacheInfo[i].level );
printf("cache size = %d\n", pCacheInfo[i].size );
printf("+--------------------------------------+\n" );
} while( pCacheInfo[++i].type > 0 );
sts = ippGetL2CacheSize( &i );
printf("\nCache L2 size = %d\n", i );
return 0;
}