The OpenD Programming Language

core.cpuid

Identify the characteristics of the host CPU, providing information about cache sizes and assembly optimisation hints. This module is provided primarily for assembly language programmers.

References: Some of this information was extremely difficult to track down. Some of the documents below were found only in cached versions stored by search engines! This code relies on information found in:

  • "Intel(R) 64 and IA-32 Architectures Software Developers Manual, Volume 2A: Instruction Set Reference, A-M" (2007).
  • "AMD CPUID Specification", Advanced Micro Devices, Rev 2.28 (2008).
  • "AMD Processor Recognition Application Note For Processors Prior to AMD Family 0Fh Processors", Advanced Micro Devices, Rev 3.13 (2005).
  • "AMD Geode(TM) GX Processors Data Book", Advanced Micro Devices, Publication ID 31505E, (2005).
  • "AMD K6 Processor Code Optimisation", Advanced Micro Devices, Rev D (2000).
  • "Application note 106: Software Customization for the 6x86 Family", Cyrix Corporation, Rev 1.5 (1998)
  • http://www.datasheetcatalog.org/datasheet/nationalsemiconductor/GX1.pdf
  • "Geode(TM) GX1 Processor Series Low Power Integrated X86 Solution", National Semiconductor, (2002)
  • "The VIA Isaiah Architecture", G. Glenn Henry, Centaur Technology, Inc (2008).
  • http://www.sandpile.org/ia32/cpuid.htm
  • http://www.akkadia.org/drepper/cpumemory.pdf
  • "What every programmer should know about memory", Ulrich Depper, Red Hat, Inc., (2007).
  • "CPU Identification by the Windows Kernel", G. Chappell (2009). http://www.geoffchappell.com/viewer.htm?doc=studies/windows/km/cpu/cx8.htm
  • "Intel(R) Processor Identification and the CPUID Instruction, Application Note 485" (2009).

Members

Properties

aes
bool aes [@property getter]

Is AES supported

amd3dnow
bool amd3dnow [@property getter]

Is AMD 3DNOW supported?

amd3dnowExt
bool amd3dnowExt [@property getter]

Is AMD 3DNOW Ext supported?

amdMmx
bool amdMmx [@property getter]

Are AMD extensions to MMX supported?

avx
bool avx [@property getter]

Is AVX supported

avx2
bool avx2 [@property getter]

Is AVX2 supported

avx512f
bool avx512f [@property getter]

Is AVX512F supported

cacheLevels
uint cacheLevels [@property getter]

The number of cache levels in the CPU.

coresPerCPU
uint coresPerCPU [@property getter]

Returns number of cores in CPU

dataCaches
const(CacheInfo)[5] dataCaches [@property getter]

The data caches. If there are fewer than 5 physical caches levels, the remaining levels are set to size_t.max (== entire memory space)

fma
bool fma [@property getter]

Is FMA supported

fp16c
bool fp16c [@property getter]

Is FP16C supported

has3dnowPrefetch
bool has3dnowPrefetch [@property getter]

Is 3DNow prefetch supported?

hasCmov
bool hasCmov [@property getter]

Is cmov supported?

hasCmpxchg16b
bool hasCmpxchg16b [@property getter]

Is cmpxchg8b supported?

hasCmpxchg8b
bool hasCmpxchg8b [@property getter]

Is cmpxchg8b supported?

hasFxsr
bool hasFxsr [@property getter]

Is fxsave/fxrstor supported?

hasLahfSahf
bool hasLahfSahf [@property getter]

Are LAHF and SAHF supported in 64-bit mode?

hasLzcnt
bool hasLzcnt [@property getter]

Is LZCNT supported?

hasPclmulqdq
bool hasPclmulqdq [@property getter]

Is pclmulqdq supported

hasPopcnt
bool hasPopcnt [@property getter]

Is POPCNT supported?

hasRdrand
bool hasRdrand [@property getter]

Is rdrand supported

hasRdseed
bool hasRdseed [@property getter]

Is rdseed supported

hasRdtsc
bool hasRdtsc [@property getter]

Is rdtsc supported?

hasSha
bool hasSha [@property getter]

Is SHA supported

hasSysEnterSysExit
bool hasSysEnterSysExit [@property getter]

Is SYSENTER/SYSEXIT supported?

hasVpclmulqdq
bool hasVpclmulqdq [@property getter]

Is vpclmulqdq supported

hle
bool hle [@property getter]

Is HLE (hardware lock elision) supported

hyperThreading
bool hyperThreading [@property getter]

Is hyperthreading supported?

isItanium
bool isItanium [@property getter]

Is this an IA64 (Itanium) processor?

isX86_64
bool isX86_64 [@property getter]

Is this an Intel64 or AMD 64?

mmx
bool mmx [@property getter]

Is MMX supported?

preferAthlon
bool preferAthlon [@property getter]

Optimisation hints for assembly code.

preferPentium1
bool preferPentium1 [@property getter]

Does this CPU perform better on Pentium I code than Pentium Pro code?

preferPentium4
bool preferPentium4 [@property getter]

Does this CPU perform better on Pentium4 code than PentiumPro..Core2 code?

processor
string processor [@property getter]

Returns processor string, for display purposes only

rtm
bool rtm [@property getter]

Is RTM (restricted transactional memory) supported

sse
bool sse [@property getter]

Is SSE supported?

sse2
bool sse2 [@property getter]

Is SSE2 supported?

sse3
bool sse3 [@property getter]

Is SSE3 supported?

sse41
bool sse41 [@property getter]

Is SSE4.1 supported?

sse42
bool sse42 [@property getter]

Is SSE4.2 supported?

sse4a
bool sse4a [@property getter]

Is SSE4a supported?

ssse3
bool ssse3 [@property getter]

Is SSSE3 supported?

threadsPerCPU
uint threadsPerCPU [@property getter]

Returns number of threads per CPU

vaes
bool vaes [@property getter]

Is VEX-Encoded AES supported

vendor
string vendor [@property getter]

Returns vendor string, for display purposes only. Do NOT use this to determine features! Note that some CPUs have programmable vendorIDs.

x87onChip
bool x87onChip [@property getter]

Does it have an x87 FPU on-chip?

Static variables

datacache
CacheInfo[5] datacache;

Scheduled for deprecation. Please use dataCaches instead.

family
uint family;
model
uint model;

Warning: This field will be turned into a property in a future release.

numCacheLevels
uint numCacheLevels;

This field has been deprecated. Please use cacheLevels instead.

stepping
uint stepping;

Warning: This field will be turned into a property in a future release.

Structs

CacheInfo
struct CacheInfo

Cache size and behaviour

Bugs

Currently only works on x86 and Itanium CPUs. Many processors have bugs in their microcode for the CPUID instruction, so sometimes the cache information may be incorrect.

Meta

Authors

Don Clugston, Tomas Lindquist Olsen <tomas@famolsen.dk>