3

I have an image drawing routine which is compiled multiple times for SSE, SSE2, SSE3, SSE4.1, SSE4.2, AVX and AVX2. My program dynamically dispatches one of these binary variations by checking CPUID flags.

On Windows, I check the version of Windows and disable AVX/AVX2 dispatch if the OS doesn't support them. (For example, only Windows 7 SP1 or later supports AVX/AVX2.)

I want to do the same thing on Mac OS X, but I'm not sure what version of OS X supports AVX/AVX2.

Note that what I want to know is the minimum version of OS X for use with AVX/AVX2. Not machine models which are capable of AVX/AVX2.

2

2 Answers 2

5

For detecting instruction set features there are two source files I reference:

  1. Mysticial's cpu_x86.cpp
  2. Agner Fog's instrset_detect.cpp

Both of these files will tell you how to detect SSE through AVX2 as well as XOP, FMA3, FMA4, if your OS supports AVX and other features.

I am used to Agner's code (one source file for MSVC, GCC, Clang, ICC) so let's look at that first.

Here are the relevant code fragments from instrset_detect.cpp for detecting AVX:

iset = 0;                                              // default value
int abcd[4] = {0,0,0,0};                               // cpuid results
cpuid(abcd, 0);                                        // call cpuid function 0
//....
iset = 6;                                              // 6: SSE4.2 supported
if ((abcd[2] & (1 << 27)) == 0) return iset;           // no OSXSAVE
if ((xgetbv(0) & 6) != 6)       return iset;           // AVX not enabled in O.S.
if ((abcd[2] & (1 << 28)) == 0) return iset;           // no AVX
iset = 7;                                              // 7: AVX supported

with xgetbv defined as

// Define interface to xgetbv instruction
static inline int64_t xgetbv (int ctr) {    
#if (defined (_MSC_FULL_VER) && _MSC_FULL_VER >= 160040000) || (defined (__INTEL_COMPILER) && __INTEL_COMPILER >= 1200) // Microsoft or Intel compiler supporting _xgetbv intrinsic

    return _xgetbv(ctr);                                   // intrinsic function for XGETBV

#elif defined(__GNUC__)                                    // use inline assembly, Gnu/AT&T syntax

   uint32_t a, d;
   __asm("xgetbv" : "=a"(a),"=d"(d) : "c"(ctr) : );
   return a | (uint64_t(d) << 32);

#else  // #elif defined (_WIN32)                           // other compiler. try inline assembly with masm/intel/MS syntax

  //see the source file
}

I did not include the cpuid function (see the source code) and I removed the non GCC inline assembly from xgetbv to make the answer shorter.

Here is the detect_OS_AVX() from Mysticial's cpu_x86.cpp for detecting AVX:

bool cpu_x86::detect_OS_AVX(){
    //  Copied from: http://stackoverflow.com/a/22521619/922184

    bool avxSupported = false;

    int cpuInfo[4];
    cpuid(cpuInfo, 1);

    bool osUsesXSAVE_XRSTORE = (cpuInfo[2] & (1 << 27)) != 0;
    bool cpuAVXSuport = (cpuInfo[2] & (1 << 28)) != 0;

    if (osUsesXSAVE_XRSTORE && cpuAVXSuport)
    {
        uint64_t xcrFeatureMask = xgetbv(_XCR_XFEATURE_ENABLED_MASK);
        avxSupported = (xcrFeatureMask & 0x6) == 0x6;
    }

    return avxSupported;
}

Mystical apparently came up with this solution from this answer.

Notice that both source files do basically the same thing: check the OSXSAVE bit 27, check the AVX bit 28 from CPUID, check a result from xgetbv.

4
  • Thank you very much for kind explanation. I understood very well. Now I know I had a bad idea. The correct way is like "Step1: Get OSXSAVE bit to check if OS allows XGETBV instruction. Step2: Get AVX/AVX2 bits. Step3: Issue XGETBV and check if OS saves YMM registers." However, I guess the answer for my question is "Mac OS X 10.6.7" :-)
    – TABATA
    Jul 13, 2016 at 9:10
  • @TABATA, did you want a computer answer or a human answer? Computer answers lead to crashes, literally. Several Tesla's have crashed recently due to computer answers. I don't think the restrictive filter of SO should lead to a higher rate of people failing the Turing test...
    – Z boson
    Jul 13, 2016 at 11:27
  • 1
    Surely. I've already implemented the way you told me. Thanks again. I should have simply asked the steps to check AVX capability, not a OS version. I'll try writing a simple question next time.
    – TABATA
    Jul 13, 2016 at 14:36
  • @TABATA: you can edit your question to take out the mistaken idea of looking at OS version, and just ask how to detect if AVX / AVX2 is usable in a program. Now that you know the answer isn't OS-specific, you can tidy up the question even more if you want to. But it might not hurt to leave some mention of Windows and OS X in there, since people searching in the future might have the same idea as you, and be looking for the Windows way or the OS X way. Jul 13, 2016 at 19:59
3

For AVX the answer is quite straightforward:

You need at least OS X 10.6.7

Please note that only build 10J3250 and 10J4138 would support it.

For AVX2 that would be 10.8.4 build 12E3067 or 12E4022

16
  • That's exactly what I wanted to know. Thank you very much, Antzi!
    – TABATA
    Jul 12, 2016 at 4:01
  • 1
    @TABATA, cutting on OS version I don't think is the right way to go about this. There are methods to ask if the OS supports AVX which are cross platform. Relying on OS version cuts is not the ideal solution.
    – Z boson
    Jul 12, 2016 at 12:42
  • 1
    @Zboson Yes. I only do it for testing, but many of my users do it for everyday use. AVX heavily taxes Haswell processors to the point that can overheat (100C+) even at stock settings. Throw in a large overclock and it's a recipe for disaster. Try googling for "Haswell AVX overclock". The situation is so bad that many overclockers simply disable AVX via bcdedit. And those that do start reporting crashes with specific apps. (Namely those that attempt to use AVX after seeing the AVX bit in cpuid, but without also checking the xsave bit.)
    – Mysticial
    Jul 13, 2016 at 14:50
  • 1
    @Zboson As an update to my comments. Kaby Lake lets you set an "AVX offset" that will drop the CPU multiplier when running AVX. This feature was already present in Haswell-EP and Broadwell-EP. Now you can control it for Kaby Lake with a suitable (overclockable) motheraboard/BIOS.
    – Mysticial
    Feb 17, 2017 at 1:23
  • 1
    @Zboson Yes. Pretty much every single Kaby Lake overclocking guide covers it. Just take a look at edgeup.asus.com/2017/01/31/kaby-lake-overclocking-guide and scroll down to the section, "AVX offset".
    – Mysticial
    Feb 17, 2017 at 16:17

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.