SDL  2.0
SDL_cpuinfo.c File Reference
#include "../SDL_internal.h"
#include "SDL_simd.h"
#include "SDL_cpuinfo.h"
#include "SDL_assert.h"
+ Include dependency graph for SDL_cpuinfo.c:

Go to the source code of this file.

Macros

#define CPU_HAS_RDTSC   (1 << 0)
 
#define CPU_HAS_ALTIVEC   (1 << 1)
 
#define CPU_HAS_MMX   (1 << 2)
 
#define CPU_HAS_3DNOW   (1 << 3)
 
#define CPU_HAS_SSE   (1 << 4)
 
#define CPU_HAS_SSE2   (1 << 5)
 
#define CPU_HAS_SSE3   (1 << 6)
 
#define CPU_HAS_SSE41   (1 << 7)
 
#define CPU_HAS_SSE42   (1 << 8)
 
#define CPU_HAS_AVX   (1 << 9)
 
#define CPU_HAS_AVX2   (1 << 10)
 
#define CPU_HAS_NEON   (1 << 11)
 
#define CPU_HAS_AVX512F   (1 << 12)
 
#define cpuid(func, a, b, c, d)   do { a = b = c = d = 0; (void) a; (void) b; (void) c; (void) d; } while (0)
 
#define CPU_haveRDTSC()   (CPU_CPUIDFeatures[3] & 0x00000010)
 
#define CPU_haveMMX()   (CPU_CPUIDFeatures[3] & 0x00800000)
 
#define CPU_haveSSE()   (CPU_CPUIDFeatures[3] & 0x02000000)
 
#define CPU_haveSSE2()   (CPU_CPUIDFeatures[3] & 0x04000000)
 
#define CPU_haveSSE3()   (CPU_CPUIDFeatures[2] & 0x00000001)
 
#define CPU_haveSSE41()   (CPU_CPUIDFeatures[2] & 0x00080000)
 
#define CPU_haveSSE42()   (CPU_CPUIDFeatures[2] & 0x00100000)
 
#define CPU_haveAVX()   (CPU_OSSavesYMM && (CPU_CPUIDFeatures[2] & 0x10000000))
 
#define CPU_FEATURE_AVAILABLE(f)   ((SDL_GetCPUFeatures() & f) ? SDL_TRUE : SDL_FALSE)
 

Functions

static int CPU_haveCPUID (void)
 
static void CPU_calcCPUIDFeatures (void)
 
static int CPU_haveAltiVec (void)
 
static int CPU_haveNEON (void)
 
static int CPU_have3DNow (void)
 
static int CPU_haveAVX2 (void)
 
static int CPU_haveAVX512F (void)
 
int SDL_GetCPUCount (void)
 
static const char * SDL_GetCPUType (void)
 
int SDL_GetCPUCacheLineSize (void)
 
static Uint32 SDL_GetCPUFeatures (void)
 
SDL_bool SDL_HasRDTSC (void)
 
SDL_bool SDL_HasAltiVec (void)
 
SDL_bool SDL_HasMMX (void)
 
SDL_bool SDL_Has3DNow (void)
 
SDL_bool SDL_HasSSE (void)
 
SDL_bool SDL_HasSSE2 (void)
 
SDL_bool SDL_HasSSE3 (void)
 
SDL_bool SDL_HasSSE41 (void)
 
SDL_bool SDL_HasSSE42 (void)
 
SDL_bool SDL_HasAVX (void)
 
SDL_bool SDL_HasAVX2 (void)
 
SDL_bool SDL_HasAVX512F (void)
 
SDL_bool SDL_HasNEON (void)
 
int SDL_GetSystemRAM (void)
 
size_t SDL_SIMDGetAlignment (void)
 Report the alignment this system needs for SIMD allocations. More...
 
voidSDL_SIMDAlloc (const size_t len)
 Allocate memory in a SIMD-friendly way. More...
 
void SDL_SIMDFree (void *ptr)
 Deallocate memory obtained from SDL_SIMDAlloc. More...
 

Variables

static int CPU_CPUIDFeatures [4]
 
static int CPU_CPUIDMaxFunction = 0
 
static SDL_bool CPU_OSSavesYMM = SDL_FALSE
 
static SDL_bool CPU_OSSavesZMM = SDL_FALSE
 
static int SDL_CPUCount = 0
 
static Uint32 SDL_CPUFeatures = 0xFFFFFFFF
 
static Uint32 SDL_SIMDAlignment = 0xFFFFFFFF
 
static int SDL_SystemRAM = 0
 

Macro Definition Documentation

◆ CPU_FEATURE_AVAILABLE

◆ CPU_HAS_3DNOW

#define CPU_HAS_3DNOW   (1 << 3)

Definition at line 84 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_Has3DNow().

◆ CPU_HAS_ALTIVEC

#define CPU_HAS_ALTIVEC   (1 << 1)

Definition at line 82 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasAltiVec().

◆ CPU_HAS_AVX

#define CPU_HAS_AVX   (1 << 9)

Definition at line 90 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasAVX().

◆ CPU_HAS_AVX2

#define CPU_HAS_AVX2   (1 << 10)

Definition at line 91 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasAVX2().

◆ CPU_HAS_AVX512F

#define CPU_HAS_AVX512F   (1 << 12)

Definition at line 93 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasAVX512F().

◆ CPU_HAS_MMX

#define CPU_HAS_MMX   (1 << 2)

Definition at line 83 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasMMX().

◆ CPU_HAS_NEON

#define CPU_HAS_NEON   (1 << 11)

Definition at line 92 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasNEON().

◆ CPU_HAS_RDTSC

#define CPU_HAS_RDTSC   (1 << 0)

Definition at line 81 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasRDTSC().

◆ CPU_HAS_SSE

#define CPU_HAS_SSE   (1 << 4)

Definition at line 85 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasSSE().

◆ CPU_HAS_SSE2

#define CPU_HAS_SSE2   (1 << 5)

Definition at line 86 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasSSE2().

◆ CPU_HAS_SSE3

#define CPU_HAS_SSE3   (1 << 6)

Definition at line 87 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasSSE3().

◆ CPU_HAS_SSE41

#define CPU_HAS_SSE41   (1 << 7)

Definition at line 88 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasSSE41().

◆ CPU_HAS_SSE42

#define CPU_HAS_SSE42   (1 << 8)

Definition at line 89 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_HasSSE42().

◆ CPU_haveAVX

#define CPU_haveAVX ( )    (CPU_OSSavesYMM && (CPU_CPUIDFeatures[2] & 0x10000000))

Definition at line 394 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveMMX

#define CPU_haveMMX ( )    (CPU_CPUIDFeatures[3] & 0x00800000)

Definition at line 388 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveRDTSC

#define CPU_haveRDTSC ( )    (CPU_CPUIDFeatures[3] & 0x00000010)

Definition at line 387 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveSSE

#define CPU_haveSSE ( )    (CPU_CPUIDFeatures[3] & 0x02000000)

Definition at line 389 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveSSE2

#define CPU_haveSSE2 ( )    (CPU_CPUIDFeatures[3] & 0x04000000)

Definition at line 390 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveSSE3

#define CPU_haveSSE3 ( )    (CPU_CPUIDFeatures[2] & 0x00000001)

Definition at line 391 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveSSE41

#define CPU_haveSSE41 ( )    (CPU_CPUIDFeatures[2] & 0x00080000)

Definition at line 392 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ CPU_haveSSE42

#define CPU_haveSSE42 ( )    (CPU_CPUIDFeatures[2] & 0x00100000)

Definition at line 393 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ cpuid

#define cpuid (   func,
  a,
  b,
  c,
  d 
)    do { a = b = c = d = 0; (void) a; (void) b; (void) c; (void) d; } while (0)

Function Documentation

◆ CPU_calcCPUIDFeatures()

static void CPU_calcCPUIDFeatures ( void  )
static

Definition at line 255 of file SDL_cpuinfo.c.

References CPU_CPUIDFeatures, CPU_CPUIDMaxFunction, CPU_haveCPUID(), CPU_OSSavesYMM, CPU_OSSavesZMM, cpuid, d, SDL_FALSE, and SDL_TRUE.

Referenced by SDL_GetCPUFeatures(), and SDL_GetCPUType().

256 {
257  static SDL_bool checked = SDL_FALSE;
258  if (!checked) {
259  checked = SDL_TRUE;
260  if (CPU_haveCPUID()) {
261  int a, b, c, d;
262  cpuid(0, a, b, c, d);
264  if (CPU_CPUIDMaxFunction >= 1) {
265  cpuid(1, a, b, c, d);
266  CPU_CPUIDFeatures[0] = a;
267  CPU_CPUIDFeatures[1] = b;
268  CPU_CPUIDFeatures[2] = c;
269  CPU_CPUIDFeatures[3] = d;
270 
271  /* Check to make sure we can call xgetbv */
272  if (c & 0x08000000) {
273  /* Call xgetbv to see if YMM (etc) register state is saved */
274 #if defined(__GNUC__) && (defined(i386) || defined(__x86_64__))
275  __asm__(".byte 0x0f, 0x01, 0xd0" : "=a" (a) : "c" (0) : "%edx");
276 #elif defined(_MSC_VER) && (defined(_M_IX86) || defined(_M_X64)) && (_MSC_FULL_VER >= 160040219) /* VS2010 SP1 */
277  a = (int)_xgetbv(0);
278 #elif (defined(_MSC_VER) && defined(_M_IX86)) || defined(__WATCOMC__)
279  __asm
280  {
281  xor ecx, ecx
282  _asm _emit 0x0f _asm _emit 0x01 _asm _emit 0xd0
283  mov a, eax
284  }
285 #endif
286  CPU_OSSavesYMM = ((a & 6) == 6) ? SDL_TRUE : SDL_FALSE;
287  CPU_OSSavesZMM = (CPU_OSSavesYMM && ((a & 0xe0) == 0xe0)) ? SDL_TRUE : SDL_FALSE;
288  }
289  }
290  }
291  }
292 }
static SDL_bool CPU_OSSavesYMM
Definition: SDL_cpuinfo.c:251
static int CPU_CPUIDMaxFunction
Definition: SDL_cpuinfo.c:250
static int CPU_haveCPUID(void)
Definition: SDL_cpuinfo.c:108
static SDL_bool CPU_OSSavesZMM
Definition: SDL_cpuinfo.c:252
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
SDL_bool
Definition: SDL_stdinc.h:161
static int CPU_CPUIDFeatures[4]
Definition: SDL_cpuinfo.c:249
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ CPU_have3DNow()

static int CPU_have3DNow ( void  )
static

Definition at line 374 of file SDL_cpuinfo.c.

References CPU_CPUIDMaxFunction, cpuid, and d.

Referenced by SDL_GetCPUFeatures().

375 {
376  if (CPU_CPUIDMaxFunction > 0) { /* that is, do we have CPUID at all? */
377  int a, b, c, d;
378  cpuid(0x80000000, a, b, c, d);
379  if (a >= 0x80000001) {
380  cpuid(0x80000001, a, b, c, d);
381  return (d & 0x80000000);
382  }
383  }
384  return 0;
385 }
static int CPU_CPUIDMaxFunction
Definition: SDL_cpuinfo.c:250
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ CPU_haveAltiVec()

static int CPU_haveAltiVec ( void  )
static

Definition at line 295 of file SDL_cpuinfo.c.

References NULL, and void.

Referenced by SDL_GetCPUFeatures().

296 {
297  volatile int altivec = 0;
298 #ifndef SDL_CPUINFO_DISABLED
299 #if (defined(__MACOSX__) && (defined(__ppc__) || defined(__ppc64__))) || (defined(__OpenBSD__) && defined(__powerpc__))
300 #ifdef __OpenBSD__
301  int selectors[2] = { CTL_MACHDEP, CPU_ALTIVEC };
302 #else
303  int selectors[2] = { CTL_HW, HW_VECTORUNIT };
304 #endif
305  int hasVectorUnit = 0;
306  size_t length = sizeof(hasVectorUnit);
307  int error = sysctl(selectors, 2, &hasVectorUnit, &length, NULL, 0);
308  if (0 == error)
309  altivec = (hasVectorUnit != 0);
310 #elif SDL_ALTIVEC_BLITTERS && HAVE_SETJMP
311  void (*handler) (int sig);
312  handler = signal(SIGILL, illegal_instruction);
313  if (setjmp(jmpbuf) == 0) {
314  asm volatile ("mtspr 256, %0\n\t" "vand %%v0, %%v0, %%v0"::"r" (-1));
315  altivec = 1;
316  }
317  signal(SIGILL, handler);
318 #endif
319 #endif
320  return altivec;
321 }
#define NULL
Definition: begin_code.h:164
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
GLuint GLsizei GLsizei * length

◆ CPU_haveAVX2()

static int CPU_haveAVX2 ( void  )
static

Definition at line 397 of file SDL_cpuinfo.c.

References CPU_CPUIDMaxFunction, CPU_OSSavesYMM, cpuid, d, and void.

Referenced by SDL_GetCPUFeatures().

398 {
399  if (CPU_OSSavesYMM && (CPU_CPUIDMaxFunction >= 7)) {
400  int a, b, c, d;
401  (void) a; (void) b; (void) c; (void) d; /* compiler warnings... */
402  cpuid(7, a, b, c, d);
403  return (b & 0x00000020);
404  }
405  return 0;
406 }
static SDL_bool CPU_OSSavesYMM
Definition: SDL_cpuinfo.c:251
static int CPU_CPUIDMaxFunction
Definition: SDL_cpuinfo.c:250
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ CPU_haveAVX512F()

static int CPU_haveAVX512F ( void  )
static

Definition at line 409 of file SDL_cpuinfo.c.

References CPU_CPUIDMaxFunction, CPU_OSSavesZMM, cpuid, d, and void.

Referenced by SDL_GetCPUFeatures().

410 {
411  if (CPU_OSSavesZMM && (CPU_CPUIDMaxFunction >= 7)) {
412  int a, b, c, d;
413  (void) a; (void) b; (void) c; (void) d; /* compiler warnings... */
414  cpuid(7, a, b, c, d);
415  return (b & 0x00010000);
416  }
417  return 0;
418 }
static int CPU_CPUIDMaxFunction
Definition: SDL_cpuinfo.c:250
static SDL_bool CPU_OSSavesZMM
Definition: SDL_cpuinfo.c:252
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ CPU_haveCPUID()

static int CPU_haveCPUID ( void  )
static

Definition at line 108 of file SDL_cpuinfo.c.

References done, and pop.

Referenced by CPU_calcCPUIDFeatures().

109 {
110  int has_CPUID = 0;
111 
112 /* *INDENT-OFF* */
113 #ifndef SDL_CPUINFO_DISABLED
114 #if defined(__GNUC__) && defined(i386)
115  __asm__ (
116 " pushfl # Get original EFLAGS \n"
117 " popl %%eax \n"
118 " movl %%eax,%%ecx \n"
119 " xorl $0x200000,%%eax # Flip ID bit in EFLAGS \n"
120 " pushl %%eax # Save new EFLAGS value on stack \n"
121 " popfl # Replace current EFLAGS value \n"
122 " pushfl # Get new EFLAGS \n"
123 " popl %%eax # Store new EFLAGS in EAX \n"
124 " xorl %%ecx,%%eax # Can not toggle ID bit, \n"
125 " jz 1f # Processor=80486 \n"
126 " movl $1,%0 # We have CPUID support \n"
127 "1: \n"
128  : "=m" (has_CPUID)
129  :
130  : "%eax", "%ecx"
131  );
132 #elif defined(__GNUC__) && defined(__x86_64__)
133 /* Technically, if this is being compiled under __x86_64__ then it has
134  CPUid by definition. But it's nice to be able to prove it. :) */
135  __asm__ (
136 " pushfq # Get original EFLAGS \n"
137 " popq %%rax \n"
138 " movq %%rax,%%rcx \n"
139 " xorl $0x200000,%%eax # Flip ID bit in EFLAGS \n"
140 " pushq %%rax # Save new EFLAGS value on stack \n"
141 " popfq # Replace current EFLAGS value \n"
142 " pushfq # Get new EFLAGS \n"
143 " popq %%rax # Store new EFLAGS in EAX \n"
144 " xorl %%ecx,%%eax # Can not toggle ID bit, \n"
145 " jz 1f # Processor=80486 \n"
146 " movl $1,%0 # We have CPUID support \n"
147 "1: \n"
148  : "=m" (has_CPUID)
149  :
150  : "%rax", "%rcx"
151  );
152 #elif (defined(_MSC_VER) && defined(_M_IX86)) || defined(__WATCOMC__)
153  __asm {
154  pushfd ; Get original EFLAGS
155  pop eax
156  mov ecx, eax
157  xor eax, 200000h ; Flip ID bit in EFLAGS
158  push eax ; Save new EFLAGS value on stack
159  popfd ; Replace current EFLAGS value
160  pushfd ; Get new EFLAGS
161  pop eax ; Store new EFLAGS in EAX
162  xor eax, ecx ; Can not toggle ID bit,
163  jz done ; Processor=80486
164  mov has_CPUID,1 ; We have CPUID support
165 done:
166  }
167 #elif defined(_MSC_VER) && defined(_M_X64)
168  has_CPUID = 1;
169 #elif defined(__sun) && defined(__i386)
170  __asm (
171 " pushfl \n"
172 " popl %eax \n"
173 " movl %eax,%ecx \n"
174 " xorl $0x200000,%eax \n"
175 " pushl %eax \n"
176 " popfl \n"
177 " pushfl \n"
178 " popl %eax \n"
179 " xorl %ecx,%eax \n"
180 " jz 1f \n"
181 " movl $1,-8(%ebp) \n"
182 "1: \n"
183  );
184 #elif defined(__sun) && defined(__amd64)
185  __asm (
186 " pushfq \n"
187 " popq %rax \n"
188 " movq %rax,%rcx \n"
189 " xorl $0x200000,%eax \n"
190 " pushq %rax \n"
191 " popfq \n"
192 " pushfq \n"
193 " popq %rax \n"
194 " xorl %ecx,%eax \n"
195 " jz 1f \n"
196 " movl $1,-8(%rbp) \n"
197 "1: \n"
198  );
199 #endif
200 #endif
201 /* *INDENT-ON* */
202  return has_CPUID;
203 }
GLfloat GLfloat GLfloat GLfloat h
#define pop
Definition: SDL_qsort.c:192
int done
Definition: checkkeys.c:28
GLsizei const GLfloat * value
GLuint in

◆ CPU_haveNEON()

static int CPU_haveNEON ( void  )
static

Definition at line 345 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

346 {
347 /* The way you detect NEON is a privileged instruction on ARM, so you have
348  query the OS kernel in a platform-specific way. :/ */
349 #if defined(SDL_CPUINFO_DISABLED) || !defined(__ARM_ARCH)
350  return 0; /* disabled or not an ARM CPU at all. */
351 #elif __ARM_ARCH >= 8
352  return 1; /* ARMv8 always has non-optional NEON support. */
353 #elif defined(__APPLE__) && (__ARM_ARCH >= 7)
354  /* (note that sysctlbyname("hw.optional.neon") doesn't work!) */
355  return 1; /* all Apple ARMv7 chips and later have NEON. */
356 #elif defined(__APPLE__)
357  return 0; /* assume anything else from Apple doesn't have NEON. */
358 #elif defined(__QNXNTO__)
359  return SYSPAGE_ENTRY(cpuinfo)->flags & ARM_CPU_FLAG_NEON;
360 #elif (defined(__LINUX__) || defined(__ANDROID__)) && defined(HAVE_GETAUXVAL)
361  return ((getauxval(AT_HWCAP) & HWCAP_NEON) == HWCAP_NEON);
362 #elif (defined(__LINUX__) || defined(__ANDROID__))
363  return readProcAuxvForNeon(); /* Android offers a static library for this, but it just parses /proc/self/auxv */
364 #elif (defined(__WINDOWS__) || defined(__WINRT__)) && defined(_M_ARM)
365  /* All WinRT ARM devices are required to support NEON, but just in case. */
366  return IsProcessorFeaturePresent(PF_ARM_NEON_INSTRUCTIONS_AVAILABLE) != 0;
367 #else
368 #warning SDL_HasNEON is not implemented for this ARM platform. Write me.
369  return 0;
370 #endif
371 }

◆ SDL_GetCPUCacheLineSize()

int SDL_GetCPUCacheLineSize ( void  )

This function returns the L1 cache line size of the CPU

This is useful for determining multi-threaded structure padding or SIMD prefetch sizes.

Definition at line 573 of file SDL_cpuinfo.c.

References cpuid, d, SDL_CACHELINE_SIZE, SDL_GetCPUType(), SDL_strcmp, and void.

Referenced by SDL_SIMDFree().

574 {
575  const char *cpuType = SDL_GetCPUType();
576  int a, b, c, d;
577  (void) a; (void) b; (void) c; (void) d;
578  if (SDL_strcmp(cpuType, "GenuineIntel") == 0) {
579  cpuid(0x00000001, a, b, c, d);
580  return (((b >> 8) & 0xff) * 8);
581  } else if (SDL_strcmp(cpuType, "AuthenticAMD") == 0) {
582  cpuid(0x80000005, a, b, c, d);
583  return (c & 0xff);
584  } else {
585  /* Just make a guess here... */
586  return SDL_CACHELINE_SIZE;
587  }
588 }
static const char * SDL_GetCPUType(void)
Definition: SDL_cpuinfo.c:462
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
#define SDL_CACHELINE_SIZE
Definition: SDL_cpuinfo.h:95
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
#define SDL_strcmp
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ SDL_GetCPUCount()

int SDL_GetCPUCount ( void  )

This function returns the number of CPU cores available.

Definition at line 423 of file SDL_cpuinfo.c.

References NULL, and SDL_CPUCount.

Referenced by SDL_SIMDFree().

424 {
425  if (!SDL_CPUCount) {
426 #ifndef SDL_CPUINFO_DISABLED
427 #if defined(HAVE_SYSCONF) && defined(_SC_NPROCESSORS_ONLN)
428  if (SDL_CPUCount <= 0) {
429  SDL_CPUCount = (int)sysconf(_SC_NPROCESSORS_ONLN);
430  }
431 #endif
432 #ifdef HAVE_SYSCTLBYNAME
433  if (SDL_CPUCount <= 0) {
434  size_t size = sizeof(SDL_CPUCount);
435  sysctlbyname("hw.ncpu", &SDL_CPUCount, &size, NULL, 0);
436  }
437 #endif
438 #ifdef __WIN32__
439  if (SDL_CPUCount <= 0) {
440  SYSTEM_INFO info;
441  GetSystemInfo(&info);
442  SDL_CPUCount = info.dwNumberOfProcessors;
443  }
444 #endif
445 #ifdef __OS2__
446  if (SDL_CPUCount <= 0) {
447  DosQuerySysInfo(QSV_NUMPROCESSORS, QSV_NUMPROCESSORS,
448  &SDL_CPUCount, sizeof(SDL_CPUCount) );
449  }
450 #endif
451 #endif
452  /* There has to be at least 1, right? :) */
453  if (SDL_CPUCount <= 0) {
454  SDL_CPUCount = 1;
455  }
456  }
457  return SDL_CPUCount;
458 }
GLsizeiptr size
#define NULL
Definition: begin_code.h:164
static int SDL_CPUCount
Definition: SDL_cpuinfo.c:420

◆ SDL_GetCPUFeatures()

static Uint32 SDL_GetCPUFeatures ( void  )
static

Definition at line 594 of file SDL_cpuinfo.c.

References CPU_calcCPUIDFeatures(), CPU_HAS_3DNOW, CPU_HAS_ALTIVEC, CPU_HAS_AVX, CPU_HAS_AVX2, CPU_HAS_AVX512F, CPU_HAS_MMX, CPU_HAS_NEON, CPU_HAS_RDTSC, CPU_HAS_SSE, CPU_HAS_SSE2, CPU_HAS_SSE3, CPU_HAS_SSE41, CPU_HAS_SSE42, CPU_have3DNow(), CPU_haveAltiVec(), CPU_haveAVX, CPU_haveAVX2(), CPU_haveAVX512F(), CPU_haveMMX, CPU_haveNEON(), CPU_haveRDTSC, CPU_haveSSE, CPU_haveSSE2, CPU_haveSSE3, CPU_haveSSE41, CPU_haveSSE42, SDL_CPUFeatures, SDL_max, and SDL_SIMDAlignment.

Referenced by SDL_SIMDGetAlignment().

595 {
596  if (SDL_CPUFeatures == 0xFFFFFFFF) {
598  SDL_CPUFeatures = 0;
599  SDL_SIMDAlignment = 4; /* a good safe base value */
600  if (CPU_haveRDTSC()) {
602  }
603  if (CPU_haveAltiVec()) {
606  }
607  if (CPU_haveMMX()) {
610  }
611  if (CPU_have3DNow()) {
614  }
615  if (CPU_haveSSE()) {
618  }
619  if (CPU_haveSSE2()) {
622  }
623  if (CPU_haveSSE3()) {
626  }
627  if (CPU_haveSSE41()) {
630  }
631  if (CPU_haveSSE42()) {
634  }
635  if (CPU_haveAVX()) {
638  }
639  if (CPU_haveAVX2()) {
642  }
643  if (CPU_haveAVX512F()) {
646  }
647  if (CPU_haveNEON()) {
650  }
651  }
652  return SDL_CPUFeatures;
653 }
#define CPU_haveSSE2()
Definition: SDL_cpuinfo.c:390
#define CPU_haveAVX()
Definition: SDL_cpuinfo.c:394
#define CPU_HAS_SSE41
Definition: SDL_cpuinfo.c:88
#define CPU_HAS_RDTSC
Definition: SDL_cpuinfo.c:81
#define CPU_HAS_SSE3
Definition: SDL_cpuinfo.c:87
static void CPU_calcCPUIDFeatures(void)
Definition: SDL_cpuinfo.c:255
#define CPU_HAS_SSE2
Definition: SDL_cpuinfo.c:86
#define CPU_HAS_AVX512F
Definition: SDL_cpuinfo.c:93
static int CPU_have3DNow(void)
Definition: SDL_cpuinfo.c:374
#define CPU_haveRDTSC()
Definition: SDL_cpuinfo.c:387
#define CPU_HAS_ALTIVEC
Definition: SDL_cpuinfo.c:82
#define CPU_haveMMX()
Definition: SDL_cpuinfo.c:388
#define SDL_max(x, y)
Definition: SDL_stdinc.h:407
static int CPU_haveAltiVec(void)
Definition: SDL_cpuinfo.c:295
static int CPU_haveAVX512F(void)
Definition: SDL_cpuinfo.c:409
#define CPU_HAS_AVX
Definition: SDL_cpuinfo.c:90
#define CPU_haveSSE42()
Definition: SDL_cpuinfo.c:393
#define CPU_HAS_NEON
Definition: SDL_cpuinfo.c:92
#define CPU_haveSSE3()
Definition: SDL_cpuinfo.c:391
static Uint32 SDL_CPUFeatures
Definition: SDL_cpuinfo.c:590
#define CPU_HAS_SSE
Definition: SDL_cpuinfo.c:85
static int CPU_haveAVX2(void)
Definition: SDL_cpuinfo.c:397
#define CPU_HAS_AVX2
Definition: SDL_cpuinfo.c:91
static int CPU_haveNEON(void)
Definition: SDL_cpuinfo.c:345
#define CPU_haveSSE()
Definition: SDL_cpuinfo.c:389
#define CPU_HAS_MMX
Definition: SDL_cpuinfo.c:83
#define CPU_haveSSE41()
Definition: SDL_cpuinfo.c:392
#define CPU_HAS_SSE42
Definition: SDL_cpuinfo.c:89
static Uint32 SDL_SIMDAlignment
Definition: SDL_cpuinfo.c:591
#define CPU_HAS_3DNOW
Definition: SDL_cpuinfo.c:84

◆ SDL_GetCPUType()

static const char* SDL_GetCPUType ( void  )
static

Definition at line 462 of file SDL_cpuinfo.c.

References CPU_calcCPUIDFeatures(), CPU_CPUIDMaxFunction, cpuid, d, i, SDL_strlcpy, and void.

Referenced by SDL_GetCPUCacheLineSize(), and SDL_SIMDFree().

463 {
464  static char SDL_CPUType[13];
465 
466  if (!SDL_CPUType[0]) {
467  int i = 0;
468 
470  if (CPU_CPUIDMaxFunction > 0) { /* do we have CPUID at all? */
471  int a, b, c, d;
472  cpuid(0x00000000, a, b, c, d);
473  (void) a;
474  SDL_CPUType[i++] = (char)(b & 0xff); b >>= 8;
475  SDL_CPUType[i++] = (char)(b & 0xff); b >>= 8;
476  SDL_CPUType[i++] = (char)(b & 0xff); b >>= 8;
477  SDL_CPUType[i++] = (char)(b & 0xff);
478 
479  SDL_CPUType[i++] = (char)(d & 0xff); d >>= 8;
480  SDL_CPUType[i++] = (char)(d & 0xff); d >>= 8;
481  SDL_CPUType[i++] = (char)(d & 0xff); d >>= 8;
482  SDL_CPUType[i++] = (char)(d & 0xff);
483 
484  SDL_CPUType[i++] = (char)(c & 0xff); c >>= 8;
485  SDL_CPUType[i++] = (char)(c & 0xff); c >>= 8;
486  SDL_CPUType[i++] = (char)(c & 0xff); c >>= 8;
487  SDL_CPUType[i++] = (char)(c & 0xff);
488  }
489  if (!SDL_CPUType[0]) {
490  SDL_strlcpy(SDL_CPUType, "Unknown", sizeof(SDL_CPUType));
491  }
492  }
493  return SDL_CPUType;
494 }
#define SDL_strlcpy
static void CPU_calcCPUIDFeatures(void)
Definition: SDL_cpuinfo.c:255
static int CPU_CPUIDMaxFunction
Definition: SDL_cpuinfo.c:250
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 SDL_AssertionHandler void SDL_SpinLock SDL_atomic_t int int return SDL_atomic_t return void void void return void return int return SDL_AudioSpec SDL_AudioSpec return int int return return int SDL_RWops int SDL_AudioSpec Uint8 ** d
const GLubyte * c
#define cpuid(func, a, b, c, d)
Definition: SDL_cpuinfo.c:245
return Display return Display Bool Bool int int int return Display XEvent Bool(*) XPointer return Display return Display Drawable _Xconst char unsigned int unsigned int return Display Pixmap Pixmap XColor XColor unsigned int unsigned int return Display _Xconst char char int char return Display Visual unsigned int int int char unsigned int unsigned int in i)
Definition: SDL_x11sym.h:50
SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char int SDL_PRINTF_FORMAT_STRING const char const char SDL_SCANF_FORMAT_STRING const char return SDL_ThreadFunction const char void return Uint32 return Uint32 void
GLboolean GLboolean GLboolean GLboolean a
GLboolean GLboolean GLboolean b

◆ SDL_GetSystemRAM()

int SDL_GetSystemRAM ( void  )

This function returns the amount of RAM configured in the system, in MB.

Definition at line 737 of file SDL_cpuinfo.c.

References NULL, and SDL_SystemRAM.

Referenced by SDL_SIMDFree().

738 {
739  if (!SDL_SystemRAM) {
740 #ifndef SDL_CPUINFO_DISABLED
741 #if defined(HAVE_SYSCONF) && defined(_SC_PHYS_PAGES) && defined(_SC_PAGESIZE)
742  if (SDL_SystemRAM <= 0) {
743  SDL_SystemRAM = (int)((Sint64)sysconf(_SC_PHYS_PAGES) * sysconf(_SC_PAGESIZE) / (1024*1024));
744  }
745 #endif
746 #ifdef HAVE_SYSCTLBYNAME
747  if (SDL_SystemRAM <= 0) {
748 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__NetBSD__)
749 #ifdef HW_REALMEM
750  int mib[2] = {CTL_HW, HW_REALMEM};
751 #else
752  /* might only report up to 2 GiB */
753  int mib[2] = {CTL_HW, HW_PHYSMEM};
754 #endif /* HW_REALMEM */
755 #else
756  int mib[2] = {CTL_HW, HW_MEMSIZE};
757 #endif /* __FreeBSD__ || __FreeBSD_kernel__ */
758  Uint64 memsize = 0;
759  size_t len = sizeof(memsize);
760 
761  if (sysctl(mib, 2, &memsize, &len, NULL, 0) == 0) {
762  SDL_SystemRAM = (int)(memsize / (1024*1024));
763  }
764  }
765 #endif
766 #ifdef __WIN32__
767  if (SDL_SystemRAM <= 0) {
768  MEMORYSTATUSEX stat;
769  stat.dwLength = sizeof(stat);
770  if (GlobalMemoryStatusEx(&stat)) {
771  SDL_SystemRAM = (int)(stat.ullTotalPhys / (1024 * 1024));
772  }
773  }
774 #endif
775 #ifdef __OS2__
776  if (SDL_SystemRAM <= 0) {
777  Uint32 sysram = 0;
778  DosQuerySysInfo(QSV_TOTPHYSMEM, QSV_TOTPHYSMEM, &sysram, 4);
779  SDL_SystemRAM = (int) (sysram / 0x100000U);
780  }
781 #endif
782 #endif
783  }
784  return SDL_SystemRAM;
785 }
static int SDL_SystemRAM
Definition: SDL_cpuinfo.c:734
uint64_t Uint64
Definition: SDL_stdinc.h:216
GLenum GLsizei len
#define NULL
Definition: begin_code.h:164
uint32_t Uint32
Definition: SDL_stdinc.h:203
int64_t Sint64
Definition: SDL_stdinc.h:210

◆ SDL_Has3DNow()

SDL_bool SDL_Has3DNow ( void  )

This function returns true if the CPU has 3DNow! features.

Definition at line 675 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_3DNOW.

Referenced by SDL_SIMDFree().

676 {
678 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_3DNOW
Definition: SDL_cpuinfo.c:84

◆ SDL_HasAltiVec()

SDL_bool SDL_HasAltiVec ( void  )

This function returns true if the CPU has AltiVec features.

Definition at line 663 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_ALTIVEC.

Referenced by SDL_SIMDFree().

664 {
666 }
#define CPU_HAS_ALTIVEC
Definition: SDL_cpuinfo.c:82
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasAVX()

SDL_bool SDL_HasAVX ( void  )

This function returns true if the CPU has AVX features.

Definition at line 711 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_AVX.

Referenced by SDL_SIMDFree().

712 {
714 }
#define CPU_HAS_AVX
Definition: SDL_cpuinfo.c:90
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasAVX2()

SDL_bool SDL_HasAVX2 ( void  )

This function returns true if the CPU has AVX2 features.

Definition at line 717 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_AVX2.

Referenced by SDL_SIMDFree().

718 {
720 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_AVX2
Definition: SDL_cpuinfo.c:91

◆ SDL_HasAVX512F()

SDL_bool SDL_HasAVX512F ( void  )

This function returns true if the CPU has AVX-512F (foundation) features.

Definition at line 723 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_AVX512F.

Referenced by SDL_SIMDFree().

724 {
726 }
#define CPU_HAS_AVX512F
Definition: SDL_cpuinfo.c:93
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasMMX()

SDL_bool SDL_HasMMX ( void  )

This function returns true if the CPU has MMX features.

Definition at line 669 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_MMX.

Referenced by SDL_SIMDFree().

670 {
672 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_MMX
Definition: SDL_cpuinfo.c:83

◆ SDL_HasNEON()

SDL_bool SDL_HasNEON ( void  )

This function returns true if the CPU has NEON (ARM SIMD) features.

Definition at line 729 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_NEON.

Referenced by SDL_SIMDFree().

730 {
732 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_NEON
Definition: SDL_cpuinfo.c:92

◆ SDL_HasRDTSC()

SDL_bool SDL_HasRDTSC ( void  )

This function returns true if the CPU has the RDTSC instruction.

Definition at line 657 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_RDTSC.

Referenced by SDL_SIMDFree().

658 {
660 }
#define CPU_HAS_RDTSC
Definition: SDL_cpuinfo.c:81
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasSSE()

SDL_bool SDL_HasSSE ( void  )

This function returns true if the CPU has SSE features.

Definition at line 681 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_SSE.

Referenced by SDL_SIMDFree().

682 {
684 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_SSE
Definition: SDL_cpuinfo.c:85

◆ SDL_HasSSE2()

SDL_bool SDL_HasSSE2 ( void  )

This function returns true if the CPU has SSE2 features.

Definition at line 687 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_SSE2.

Referenced by SDL_SIMDFree().

688 {
690 }
#define CPU_HAS_SSE2
Definition: SDL_cpuinfo.c:86
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasSSE3()

SDL_bool SDL_HasSSE3 ( void  )

This function returns true if the CPU has SSE3 features.

Definition at line 693 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_SSE3.

Referenced by SDL_SIMDFree().

694 {
696 }
#define CPU_HAS_SSE3
Definition: SDL_cpuinfo.c:87
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasSSE41()

SDL_bool SDL_HasSSE41 ( void  )

This function returns true if the CPU has SSE4.1 features.

Definition at line 699 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_SSE41.

Referenced by SDL_SIMDFree().

700 {
702 }
#define CPU_HAS_SSE41
Definition: SDL_cpuinfo.c:88
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655

◆ SDL_HasSSE42()

SDL_bool SDL_HasSSE42 ( void  )

This function returns true if the CPU has SSE4.2 features.

Definition at line 705 of file SDL_cpuinfo.c.

References CPU_FEATURE_AVAILABLE, and CPU_HAS_SSE42.

Referenced by SDL_SIMDFree().

706 {
708 }
#define CPU_FEATURE_AVAILABLE(f)
Definition: SDL_cpuinfo.c:655
#define CPU_HAS_SSE42
Definition: SDL_cpuinfo.c:89

◆ SDL_SIMDAlloc()

void* SDL_SIMDAlloc ( const size_t  len)

Allocate memory in a SIMD-friendly way.

This will allocate a block of memory that is suitable for use with SIMD instructions. Specifically, it will be properly aligned and padded for the system's supported vector instructions.

The memory returned will be padded such that it is safe to read or write an incomplete vector at the end of the memory block. This can be useful so you don't have to drop back to a scalar fallback at the end of your SIMD processing loop to deal with the final elements without overflowing the allocated buffer.

You must free this memory with SDL_FreeSIMD(), not free() or SDL_free() or delete[], etc.

Note that SDL will only deal with SIMD instruction sets it is aware of; for example, SDL 2.0.8 knows that SSE wants 16-byte vectors (SDL_HasSSE()), and AVX2 wants 32 bytes (SDL_HasAVX2()), but doesn't know that AVX-512 wants 64. To be clear: if you can't decide to use an instruction set with an SDL_Has*() function, don't use that instruction set with memory allocated through here.

SDL_AllocSIMD(0) will return a non-NULL pointer, assuming the system isn't out of memory.

Parameters
lenThe length, in bytes, of the block to allocated. The actual allocated block might be larger due to padding, etc.
Returns
Pointer to newly-allocated block, NULL if out of memory.
See also
SDL_SIMDAlignment
SDL_SIMDFree

Definition at line 799 of file SDL_cpuinfo.c.

References NULL, retval, SDL_malloc, and SDL_SIMDGetAlignment().

800 {
801  const size_t alignment = SDL_SIMDGetAlignment();
802  const size_t padding = alignment - (len % alignment);
803  const size_t padded = (padding != alignment) ? (len + padding) : len;
804  Uint8 *retval = NULL;
805  Uint8 *ptr = (Uint8 *) SDL_malloc(padded + alignment + sizeof (void *));
806  if (ptr) {
807  /* store the actual malloc pointer right before our aligned pointer. */
808  retval = ptr + sizeof (void *);
809  retval += alignment - (((size_t) retval) % alignment);
810  *(((void **) retval) - 1) = ptr;
811  }
812  return retval;
813 }
unsigned int size_t
GLenum GLsizei len
SDL_bool retval
uint8_t Uint8
Definition: SDL_stdinc.h:179
#define NULL
Definition: begin_code.h:164
#define SDL_malloc
size_t SDL_SIMDGetAlignment(void)
Report the alignment this system needs for SIMD allocations.
Definition: SDL_cpuinfo.c:789

◆ SDL_SIMDFree()

void SDL_SIMDFree ( void ptr)

Deallocate memory obtained from SDL_SIMDAlloc.

It is not valid to use this function on a pointer from anything but SDL_SIMDAlloc(). It can't be used on pointers from malloc, realloc, SDL_malloc, memalign, new[], etc.

However, SDL_SIMDFree(NULL) is a legal no-op.

See also
SDL_SIMDAlloc

Definition at line 816 of file SDL_cpuinfo.c.

References main, SDL_free, SDL_GetCPUCacheLineSize(), SDL_GetCPUCount(), SDL_GetCPUType(), SDL_GetSystemRAM(), SDL_Has3DNow(), SDL_HasAltiVec(), SDL_HasAVX(), SDL_HasAVX2(), SDL_HasAVX512F(), SDL_HasMMX(), SDL_HasNEON(), SDL_HasRDTSC(), SDL_HasSSE(), SDL_HasSSE2(), SDL_HasSSE3(), SDL_HasSSE41(), and SDL_HasSSE42().

817 {
818  if (ptr) {
819  void **realptr = (void **) ptr;
820  realptr--;
821  SDL_free(*(((void **) ptr) - 1));
822  }
823 }
#define SDL_free

◆ SDL_SIMDGetAlignment()

size_t SDL_SIMDGetAlignment ( void  )

Report the alignment this system needs for SIMD allocations.

This will return the minimum number of bytes to which a pointer must be aligned to be compatible with SIMD instructions on the current machine. For example, if the machine supports SSE only, it will return 16, but if it supports AVX-512F, it'll return 64 (etc). This only reports values for instruction sets SDL knows about, so if your SDL build doesn't have SDL_HasAVX512F(), then it might return 16 for the SSE support it sees and not 64 for the AVX-512 instructions that exist but SDL doesn't know about. Plan accordingly.

Definition at line 789 of file SDL_cpuinfo.c.

References SDL_assert, SDL_GetCPUFeatures(), and SDL_SIMDAlignment.

Referenced by SDL_SIMDAlloc().

790 {
791  if (SDL_SIMDAlignment == 0xFFFFFFFF) {
792  SDL_GetCPUFeatures(); /* make sure this has been calculated */
793  }
795  return SDL_SIMDAlignment;
796 }
static Uint32 SDL_GetCPUFeatures(void)
Definition: SDL_cpuinfo.c:594
#define SDL_assert(condition)
Definition: SDL_assert.h:169
static Uint32 SDL_SIMDAlignment
Definition: SDL_cpuinfo.c:591

Variable Documentation

◆ CPU_CPUIDFeatures

int CPU_CPUIDFeatures[4]
static

Definition at line 249 of file SDL_cpuinfo.c.

Referenced by CPU_calcCPUIDFeatures().

◆ CPU_CPUIDMaxFunction

int CPU_CPUIDMaxFunction = 0
static

◆ CPU_OSSavesYMM

SDL_bool CPU_OSSavesYMM = SDL_FALSE
static

Definition at line 251 of file SDL_cpuinfo.c.

Referenced by CPU_calcCPUIDFeatures(), and CPU_haveAVX2().

◆ CPU_OSSavesZMM

SDL_bool CPU_OSSavesZMM = SDL_FALSE
static

Definition at line 252 of file SDL_cpuinfo.c.

Referenced by CPU_calcCPUIDFeatures(), and CPU_haveAVX512F().

◆ SDL_CPUCount

int SDL_CPUCount = 0
static

Definition at line 420 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUCount().

◆ SDL_CPUFeatures

Uint32 SDL_CPUFeatures = 0xFFFFFFFF
static

Definition at line 590 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures().

◆ SDL_SIMDAlignment

Uint32 SDL_SIMDAlignment = 0xFFFFFFFF
static

Definition at line 591 of file SDL_cpuinfo.c.

Referenced by SDL_GetCPUFeatures(), and SDL_SIMDGetAlignment().

◆ SDL_SystemRAM

int SDL_SystemRAM = 0
static

Definition at line 734 of file SDL_cpuinfo.c.

Referenced by SDL_GetSystemRAM().