cpu_id_t man page

cpu_id_t — This contains the recognized CPU features/info.  

Synopsis

#include <libcpuid.h>

Data Fields

char vendor_str [VENDOR_STR_MAX]
char brand_str [BRAND_STR_MAX]
cpu_vendor_t vendor
uint8_t flags [CPU_FLAGS_MAX]
int32_t family
int32_t model
int32_t stepping
int32_t ext_family
int32_t ext_model
int32_t num_cores
int32_t num_logical_cpus
int32_t total_logical_cpus
int32_t l1_data_cache
int32_t l1_instruction_cache
int32_t l2_cache
int32_t l3_cache
int32_t l4_cache
int32_t l1_assoc
int32_t l2_assoc
int32_t l3_assoc
int32_t l4_assoc
int32_t l1_cacheline
int32_t l2_cacheline
int32_t l3_cacheline
int32_t l4_cacheline
char cpu_codename [64]
int32_t sse_size
uint8_t detection_hints [CPU_HINTS_MAX]
struct cpu_sgx_t sgx

Detailed Description

This contains the recognized CPU features/info.

Field Documentation

char cpu_id_t::brand_str[BRAND_STR_MAX]

contains the brand string, e.g. 'Intel(R) Xeon(TM) CPU 2.40GHz'

char cpu_id_t::cpu_codename[64]

The brief and human-friendly CPU codename, which was recognized.
Examples:

+--------+--------+-------+-------+-------+---------------------------------------+-----------------------+
| Vendor | Family | Model | Step. | Cache |       Brand String                    | cpu_id_t.cpu_codename |
+--------+--------+-------+-------+-------+---------------------------------------+-----------------------+
| AMD    |      6 |     8 |     0 |   256 | (not available - will be ignored)     | "K6-2"                |
| Intel  |     15 |     2 |     5 |   512 | "Intel(R) Xeon(TM) CPU 2.40GHz"       | "Xeon (Prestonia)"    |
| Intel  |      6 |    15 |    11 |  4096 | "Intel(R) Core(TM)2 Duo CPU E6550..." | "Conroe (Core 2 Duo)" |
| AMD    |     15 |    35 |     2 |  1024 | "Dual Core AMD Opteron(tm) Proces..." | "Opteron (Dual Core)" |
+--------+--------+-------+-------+-------+---------------------------------------+-----------------------+

uint8_t cpu_id_t::detection_hints[CPU_HINTS_MAX]

contain miscellaneous detection information. Used to test about specifics of certain detected features. See CPU_HINT_* macros below.

See also:

Hints

int32_t cpu_id_t::ext_family

CPU extended family

int32_t cpu_id_t::ext_model

CPU extended model

int32_t cpu_id_t::family

CPU family

uint8_t cpu_id_t::flags[CPU_FLAGS_MAX]

contain CPU flags. Used to test for features. See the CPU_FEATURE_* macros below.

See also:

Features

int32_t cpu_id_t::l1_assoc

Cache associativity for the L1 data cache. -1 if undetermined

int32_t cpu_id_t::l1_cacheline

Cache-line size for L1 data cache. -1 if undetermined

int32_t cpu_id_t::l1_data_cache

L1 data cache size in KB. Could be zero, if the CPU lacks cache. If the size cannot be determined, it will be -1.

int32_t cpu_id_t::l1_instruction_cache

L1 instruction cache size in KB. Could be zero, if the CPU lacks cache. If the size cannot be determined, it will be -1.

Note:

On some Intel CPUs, whose instruction cache is in fact a trace cache, the size will be expressed in K uOps.

int32_t cpu_id_t::l2_assoc

Cache associativity for the L2 cache. -1 if undetermined

int32_t cpu_id_t::l2_cache

L2 cache size in KB. Could be zero, if the CPU lacks L2 cache. If the size of the cache could not be determined, it will be -1

int32_t cpu_id_t::l2_cacheline

Cache-line size for L2 cache. -1 if undetermined

int32_t cpu_id_t::l3_assoc

Cache associativity for the L3 cache. -1 if undetermined

int32_t cpu_id_t::l3_cache

L3 cache size in KB. Zero on most systems

int32_t cpu_id_t::l3_cacheline

Cache-line size for L3 cache. -1 if undetermined

int32_t cpu_id_t::l4_assoc

Cache associativity for the L4 cache. -1 if undetermined

int32_t cpu_id_t::l4_cache

L4 cache size in KB. Zero on most systems

int32_t cpu_id_t::l4_cacheline

Cache-line size for L4 cache. -1 if undetermined

int32_t cpu_id_t::model

CPU model

int32_t cpu_id_t::num_cores

Number of CPU cores on the current processor

int32_t cpu_id_t::num_logical_cpus

Number of logical processors on the current processor. Could be more than the number of physical cores, e.g. when the processor has HyperThreading.

struct cpu_sgx_t cpu_id_t::sgx

contains information about SGX features if the processor, if present

int32_t cpu_id_t::sse_size

SSE execution unit size (64 or 128; -1 if N/A)

int32_t cpu_id_t::stepping

CPU stepping

int32_t cpu_id_t::total_logical_cpus

The total number of logical processors. The same value is availabe through cpuid_get_total_cpus.

This is num_logical_cpus * {total physical processors in the system} (but only on a real system, under a VM this number may be lower).

If you're writing a multithreaded program and you want to run it on all CPUs, this is the number of threads you need.

Note:

in a VM, this will exactly match the number of CPUs set in the VM's configuration.

cpu_vendor_t cpu_id_t::vendor

contains the recognized CPU vendor

char cpu_id_t::vendor_str[VENDOR_STR_MAX]

contains the CPU vendor string, e.g. 'GenuineIntel'

Author

Generated automatically by Doxygen for libcpuid from the source code.

Info

Tue Oct 24 2017 Version 0.4.0 libcpuid