Skip to content

Platform Support Matrix

Jump to bottom
whisprer edited this page Aug 4, 2025 · 4 revisions

Platform Support Matrix - Universal RNG Library

🖥️ Comprehensive Platform Coverage

Support Status Legend

  • ✅ Full Support: Thoroughly tested, optimal performance
  • 🟡 Partial Support: Works with limitations or reduced performance
  • 🔄 In Development: Actively being implemented
  • ❌ Not Supported: Not compatible or not planned

🏗️ Operating Systems

Operating System Version Status SIMD Support Notes
Windows 10/11 x64 ✅ Full AVX2, SSE4.2 MSVC 2019+, MinGW64
Windows 10/11 ARM64 🟡 Partial NEON (limited) Future ARM development
Linux Ubuntu 18.04+ ✅ Full AVX2, AVX-512* GCC 7+, Clang 5+
Linux CentOS 7+ ✅ Full AVX2, SSE4.2 RHEL compatible
Linux Debian 10+ ✅ Full AVX2, SSE4.2 Stable and testing
Linux Arch Linux ✅ Full AVX2, AVX-512* Rolling release
Linux ARM64/aarch64 🔄 In Dev NEON Raspberry Pi 4+, server
macOS 10.15+ Intel ✅ Full AVX2, SSE4.2 Xcode 11+
macOS 11+ Apple Silicon 🟡 Partial NEON (limited) M1/M2 native building
FreeBSD 12+ 🔄 In Dev AVX2 Community contributions
OpenBSD 7+ 🔄 In Dev SSE4.2 Community contributions

📞 Platform-Specific Support

Getting Help by Platform

Windows Issues

  • GitHub Issues: Tag with platform:windows
  • Common Solutions: Check troubleshooting guide first
  • MSVC Specific: Include compiler version and build log

Linux Issues

  • GitHub Issues: Tag with platform:linux
  • Distribution Specific: Include distro and version
  • Compiler Problems: Include gcc --version output

macOS Issues

  • GitHub Issues: Tag with platform:macos
  • Architecture Specific: Specify Intel vs Apple Silicon
  • Xcode Problems: Include Xcode and command line tools version

Contributing Platform Support

Adding New Platform Support

  1. Fork repository and create platform branch
  2. Add platform detection in CMake files
  3. Implement SIMD support for platform architecture
  4. Add CI integration if possible
  5. Submit PR with platform documentation

Platform Maintainership

Interested in maintaining a specific platform? Contact maintainers about:

  • Regular testing and issue triage
  • Platform-specific optimization
  • Documentation updates
  • User support

📋 Platform Selection Guide

For Maximum Performance

Intel Skylake+ with Linux + GCC 11: Peak SIMD performance, best optimization

For Development

Any modern platform: All major platforms supported for development

For Production Deployment

  • Linux servers: Best performance and stability
  • Windows servers: Good performance with MSVC
  • Cloud platforms: Excellent on AWS, Azure, GCP

For Embedded/Edge

  • ARM64 Linux: Good performance with NEON (in development)
  • x86-64 embedded: Full AVX2 support available

Choose your platform based on performance requirements, development environment, and deployment constraints. The library adapts to provide optimal performance on each supported platform.

There is currently data lost off the bottom off the page - a search party needs to be sent in to rescue!

PLEASE DO BEAR IN CONSTANT MIND ABOVE ALL ELSE: CURRENT STATE OF DEVELOPMENT THE C++ STD LIBRARY EMPLOYING MERSENNE TWISTER STILL OUTPERFORMS SINGLE CALCULATION OPERATIONS FOR NON-SIMD BOOSTED COMPUTERS. THESE LIBRARIES FULLY REQUIRE AT LEAST AVX2 MINIMUM TO BENEFIT OVER THE STD GENERATION METHODS WHEN CONSIDERING SINGLE NUMBER GENERATION TASKS.

Clone this wiki locally