a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Mesa 3-D graphics library
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Version: 6.5.2
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Permission is hereby granted, free of charge, to any person obtaining a
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * copy of this software and associated documentation files (the "Software"),
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * to deal in the Software without restriction, including without limitation
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * the rights to use, copy, modify, merge, publish, distribute, sublicense,
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * and/or sell copies of the Software, and to permit persons to whom the
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Software is furnished to do so, subject to the following conditions:
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * The above copyright notice and this permission notice shall be included
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * in all copies or substantial portions of the Software.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Thread support for gl dispatch.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Initial version by John Stone (j.stone@acm.org) (johns@cs.umr.edu)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * and Christoph Poliwoda (poliwoda@volumegraphics.com)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Revised by Keith Whitwell
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Adapted for new gl dispatcher by Brian Paul
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * DOCUMENTATION
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * This thread module exports the following types:
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_TSD Thread-specific data area
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_Thread Thread datatype
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_Mutex Mutual exclusion lock
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_DECLARE_STATIC_MUTEX(name) Declare a non-local mutex
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_INIT_MUTEX(name) Initialize a mutex
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_LOCK_MUTEX(name) Lock a mutex
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_UNLOCK_MUTEX(name) Unlock a mutex
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Functions:
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_GetID(v) Get integer thread ID
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_InitTSD() Initialize thread-specific data
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_GetTSD() Get thread-specific data
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * _glthread_SetTSD() Set thread-specific data
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * If this file is accidentally included by a non-threaded build,
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * it should not cause the build to fail, or otherwise cause problems.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * In general, it should only be included when needed however.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync && !defined(THREADS)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * POSIX threads. This should be your choice in the Unix world
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * whenever possible. When building with POSIX threads, be sure
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * to enable any compiler flags which will cause the MT-safe
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * libc (if one exists) to be used when linking, as well as any
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * header macros for MT-safe errno, etc. For Solaris, this is the -mt
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * compiler flag. On Solaris with gcc, use -D_REENTRANT to enable
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * proper compiling for MT-safe libc etc.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsynctypedef struct {
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync static _glthread_Mutex name = PTHREAD_MUTEX_INITIALIZER
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* PTHREADS */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Solaris threads. Use only up to Solaris 2.4.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Solaris 2.5 and higher provide POSIX threads.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Be sure to compile with -mt on the Solaris compilers, or
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * use -D_REENTRANT if using gcc.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Windows threads. Should work with Windows NT and 95.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * IMPORTANT: Link with multithreaded runtime library when THREADS are
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsynctypedef struct {
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_DECLARE_STATIC_MUTEX(name) /*static*/ _glthread_Mutex name = {0,0,0,0,0,0}
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_INIT_MUTEX(name) InitializeCriticalSection(&name)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_DESTROY_MUTEX(name) DeleteCriticalSection(&name)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_LOCK_MUTEX(name) EnterCriticalSection(&name)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_UNLOCK_MUTEX(name) LeaveCriticalSection(&name)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* WIN32_THREADS */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * BeOS threads. R5.x required.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsynctypedef struct {
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync/* Use Benaphore, aka speeder semaphore */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsynctypedef struct {
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_DECLARE_STATIC_MUTEX(name) static _glthread_Mutex name = { 0, 0 }
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_INIT_MUTEX(name) name.sem = create_sem(0, #name"_benaphore"), name.lock = 0
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_DESTROY_MUTEX(name) delete_sem(name.sem), name.lock = 0
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_LOCK_MUTEX(name) if (name.sem == 0) _glthread_INIT_MUTEX(name); \
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync if (atomic_add(&(name.lock), 1) >= 1) acquire_sem(name.sem)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_UNLOCK_MUTEX(name) if (atomic_add(&(name.lock), -1) > 1) release_sem(name.sem)
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* BEOS_THREADS */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * THREADS not defined
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#define _glthread_DECLARE_STATIC_MUTEX(name) static _glthread_Mutex name = 0
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* THREADS */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync * Platform independent thread specific data API.
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsyncextern unsigned long
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsyncextern TLS struct _glapi_table *_glapi_tls_Dispatch;
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync ((__builtin_expect( _glapi_Dispatch != NULL, 1 )) \
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* defined(THREADS) */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* ndef GL_CALL */
a3f3701cea1ba388e7c877955252bb7375eedebdvboxsync#endif /* THREADS_H */