WCPUID Guide — Extracting CPU Features Easily

WCPUID: What It Is and How to Use It

What WCPUID Is

WCPUID is a small diagnostic utility that queries the CPUID interface on x86/x86-64 processors and presents CPU feature flags, model and family information, cache topology, and vendor identification in a human-readable form. It acts as a convenient wrapper around the CPUID instruction, decoding raw register values into labeled features (for example SSE, AVX, hyper-threading support) and enumerating core/cache details that are helpful for developers, performance engineers, and system diagnosticians.

Why it’s useful

• Quick hardware checks: Confirms which instruction-set extensions a CPU supports (SSE/AVX/AVX2/AVX-512, AES, etc.).
• Compatibility testing: Helps determine whether compiled software or workloads will run optimally or require fallbacks.
• Performance tuning: Reveals cache sizes and topology for cache-aware tuning and thread placement.
• Troubleshooting: Identifies mismatches between expected CPU capabilities and observed behavior (e.g., missing features due to BIOS/firmware or virtualization).

Where WCPUID fits vs. other tools

• Compared with generic system info utilities, WCPUID focuses specifically on CPUID-level details and exposes bit-level feature flags that higher-level tools may hide or summarize.
• Unlike heavy profiling tools, WCPUID is lightweight and non-invasive — it only reads CPUID registers and formats results.

How to get WCPUID

• WCPUID is commonly distributed as a small executable for Windows, Linux, or as source code you can compile. Check the project repository or package manager for prebuilt binaries. If compiling, ensure you have a C/C++ toolchain and necessary build tools.

Basic usage

1. Download or build the executable for your platform.
2. Run without arguments to get a full dump of CPUID leaves and decoded features:
   • Example (Linux/Windows command line): wcpuid
3. Use common flags to filter output (tool-specific; assume typical flags):
   • -v or –verbose for more detail.
   • -leaf to request a specific CPUID leaf.
   • -json to output machine-readable JSON for scripts.
4. Redirect output to a file for later analysis:
   • wcpuid > cpuid-output.txt

Interpreting key sections

• Vendor string and brand: Identifies CPU vendor (e.g., GenuineIntel, AuthenticAMD) and a human-readable brand string with model name and clock information.
• Feature flags: Grouped by CPUID leaf/register (EAX/EBX/ECX/EDX). Look for labels like SSE4.2, AVX, AES, RDRAND, XSAVE, HYPERVISOR. Presence indicates CPU support; absence requires software fallbacks or recompile.
• Topology and cores: Shows logical processor count, physical cores, SMT/hyperthreading status, and APIC IDs used for affinity decisions.
• Cache information: Sizes and associativity for L1/L2/L3 caches and which cores share them — critical for performance-sensitive scheduling.
• Extended/APIC/MSR hints: May show extended features (e.g., extended CPUID leaves), and whether running under a hypervisor (commonly seen in virtual machines).

Common practical examples

• Confirm AVX2 support before deploying SIMD-optimized binaries:
  • Run WCPUID and verify the AVX2 feature flag is present.
• Check hyperthreading status:
  • Inspect logical vs. physical core counts and the Hyper-Threading-related feature bits.
• Scripted inventory of servers:
  • Run wcpuid -json across machines and aggregate outputs to ensure homogeneity.

Troubleshooting tips

• If expected features are missing:
  • Check BIOS/UEFI settings (some features can be disabled).
  • Verify running on bare metal vs. a VM; some hypervisors mask or limit CPUID features.
  • Ensure the kernel/OS isn’t blocking access or presenting a virtualized CPUID.
• If WCPUID fails to run:
  • Confirm you have proper privileges and that the binary matches your OS/architecture.
  • Rebuild from source ensuring use of the correct compiler flags for your platform.

Security and safety notes

WCPUID only reads CPU registers and does not modify system state. It’s safe to run on production systems, though on some locked-down environments access to low-level CPU features may be restricted.

Example output excerpt (illustrative)

• Vendor: GenuineIntel
• Brand: Intel® Core™ i7-9700K CPU @ 3.60GHz
• Features: SSE SSE2 SSE3 SSSE3 SSE4.1 SSE4.2 AVX AVX2 AES RDRAND
• Cores: 8 physical, 8 logical (no hyper-threading)
• L1D: 32 KB/core, L2: 256 KB/core, L3: 12 MB shared

Conclusion

WCPUID is an efficient, focused tool to expose CPUID-level CPU details. Use it to verify instruction-set support, inspect cache and topology for tuning, and troubleshoot discrepancies caused by firmware or virtualization layers. Running WCPUID regularly as part of system audits or CI hardware checks helps ensure deployment compatibility and optimal performance.