initial rev
authorBrian Paul <brian.paul@tungstengraphics.com>
Thu, 16 Dec 1999 17:31:06 +0000 (17:31 +0000)
committerBrian Paul <brian.paul@tungstengraphics.com>
Thu, 16 Dec 1999 17:31:06 +0000 (17:31 +0000)
src/mesa/glapi/glthread.c [new file with mode: 0644]
src/mesa/glapi/glthread.h [new file with mode: 0644]

diff --git a/src/mesa/glapi/glthread.c b/src/mesa/glapi/glthread.c
new file mode 100644 (file)
index 0000000..f4a68f2
--- /dev/null
@@ -0,0 +1,243 @@
+/* $Id: glthread.c,v 1.1 1999/12/16 17:31:06 brianp Exp $ */
+
+/*
+ * Mesa 3-D graphics library
+ * Version:  3.3
+ * 
+ * Copyright (C) 1999  Brian Paul   All Rights Reserved.
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+ * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+ * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+
+/*
+ * Thread support for gl dispatch.
+ *
+ * Initial version by John Stone (j.stone@acm.org) (johns@cs.umr.edu)
+ *                and Christoph Poliwoda (poliwoda@volumegraphics.com)
+ *
+ * Revised by Keith Whitwell
+ * Adapted for new gl dispatcher by Brian Paul
+ */
+
+
+#ifdef PC_ALL
+#include "all.h"
+#else
+#include "glheader.h"
+#endif
+
+
+
+/*
+ * This file should still compile even when THREADS is not defined.
+ * This is to make things easier to deal with on the makefile scene..
+ */
+#ifdef THREADS
+#include <errno.h>
+#include "glthread.h" 
+
+
+/*
+ * Error messages
+ */
+#define INIT_TSD_ERROR "_glthread_: failed to allocate key for thread specific data"
+#define GET_TSD_ERROR "_glthread_: failed to get thread specific data"
+#define SET_TSD_ERROR "_glthread_: thread failed to set thread specific data"
+
+
+/*
+ * magic number for win32 and solaris threads equivalents of pthread_once
+ * This could probably be done better, but we haven't figured out how yet. 
+ */
+#define INITFUNC_CALLED_MAGIC 0xff8adc98
+
+
+
+/*
+ * POSIX Threads -- The best way to go if your platform supports them.
+ *                  Solaris >= 2.5 have POSIX threads, IRIX >= 6.4 reportedly
+ *                  has them, and many of the free Unixes now have them.
+ *                  Be sure to use appropriate -mt or -D_REENTRANT type
+ *                  compile flags when building.
+ */
+#ifdef PTHREADS
+
+unsigned long
+_glthread_GetID(void)
+{
+   return (unsigned long) pthread_self();
+}
+
+
+void
+_glthread_InitTSD(_glthread_TSD *tsd)
+{
+   if (pthread_key_create(&tsd->key, free) != 0) {
+      perror(INIT_TSD_ERROR);
+      exit(-1);
+   }
+}
+
+
+void *
+_glthread_GetTSD(_glthread_TSD *tsd)
+{
+   return pthread_getspecific(tsd->key);
+}
+
+
+void
+_glthread_SetTSD(_glthread_TSD *tsd, void *ptr, void (*initfunc)(void))
+{
+   pthread_once(&tsd->once, initfunc);
+   if (pthread_setspecific(tsd->key, ptr) != 0) {
+      perror(SET_TSD_ERROR);
+      exit(-1);
+   };
+}
+
+#endif /* PTHREADS */
+
+
+
+/*
+ * Solaris/Unix International Threads -- Use only if POSIX threads 
+ *   aren't available on your Unix platform.  Solaris 2.[34] are examples
+ *   of platforms where this is the case.  Be sure to use -mt and/or 
+ *   -D_REENTRANT when compiling.
+ */
+#ifdef SOLARIS_THREADS
+#define USE_LOCK_FOR_KEY       /* undef this to try a version without
+                                  lock for the global key... */
+
+unsigned long
+_glthread_GetID(void)
+{
+   abort();   /* XXX not implemented yet */
+   return (unsigned long) 0;
+}
+
+
+void
+_glthread_InitTSD(_glthread_TSD *tsd)
+{
+   if ((errno = mutex_init(&tsd->keylock, 0, NULL)) != 0 ||
+      (errno = thr_keycreate(&(tsd->key), free)) != 0) {
+      perror(INIT_TSD_ERROR);
+      exit(-1);
+   }
+}
+
+
+void *
+_glthread_GetTSD(_glthread_TSD *tsd)
+{
+   void* ret;
+#ifdef USE_LOCK_FOR_KEY
+   mutex_lock(&tsd->keylock);
+   thr_getspecific(tsd->key, &ret);
+   mutex_unlock(&tsd->keylock); 
+#else
+   if ((errno = thr_getspecific(tsd->key, &ret)) != 0) {
+      perror(GET_TSD_ERROR);
+      exit(-1);
+   };
+#endif
+   return ret;
+}
+
+
+void
+_glthread_SetTSD(_glthread_TSD *tsd, void *ptr, void (*initfunc)(void))
+{
+   /* the following code assumes that the _glthread_TSD has been initialized
+      to zero at creation */
+   fprintf(stderr, "initfuncCalled = %d\n", tsd->initfuncCalled);
+   if (tsd->initfuncCalled != INITFUNC_CALLED_MAGIC) {
+      initfunc();
+      tsd->initfuncCalled = INITFUNC_CALLED_MAGIC;
+   }
+   if ((errno = thr_setspecific(tsd->key, ptr)) != 0) {
+      perror(SET_TSD_ERROR);
+      exit(-1);
+   };
+}
+
+#undef USE_LOCK_FOR_KEY
+#endif /* SOLARIS_THREADS */
+
+
+
+/*
+ * Win32 Threads.  The only available option for Windows 95/NT.
+ * Be sure that you compile using the Multithreaded runtime, otherwise
+ * bad things will happen.
+ */  
+#ifdef WIN32
+
+unsigned long
+_glthread_GetID(void)
+{
+   abort();   /* XXX not implemented yet */
+   return (unsigned long) 0;
+}
+
+
+void
+_glthread_InitTSD(_glthread_TSD *tsd)
+{
+   tsd->key = TlsAlloc();
+   if (tsd->key == 0xffffffff) {
+      /* Can Windows handle stderr messages for non-console
+         applications? Does Windows have perror? */
+      /* perror(SET_INIT_ERROR);*/
+      exit(-1);
+   }
+}
+
+
+void *
+_glthread_GetTSD(_glthread_TSD *tsd)
+{
+   return TlsGetValue(tsd->key);
+}
+
+
+void
+_glthread_SetTSD(_glthread_TSD *tsd, void *ptr, void (*initfunc)(void))
+{
+   /* the following code assumes that the _glthread_TSD has been initialized
+      to zero at creation */
+   if (tsd->initfuncCalled != INITFUNC_CALLED_MAGIC) {
+      initfunc();
+      tsd->initfuncCalled = INITFUNC_CALLED_MAGIC;
+   }
+   if (TlsSetValue(tsd->key, ptr) == 0) {
+      /* Can Windows handle stderr messages for non-console
+         applications? Does Windows have perror? */
+      /* perror(SET_TSD_ERROR);*/
+      exit(-1);
+   };
+}
+
+#endif /* WIN32 */
+
+#endif /* THREADS */
+
+
diff --git a/src/mesa/glapi/glthread.h b/src/mesa/glapi/glthread.h
new file mode 100644 (file)
index 0000000..c1b9f9d
--- /dev/null
@@ -0,0 +1,145 @@
+/* $Id: glthread.h,v 1.1 1999/12/16 17:31:06 brianp Exp $ */
+
+/*
+ * Mesa 3-D graphics library
+ * Version:  3.3
+ * 
+ * Copyright (C) 1999  Brian Paul   All Rights Reserved.
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+ * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+ * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+
+/*
+ * Thread support for gl dispatch.
+ *
+ * Initial version by John Stone (j.stone@acm.org) (johns@cs.umr.edu)
+ *                and Christoph Poliwoda (poliwoda@volumegraphics.com)
+ * Revised by Keith Whitwell
+ * Adapted for new gl dispatcher by Brian Paul
+ */
+
+
+
+/*
+ * If this file is accidentally included by a non-threaded build, 
+ * it should not cause the build to fail, or otherwise cause problems.
+ * In general, it should only be included when needed however.
+ */
+#ifdef THREADS
+/*
+ * It is an error not to select a specific threads API when compiling.
+ */
+#if !defined(PTHREADS) && !defined(SOLARIS_THREADS) && !defined(WIN32)
+#error One of PTHREADS, SOLARIS_THREADS or WIN32 must be defined.
+#endif
+
+
+
+/*
+ * POSIX threads. This should be your choice in the Unix world
+ * whenever possible.  When building with POSIX threads, be sure
+ * to enable any compiler flags which will cause the MT-safe
+ * libc (if one exists) to be used when linking, as well as any
+ * header macros for MT-safe errno, etc.  For Solaris, this is the -mt
+ * compiler flag.  On Solaris with gcc, use -D_REENTRANT to enable
+ * proper compiling for MT-safe libc etc.
+ */
+#ifdef PTHREADS
+#include <pthread.h> /* POSIX threads headers */
+
+typedef struct {
+   pthread_key_t  key;
+   pthread_once_t once;
+} _glthread_TSD;
+
+typedef pthread_mutex_t _glthread_Mutex;
+typedef pthread_t _glthread_Thread;
+
+#endif /* PTHREADS */
+
+
+
+
+/*
+ * Solaris threads. Use only up to Solaris 2.4. 
+ * Solaris 2.5 and higher provide POSIX threads.
+ * Be sure to compile with -mt on the Solaris compilers, or 
+ * use -D_REENTRANT if using gcc.
+ */
+#ifdef SOLARIS_THREADS
+#include <thread.h>
+
+typedef struct {
+   thread_key_t key;
+   mutex_t      keylock;
+   int          initfuncCalled;
+} _glthread_TSD;
+
+typedef mutex_t _glthread_Mutex;
+typedef thread_t _glthread_Thread;
+
+#endif /* SOLARIS_THREADS */
+
+
+
+
+/*
+ * Windows threads. Should work with Windows NT and 95. 
+ * IMPORTANT: Link with multithreaded runtime library when THREADS are
+ * used!
+ */
+
+#ifdef WIN32
+#include <windows.h>
+
+typedef struct {
+   DWORD key;
+   int   initfuncCalled;
+} _glthread_TSD;
+
+typedef CRITICAL_SECTION _glthread_Mutex;
+typedef HANDLE _glthread_Thread;
+
+#endif /* WIN32 */
+
+
+
+
+/*
+ * Platform independent thread specific data API. 
+ */
+
+extern unsigned long
+_glthread_GetID(void);
+
+
+extern void
+_glthread_InitTSD(_glthread_TSD *);
+
+
+extern void *
+_glthread_GetTSD(_glthread_TSD *);
+
+
+extern void
+_glthread_SetTSD(_glthread_TSD *, void *, void (*initfunc)(void));
+
+
+
+#endif