Cpuid C++-APIs - 5.2 English - 68552

Constructor from CpuidUtils object.

Parameters:

• cUtils – [in] CpuidUtils object to use for fetching CPUID info.

• num – [in] CPU number to fetch info from.

Default constructor.

This constructor sets the CPU number to info from.

Parameters:

num – [in] Any valid core number starting from 0.

Destructor.

Check if vendor is AMD.

This function will work on all AMD processors.

Returns:

true if ‘num’ was an AMD x86-64, false otherwise

Checks if processor is x86_64-v2 compliant.

Based on GCC following flags account for x86_64-v2 (in addition to x86_64 [sse, sse2])

cx16 lahf_lm popcnt sse4_1 sse4_2 ssse3

Output of this API will be same as hasFlag(ECpuidFlag::sse) && hasFlag(ECpuidFlag::sse2) && hasFlag(ECpuidFlag::cx16) && hasFlag(ECpuidFlag::lahf_lm)&& hasFlag(ECpuidFlag::popcnt)&& hasFlag(ECpuidFlag::sse4_1) && hasFlag(ECpuidFlag::sse4_2)&& hasFlag(ECpuidFlag::ssse3)

Parameters:

none –

Returns:

true if cpu supports all features above, false otherwise

Checks if processor is x86_64-v3 compliant.

Based on GCC following flags account for x86_64-v3 (in addition to x86_64-v2)

avx avx2 bmi1 bmi2 f16c fma abm movbe xsave

Output of this API will be same as isX86_64v2() && hasFlag(ECpuidFlag::avx) && hasFlag(ECpuidFlag::avx2) && hasFlag(ECpuidFlag::bmi1) && hasFlag(ECpuidFlag::bmi2) && hasFlag(ECpuidFlag::f16c) && hasFlag(ECpuidFlag::fma) && hasFlag(ECpuidFlag::abm) && hasFlag(ECpuidFlag::movbe)&& hasFlag(ECpuidFlag::xsave)

Parameters:

none –

Returns:

true if cpu supports all features above, false otherwise

Checks if processor is x86_64-v4 compliant.

Based on GCC following flags account for x86_64-v4 (in addition to x86_64-v2 + x86_64-v3)

avx512f avx512bw avx512cd avx512dq avx512vl

Output of this API will be same as isX86_64v3() && hasFlag(ECpuidFlag::avx512f) && hasFlag(ECpuidFlag::avx512bw) && hasFlag(ECpuidFlag::avx512cd) && hasFlag(ECpuidFlag::avx512dq) && hasFlag(ECpuidFlag::avx512vl)

Parameters:

none –

Returns:

true if cpu supports all features above, false otherwise

Check if vendor is Intel.

This function will work on all Intel processors.

Parameters:

none –

Returns:

true if ‘num’ was an Intel x86-64, false otherwise

Check if the flag is suppored by the CPU ideintified by num.

List of supported flags: sse3, pclmulqdq, dtes64, monitor, dscpl, vmx, smx, est, tm2, ssse3, cid, fma, cx16, xtpr, pdcm, pcid, dca, sse4_1, sse4_2, x2apic, movbe, popcnt, tsc_deadline, aes, xsave, osxsave, avx, f16c, rdrand, hypervisor, fpu, vme, de, pse, tsc, msr, pae, mce, cx8, apic, sep, mtrr, pge, mca, cmov, pat, pse36, pn, clflush, ds, acpi, mmx, fxsr, sse, sse2, ss, ht, tm, ia64, pbe, arat, fsgsbase, tsc_adjust, bmi1, hle, avx2, smep, bmi2, erms, invpcid, rtm, mpx, avx512f, avx512dq, rdseed, adx, smap, avx512ifma, pcommit, clflushopt, clwb, avx512pf, avx512er, avx512cd, sha_ni, avx512bw, avx512vl, avx512vbmi, umip, pku, ospke, avx512_vpopcntdq, la57, rdpid, avx512_4vnniw, avx512_4fmaps, avx512_bf16, avxvnni, xsaveopt, xsavec, xgetbv1, xsaves, lahf_lm, cmp_legacy, svm, extapic, cr8legacy, abm, sse4a, misalignsse, _3dnowprefetch, osvw, ibs, xop, skinit, wdt, lwp, fma4, tce, nodeid_msr, tbm, topoext, perfctr_core, perfctr_nb, syscall, nxxd, mmxext, fxsr_opt, pdpe1gb, rdtscp, lmi64, _3dnowext, _3dnow, invtsc, npt, lbrv, svm_lock, nrip_save, tsc_scale, vmcb_clean, flushbyasid, decodeassists, pause_filter, pfthreshold, xstore, xstore_en, xcrypt, xcrypt_en, ace2, ace2_en, phe, phe_en, pmm, pmm_en, vaes, vpclmulqdq, avx512_vnni, avx512_bitalg, avx512vbmi2, movdiri, movdir64b, avx512_vpintersect, x2avic

Parameters:

eflag – [in] ECpuidFlag that needs to be checked

Returns:

true if eflag is present in the availableflags and usable flags, false otherwise

Check if the flag is suppored by the CPU ideintified by num. This function is used to check any of the flags are available.

List of supported flags: sse3, pclmulqdq, dtes64, monitor, dscpl, vmx, smx, est, tm2, ssse3, cid, fma, cx16, xtpr, pdcm, pcid, dca, sse4_1, sse4_2, x2apic, movbe, popcnt, tsc_deadline, aes, xsave, osxsave, avx, f16c, rdrand, hypervisor, fpu, vme, de, pse, tsc, msr, pae, mce, cx8, apic, sep, mtrr, pge, mca, cmov, pat, pse36, pn, clflush, ds, acpi, mmx, fxsr, sse, sse2, ss, ht, tm, ia64, pbe, arat, fsgsbase, tsc_adjust, bmi1, hle, avx2, smep, bmi2, erms, invpcid, rtm, mpx, avx512f, avx512dq, rdseed, adx, smap, avx512ifma, pcommit, clflushopt, clwb, avx512pf, avx512er, avx512cd, sha_ni, avx512bw, avx512vl, avx512vbmi, umip, pku, ospke, avx512_vpopcntdq, la57, rdpid, avx512_4vnniw, avx512_4fmaps, avx512_bf16, avxvnni, xsaveopt, xsavec, xgetbv1, xsaves, lahf_lm, cmp_legacy, svm, extapic, cr8legacy, abm, sse4a, misalignsse, _3dnowprefetch, osvw, ibs, xop, skinit, wdt, lwp, fma4, tce, nodeid_msr, tbm, topoext, perfctr_core, perfctr_nb, syscall, nxxd, mmxext, fxsr_opt, pdpe1gb, rdtscp, lmi64, _3dnowext, _3dnow, invtsc, npt, lbrv, svm_lock, nrip_save, tsc_scale, vmcb_clean, flushbyasid, decodeassists, pause_filter, pfthreshold, xstore, xstore_en, xcrypt, xcrypt_en, ace2, ace2_en, phe, phe_en, pmm, pmm_en, vaes, vpclmulqdq, avx512_vnni, avx512_bitalg, avx512vbmi2, movdiri, movdir64b, avx512_vpintersect, x2avic

Parameters:

eflags – [in] List of ECpuidFlag that needs to be checked

Returns:

true if any eflags are present in the availableflags and usable

Check if the flag is suppored by the CPU ideintified by num. This function is used to check all of the flags are available.

List of supported flags: sse3, pclmulqdq, dtes64, monitor, dscpl, vmx, smx, est, tm2, ssse3, cid, fma, cx16, xtpr, pdcm, pcid, dca, sse4_1, sse4_2, x2apic, movbe, popcnt, tsc_deadline, aes, xsave, osxsave, avx, f16c, rdrand, hypervisor, fpu, vme, de, pse, tsc, msr, pae, mce, cx8, apic, sep, mtrr, pge, mca, cmov, pat, pse36, pn, clflush, ds, acpi, mmx, fxsr, sse, sse2, ss, ht, tm, ia64, pbe, arat, fsgsbase, tsc_adjust, bmi1, hle, avx2, smep, bmi2, erms, invpcid, rtm, mpx, avx512f, avx512dq, rdseed, adx, smap, avx512ifma, pcommit, clflushopt, clwb, avx512pf, avx512er, avx512cd, sha_ni, avx512bw, avx512vl, avx512vbmi, umip, pku, ospke, avx512_vpopcntdq, la57, rdpid, avx512_4vnniw, avx512_4fmaps, avx512_bf16, avxvnni, xsaveopt, xsavec, xgetbv1, xsaves, lahf_lm, cmp_legacy, svm, extapic, cr8legacy, abm, sse4a, misalignsse, _3dnowprefetch, osvw, ibs, xop, skinit, wdt, lwp, fma4, tce, nodeid_msr, tbm, topoext, perfctr_core, perfctr_nb, syscall, nxxd, mmxext, fxsr_opt, pdpe1gb, rdtscp, lmi64, _3dnowext, _3dnow, invtsc, npt, lbrv, svm_lock, nrip_save, tsc_scale, vmcb_clean, flushbyasid, decodeassists, pause_filter, pfthreshold, xstore, xstore_en, xcrypt, xcrypt_en, ace2, ace2_en, phe, phe_en, pmm, pmm_en, vaes, vpclmulqdq, avx512_vnni, avx512_bitalg, avx512vbmi2, movdiri, movdir64b, avx512_vpintersect, x2avic

Parameters:

eflags – [in] List of ECpuidFlag that needs to be checked

Returns:

true if all eflags are present in the availableflags and usable

Check if the flag is suppored by the CPU ideintified by num.

List of supported flags: sse3, pclmulqdq, dtes64, monitor, dscpl, vmx, smx, est, tm2, ssse3, cid, fma, cx16, xtpr, pdcm, pcid, dca, sse4_1, sse4_2, x2apic, movbe, popcnt, tsc_deadline, aes, xsave, osxsave, avx, f16c, rdrand, hypervisor, fpu, vme, de, pse, tsc, msr, pae, mce, cx8, apic, sep, mtrr, pge, mca, cmov, pat, pse36, pn, clflush, ds, acpi, mmx, fxsr, sse, sse2, ss, ht, tm, ia64, pbe, arat, fsgsbase, tsc_adjust, bmi1, hle, avx2, smep, bmi2, erms, invpcid, rtm, mpx, avx512f, avx512dq, rdseed, adx, smap, avx512ifma, pcommit, clflushopt, clwb, avx512pf, avx512er, avx512cd, sha_ni, avx512bw, avx512vl, avx512vbmi, umip, pku, ospke, avx512_vpopcntdq, la57, rdpid, avx512_4vnniw, avx512_4fmaps, avx512_bf16, avxvnni, xsaveopt, xsavec, xgetbv1, xsaves, lahf_lm, cmp_legacy, svm, extapic, cr8legacy, abm, sse4a, misalignsse, _3dnowprefetch, osvw, ibs, xop, skinit, wdt, lwp, fma4, tce, nodeid_msr, tbm, topoext, perfctr_core, perfctr_nb, syscall, nxxd, mmxext, fxsr_opt, pdpe1gb, rdtscp, lmi64, _3dnowext, _3dnow, invtsc, npt, lbrv, svm_lock, nrip_save, tsc_scale, vmcb_clean, flushbyasid, decodeassists, pause_filter, pfthreshold, xstore, xstore_en, xcrypt, xcrypt_en, ace2, ace2_en, phe, phe_en, pmm, pmm_en, vaes, vpclmulqdq, avx512_vnni, avx512_bitalg, avx512vbmi2, movdiri, movdir64b, avx512_vpintersect, x2avic

       Note: The api is deprecated. Use hasFlag instead.

Parameters:

eflag – [in] ECpuidFlag that needs to be checked

Returns:

true if eflag is present in the availableflags and usable flags, false otherwise

Get microarchitecture of CPU from CPUID instruction.

The microarchitecture of the CPU can be Zen, Zen2, Zen3, Zen4, Zen5

Will return Unknown if the microarchitecture is not supported (non-AMD CPUs)

Parameters:

none –

Returns:

Returns microarchitecture of CPU.

Checks microarchitecture from CPUID instruction and compare with input Like Zen, Zen2, Zen3 etc.

Given a microarchitecture, this function will check if the CPU microarchitecture is matched with input.

When given strict as true, it will check for exact match.

C++-API Behaviour Summary

Parameters:

• arch – [in] Microarchitecture input to check for.

• strict – [in] If true, then exact match is checked.

Returns:

Returns true if CPU microarchitecture is matched with input.

Check if the CPU is Zen family.

This function will check if the CPU is Zen family. Zen family includes Zen, Zen2, Zen3, Zen4, Zen5 microarchitectures.

Returns:

true if CPU is Zen family, false otherwise

Get the VendorInfo object.

This function will return the VendorInfo object which contains the vendor, family, model, stepping and microarchitecture of the CPU.

VendorInfo object contains the following fields:

1. EVendor m_mfg; // CPU manufacturing vendor.

2. EFamily m_family; // CPU family ID.

3. Uint16 m_model; // CPU model number.

4. Uint16 m_stepping; // CPU stepping.

5. EUarch m_uarch; // CPU microarchitecture.

Parameters:

none –

Returns:

VendorInfo

Execute CPUID instruction and update the internal data.

Parameters:

none –

Returns:

none

Interface to get Freqency scaling governer.

Returns:

EGoverner type