System.LibCPUID

Contents

Description

Currently implemented:

getting CPU vendor and brand strings, TSC availability, number of physical, and logical cores
measuring CPU clock frequency using a time-stamp counter and time intervals
getting CPU clock frequency as reported by the OS
measuring CPU clock frequency using a busy-wait cycle

Synopsis

LibCPUID utilities

Get the total number of logical cores (even if CPUID is not present). If CPUID is present, the following is true:

getTotalLogicalCores = totalLogicalCores <$> cpuid

Get the CPU clock frequency in MHz, as reported by the OS (which may differ from the true clock). If the OS is not supported, the result will be -1.

Get the CPU clock frequency in MHz, after performing a busy-wait cycle for the given time in ms. If RDTSC is not supported, the result will be -1.

Should clockMeasure do a more thorough measurement (quadruple checking).

Constructors

Get the CPU clock frequency in MHz, by trying all available methods. If all of them fail, the result will be -1.

Reexports from System.LibCPUID.CPUID

CPU information and features.

Constructors

Fields

vendorString :: String
CPU vendor string, e.g. "GenuineIntel".
brandString :: String
CPU brand string, e.g. "Intel(R) Core(TM) i5-7500 CPU @ 3.40GHz".
hasTSC :: Bool
Is a time-stamp counter available.
physicalCores :: Int
Number of physical cores per processor.
logicalCores :: Int
Number of logical cores per processor.
totalLogicalCores :: Int
Total number of logical cores, which is logicalCores multiplied by the number of processors.

Instances

Storable CPUID Source #
Instance details Defined in System.LibCPUID.CPUID Methods sizeOf :: CPUID -> Int # alignment :: CPUID -> Int # peekElemOff :: Ptr CPUID -> Int -> IO CPUID # pokeElemOff :: Ptr CPUID -> Int -> CPUID -> IO () # peekByteOff :: Ptr b -> Int -> IO CPUID # pokeByteOff :: Ptr b -> Int -> CPUID -> IO () # peek :: Ptr CPUID -> IO CPUID # poke :: Ptr CPUID -> CPUID -> IO () #

Get CPU information and features, or an error message, if the CPU can't be identified by libcpuid.

Initialise a TSCMark.

Mark a time interval for calculating the CPU clock frequency.

Unmark a time interval for calculating the CPU clock frequency.

Calculate the CPU clock frequency in MHz, for an interval, marked with mark, and unmark. If the interval is insufficient, the result will be -1.