1 /* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * gthread.c: posix thread system implementation
5 * Copyright 1998 Sebastian Wilhelmi; University of Karlsruhe
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser 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.
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 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser 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.
24 * Modified by the GLib Team and others 1997-2000. See the AUTHORS
25 * file for a list of people on the GLib Team. See the ChangeLog
26 * files for a list of changes. These files are distributed with
27 * GLib at ftp://ftp.gtk.org/pub/gtk/.
30 /* The GMutex, GCond and GPrivate implementations in this file are some
31 * of the lowest-level code in GLib. All other parts of GLib (messages,
32 * memory, slices, etc) assume that they can freely use these facilities
33 * without risking recursion.
35 * As such, these functions are NOT permitted to call any other part of
38 * The thread manipulation functions (create, exit, join, etc.) have
39 * more freedom -- they can do as they please.
46 #include "gthreadprivate.h"
48 #include "gmessages.h"
49 #include "gstrfuncs.h"
57 #ifdef HAVE_SYS_TIME_H
58 # include <sys/time.h>
66 #ifdef HAVE_SYS_PRCTL_H
67 #include <sys/prctl.h>
71 g_thread_abort (gint status,
72 const gchar *function)
74 fprintf (stderr, "GLib (gthread-posix.c): Unexpected error from C library during '%s': %s. Aborting.\n",
75 strerror (status), function);
81 static pthread_mutex_t *
82 g_mutex_impl_new (void)
84 pthread_mutexattr_t *pattr = NULL;
85 pthread_mutex_t *mutex;
88 mutex = malloc (sizeof (pthread_mutex_t));
89 if G_UNLIKELY (mutex == NULL)
90 g_thread_abort (errno, "malloc");
92 #ifdef PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP
93 pthread_mutexattr_t attr;
94 pthread_mutexattr_init (&attr);
95 pthread_mutexattr_settype (&attr, PTHREAD_MUTEX_ADAPTIVE_NP);
99 if G_UNLIKELY ((status = pthread_mutex_init (mutex, pattr)) != 0)
100 g_thread_abort (status, "pthread_mutex_init");
102 #ifdef PTHREAD_ADAPTIVE_MUTEX_NP
103 pthread_mutexattr_destroy (&attr);
110 g_mutex_impl_free (pthread_mutex_t *mutex)
112 pthread_mutex_destroy (mutex);
116 static pthread_mutex_t *
117 g_mutex_get_impl (GMutex *mutex)
119 pthread_mutex_t *impl = mutex->p;
121 if G_UNLIKELY (impl == NULL)
123 impl = g_mutex_impl_new ();
124 if (!g_atomic_pointer_compare_and_exchange (&mutex->p, NULL, impl))
125 g_mutex_impl_free (impl);
135 * @mutex: an uninitialized #GMutex
137 * Initializes a #GMutex so that it can be used.
139 * This function is useful to initialize a mutex that has been
140 * allocated on the stack, or as part of a larger structure.
141 * It is not necessary to initialize a mutex that has been
142 * created with g_mutex_new() or that has been statically allocated.
152 * b = g_new (Blob, 1);
153 * g_mutex_init (&b->m);
156 * To undo the effect of g_mutex_init() when a mutex is no longer
157 * needed, use g_mutex_clear().
159 * Calling g_mutex_init() on an already initialized #GMutex leads
160 * to undefined behaviour.
165 g_mutex_init (GMutex *mutex)
167 mutex->p = g_mutex_impl_new ();
172 * @mutex: an initialized #GMutex
174 * Frees the resources allocated to a mutex with g_mutex_init().
176 * #GMutexes that have have been created with g_mutex_new() should
177 * be freed with g_mutex_free() instead.
179 * Calling g_mutex_clear() on a locked mutex leads to undefined
185 g_mutex_clear (GMutex *mutex)
187 g_mutex_impl_free (mutex->p);
194 * Locks @mutex. If @mutex is already locked by another thread, the
195 * current thread will block until @mutex is unlocked by the other
198 * This function can be used even if g_thread_init() has not yet been
199 * called, and, in that case, will do nothing.
201 * <note>#GMutex is neither guaranteed to be recursive nor to be
202 * non-recursive, i.e. a thread could deadlock while calling
203 * g_mutex_lock(), if it already has locked @mutex. Use
204 * #GRecMutex if you need recursive mutexes.</note>
207 g_mutex_lock (GMutex *mutex)
211 if G_UNLIKELY ((status = pthread_mutex_lock (g_mutex_get_impl (mutex))) != 0)
212 g_thread_abort (status, "pthread_mutex_lock");
219 * Unlocks @mutex. If another thread is blocked in a g_mutex_lock()
220 * call for @mutex, it will become unblocked and can lock @mutex itself.
222 * Calling g_mutex_unlock() on a mutex that is not locked by the
223 * current thread leads to undefined behaviour.
225 * This function can be used even if g_thread_init() has not yet been
226 * called, and, in that case, will do nothing.
229 g_mutex_unlock (GMutex *mutex)
233 if G_UNLIKELY ((status = pthread_mutex_unlock (g_mutex_get_impl (mutex))) != 0)
234 g_thread_abort (status, "pthread_mutex_lock");
241 * Tries to lock @mutex. If @mutex is already locked by another thread,
242 * it immediately returns %FALSE. Otherwise it locks @mutex and returns
245 * This function can be used even if g_thread_init() has not yet been
246 * called, and, in that case, will immediately return %TRUE.
248 * <note>#GMutex is neither guaranteed to be recursive nor to be
249 * non-recursive, i.e. the return value of g_mutex_trylock() could be
250 * both %FALSE or %TRUE, if the current thread already has locked
251 * @mutex. Use #GRecMutex if you need recursive mutexes.</note>
253 * Returns: %TRUE if @mutex could be locked
256 g_mutex_trylock (GMutex *mutex)
260 if G_LIKELY ((status = pthread_mutex_trylock (g_mutex_get_impl (mutex))) == 0)
263 if G_UNLIKELY (status != EBUSY)
264 g_thread_abort (status, "pthread_mutex_trylock");
271 static pthread_mutex_t *
272 g_rec_mutex_impl_new (void)
274 pthread_mutexattr_t attr;
275 pthread_mutex_t *mutex;
277 mutex = g_slice_new (pthread_mutex_t);
278 pthread_mutexattr_init (&attr);
279 pthread_mutexattr_settype (&attr, PTHREAD_MUTEX_RECURSIVE);
280 pthread_mutex_init (mutex, &attr);
281 pthread_mutexattr_destroy (&attr);
287 g_rec_mutex_impl_free (pthread_mutex_t *mutex)
289 pthread_mutex_destroy (mutex);
290 g_slice_free (pthread_mutex_t, mutex);
293 static pthread_mutex_t *
294 g_rec_mutex_get_impl (GRecMutex *rec_mutex)
296 pthread_mutex_t *impl = rec_mutex->p;
298 if G_UNLIKELY (impl == NULL)
300 impl = g_rec_mutex_impl_new ();
301 if (!g_atomic_pointer_compare_and_exchange (&rec_mutex->p, NULL, impl))
302 g_rec_mutex_impl_free (impl);
311 * @rec_mutex: an uninitialized #GRecMutex
313 * Initializes a #GRecMutex so that it can be used.
315 * This function is useful to initialize a recursive mutex
316 * that has been allocated on the stack, or as part of a larger
318 * It is not necessary to initialize a recursive mutex that has
319 * been created with g_rec_mutex_new(). It is not necessary to
320 * initialise a recursive mutex that has been statically allocated.
330 * b = g_new (Blob, 1);
331 * g_rec_mutex_init (&b->m);
334 * Calling g_rec_mutex_init() on an already initialized #GRecMutex
335 * leads to undefined behaviour.
337 * To undo the effect of g_rec_mutex_init() when a recursive mutex
338 * is no longer needed, use g_rec_mutex_clear().
343 g_rec_mutex_init (GRecMutex *rec_mutex)
345 rec_mutex->p = g_rec_mutex_impl_new ();
350 * @rec_mutex: an initialized #GRecMutex
352 * Frees the resources allocated to a recursive mutex with
353 * g_rec_mutex_init().
355 * #GRecMutexes that have have been created with g_rec_mutex_new()
356 * should be freed with g_rec_mutex_free() instead.
358 * Calling g_rec_mutex_clear() on a locked recursive mutex leads
359 * to undefined behaviour.
364 g_rec_mutex_clear (GRecMutex *rec_mutex)
366 g_rec_mutex_impl_free (rec_mutex->p);
371 * @rec_mutex: a #GRecMutex
373 * Locks @rec_mutex. If @rec_mutex is already locked by another
374 * thread, the current thread will block until @rec_mutex is
375 * unlocked by the other thread. If @rec_mutex is already locked
376 * by the current thread, the 'lock count' of @rec_mutex is increased.
377 * The mutex will only become available again when it is unlocked
378 * as many times as it has been locked.
383 g_rec_mutex_lock (GRecMutex *mutex)
385 pthread_mutex_lock (g_rec_mutex_get_impl (mutex));
389 * g_rec_mutex_unlock:
390 * @rec_mutex: a #RecGMutex
392 * Unlocks @rec_mutex. If another thread is blocked in a
393 * g_rec_mutex_lock() call for @rec_mutex, it will become unblocked
394 * and can lock @rec_mutex itself.
396 * Calling g_rec_mutex_unlock() on a recursive mutex that is not
397 * locked by the current thread leads to undefined behaviour.
402 g_rec_mutex_unlock (GRecMutex *rec_mutex)
404 pthread_mutex_unlock (rec_mutex->p);
408 * g_rec_mutex_trylock:
409 * @rec_mutex: a #GRecMutex
411 * Tries to lock @rec_mutex. If @rec_mutex is already locked
412 * by another thread, it immediately returns %FALSE. Otherwise
413 * it locks @rec_mutex and returns %TRUE.
415 * Returns: %TRUE if @rec_mutex could be locked
420 g_rec_mutex_trylock (GRecMutex *rec_mutex)
422 if (pthread_mutex_trylock (g_rec_mutex_get_impl (rec_mutex)) != 0)
430 static pthread_rwlock_t *
431 g_rw_lock_impl_new (void)
433 pthread_rwlock_t *rwlock;
436 rwlock = malloc (sizeof (pthread_rwlock_t));
437 if G_UNLIKELY (rwlock == NULL)
438 g_thread_abort (errno, "malloc");
440 if G_UNLIKELY ((status = pthread_rwlock_init (rwlock, NULL)) != 0)
441 g_thread_abort (status, "pthread_rwlock_init");
447 g_rw_lock_impl_free (pthread_rwlock_t *rwlock)
449 pthread_rwlock_destroy (rwlock);
453 static pthread_rwlock_t *
454 g_rw_lock_get_impl (GRWLock *lock)
456 pthread_rwlock_t *impl = lock->p;
458 if G_UNLIKELY (impl == NULL)
460 impl = g_rw_lock_impl_new ();
461 if (!g_atomic_pointer_compare_and_exchange (&lock->p, NULL, impl))
462 g_rw_lock_impl_free (impl);
471 * @rw_lock: an uninitialized #GRWLock
473 * Initializes a #GRWLock so that it can be used.
475 * This function is useful to initialize a lock that has been
476 * allocated on the stack, or as part of a larger structure. It is not
477 * necessary to initialise a reader-writer lock that has been statically
488 * b = g_new (Blob, 1);
489 * g_rw_lock_init (&b->l);
492 * To undo the effect of g_rw_lock_init() when a lock is no longer
493 * needed, use g_rw_lock_clear().
495 * Calling g_rw_lock_init() on an already initialized #GRWLock leads
496 * to undefined behaviour.
501 g_rw_lock_init (GRWLock *rw_lock)
503 rw_lock->p = g_rw_lock_impl_new ();
508 * @rw_lock: an initialized #GRWLock
510 * Frees the resources allocated to a lock with g_rw_lock_init().
512 * Calling g_rw_lock_clear() when any thread holds the lock
513 * leads to undefined behaviour.
518 g_rw_lock_clear (GRWLock *rw_lock)
520 g_rw_lock_impl_free (rw_lock->p);
524 * g_rw_lock_writer_lock:
525 * @rw_lock: a #GRWLock
527 * Obtain a write lock on @rw_lock. If any thread already holds
528 * a read or write lock on @rw_lock, the current thread will block
529 * until all other threads have dropped their locks on @rw_lock.
534 g_rw_lock_writer_lock (GRWLock *rw_lock)
536 pthread_rwlock_wrlock (g_rw_lock_get_impl (rw_lock));
540 * g_rw_lock_writer_trylock:
541 * @rw_lock: a #GRWLock
543 * Tries to obtain a write lock on @rw_lock. If any other thread holds
544 * a read or write lock on @rw_lock, it immediately returns %FALSE.
545 * Otherwise it locks @rw_lock and returns %TRUE.
547 * Returns: %TRUE if @rw_lock could be locked
552 g_rw_lock_writer_trylock (GRWLock *rw_lock)
554 if (pthread_rwlock_trywrlock (g_rw_lock_get_impl (rw_lock)) != 0)
561 * g_rw_lock_writer_unlock:
562 * @rw_lock: a #GRWLock
564 * Release a write lock on @rw_lock.
566 * Calling g_rw_lock_writer_unlock() on a lock that is not held
567 * by the current thread leads to undefined behaviour.
572 g_rw_lock_writer_unlock (GRWLock *rw_lock)
574 pthread_rwlock_unlock (g_rw_lock_get_impl (rw_lock));
578 * g_rw_lock_reader_lock:
579 * @rw_lock: a #GRWLock
581 * Obtain a read lock on @rw_lock. If another thread currently holds
582 * the write lock on @rw_lock or blocks waiting for it, the current
583 * thread will block. Read locks can be taken recursively.
585 * It is implementation-defined how many threads are allowed to
586 * hold read locks on the same lock simultaneously.
591 g_rw_lock_reader_lock (GRWLock *rw_lock)
593 pthread_rwlock_rdlock (g_rw_lock_get_impl (rw_lock));
597 * g_rw_lock_reader_trylock:
598 * @rw_lock: a #GRWLock
600 * Tries to obtain a read lock on @rw_lock and returns %TRUE if
601 * the read lock was successfully obtained. Otherwise it
604 * Returns: %TRUE if @rw_lock could be locked
609 g_rw_lock_reader_trylock (GRWLock *rw_lock)
611 if (pthread_rwlock_tryrdlock (g_rw_lock_get_impl (rw_lock)) != 0)
618 * g_rw_lock_reader_unlock:
619 * @rw_lock: a #GRWLock
621 * Release a read lock on @rw_lock.
623 * Calling g_rw_lock_reader_unlock() on a lock that is not held
624 * by the current thread leads to undefined behaviour.
629 g_rw_lock_reader_unlock (GRWLock *rw_lock)
631 pthread_rwlock_unlock (g_rw_lock_get_impl (rw_lock));
636 static pthread_cond_t *
637 g_cond_impl_new (void)
639 pthread_cond_t *cond;
642 cond = malloc (sizeof (pthread_cond_t));
643 if G_UNLIKELY (cond == NULL)
644 g_thread_abort (errno, "malloc");
646 if G_UNLIKELY ((status = pthread_cond_init (cond, NULL)) != 0)
647 g_thread_abort (status, "pthread_cond_init");
653 g_cond_impl_free (pthread_cond_t *cond)
655 pthread_cond_destroy (cond);
659 static pthread_cond_t *
660 g_cond_get_impl (GCond *cond)
662 pthread_cond_t *impl = cond->p;
664 if G_UNLIKELY (impl == NULL)
666 impl = g_cond_impl_new ();
667 if (!g_atomic_pointer_compare_and_exchange (&cond->p, NULL, impl))
668 g_cond_impl_free (impl);
677 * @cond: an uninitialized #GCond
679 * Initialized a #GCond so that it can be used.
681 * This function is useful to initialize a #GCond that has been
682 * allocated on the stack, or as part of a larger structure.
683 * It is not necessary to initialize a #GCond that has been
684 * created with g_cond_new() or that has been statically allocated.
686 * To undo the effect of g_cond_init() when a #GCond is no longer
687 * needed, use g_cond_clear().
689 * Calling g_cond_init() on an already initialized #GCond leads
690 * to undefined behaviour.
695 g_cond_init (GCond *cond)
697 cond->p = g_cond_impl_new ();
702 * @cond: an initialized #GCond
704 * Frees the resources allocated to a #GCond with g_cond_init().
706 * #GConds that have been created with g_cond_new() should
707 * be freed with g_cond_free() instead.
709 * Calling g_cond_clear() for a #GCond on which threads are
710 * blocking leads to undefined behaviour.
715 g_cond_clear (GCond *cond)
717 g_cond_impl_free (cond->p);
723 * @mutex: a #GMutex that is currently locked
725 * Waits until this thread is woken up on @cond. The @mutex is unlocked
726 * before falling asleep and locked again before resuming.
728 * This function can be used even if g_thread_init() has not yet been
729 * called, and, in that case, will immediately return.
732 g_cond_wait (GCond *cond,
737 if G_UNLIKELY ((status = pthread_cond_wait (g_cond_get_impl (cond), g_mutex_get_impl (mutex))) != 0)
738 g_thread_abort (status, "pthread_cond_wait");
745 * If threads are waiting for @cond, at least one of them is unblocked.
746 * If no threads are waiting for @cond, this function has no effect.
747 * It is good practice to hold the same lock as the waiting thread
748 * while calling this function, though not required.
750 * This function can be used even if g_thread_init() has not yet been
751 * called, and, in that case, will do nothing.
754 g_cond_signal (GCond *cond)
758 if G_UNLIKELY ((status = pthread_cond_signal (g_cond_get_impl (cond))) != 0)
759 g_thread_abort (status, "pthread_cond_signal");
766 * If threads are waiting for @cond, all of them are unblocked.
767 * If no threads are waiting for @cond, this function has no effect.
768 * It is good practice to lock the same mutex as the waiting threads
769 * while calling this function, though not required.
771 * This function can be used even if g_thread_init() has not yet been
772 * called, and, in that case, will do nothing.
775 g_cond_broadcast (GCond *cond)
779 if G_UNLIKELY ((status = pthread_cond_broadcast (g_cond_get_impl (cond))) != 0)
780 g_thread_abort (status, "pthread_cond_broadcast");
786 * @mutex: a #GMutex that is currently locked
787 * @abs_time: a #GTimeVal, determining the final time
789 * Waits until this thread is woken up on @cond, but not longer than
790 * until the time specified by @abs_time. The @mutex is unlocked before
791 * falling asleep and locked again before resuming.
793 * If @abs_time is %NULL, g_cond_timed_wait() acts like g_cond_wait().
795 * This function can be used even if g_thread_init() has not yet been
796 * called, and, in that case, will immediately return %TRUE.
798 * To easily calculate @abs_time a combination of g_get_current_time()
799 * and g_time_val_add() can be used.
801 * Returns: %TRUE if @cond was signalled, or %FALSE on timeout
804 g_cond_timed_wait (GCond *cond,
808 struct timespec end_time;
811 if (abs_time == NULL)
813 g_cond_wait (cond, mutex);
817 end_time.tv_sec = abs_time->tv_sec;
818 end_time.tv_nsec = abs_time->tv_usec * 1000;
820 if ((status = pthread_cond_timedwait (g_cond_get_impl (cond), g_mutex_get_impl (mutex), &end_time)) == 0)
823 if G_UNLIKELY (status != ETIMEDOUT)
824 g_thread_abort (status, "pthread_cond_timedwait");
832 * @mutex: a #GMutex that is currently locked
833 * @abs_time: the final time, in microseconds
835 * A variant of g_cond_timed_wait() that takes @abs_time
836 * as a #gint64 instead of a #GTimeVal.
837 * See g_cond_timed_wait() for details.
839 * Returns: %TRUE if @cond was signalled, or %FALSE on timeout
844 g_cond_timedwait (GCond *cond,
848 struct timespec end_time;
851 end_time.tv_sec = abs_time / 1000000;
852 end_time.tv_nsec = (abs_time % 1000000) * 1000;
854 if ((status = pthread_cond_timedwait (g_cond_get_impl (cond), g_mutex_get_impl (mutex), &end_time)) == 0)
857 if G_UNLIKELY (status != ETIMEDOUT)
858 g_thread_abort (status, "pthread_cond_timedwait");
868 * The #GPrivate struct is an opaque data structure to represent a
869 * thread-local data key. It is approximately equivalent to the
870 * pthread_setspecific()/pthread_getspecific() APIs on POSIX and to
871 * TlsSetValue()/TlsGetValue() on Windows.
873 * If you don't already know why you might want this functionality,
874 * then you probably don't need it.
876 * #GPrivate is a very limited resource (as far as 128 per program,
877 * shared between all libraries). It is also not possible to destroy a
878 * #GPrivate after it has been used. As such, it is only ever acceptable
879 * to use #GPrivate in static scope, and even then sparingly so.
881 * See G_PRIVATE_INIT() for a couple of examples.
883 * The #GPrivate structure should be considered opaque. It should only
884 * be accessed via the <function>g_private_</function> functions.
889 * @notify: a #GDestroyNotify
891 * A macro to assist with the static initialisation of a #GPrivate.
893 * This macro is useful for the case that a #GDestroyNotify function
894 * should be associated the key. This is needed when the key will be
895 * used to point at memory that should be deallocated when the thread
898 * Additionally, the #GDestroyNotify will also be called on the previous
899 * value stored in the key when g_private_replace() is used.
901 * If no #GDestroyNotify is needed, then use of this macro is not
902 * required -- if the #GPrivate is declared in static scope then it will
903 * be properly initialised by default (ie: to all zeros). See the
907 * static GPrivate name_key = G_PRIVATE_INIT (g_free);
909 * // return value should not be freed
911 * get_local_name (void)
913 * return g_private_get (&name_key);
917 * set_local_name (const gchar *name)
919 * g_private_replace (&name_key, g_strdup (name));
923 * static GPrivate count_key; // no free function
926 * get_local_count (void)
928 * return GPOINTER_TO_INT (g_private_get (&count_key));
932 * set_local_count (gint count)
934 * g_private_set (&count_key, GINT_TO_POINTER (count));
941 static pthread_key_t *
942 g_private_impl_new (GDestroyNotify notify)
947 key = malloc (sizeof (pthread_key_t));
948 if G_UNLIKELY (key == NULL)
949 g_thread_abort (errno, "malloc");
950 status = pthread_key_create (key, notify);
951 if G_UNLIKELY (status != 0)
952 g_thread_abort (status, "pthread_key_create");
958 g_private_impl_free (pthread_key_t *key)
962 status = pthread_key_delete (*key);
963 if G_UNLIKELY (status != 0)
964 g_thread_abort (status, "pthread_key_delete");
968 static pthread_key_t *
969 g_private_get_impl (GPrivate *key)
971 pthread_key_t *impl = key->p;
973 if G_UNLIKELY (impl == NULL)
975 impl = g_private_impl_new (key->notify);
976 if (!g_atomic_pointer_compare_and_exchange (&key->p, NULL, impl))
978 g_private_impl_free (impl);
990 * Returns the current value of the thread local variable @key.
992 * If the value has not yet been set in this thread, %NULL is returned.
993 * Values are never copied between threads (when a new thread is
994 * created, for example).
996 * Returns: the thread-local value
999 g_private_get (GPrivate *key)
1001 /* quote POSIX: No errors are returned from pthread_getspecific(). */
1002 return pthread_getspecific (*g_private_get_impl (key));
1008 * @value: the new value
1010 * Sets the thread local variable @key to have the value @value in the
1013 * This function differs from g_private_replace() in the following way:
1014 * the #GDestroyNotify for @key is not called on the old value.
1017 g_private_set (GPrivate *key,
1022 if G_UNLIKELY ((status = pthread_setspecific (*g_private_get_impl (key), value)) != 0)
1023 g_thread_abort (status, "pthread_setspecific");
1027 * g_private_replace:
1029 * @value: the new value
1031 * Sets the thread local variable @key to have the value @value in the
1034 * This function differs from g_private_set() in the following way: if
1035 * the previous value was non-%NULL then the #GDestroyNotify handler for
1036 * @key is run on it.
1041 g_private_replace (GPrivate *key,
1044 pthread_key_t *impl = g_private_get_impl (key);
1048 old = pthread_getspecific (*impl);
1049 if (old && key->notify)
1052 if G_UNLIKELY ((status = pthread_setspecific (*impl, value)) != 0)
1053 g_thread_abort (status, "pthread_setspecific");
1058 #define posix_check_err(err, name) G_STMT_START{ \
1059 int error = (err); \
1061 g_error ("file %s: line %d (%s): error '%s' during '%s'", \
1062 __FILE__, __LINE__, G_STRFUNC, \
1063 g_strerror (error), name); \
1066 #define posix_check_cmd(cmd) posix_check_err (cmd, #cmd)
1069 g_system_thread_create (GThreadFunc thread_func,
1076 pthread_attr_t attr;
1079 g_return_if_fail (thread_func);
1081 posix_check_cmd (pthread_attr_init (&attr));
1083 #ifdef HAVE_PTHREAD_ATTR_SETSTACKSIZE
1086 #ifdef _SC_THREAD_STACK_MIN
1087 stack_size = MAX (sysconf (_SC_THREAD_STACK_MIN), stack_size);
1088 #endif /* _SC_THREAD_STACK_MIN */
1089 /* No error check here, because some systems can't do it and
1090 * we simply don't want threads to fail because of that. */
1091 pthread_attr_setstacksize (&attr, stack_size);
1093 #endif /* HAVE_PTHREAD_ATTR_SETSTACKSIZE */
1095 posix_check_cmd (pthread_attr_setdetachstate (&attr,
1096 joinable ? PTHREAD_CREATE_JOINABLE : PTHREAD_CREATE_DETACHED));
1098 ret = pthread_create (thread, &attr, (void* (*)(void*))thread_func, arg);
1100 posix_check_cmd (pthread_attr_destroy (&attr));
1104 g_set_error (error, G_THREAD_ERROR, G_THREAD_ERROR_AGAIN,
1105 "Error creating thread: %s", g_strerror (ret));
1109 posix_check_err (ret, "pthread_create");
1115 * Causes the calling thread to voluntarily relinquish the CPU, so
1116 * that other threads can run.
1118 * This function is often used as a method to make busy wait less evil.
1119 * But in most cases you will encounter, there are better methods to do
1120 * that. So in general you shouldn't use this function.
1123 g_thread_yield (void)
1129 g_system_thread_join (gpointer thread)
1132 posix_check_cmd (pthread_join (*(pthread_t*)thread, &ignore));
1136 g_system_thread_exit (void)
1138 pthread_exit (NULL);
1142 g_system_thread_self (gpointer thread)
1144 *(pthread_t*)thread = pthread_self();
1148 g_system_thread_equal (gpointer thread1,
1151 return (pthread_equal (*(pthread_t*)thread1, *(pthread_t*)thread2) != 0);
1155 g_system_thread_set_name (const gchar *name)
1157 #ifdef HAVE_SYS_PRCTL_H
1158 prctl (PR_SET_NAME, name, 0, 0, 0, 0);
1163 /* vim:set foldmethod=marker: */