gcc/gthr.h

   1 /* Threads compatibility routines for libgcc2.  */
   2 /* Compile this one with gcc.  */
   3 /* Copyright (C) 1997, 1998 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 /* As a special exception, if you link this library with other files,
  23    some of which are compiled with GCC, to produce an executable,
  24    this library does not by itself cause the resulting executable
  25    to be covered by the GNU General Public License.
  26    This exception does not however invalidate any other reasons why
  27    the executable file might be covered by the GNU General Public License.  */
  28
  29 #ifndef GCC_GTHR_H
  30 #define GCC_GTHR_H
  31
  32 /* If this file is compiled with threads support, it must
  33        #define __GTHREADS 1
  34    to indicate that threads support is present.  Also it has define
  35    function
  36      int __gthread_active_p ()
  37    that returns 1 if thread system is active, 0 if not.
  38
  39    The threads interface must define the following types:
  40      __gthread_key_t
  41      __gthread_once_t
  42      __gthread_mutex_t
  43
  44    The threads interface must define the following macros:
  45
  46      __GTHREAD_ONCE_INIT
  47                 to initialize __gthread_once_t
  48      __GTHREAD_MUTEX_INIT
  49                 to initialize __gthread_mutex_t to get a fast
  50                 non-recursive mutex.
  51      __GTHREAD_MUTEX_INIT_FUNCTION
  52                 some systems can't initalize a mutex without a
  53                 function call.  On such systems, define this to a
  54                 function which looks like this:
  55                   void __GTHREAD_MUTEX_INIT_FUNCTION (__gthread_mutex_t *)
  56                 Don't define __GTHREAD_MUTEX_INIT in this case
  57
  58    The threads interface must define the following static functions:
  59
  60      int __gthread_once (__gthread_once_t *once, void (*func) ())
  61
  62      int __gthread_key_create (__gthread_key_t *keyp, void (*dtor) (void *))
  63      int __gthread_key_delete (__gthread_key_t key)
  64
  65      int __gthread_key_dtor (__gthread_key_t key, void *ptr)
  66
  67      void *__gthread_getspecific (__gthread_key_t key)
  68      int __gthread_setspecific (__gthread_key_t key, const void *ptr)
  69
  70      int __gthread_mutex_lock (__gthread_mutex_t *mutex);
  71      int __gthread_mutex_trylock (__gthread_mutex_t *mutex);
  72      int __gthread_mutex_unlock (__gthread_mutex_t *mutex);
  73
  74    All functions returning int should return zero on success or the error
  75    number.  If the operation is not supported, -1 is returned.
  76
  77    Currently supported threads packages are
  78      POSIX threads with -D_PTHREADS
  79      DCE threads with -D_DCE_THREADS
  80      Solaris/UI threads with -D_SOLARIS_THREADS
  81 */
  82
  83 /* Check first for thread specific defines. */
  84 #if _PTHREADS
  85 #include "gthr-posix.h"
  86 #elif _DCE_THREADS
  87 #include "gthr-dce.h"
  88 #elif _SOLARIS_THREADS
  89 #include "gthr-solaris.h"
  90
  91 /* Include GTHREAD_FILE if one is defined. */
  92 #elif defined(HAVE_GTHR_DEFAULT)
  93 #if SUPPORTS_WEAK
  94 #ifndef GTHREAD_USE_WEAK
  95 #define GTHREAD_USE_WEAK 1
  96 #endif
  97 #endif
  98 #include "gthr-default.h"
  99
 100 /* Fallback to single thread definitions. */
 101 #else
 102 #include "gthr-single.h"
 103 #endif
 104
 105 #endif /* ! GCC_GTHR_H */