mesa/src/egl/main
Eric Engestrom 311c091658 egl/display: make platform detection thread-safe
Imagine there are 2 threads that both call _eglGetNativePlatform()
simultaneously:
- thread 1 completes the first "if (native_platform ==
  _EGL_INVALID_PLATFORM)" check and is preempted to do something else
- thread 2 executes the whole function, does "native_platform =
  _EGL_NATIVE_PLATFORM" and just before returning it's preempted
- thread 1 wakes up and calls _eglGetNativePlatformFromEnv() which
  returns _EGL_INVALID_PLATFORM because no env vars are set, updates
  native_platform and then gets preempted again
- thread 2 wakes up and returns wrong _EGL_INVALID_PLATFORM

Solve this by doing the detection in a local var and only overwriting
the global one at the end, if no other thread has updated it since.

This means the platform detected in the thread might not be the platform
returned by the function, but this is a different issue that will need
to be discussed when this becomes possible.

Bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=101252
Signed-off-by: Eric Engestrom <eric@engestrom.ch>
Reviewed-by: Grazvydas Ignotas <notasas@gmail.com>
Acked-by: Emil Velikov <emil.l.velikov@gmail.com>
2017-06-16 11:02:06 +01:00
..
50_mesa.json EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
egl.def egl: Add egl.def for win32 build. 2010-08-20 19:22:50 +08:00
egl.pc.in egl/main: Convert to automake. 2012-02-29 11:52:40 -08:00
eglapi.c egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglapi.h egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglarray.c egl: _eglFilterArray's filter is always non-null 2017-02-16 15:27:20 +00:00
eglarray.h egl: Add needed extern "C" for C++ access 2015-05-14 14:08:37 -04:00
eglconfig.c egl: remove suprous header eglcompiler.h 2017-05-08 15:33:59 +01:00
eglconfig.h egl: Add EGL_RECORDABLE_ANDROID attribute 2016-04-01 13:45:08 +01:00
eglcontext.c egl: Implement __DRI_BACKGROUND_CALLABLE 2017-03-16 14:14:18 +11:00
eglcontext.h egl: Implement __DRI_BACKGROUND_CALLABLE 2017-03-16 14:14:18 +11:00
eglcurrent.c egl: initialise dummy_thread via _eglInitThreadInfo 2017-04-29 14:40:53 +01:00
eglcurrent.h egl: Track EGL_KHR_debug state when going through EGL API calls (v3) 2016-10-05 11:40:51 -04:00
egldefines.h egl: use util/macros.h 2016-11-04 11:30:47 +01:00
egldispatchstubs.c EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
egldispatchstubs.h EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
egldisplay.c egl/display: make platform detection thread-safe 2017-06-16 11:02:06 +01:00
egldisplay.h egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
egldriver.c egl: remove final Windows specific workaround 2015-07-22 16:35:26 +01:00
egldriver.h egl/main: cleanup function prototypes 2015-05-14 21:00:04 +00:00
eglentrypoint.h egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglfallbacks.c egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglglobals.c EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
eglglobals.h EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
eglglvnd.c EGL: Implement the libglvnd interface for EGL (v3) 2017-04-17 13:03:58 +01:00
eglimage.c egl/dri2: Create EGLImages with dmabuf modifiers 2017-05-30 13:56:20 +01:00
eglimage.h egl/dri2: Create EGLImages with dmabuf modifiers 2017-05-30 13:56:20 +01:00
egllog.c egl: fix android logger compilation 2017-05-15 16:03:51 +01:00
egllog.h egl: remove no longer needed logger infra 2017-05-08 15:33:54 +01:00
eglsurface.c egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglsurface.h egl/android: support for EGL_KHR_partial_update 2017-06-11 01:02:09 +01:00
eglsync.c egl: add EGL_ANDROID_native_fence_sync 2016-12-01 10:57:35 -08:00
eglsync.h egl: add EGL_ANDROID_native_fence_sync 2016-12-01 10:57:35 -08:00
egltypedefs.h egl: remove suprous header eglcompiler.h 2017-05-08 15:33:59 +01:00
README.txt egl/main: Update README.txt 2015-05-14 21:00:04 +00:00


Notes about the EGL library:


The EGL code here basically consists of two things:

1. An EGL API dispatcher.  This directly routes all the eglFooBar() API
   calls into driver-specific functions.

2. Fallbacks for EGL API functions.  A driver _could_ implement all the
   EGL API calls from scratch.  But in many cases, the fallbacks provided
   in libEGL (such as eglChooseConfig()) will do the job.



Bootstrapping:

When the apps calls eglInitialize() a device driver is selected and loaded
(look for _eglAddDrivers() and _eglLoadModule() in egldriver.c).

The built-in driver's entry point function is then called.  This driver function
allocates, initializes and returns a new _EGLDriver object (usually a
subclass of that type).

As part of initialization, the dispatch table in _EGLDriver->API must be
populated with all the EGL entrypoints.  Typically, _eglInitDriverFallbacks()
can be used to plug in default/fallback functions.  Some functions like
driver->API.Initialize and driver->API.Terminate _must_ be implemented
with driver-specific code (no default/fallback function is possible).


Shortly after, the driver->API.Initialize() function is executed.  Any additional
driver initialization that wasn't done in the driver entry point should be
done at this point.  Typically, this will involve setting up visual configs, etc.



Special Functions:

Certain EGL functions _must_ be implemented by the driver.  This includes:

eglCreateContext
eglCreateWindowSurface
eglCreatePixmapSurface
eglCreatePBufferSurface
eglMakeCurrent
eglSwapBuffers

Most of the EGLConfig-related functions can be implemented with the
defaults/fallbacks.  Same thing for the eglGet/Query functions.




Teardown:

When eglTerminate() is called, the driver->API.Terminate() function is
called.  The driver should clean up after itself.  eglTerminate() will
then close/unload the driver (shared library).




Subclassing:

The internal libEGL data structures such as _EGLDisplay, _EGLContext,
_EGLSurface, etc should be considered base classes from which drivers
will derive subclasses.