glib/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: MT safety related functions
   5  * Copyright 1998 Sebastian Wilhelmi; University of Karlsruhe
   6  *                Owen Taylor
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the
  20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  21  * Boston, MA 02111-1307, USA.
  22  */
  23
  24 /*
  25  * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
  26  * file for a list of people on the GLib Team.  See the ChangeLog
  27  * files for a list of changes.  These files are distributed with
  28  * GLib at ftp://ftp.gtk.org/pub/gtk/.
  29  */
  30
  31 /*
  32  * MT safe
  33  */
  34
  35 /* implement gthread.h's inline functions */
  36 #define G_IMPLEMENT_INLINES 1
  37 #define __G_THREAD_C__
  38
  39 #include "config.h"
  40
  41 #include "glib.h"
  42 #include "gthreadprivate.h"
  43
  44 #ifdef HAVE_UNISTD_H
  45 #include <unistd.h>
  46 #endif
  47
  48 #ifndef G_OS_WIN32
  49 #include <sys/time.h>
  50 #include <time.h>
  51 #else
  52 #include <windows.h>
  53 #endif /* G_OS_WIN32 */
  54
  55 #include <string.h>
  56
  57 #include "galias.h"
  58
  59 GQuark
  60 g_thread_error_quark (void)
  61 {
  62   return g_quark_from_static_string ("g_thread_error");
  63 }
  64
  65 /* Keep this in sync with GRealThread in gmain.c! */
  66 typedef struct _GRealThread GRealThread;
  67 struct  _GRealThread
  68 {
  69   GThread thread;
  70   gpointer private_data;
  71   GRealThread *next;
  72   gpointer retval;
  73   GSystemThread system_thread;
  74 };
  75
  76 typedef struct _GStaticPrivateNode GStaticPrivateNode;
  77 struct _GStaticPrivateNode
  78 {
  79   gpointer       data;
  80   GDestroyNotify destroy;
  81 };
  82
  83 static void    g_thread_cleanup (gpointer data);
  84 static void    g_thread_fail (void);
  85 static guint64 gettime (void);
  86
  87 guint64        (*g_thread_gettime) (void) = gettime;
  88
  89 /* Global variables */
  90
  91 static GSystemThread zero_thread; /* This is initialized to all zero */
  92 gboolean g_thread_use_default_impl = TRUE;
  93 gboolean g_threads_got_initialized = FALSE;
  94
  95 GThreadFunctions g_thread_functions_for_glib_use = {
  96   (GMutex*(*)())g_thread_fail,                 /* mutex_new */
  97   NULL,                                        /* mutex_lock */
  98   NULL,                                        /* mutex_trylock */
  99   NULL,                                        /* mutex_unlock */
 100   NULL,                                        /* mutex_free */
 101   (GCond*(*)())g_thread_fail,                  /* cond_new */
 102   NULL,                                        /* cond_signal */
 103   NULL,                                        /* cond_broadcast */
 104   NULL,                                        /* cond_wait */
 105   NULL,                                        /* cond_timed_wait  */
 106   NULL,                                        /* cond_free */
 107   (GPrivate*(*)(GDestroyNotify))g_thread_fail, /* private_new */
 108   NULL,                                        /* private_get */
 109   NULL,                                        /* private_set */
 110   (void(*)(GThreadFunc, gpointer, gulong,
 111            gboolean, gboolean, GThreadPriority,
 112            gpointer, GError**))g_thread_fail,  /* thread_create */
 113   NULL,                                        /* thread_yield */
 114   NULL,                                        /* thread_join */
 115   NULL,                                        /* thread_exit */
 116   NULL,                                        /* thread_set_priority */
 117   NULL,                                        /* thread_self */
 118   NULL                                         /* thread_equal */
 119 };
 120
 121 /* Local data */
 122
 123 static GMutex   *g_once_mutex = NULL;
 124 static GCond    *g_once_cond = NULL;
 125 static GPrivate *g_thread_specific_private = NULL;
 126 static GRealThread *g_thread_all_threads = NULL;
 127 static GSList   *g_thread_free_indeces = NULL;
 128 static GSList*   g_once_init_list = NULL;
 129
 130 G_LOCK_DEFINE_STATIC (g_thread);
 131
 132 #ifdef G_THREADS_ENABLED
 133 /* This must be called only once, before any threads are created.
 134  * It will only be called from g_thread_init() in -lgthread.
 135  */
 136 void
 137 g_thread_init_glib (void)
 138 {
 139   /* We let the main thread (the one that calls g_thread_init) inherit
 140    * the static_private data set before calling g_thread_init
 141    */
 142   GRealThread* main_thread = (GRealThread*) g_thread_self ();
 143
 144   /* mutex and cond creation works without g_threads_got_initialized */
 145   g_once_mutex = g_mutex_new ();
 146   g_once_cond = g_cond_new ();
 147
 148   /* we may only create mutex and cond in here */
 149   _g_mem_thread_init_noprivate_nomessage ();
 150
 151   /* setup the basic threading system */
 152   g_threads_got_initialized = TRUE;
 153   g_thread_specific_private = g_private_new (g_thread_cleanup);
 154   g_private_set (g_thread_specific_private, main_thread);
 155   G_THREAD_UF (thread_self, (&main_thread->system_thread));
 156
 157   /* complete memory system initialization, g_private_*() works now */
 158   _g_slice_thread_init_nomessage ();
 159
 160   /* accomplish log system initialization to enable messaging */
 161   _g_messages_thread_init_nomessage ();
 162
 163   /* we may run full-fledged initializers from here */
 164   _g_atomic_thread_init ();
 165   _g_convert_thread_init ();
 166   _g_rand_thread_init ();
 167   _g_main_thread_init ();
 168   _g_utils_thread_init ();
 169 #ifdef G_OS_WIN32
 170   _g_win32_thread_init ();
 171 #endif
 172 }
 173 #endif /* G_THREADS_ENABLED */
 174
 175 gpointer
 176 g_once_impl (GOnce       *once,
 177              GThreadFunc  func,
 178              gpointer     arg)
 179 {
 180   g_mutex_lock (g_once_mutex);
 181
 182   while (once->status == G_ONCE_STATUS_PROGRESS)
 183     g_cond_wait (g_once_cond, g_once_mutex);
 184
 185   if (once->status != G_ONCE_STATUS_READY)
 186     {
 187       once->status = G_ONCE_STATUS_PROGRESS;
 188       g_mutex_unlock (g_once_mutex);
 189
 190       once->retval = func (arg);
 191
 192       g_mutex_lock (g_once_mutex);
 193       once->status = G_ONCE_STATUS_READY;
 194       g_cond_broadcast (g_once_cond);
 195     }
 196
 197   g_mutex_unlock (g_once_mutex);
 198
 199   return once->retval;
 200 }
 201
 202 gboolean
 203 g_once_init_enter_impl (volatile gsize *value_location)
 204 {
 205   gboolean need_init = FALSE;
 206   g_mutex_lock (g_once_mutex);
 207   if (g_atomic_pointer_get (value_location) == NULL)
 208     {
 209       if (!g_slist_find (g_once_init_list, (void*) value_location))
 210         {
 211           need_init = TRUE;
 212           g_once_init_list = g_slist_prepend (g_once_init_list, (void*) value_location);
 213         }
 214       else
 215         do
 216           g_cond_wait (g_once_cond, g_once_mutex);
 217         while (g_slist_find (g_once_init_list, (void*) value_location));
 218     }
 219   g_mutex_unlock (g_once_mutex);
 220   return need_init;
 221 }
 222
 223 void
 224 g_once_init_leave (volatile gsize *value_location,
 225                    gsize           initialization_value)
 226 {
 227   g_return_if_fail (g_atomic_pointer_get (value_location) == NULL);
 228   g_return_if_fail (initialization_value != 0);
 229   g_return_if_fail (g_once_init_list != NULL);
 230
 231   g_atomic_pointer_set ((void**)value_location, (void*) initialization_value);
 232   g_mutex_lock (g_once_mutex);
 233   g_once_init_list = g_slist_remove (g_once_init_list, (void*) value_location);
 234   g_cond_broadcast (g_once_cond);
 235   g_mutex_unlock (g_once_mutex);
 236 }
 237
 238 void
 239 g_static_mutex_init (GStaticMutex *mutex)
 240 {
 241   static const GStaticMutex init_mutex = G_STATIC_MUTEX_INIT;
 242
 243   g_return_if_fail (mutex);
 244
 245   *mutex = init_mutex;
 246 }
 247
 248 GMutex *
 249 g_static_mutex_get_mutex_impl (GMutex** mutex)
 250 {
 251   if (!g_thread_supported ())
 252     return NULL;
 253
 254   g_assert (g_once_mutex);
 255
 256   g_mutex_lock (g_once_mutex);
 257
 258   if (!(*mutex))
 259     g_atomic_pointer_set (mutex, g_mutex_new());
 260
 261   g_mutex_unlock (g_once_mutex);
 262
 263   return *mutex;
 264 }
 265
 266 void
 267 g_static_mutex_free (GStaticMutex* mutex)
 268 {
 269   GMutex **runtime_mutex;
 270
 271   g_return_if_fail (mutex);
 272
 273   /* The runtime_mutex is the first (or only) member of GStaticMutex,
 274    * see both versions (of glibconfig.h) in configure.in. Note, that
 275    * this variable is NULL, if g_thread_init() hasn't been called or
 276    * if we're using the default thread implementation and it provides
 277    * static mutexes. */
 278   runtime_mutex = ((GMutex**)mutex);
 279
 280   if (*runtime_mutex)
 281     g_mutex_free (*runtime_mutex);
 282
 283   *runtime_mutex = NULL;
 284 }
 285
 286 void
 287 g_static_rec_mutex_init (GStaticRecMutex *mutex)
 288 {
 289   static const GStaticRecMutex init_mutex = G_STATIC_REC_MUTEX_INIT;
 290
 291   g_return_if_fail (mutex);
 292
 293   *mutex = init_mutex;
 294 }
 295
 296 void
 297 g_static_rec_mutex_lock (GStaticRecMutex* mutex)
 298 {
 299   GSystemThread self;
 300
 301   g_return_if_fail (mutex);
 302
 303   if (!g_thread_supported ())
 304     return;
 305
 306   G_THREAD_UF (thread_self, (&self));
 307
 308   if (g_system_thread_equal (self, mutex->owner))
 309     {
 310       mutex->depth++;
 311       return;
 312     }
 313   g_static_mutex_lock (&mutex->mutex);
 314   g_system_thread_assign (mutex->owner, self);
 315   mutex->depth = 1;
 316 }
 317
 318 gboolean
 319 g_static_rec_mutex_trylock (GStaticRecMutex* mutex)
 320 {
 321   GSystemThread self;
 322
 323   g_return_val_if_fail (mutex, FALSE);
 324
 325   if (!g_thread_supported ())
 326     return TRUE;
 327
 328   G_THREAD_UF (thread_self, (&self));
 329
 330   if (g_system_thread_equal (self, mutex->owner))
 331     {
 332       mutex->depth++;
 333       return TRUE;
 334     }
 335
 336   if (!g_static_mutex_trylock (&mutex->mutex))
 337     return FALSE;
 338
 339   g_system_thread_assign (mutex->owner, self);
 340   mutex->depth = 1;
 341   return TRUE;
 342 }
 343
 344 void
 345 g_static_rec_mutex_unlock (GStaticRecMutex* mutex)
 346 {
 347   g_return_if_fail (mutex);
 348
 349   if (!g_thread_supported ())
 350     return;
 351
 352   if (mutex->depth > 1)
 353     {
 354       mutex->depth--;
 355       return;
 356     }
 357   g_system_thread_assign (mutex->owner, zero_thread);
 358   g_static_mutex_unlock (&mutex->mutex);
 359 }
 360
 361 void
 362 g_static_rec_mutex_lock_full   (GStaticRecMutex *mutex,
 363                                 guint            depth)
 364 {
 365   GSystemThread self;
 366   g_return_if_fail (mutex);
 367
 368   if (!g_thread_supported ())
 369     return;
 370
 371   if (depth == 0)
 372     return;
 373
 374   G_THREAD_UF (thread_self, (&self));
 375
 376   if (g_system_thread_equal (self, mutex->owner))
 377     {
 378       mutex->depth += depth;
 379       return;
 380     }
 381   g_static_mutex_lock (&mutex->mutex);
 382   g_system_thread_assign (mutex->owner, self);
 383   mutex->depth = depth;
 384 }
 385
 386 guint
 387 g_static_rec_mutex_unlock_full (GStaticRecMutex *mutex)
 388 {
 389   guint depth;
 390
 391   g_return_val_if_fail (mutex, 0);
 392
 393   if (!g_thread_supported ())
 394     return 1;
 395
 396   depth = mutex->depth;
 397
 398   g_system_thread_assign (mutex->owner, zero_thread);
 399   mutex->depth = 0;
 400   g_static_mutex_unlock (&mutex->mutex);
 401
 402   return depth;
 403 }
 404
 405 void
 406 g_static_rec_mutex_free (GStaticRecMutex *mutex)
 407 {
 408   g_return_if_fail (mutex);
 409
 410   g_static_mutex_free (&mutex->mutex);
 411 }
 412
 413 void
 414 g_static_private_init (GStaticPrivate *private_key)
 415 {
 416   private_key->index = 0;
 417 }
 418
 419 gpointer
 420 g_static_private_get (GStaticPrivate *private_key)
 421 {
 422   GRealThread *self = (GRealThread*) g_thread_self ();
 423   GArray *array;
 424
 425   array = self->private_data;
 426   if (!array)
 427     return NULL;
 428
 429   if (!private_key->index)
 430     return NULL;
 431   else if (private_key->index <= array->len)
 432     return g_array_index (array, GStaticPrivateNode,
 433                           private_key->index - 1).data;
 434   else
 435     return NULL;
 436 }
 437
 438 void
 439 g_static_private_set (GStaticPrivate *private_key,
 440                       gpointer        data,
 441                       GDestroyNotify  notify)
 442 {
 443   GRealThread *self = (GRealThread*) g_thread_self ();
 444   GArray *array;
 445   static guint next_index = 0;
 446   GStaticPrivateNode *node;
 447
 448   array = self->private_data;
 449   if (!array)
 450     {
 451       array = g_array_new (FALSE, TRUE, sizeof (GStaticPrivateNode));
 452       self->private_data = array;
 453     }
 454
 455   if (!private_key->index)
 456     {
 457       G_LOCK (g_thread);
 458
 459       if (!private_key->index)
 460         {
 461           if (g_thread_free_indeces)
 462             {
 463               private_key->index =
 464                 GPOINTER_TO_UINT (g_thread_free_indeces->data);
 465               g_thread_free_indeces =
 466                 g_slist_delete_link (g_thread_free_indeces,
 467                                      g_thread_free_indeces);
 468             }
 469           else
 470             private_key->index = ++next_index;
 471         }
 472
 473       G_UNLOCK (g_thread);
 474     }
 475
 476   if (private_key->index > array->len)
 477     g_array_set_size (array, private_key->index);
 478
 479   node = &g_array_index (array, GStaticPrivateNode, private_key->index - 1);
 480   if (node->destroy)
 481     {
 482       gpointer ddata = node->data;
 483       GDestroyNotify ddestroy = node->destroy;
 484
 485       node->data = data;
 486       node->destroy = notify;
 487
 488       ddestroy (ddata);
 489     }
 490   else
 491     {
 492       node->data = data;
 493       node->destroy = notify;
 494     }
 495 }
 496
 497 void
 498 g_static_private_free (GStaticPrivate *private_key)
 499 {
 500   guint idx = private_key->index;
 501   GRealThread *thread;
 502
 503   if (!idx)
 504     return;
 505
 506   private_key->index = 0;
 507
 508   G_LOCK (g_thread);
 509
 510   thread = g_thread_all_threads;
 511   while (thread)
 512     {
 513       GArray *array = thread->private_data;
 514       thread = thread->next;
 515
 516       if (array && idx <= array->len)
 517         {
 518           GStaticPrivateNode *node = &g_array_index (array,
 519                                                      GStaticPrivateNode,
 520                                                      idx - 1);
 521           gpointer ddata = node->data;
 522           GDestroyNotify ddestroy = node->destroy;
 523
 524           node->data = NULL;
 525           node->destroy = NULL;
 526
 527           if (ddestroy)
 528             {
 529               G_UNLOCK (g_thread);
 530               ddestroy (ddata);
 531               G_LOCK (g_thread);
 532             }
 533         }
 534     }
 535   g_thread_free_indeces = g_slist_prepend (g_thread_free_indeces,
 536                                            GUINT_TO_POINTER (idx));
 537   G_UNLOCK (g_thread);
 538 }
 539
 540 static void
 541 g_thread_cleanup (gpointer data)
 542 {
 543   if (data)
 544     {
 545       GRealThread* thread = data;
 546       if (thread->private_data)
 547         {
 548           GArray* array = thread->private_data;
 549           guint i;
 550
 551           for (i = 0; i < array->len; i++ )
 552             {
 553               GStaticPrivateNode *node =
 554                 &g_array_index (array, GStaticPrivateNode, i);
 555               if (node->destroy)
 556                 node->destroy (node->data);
 557             }
 558           g_array_free (array, TRUE);
 559         }
 560
 561       /* We only free the thread structure, if it isn't joinable. If
 562          it is, the structure is freed in g_thread_join */
 563       if (!thread->thread.joinable)
 564         {
 565           GRealThread *t, *p;
 566
 567           G_LOCK (g_thread);
 568           for (t = g_thread_all_threads, p = NULL; t; p = t, t = t->next)
 569             {
 570               if (t == thread)
 571                 {
 572                   if (p)
 573                     p->next = t->next;
 574                   else
 575                     g_thread_all_threads = t->next;
 576                   break;
 577                 }
 578             }
 579           G_UNLOCK (g_thread);
 580
 581           /* Just to make sure, this isn't used any more */
 582           g_system_thread_assign (thread->system_thread, zero_thread);
 583           g_free (thread);
 584         }
 585     }
 586 }
 587
 588 static void
 589 g_thread_fail (void)
 590 {
 591   g_error ("The thread system is not yet initialized.");
 592 }
 593
 594 #define G_NSEC_PER_SEC 1000000000
 595
 596 static guint64
 597 gettime (void)
 598 {
 599 #ifdef G_OS_WIN32
 600   guint64 v;
 601
 602   /* Returns 100s of nanoseconds since start of 1601 */
 603   GetSystemTimeAsFileTime ((FILETIME *)&v);
 604
 605   /* Offset to Unix epoch */
 606   v -= G_GINT64_CONSTANT (116444736000000000);
 607   /* Convert to nanoseconds */
 608   v *= 100;
 609
 610   return v;
 611 #else
 612   struct timeval tv;
 613
 614   gettimeofday (&tv, NULL);
 615
 616   return (guint64) tv.tv_sec * G_NSEC_PER_SEC + tv.tv_usec * (G_NSEC_PER_SEC / G_USEC_PER_SEC);
 617 #endif
 618 }
 619
 620 static gpointer
 621 g_thread_create_proxy (gpointer data)
 622 {
 623   GRealThread* thread = data;
 624
 625   g_assert (data);
 626
 627   /* This has to happen before G_LOCK, as that might call g_thread_self */
 628   g_private_set (g_thread_specific_private, data);
 629
 630   /* the lock makes sure, that thread->system_thread is written,
 631      before thread->thread.func is called. See g_thread_create. */
 632   G_LOCK (g_thread);
 633   G_UNLOCK (g_thread);
 634
 635   thread->retval = thread->thread.func (thread->thread.data);
 636
 637   return NULL;
 638 }
 639
 640 GThread*
 641 g_thread_create_full (GThreadFunc       func,
 642                       gpointer          data,
 643                       gulong            stack_size,
 644                       gboolean          joinable,
 645                       gboolean          bound,
 646                       GThreadPriority   priority,
 647                       GError          **error)
 648 {
 649   GRealThread* result;
 650   GError *local_error = NULL;
 651   g_return_val_if_fail (func, NULL);
 652   g_return_val_if_fail (priority >= G_THREAD_PRIORITY_LOW, NULL);
 653   g_return_val_if_fail (priority <= G_THREAD_PRIORITY_URGENT, NULL);
 654
 655   result = g_new0 (GRealThread, 1);
 656
 657   result->thread.joinable = joinable;
 658   result->thread.priority = priority;
 659   result->thread.func = func;
 660   result->thread.data = data;
 661   result->private_data = NULL;
 662   G_LOCK (g_thread);
 663   G_THREAD_UF (thread_create, (g_thread_create_proxy, result,
 664                                stack_size, joinable, bound, priority,
 665                                &result->system_thread, &local_error));
 666   if (!local_error)
 667     {
 668       result->next = g_thread_all_threads;
 669       g_thread_all_threads = result;
 670     }
 671   G_UNLOCK (g_thread);
 672
 673   if (local_error)
 674     {
 675       g_propagate_error (error, local_error);
 676       g_free (result);
 677       return NULL;
 678     }
 679
 680   return (GThread*) result;
 681 }
 682
 683 void
 684 g_thread_exit (gpointer retval)
 685 {
 686   GRealThread* real = (GRealThread*) g_thread_self ();
 687   real->retval = retval;
 688   G_THREAD_CF (thread_exit, (void)0, ());
 689 }
 690
 691 gpointer
 692 g_thread_join (GThread* thread)
 693 {
 694   GRealThread* real = (GRealThread*) thread;
 695   GRealThread *p, *t;
 696   gpointer retval;
 697
 698   g_return_val_if_fail (thread, NULL);
 699   g_return_val_if_fail (thread->joinable, NULL);
 700   g_return_val_if_fail (!g_system_thread_equal (real->system_thread,
 701                                                 zero_thread), NULL);
 702
 703   G_THREAD_UF (thread_join, (&real->system_thread));
 704
 705   retval = real->retval;
 706
 707   G_LOCK (g_thread);
 708   for (t = g_thread_all_threads, p = NULL; t; p = t, t = t->next)
 709     {
 710       if (t == (GRealThread*) thread)
 711         {
 712           if (p)
 713             p->next = t->next;
 714           else
 715             g_thread_all_threads = t->next;
 716           break;
 717         }
 718     }
 719   G_UNLOCK (g_thread);
 720
 721   /* Just to make sure, this isn't used any more */
 722   thread->joinable = 0;
 723   g_system_thread_assign (real->system_thread, zero_thread);
 724
 725   /* the thread structure for non-joinable threads is freed upon
 726      thread end. We free the memory here. This will leave a loose end,
 727      if a joinable thread is not joined. */
 728
 729   g_free (thread);
 730
 731   return retval;
 732 }
 733
 734 void
 735 g_thread_set_priority (GThread* thread,
 736                        GThreadPriority priority)
 737 {
 738   GRealThread* real = (GRealThread*) thread;
 739
 740   g_return_if_fail (thread);
 741   g_return_if_fail (!g_system_thread_equal (real->system_thread, zero_thread));
 742   g_return_if_fail (priority >= G_THREAD_PRIORITY_LOW);
 743   g_return_if_fail (priority <= G_THREAD_PRIORITY_URGENT);
 744
 745   thread->priority = priority;
 746
 747   G_THREAD_CF (thread_set_priority, (void)0,
 748                (&real->system_thread, priority));
 749 }
 750
 751 GThread*
 752 g_thread_self (void)
 753 {
 754   GRealThread* thread = g_private_get (g_thread_specific_private);
 755
 756   if (!thread)
 757     {
 758       /* If no thread data is available, provide and set one.  This
 759          can happen for the main thread and for threads, that are not
 760          created by GLib. */
 761       thread = g_new0 (GRealThread, 1);
 762       thread->thread.joinable = FALSE; /* This is a save guess */
 763       thread->thread.priority = G_THREAD_PRIORITY_NORMAL; /* This is
 764                                                              just a guess */
 765       thread->thread.func = NULL;
 766       thread->thread.data = NULL;
 767       thread->private_data = NULL;
 768
 769       if (g_thread_supported ())
 770         G_THREAD_UF (thread_self, (&thread->system_thread));
 771
 772       g_private_set (g_thread_specific_private, thread);
 773
 774       G_LOCK (g_thread);
 775       thread->next = g_thread_all_threads;
 776       g_thread_all_threads = thread;
 777       G_UNLOCK (g_thread);
 778     }
 779
 780   return (GThread*)thread;
 781 }
 782
 783 void
 784 g_static_rw_lock_init (GStaticRWLock* lock)
 785 {
 786   static const GStaticRWLock init_lock = G_STATIC_RW_LOCK_INIT;
 787
 788   g_return_if_fail (lock);
 789
 790   *lock = init_lock;
 791 }
 792
 793 inline static void
 794 g_static_rw_lock_wait (GCond** cond, GStaticMutex* mutex)
 795 {
 796   if (!*cond)
 797       *cond = g_cond_new ();
 798   g_cond_wait (*cond, g_static_mutex_get_mutex (mutex));
 799 }
 800
 801 inline static void
 802 g_static_rw_lock_signal (GStaticRWLock* lock)
 803 {
 804   if (lock->want_to_write && lock->write_cond)
 805     g_cond_signal (lock->write_cond);
 806   else if (lock->want_to_read && lock->read_cond)
 807     g_cond_broadcast (lock->read_cond);
 808 }
 809
 810 void
 811 g_static_rw_lock_reader_lock (GStaticRWLock* lock)
 812 {
 813   g_return_if_fail (lock);
 814
 815   if (!g_threads_got_initialized)
 816     return;
 817
 818   g_static_mutex_lock (&lock->mutex);
 819   lock->want_to_read++;
 820   while (lock->have_writer || lock->want_to_write)
 821     g_static_rw_lock_wait (&lock->read_cond, &lock->mutex);
 822   lock->want_to_read--;
 823   lock->read_counter++;
 824   g_static_mutex_unlock (&lock->mutex);
 825 }
 826
 827 gboolean
 828 g_static_rw_lock_reader_trylock (GStaticRWLock* lock)
 829 {
 830   gboolean ret_val = FALSE;
 831
 832   g_return_val_if_fail (lock, FALSE);
 833
 834   if (!g_threads_got_initialized)
 835     return TRUE;
 836
 837   g_static_mutex_lock (&lock->mutex);
 838   if (!lock->have_writer && !lock->want_to_write)
 839     {
 840       lock->read_counter++;
 841       ret_val = TRUE;
 842     }
 843   g_static_mutex_unlock (&lock->mutex);
 844   return ret_val;
 845 }
 846
 847 void
 848 g_static_rw_lock_reader_unlock  (GStaticRWLock* lock)
 849 {
 850   g_return_if_fail (lock);
 851
 852   if (!g_threads_got_initialized)
 853     return;
 854
 855   g_static_mutex_lock (&lock->mutex);
 856   lock->read_counter--;
 857   if (lock->read_counter == 0)
 858     g_static_rw_lock_signal (lock);
 859   g_static_mutex_unlock (&lock->mutex);
 860 }
 861
 862 void
 863 g_static_rw_lock_writer_lock (GStaticRWLock* lock)
 864 {
 865   g_return_if_fail (lock);
 866
 867   if (!g_threads_got_initialized)
 868     return;
 869
 870   g_static_mutex_lock (&lock->mutex);
 871   lock->want_to_write++;
 872   while (lock->have_writer || lock->read_counter)
 873     g_static_rw_lock_wait (&lock->write_cond, &lock->mutex);
 874   lock->want_to_write--;
 875   lock->have_writer = TRUE;
 876   g_static_mutex_unlock (&lock->mutex);
 877 }
 878
 879 gboolean
 880 g_static_rw_lock_writer_trylock (GStaticRWLock* lock)
 881 {
 882   gboolean ret_val = FALSE;
 883
 884   g_return_val_if_fail (lock, FALSE);
 885
 886   if (!g_threads_got_initialized)
 887     return TRUE;
 888
 889   g_static_mutex_lock (&lock->mutex);
 890   if (!lock->have_writer && !lock->read_counter)
 891     {
 892       lock->have_writer = TRUE;
 893       ret_val = TRUE;
 894     }
 895   g_static_mutex_unlock (&lock->mutex);
 896   return ret_val;
 897 }
 898
 899 void
 900 g_static_rw_lock_writer_unlock (GStaticRWLock* lock)
 901 {
 902   g_return_if_fail (lock);
 903
 904   if (!g_threads_got_initialized)
 905     return;
 906
 907   g_static_mutex_lock (&lock->mutex);
 908   lock->have_writer = FALSE;
 909   g_static_rw_lock_signal (lock);
 910   g_static_mutex_unlock (&lock->mutex);
 911 }
 912
 913 void
 914 g_static_rw_lock_free (GStaticRWLock* lock)
 915 {
 916   g_return_if_fail (lock);
 917
 918   if (lock->read_cond)
 919     {
 920       g_cond_free (lock->read_cond);
 921       lock->read_cond = NULL;
 922     }
 923   if (lock->write_cond)
 924     {
 925       g_cond_free (lock->write_cond);
 926       lock->write_cond = NULL;
 927     }
 928   g_static_mutex_free (&lock->mutex);
 929 }
 930
 931 /**
 932  * g_thread_foreach
 933  * @thread_func: function to call for all GThread structures
 934  * @user_data:   second argument to @thread_func
 935  *
 936  * Call @thread_func on all existing #GThread structures. Note that
 937  * threads may decide to exit while @thread_func is running, so
 938  * without intimate knowledge about the lifetime of foreign threads,
 939  * @thread_func shouldn't access the GThread* pointer passed in as
 940  * first argument. However, @thread_func will not be called for threads
 941  * which are known to have exited already.
 942  *
 943  * Due to thread lifetime checks, this function has an execution complexity
 944  * which is quadratic in the number of existing threads.
 945  *
 946  * Since: 2.10
 947  */
 948 void
 949 g_thread_foreach (GFunc    thread_func,
 950                   gpointer user_data)
 951 {
 952   GSList *slist = NULL;
 953   GRealThread *thread;
 954   g_return_if_fail (thread_func != NULL);
 955   /* snapshot the list of threads for iteration */
 956   G_LOCK (g_thread);
 957   for (thread = g_thread_all_threads; thread; thread = thread->next)
 958     slist = g_slist_prepend (slist, thread);
 959   G_UNLOCK (g_thread);
 960   /* walk the list, skipping non-existant threads */
 961   while (slist)
 962     {
 963       GSList *node = slist;
 964       slist = node->next;
 965       /* check whether the current thread still exists */
 966       G_LOCK (g_thread);
 967       for (thread = g_thread_all_threads; thread; thread = thread->next)
 968         if (thread == node->data)
 969           break;
 970       G_UNLOCK (g_thread);
 971       if (thread)
 972         thread_func (thread, user_data);
 973       g_slist_free_1 (node);
 974     }
 975 }
 976
 977 /**
 978  * g_thread_get_initialized
 979  *
 980  * Indicates if g_thread_init() has been called.
 981  *
 982  * Returns: %TRUE if threads have been initialized.
 983  *
 984  * Since: 2.20
 985  */
 986 gboolean
 987 g_thread_get_initialized ()
 988 {
 989   return g_thread_supported ();
 990 }
 991
 992 #define __G_THREAD_C__
 993 #include "galiasdef.c"