1 /* $Id: glthread.h,v 1.7 2000/11/22 07:32:17 joukj Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999-2000 Brian Paul All Rights Reserved.
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
23 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 * Thread support for gl dispatch.
31 * Initial version by John Stone (j.stone@acm.org) (johns@cs.umr.edu)
32 * and Christoph Poliwoda (poliwoda@volumegraphics.com)
33 * Revised by Keith Whitwell
34 * Adapted for new gl dispatcher by Brian Paul
40 * This thread module exports the following types:
41 * _glthread_TSD Thread-specific data area
42 * _glthread_Thread Thread datatype
43 * _glthread_Mutex Mutual exclusion lock
46 * _glthread_DECLARE_STATIC_MUTEX(name) Declare a non-local mutex
47 * _glthread_INIT_MUTEX(name) Initialize a mutex
48 * _glthread_LOCK_MUTEX(name) Lock a mutex
49 * _glthread_UNLOCK_MUTEX(name) Unlock a mutex
52 * _glthread_GetID(v) Get integer thread ID
53 * _glthread_InitTSD() Initialize thread-specific data
54 * _glthread_GetTSD() Get thread-specific data
55 * _glthread_SetTSD() Set thread-specific data
60 * If this file is accidentally included by a non-threaded build,
61 * it should not cause the build to fail, or otherwise cause problems.
62 * In general, it should only be included when needed however.
69 #if defined(PTHREADS) || defined(SOLARIS_THREADS) || defined(WIN32_THREADS) || defined(XTHREADS)
74 #include <GL/vms_x_fix.h>
78 * POSIX threads. This should be your choice in the Unix world
79 * whenever possible. When building with POSIX threads, be sure
80 * to enable any compiler flags which will cause the MT-safe
81 * libc (if one exists) to be used when linking, as well as any
82 * header macros for MT-safe errno, etc. For Solaris, this is the -mt
83 * compiler flag. On Solaris with gcc, use -D_REENTRANT to enable
84 * proper compiling for MT-safe libc etc.
87 #include <pthread.h> /* POSIX threads headers */
94 typedef pthread_t _glthread_Thread
;
96 typedef pthread_mutex_t _glthread_Mutex
;
98 #define _glthread_DECLARE_STATIC_MUTEX(name) \
99 static _glthread_Mutex name = PTHREAD_MUTEX_INITIALIZER
101 #define _glthread_INIT_MUTEX(name) \
102 pthread_mutex_init(&(name), NULL)
104 #define _glthread_LOCK_MUTEX(name) \
105 (void) pthread_mutex_lock(&(name))
107 #define _glthread_UNLOCK_MUTEX(name) \
108 (void) pthread_mutex_unlock(&(name))
110 #endif /* PTHREADS */
116 * Solaris threads. Use only up to Solaris 2.4.
117 * Solaris 2.5 and higher provide POSIX threads.
118 * Be sure to compile with -mt on the Solaris compilers, or
119 * use -D_REENTRANT if using gcc.
121 #ifdef SOLARIS_THREADS
130 typedef thread_t _glthread_Thread
;
132 typedef mutex_t _glthread_Mutex
;
134 /* XXX need to really implement mutex-related macros */
135 #define _glthread_DECLARE_STATIC_MUTEX(name) static _glthread_Mutex name = 0
136 #define _glthread_INIT_MUTEX(name) (void) name
137 #define _glthread_LOCK_MUTEX(name) (void) name
138 #define _glthread_UNLOCK_MUTEX(name) (void) name
140 #endif /* SOLARIS_THREADS */
146 * Windows threads. Should work with Windows NT and 95.
147 * IMPORTANT: Link with multithreaded runtime library when THREADS are
158 typedef HANDLE _glthread_Thread
;
160 typedef CRITICAL_SECTION _glthread_Mutex
;
162 /* XXX need to really implement mutex-related macros */
163 #define _glthread_DECLARE_STATIC_MUTEX(name) static _glthread_Mutex name = 0
164 #define _glthread_INIT_MUTEX(name) (void) name
165 #define _glthread_LOCK_MUTEX(name) (void) name
166 #define _glthread_UNLOCK_MUTEX(name) (void) name
168 #endif /* WIN32_THREADS */
174 * XFree86 has its own thread wrapper, Xthreads.h
175 * We wrap it again for GL.
178 #include "Xthreads.h"
185 typedef xthread_t _glthread_Thread
;
187 typedef xmutex_rec _glthread_Mutex
;
189 #define _glthread_DECLARE_STATIC_MUTEX(name) \
190 static _glthread_Mutex name = XMUTEX_INITIALIZER
192 #define _glthread_INIT_MUTEX(name) \
195 #define _glthread_LOCK_MUTEX(name) \
196 (void) xmutex_lock(&(name))
198 #define _glthread_UNLOCK_MUTEX(name) \
199 (void) xmutex_unlock(&(name))
201 #endif /* XTHREADS */
209 * THREADS not defined
212 typedef GLuint _glthread_TSD
;
214 typedef GLuint _glthread_Thread
;
216 typedef GLuint _glthread_Mutex
;
218 #define _glthread_DECLARE_STATIC_MUTEX(name) static _glthread_Mutex name = 0
220 #define _glthread_INIT_MUTEX(name) (void) name
222 #define _glthread_LOCK_MUTEX(name) (void) name
224 #define _glthread_UNLOCK_MUTEX(name) (void) name
231 * Platform independent thread specific data API.
235 _glthread_GetID(void);
239 _glthread_InitTSD(_glthread_TSD
*);
243 _glthread_GetTSD(_glthread_TSD
*);
247 _glthread_SetTSD(_glthread_TSD
*, void *);
251 #endif /* THREADS_H */