gthread/gthread.c

   1 /* GLIB - Library of useful routines for C programming
   2  * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * gthread.c: thread related functions
   5  * Copyright 1998 Sebastian Wilhelmi; University of Karlsruhe
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Library General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Library General Public
  18  * License along with this library; if not, write to the
  19  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  */
  22
  23 /*
  24  * MT safe
  25  */
  26
  27 #ifdef HAVE_CONFIG_H
  28 #include <config.h>
  29 #endif
  30
  31 #include <glib.h>
  32
  33 static const char *g_log_domain_gthread = "GThread";
  34 static gboolean thread_system_already_initialized = FALSE;
  35
  36 #include G_THREAD_SOURCE
  37
  38 void g_mutex_init (void);
  39 void g_mem_init (void);
  40 void g_messages_init (void);
  41
  42 void
  43 g_thread_init(GThreadFunctions* init)
  44 {
  45   gboolean supported;
  46
  47   if (thread_system_already_initialized)
  48     g_error ("the glib thread system may only be initialized once.");
  49
  50   thread_system_already_initialized = TRUE;
  51
  52   if (init == NULL)
  53     init = &g_thread_functions_for_glib_use_default;
  54   else
  55     g_thread_use_default_impl = FALSE;
  56
  57   g_thread_functions_for_glib_use = *init;
  58
  59   /* It is important, that g_thread_supported is not set before the
  60      thread initialization functions of the different modules are
  61      called */
  62
  63   supported =
  64     init->mutex_new &&
  65     init->mutex_lock &&
  66     init->mutex_trylock &&
  67     init->mutex_unlock &&
  68     init->mutex_free &&
  69     init->cond_new &&
  70     init->cond_signal &&
  71     init->cond_broadcast &&
  72     init->cond_wait &&
  73     init->cond_timed_wait &&
  74     init->cond_free &&
  75     init->private_new &&
  76     init->private_get &&
  77     init->private_get;
  78
  79   /* if somebody is calling g_thread_init (), it means that he wants to
  80      have thread support, so check this */
  81
  82   if (!supported)
  83     {
  84       if (g_thread_use_default_impl)
  85         g_error ("Threads are not supported on this platform.");
  86       else
  87         g_error ("The supplied thread function vector is invalid.");
  88     }
  89
  90   /* now call the thread initialization functions of the different
  91      glib modules. BTW: order does matter, g_mutex_init MUST be first */
  92
  93   g_mutex_init ();
  94   g_mem_init ();
  95   g_messages_init ();
  96
  97   /* now we can set g_thread_supported and thus enable all the thread
  98      functions */
  99
 100   g_thread_supported = TRUE;
 101 }