gthread/gthread-posix.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: posix thread system implementation
   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 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.
  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  * Lesser General Public License for more details.
  16  *
  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.
  21  */
  22
  23 /*
  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/.
  28  */
  29
  30 /*
  31  * MT safe
  32  */
  33
  34 #include "config.h"
  35
  36 #include <pthread.h>
  37 #include <errno.h>
  38 #include <stdlib.h>
  39 #ifdef HAVE_SYS_TIME_H
  40 # include <sys/time.h>
  41 #endif
  42 #ifdef HAVE_UNISTD_H
  43 # include <unistd.h>
  44 #endif
  45
  46 #ifdef HAVE_SCHED_H
  47 #include <sched.h>
  48 #endif
  49
  50 #define posix_check_err(err, name) G_STMT_START{                        \
  51   int error = (err);                                                    \
  52   if (error)                                                            \
  53     g_error ("file %s: line %d (%s): error '%s' during '%s'",           \
  54            __FILE__, __LINE__, G_STRFUNC,                               \
  55            g_strerror (error), name);                                   \
  56   }G_STMT_END
  57
  58 #define posix_check_cmd(cmd) posix_check_err (posix_error (cmd), #cmd)
  59
  60 #ifdef G_ENABLE_DEBUG
  61 static gboolean posix_check_cmd_prio_warned = FALSE;
  62 # define posix_check_cmd_prio(cmd) G_STMT_START{                        \
  63     int err = posix_error (cmd);                                        \
  64     if (err == EPERM)                                                   \
  65       {                                                                 \
  66         if (!posix_check_cmd_prio_warned)                               \
  67           {                                                             \
  68             posix_check_cmd_prio_warned = TRUE;                         \
  69             g_warning ("Priorities can only be changed "                \
  70                         "(resp. increased) by root.");                  \
  71           }                                                             \
  72       }                                                                 \
  73     else                                                                \
  74       posix_check_err (err, #cmd);                                      \
  75      }G_STMT_END
  76 #else /* G_ENABLE_DEBUG */
  77 # define posix_check_cmd_prio(cmd) G_STMT_START{                        \
  78     int err = posix_error (cmd);                                        \
  79     if (err != EPERM)                                                   \
  80       posix_check_err (err, #cmd);                                      \
  81      }G_STMT_END
  82 #endif /* G_ENABLE_DEBUG */
  83
  84 #if defined(G_THREADS_IMPL_POSIX)
  85 # define posix_error(what) (what)
  86 # define mutexattr_default NULL
  87 # define condattr_default NULL
  88 #elif defined(G_THREADS_IMPL_DCE)
  89 # define posix_error(what) ((what) == -1 ? errno : 0)
  90 # define pthread_key_create(a, b) pthread_keycreate (a, b)
  91 # define pthread_attr_init(a) pthread_attr_create (a)
  92 # define pthread_attr_destroy(a) pthread_attr_delete (a)
  93 # define pthread_create(a, b, c, d) pthread_create (a, *b, c, d)
  94 # define mutexattr_default (pthread_mutexattr_default)
  95 # define condattr_default (pthread_condattr_default)
  96 #else /* neither G_THREADS_IMPL_POSIX nor G_THREADS_IMPL_DCE are defined */
  97 # error This should not happen. Contact the GLib team.
  98 #endif
  99
 100 #if defined (POSIX_MIN_PRIORITY) && defined (POSIX_MAX_PRIORITY)
 101 # define HAVE_PRIORITIES 1
 102 static gint priority_normal_value;
 103 # ifdef __FreeBSD__
 104    /* FreeBSD threads use different priority values from the POSIX_
 105     * defines so we just set them here. The corresponding macros
 106     * PTHREAD_MIN_PRIORITY and PTHREAD_MAX_PRIORITY are implied to be
 107     * exported by the docs, but they aren't.
 108     */
 109 #  define PRIORITY_LOW_VALUE      0
 110 #  define PRIORITY_URGENT_VALUE   31
 111 # else /* !__FreeBSD__ */
 112 #  define PRIORITY_LOW_VALUE      POSIX_MIN_PRIORITY
 113 #  define PRIORITY_URGENT_VALUE   POSIX_MAX_PRIORITY
 114 # endif /* !__FreeBSD__ */
 115 # define PRIORITY_NORMAL_VALUE    priority_normal_value
 116 #endif /* POSIX_MIN_PRIORITY && POSIX_MAX_PRIORITY */
 117
 118 static gulong g_thread_min_stack_size = 0;
 119
 120 #define G_MUTEX_SIZE (sizeof (pthread_mutex_t))
 121
 122 #if defined(HAVE_CLOCK_GETTIME) && defined(HAVE_MONOTONIC_CLOCK)
 123 #define USE_CLOCK_GETTIME 1
 124 static gint posix_clock = 0;
 125 #endif
 126
 127 #if defined(_SC_THREAD_STACK_MIN) || defined (HAVE_PRIORITIES) || defined (USE_CLOCK_GETTIME)
 128 #define HAVE_G_THREAD_IMPL_INIT
 129 static void
 130 g_thread_impl_init(void)
 131 {
 132 #ifdef _SC_THREAD_STACK_MIN
 133   g_thread_min_stack_size = MAX (sysconf (_SC_THREAD_STACK_MIN), 0);
 134 #endif /* _SC_THREAD_STACK_MIN */
 135 #ifdef HAVE_PRIORITIES
 136 # ifdef G_THREADS_IMPL_POSIX
 137   {
 138     struct sched_param sched;
 139     int policy;
 140     posix_check_cmd (pthread_getschedparam (pthread_self(), &policy, &sched));
 141     priority_normal_value = sched.sched_priority;
 142   }
 143 # else /* G_THREADS_IMPL_DCE */
 144   posix_check_cmd (priority_normal_value =
 145                    pthread_getprio (*(pthread_t*)thread,
 146                                     g_thread_priority_map [priority]));
 147 # endif
 148 #endif /* HAVE_PRIORITIES */
 149
 150 #ifdef USE_CLOCK_GETTIME
 151  if (sysconf (_SC_MONOTONIC_CLOCK) >= 0)
 152    posix_clock = CLOCK_MONOTONIC;
 153  else
 154    posix_clock = CLOCK_REALTIME;
 155 #endif
 156 }
 157 #endif /* _SC_THREAD_STACK_MIN || HAVE_PRIORITIES */
 158
 159 static GMutex *
 160 g_mutex_new_posix_impl (void)
 161 {
 162   GMutex *result = (GMutex *) g_new (pthread_mutex_t, 1);
 163   posix_check_cmd (pthread_mutex_init ((pthread_mutex_t *) result,
 164                                        mutexattr_default));
 165   return result;
 166 }
 167
 168 static void
 169 g_mutex_free_posix_impl (GMutex * mutex)
 170 {
 171   posix_check_cmd (pthread_mutex_destroy ((pthread_mutex_t *) mutex));
 172   g_free (mutex);
 173 }
 174
 175 /* NOTE: the functions g_mutex_lock and g_mutex_unlock may not use
 176    functions from gmem.c and gmessages.c; */
 177
 178 /* pthread_mutex_lock, pthread_mutex_unlock can be taken directly, as
 179    signature and semantic are right, but without error check then!!!!,
 180    we might want to change this therefore. */
 181
 182 static gboolean
 183 g_mutex_trylock_posix_impl (GMutex * mutex)
 184 {
 185   int result;
 186
 187   result = pthread_mutex_trylock ((pthread_mutex_t *) mutex);
 188
 189 #ifdef G_THREADS_IMPL_POSIX
 190   if (result == EBUSY)
 191     return FALSE;
 192 #else /* G_THREADS_IMPL_DCE */
 193   if (result == 0)
 194     return FALSE;
 195 #endif
 196
 197   posix_check_err (posix_error (result), "pthread_mutex_trylock");
 198   return TRUE;
 199 }
 200
 201 static GCond *
 202 g_cond_new_posix_impl (void)
 203 {
 204   GCond *result = (GCond *) g_new (pthread_cond_t, 1);
 205   posix_check_cmd (pthread_cond_init ((pthread_cond_t *) result,
 206                                       condattr_default));
 207   return result;
 208 }
 209
 210 /* pthread_cond_signal, pthread_cond_broadcast and pthread_cond_wait
 211    can be taken directly, as signature and semantic are right, but
 212    without error check then!!!!, we might want to change this
 213    therefore. */
 214
 215 #define G_NSEC_PER_SEC 1000000000
 216
 217 static gboolean
 218 g_cond_timed_wait_posix_impl (GCond * cond,
 219                               GMutex * entered_mutex,
 220                               GTimeVal * abs_time)
 221 {
 222   int result;
 223   struct timespec end_time;
 224   gboolean timed_out;
 225
 226   g_return_val_if_fail (cond != NULL, FALSE);
 227   g_return_val_if_fail (entered_mutex != NULL, FALSE);
 228
 229   if (!abs_time)
 230     {
 231       result = pthread_cond_wait ((pthread_cond_t *)cond,
 232                                   (pthread_mutex_t *) entered_mutex);
 233       timed_out = FALSE;
 234     }
 235   else
 236     {
 237       end_time.tv_sec = abs_time->tv_sec;
 238       end_time.tv_nsec = abs_time->tv_usec * (G_NSEC_PER_SEC / G_USEC_PER_SEC);
 239
 240       g_return_val_if_fail (end_time.tv_nsec < G_NSEC_PER_SEC, TRUE);
 241
 242       result = pthread_cond_timedwait ((pthread_cond_t *) cond,
 243                                        (pthread_mutex_t *) entered_mutex,
 244                                        &end_time);
 245 #ifdef G_THREADS_IMPL_POSIX
 246       timed_out = (result == ETIMEDOUT);
 247 #else /* G_THREADS_IMPL_DCE */
 248       timed_out = (result == -1) && (errno == EAGAIN);
 249 #endif
 250     }
 251
 252   if (!timed_out)
 253     posix_check_err (posix_error (result), "pthread_cond_timedwait");
 254
 255   return !timed_out;
 256 }
 257
 258 static void
 259 g_cond_free_posix_impl (GCond * cond)
 260 {
 261   posix_check_cmd (pthread_cond_destroy ((pthread_cond_t *) cond));
 262   g_free (cond);
 263 }
 264
 265 static GPrivate *
 266 g_private_new_posix_impl (GDestroyNotify destructor)
 267 {
 268   GPrivate *result = (GPrivate *) g_new (pthread_key_t, 1);
 269   posix_check_cmd (pthread_key_create ((pthread_key_t *) result, destructor));
 270   return result;
 271 }
 272
 273 /* NOTE: the functions g_private_get and g_private_set may not use
 274    functions from gmem.c and gmessages.c */
 275
 276 static void
 277 g_private_set_posix_impl (GPrivate * private_key, gpointer value)
 278 {
 279   if (!private_key)
 280     return;
 281   pthread_setspecific (*(pthread_key_t *) private_key, value);
 282 }
 283
 284 static gpointer
 285 g_private_get_posix_impl (GPrivate * private_key)
 286 {
 287   if (!private_key)
 288     return NULL;
 289 #ifdef G_THREADS_IMPL_POSIX
 290   return pthread_getspecific (*(pthread_key_t *) private_key);
 291 #else /* G_THREADS_IMPL_DCE */
 292   {
 293     void* data;
 294     posix_check_cmd (pthread_getspecific (*(pthread_key_t *) private_key,
 295                                           &data));
 296     return data;
 297   }
 298 #endif
 299 }
 300
 301 static void
 302 g_thread_create_posix_impl (GThreadFunc thread_func,
 303                             gpointer arg,
 304                             gulong stack_size,
 305                             gboolean joinable,
 306                             gboolean bound,
 307                             GThreadPriority priority,
 308                             gpointer thread,
 309                             GError **error)
 310 {
 311   pthread_attr_t attr;
 312   gint ret;
 313
 314   g_return_if_fail (thread_func);
 315   g_return_if_fail (priority >= G_THREAD_PRIORITY_LOW);
 316   g_return_if_fail (priority <= G_THREAD_PRIORITY_URGENT);
 317
 318   posix_check_cmd (pthread_attr_init (&attr));
 319
 320 #ifdef HAVE_PTHREAD_ATTR_SETSTACKSIZE
 321   if (stack_size)
 322     {
 323       stack_size = MAX (g_thread_min_stack_size, stack_size);
 324       /* No error check here, because some systems can't do it and
 325        * we simply don't want threads to fail because of that. */
 326       pthread_attr_setstacksize (&attr, stack_size);
 327     }
 328 #endif /* HAVE_PTHREAD_ATTR_SETSTACKSIZE */
 329
 330 #ifdef PTHREAD_SCOPE_SYSTEM
 331   if (bound)
 332     /* No error check here, because some systems can't do it and we
 333      * simply don't want threads to fail because of that. */
 334     pthread_attr_setscope (&attr, PTHREAD_SCOPE_SYSTEM);
 335 #endif /* PTHREAD_SCOPE_SYSTEM */
 336
 337 #ifdef G_THREADS_IMPL_POSIX
 338   posix_check_cmd (pthread_attr_setdetachstate (&attr,
 339           joinable ? PTHREAD_CREATE_JOINABLE : PTHREAD_CREATE_DETACHED));
 340 #endif /* G_THREADS_IMPL_POSIX */
 341
 342 #ifdef HAVE_PRIORITIES
 343 # ifdef G_THREADS_IMPL_POSIX
 344   {
 345     struct sched_param sched;
 346     posix_check_cmd (pthread_attr_getschedparam (&attr, &sched));
 347     sched.sched_priority = g_thread_priority_map [priority];
 348     posix_check_cmd_prio (pthread_attr_setschedparam (&attr, &sched));
 349   }
 350 # else /* G_THREADS_IMPL_DCE */
 351   posix_check_cmd_prio
 352     (pthread_attr_setprio (&attr, g_thread_priority_map [priority]));
 353 # endif /* G_THREADS_IMPL_DCE */
 354 #endif /* HAVE_PRIORITIES */
 355   ret = posix_error (pthread_create (thread, &attr,
 356                                      (void* (*)(void*))thread_func, arg));
 357
 358   posix_check_cmd (pthread_attr_destroy (&attr));
 359
 360   if (ret == EAGAIN)
 361     {
 362       g_set_error (error, G_THREAD_ERROR, G_THREAD_ERROR_AGAIN,
 363                    "Error creating thread: %s", g_strerror (ret));
 364       return;
 365     }
 366
 367   posix_check_err (ret, "pthread_create");
 368
 369 #ifdef G_THREADS_IMPL_DCE
 370   if (!joinable)
 371     posix_check_cmd (pthread_detach (thread));
 372 #endif /* G_THREADS_IMPL_DCE */
 373 }
 374
 375 static void
 376 g_thread_yield_posix_impl (void)
 377 {
 378   POSIX_YIELD_FUNC;
 379 }
 380
 381 static void
 382 g_thread_join_posix_impl (gpointer thread)
 383 {
 384   gpointer ignore;
 385   posix_check_cmd (pthread_join (*(pthread_t*)thread, &ignore));
 386 }
 387
 388 static void
 389 g_thread_exit_posix_impl (void)
 390 {
 391   pthread_exit (NULL);
 392 }
 393
 394 static void
 395 g_thread_set_priority_posix_impl (gpointer thread, GThreadPriority priority)
 396 {
 397   g_return_if_fail (priority >= G_THREAD_PRIORITY_LOW);
 398   g_return_if_fail (priority <= G_THREAD_PRIORITY_URGENT);
 399 #ifdef HAVE_PRIORITIES
 400 # ifdef G_THREADS_IMPL_POSIX
 401   {
 402     struct sched_param sched;
 403     int policy;
 404     posix_check_cmd (pthread_getschedparam (*(pthread_t*)thread, &policy,
 405                                             &sched));
 406     sched.sched_priority = g_thread_priority_map [priority];
 407     posix_check_cmd_prio (pthread_setschedparam (*(pthread_t*)thread, policy,
 408                                                  &sched));
 409   }
 410 # else /* G_THREADS_IMPL_DCE */
 411   posix_check_cmd_prio (pthread_setprio (*(pthread_t*)thread,
 412                                          g_thread_priority_map [priority]));
 413 # endif
 414 #endif /* HAVE_PRIORITIES */
 415 }
 416
 417 static void
 418 g_thread_self_posix_impl (gpointer thread)
 419 {
 420   *(pthread_t*)thread = pthread_self();
 421 }
 422
 423 static gboolean
 424 g_thread_equal_posix_impl (gpointer thread1, gpointer thread2)
 425 {
 426   return (pthread_equal (*(pthread_t*)thread1, *(pthread_t*)thread2) != 0);
 427 }
 428
 429 #ifdef USE_CLOCK_GETTIME
 430 static guint64
 431 gettime (void)
 432 {
 433   struct timespec tv;
 434
 435   clock_gettime (posix_clock, &tv);
 436
 437   return (guint64) tv.tv_sec * G_NSEC_PER_SEC + tv.tv_nsec;
 438 }
 439 static guint64 (*g_thread_gettime_impl)(void) = gettime;
 440 #else
 441 static guint64 (*g_thread_gettime_impl)(void) = 0;
 442 #endif
 443
 444 static GThreadFunctions g_thread_functions_for_glib_use_default =
 445 {
 446   g_mutex_new_posix_impl,
 447   (void (*)(GMutex *)) pthread_mutex_lock,
 448   g_mutex_trylock_posix_impl,
 449   (void (*)(GMutex *)) pthread_mutex_unlock,
 450   g_mutex_free_posix_impl,
 451   g_cond_new_posix_impl,
 452   (void (*)(GCond *)) pthread_cond_signal,
 453   (void (*)(GCond *)) pthread_cond_broadcast,
 454   (void (*)(GCond *, GMutex *)) pthread_cond_wait,
 455   g_cond_timed_wait_posix_impl,
 456   g_cond_free_posix_impl,
 457   g_private_new_posix_impl,
 458   g_private_get_posix_impl,
 459   g_private_set_posix_impl,
 460   g_thread_create_posix_impl,
 461   g_thread_yield_posix_impl,
 462   g_thread_join_posix_impl,
 463   g_thread_exit_posix_impl,
 464   g_thread_set_priority_posix_impl,
 465   g_thread_self_posix_impl,
 466   g_thread_equal_posix_impl
 467 };