nfx-cpu 0.1.4
Cross-platform C++ CPU feature detection and system identification library
Loading...
Searching...
No Matches
[Unreleased]

Added

  • NIL

Changed

  • NIL

Deprecated

  • NIL

Removed

  • NIL

Fixed

  • NIL

Security

  • NIL

[0.1.4] - 2026-02-11

Changed

  • Build System: Reorganized CMake build configuration for portability
    • Moved installation prefix setup to cmake/nfxCpuBuildConfig.cmake
    • Moved license metadata into the build config module
    • Removed redundant GNUInstallDirs inclusion from install script
    • Added PATH_VARS to configure_package_config_file for relocatable packages
  • Formatting: Converted indentation from tabs to spaces across CMake, headers, samples, and tests
  • Tooling: Updated formatting configs in .editorconfig and .clang-format

[0.1.3] - 2025-11-27

Changed

  • Simplified CMake packaging configuration
    • Removed duplicate WiX tool detection
    • Simplified RPM architecture detection to use uname directly

Fixed

  • Removed incorrect runtime dependencies from DEB/RPM packages (header-only library)

[0.1.2] - 2025-11-25

Changed

  • CPU Feature Detection: Optimized has*Support() functions to skip runtime CPUID checks when compiled with feature flags
    • When compiled with -mavx2, __AVX2__, etc., functions now return true immediately (zero overhead)
    • Runtime CPUID detection only occurs when feature is not compile-time guaranteed
    • Eliminates unnecessary static lambda initialization and CPUID calls in optimized builds
    • Maintains backward compatibility with existing code

[0.1.1] - 2025-11-12

Changed

  • CPU Feature Detection: Refactored CPUID magic numbers into named constants in internal namespace
  • Documentation: Refined README with better examples and clarifications
    • Rewrote overview section to match nfx-hashing style
    • Added x86-64 architecture requirement
    • Clarified AVX/AVX2 OS validation requirements
    • Improved real-world applications examples
    • Updated verification pattern to use library functions instead of manual checks
  • Build System: Changed MSVC compiler flags from /arch:AVX to /arch:AVX2 for benchmarks, samples, and tests

Fixed

  • CPU Feature Detection: Added proper OS support verification for AVX/AVX2 detection
    • Check OSXSAVE flag and verify XCR0 register via xgetbv instruction
    • Use inline assembly for GCC/Clang to avoid -mxsave flag dependency
    • Fix MSVC AVX2 detection to use __cpuidex() with proper sub-leaf
    • Prevents false positives where CPU supports AVX/AVX2 but OS doesn't save/restore the extended state
  • CI/CD:
    • Split GitHub Pages build and deploy into separate jobs to fix artifact conflicts
    • Added concurrency control with cancel-in-progress to prevent deployment clashes
    • Updated documentation workflow to use renamed target nfx-cpu-documentation
  • Build System: Renamed documentation target from documentation to nfx-cpu-documentation to avoid collision

[0.1.0] - 2025-11-11 - Initial Release

Added

  • CPU Feature Detection: Runtime hardware capability detection with compile-time verification helpers
    • hasSse42Support(), hasAvxSupport(), hasAvx2Support() - Runtime detection functions
    • verifySse42Support(), verifyAvxSupport(), verifyAvx2Support() - Combined compile-time and runtime verification
    • Static caching for zero-overhead repeated queries
  • CPU Identification: Added CPU identification API
  • Samples: Added Sample_CoreTopology.cpp, Sample_FeatureDetection.cpp and Sample_Identification.cpp
    • Feature detection demonstration with compile-time vs runtime verification
    • Core topology detection examples with thread pool sizing recommendations
    • CPU identification and vendor information display
  • Benchmarks: Added BM_FeatureDetection benchmark suite measuring CPU feature detection overhead
  • Tests: Added TESTS_FeatureDetection test suite
  • Build System
    • CMake 3.20+ configuration with modular structure
    • Header-only interface library target
    • Cross-platform support (Linux GCC/Clang, Windows MinGW/Clang/MSVC)
    • Google Test integration for unit testing
    • Google Benchmark integration for performance benchmarking
    • Doxygen documentation generation with GitHub Pages deployment
    • CPack packaging for distribution (DEB, RPM, TGZ, ZIP, WiX MSI)
    • Installation support with CMake package config files
  • Documentation
    • README with feature overview and usage examples
    • Detailed API documentation with Doxygen comments and RFC references
    • Sample applications
    • Build and installation instructions
  • Testing & Benchmarking
    • Unit test suite
    • Performance benchmarks for all operations
    • Cross-compiler performance validation