support/xthread.h

   1 /* Support functionality for using threads.
   2    Copyright (C) 2016-2017 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, see
  17    <http://www.gnu.org/licenses/>.  */
  18
  19 #ifndef SUPPORT_THREAD_H
  20 #define SUPPORT_THREAD_H
  21
  22 #include <pthread.h>
  23 #include <sys/cdefs.h>
  24
  25 __BEGIN_DECLS
  26
  27 /* Terminate the process (with exit status 0) after SECONDS have
  28    elapsed, from a helper thread.  The process is terminated with the
  29    exit function, so atexit handlers are executed.  */
  30 void delayed_exit (int seconds);
  31
  32 /* Terminate the process (with exit status 1) if VALUE is not zero.
  33    In that case, print a failure message to standard output mentioning
  34    FUNCTION.  The process is terminated with the exit function, so
  35    atexit handlers are executed.  */
  36 void xpthread_check_return (const char *function, int value);
  37
  38 /* The following functions call the corresponding libpthread functions
  39    and terminate the process on error.  */
  40
  41 void xpthread_barrier_init (pthread_barrier_t *barrier,
  42                             pthread_barrierattr_t *attr, unsigned int count);
  43 void xpthread_barrier_destroy (pthread_barrier_t *barrier);
  44 void xpthread_mutexattr_destroy (pthread_mutexattr_t *);
  45 void xpthread_mutexattr_init (pthread_mutexattr_t *);
  46 void xpthread_mutexattr_setprotocol (pthread_mutexattr_t *, int);
  47 void xpthread_mutexattr_setpshared (pthread_mutexattr_t *, int);
  48 void xpthread_mutexattr_setrobust (pthread_mutexattr_t *, int);
  49 void xpthread_mutexattr_settype (pthread_mutexattr_t *, int);
  50 void xpthread_mutex_init (pthread_mutex_t *, const pthread_mutexattr_t *);
  51 void xpthread_mutex_destroy (pthread_mutex_t *);
  52 void xpthread_mutex_lock (pthread_mutex_t *mutex);
  53 void xpthread_mutex_unlock (pthread_mutex_t *mutex);
  54 void xpthread_mutex_consistent (pthread_mutex_t *);
  55 void xpthread_spin_lock (pthread_spinlock_t *lock);
  56 void xpthread_spin_unlock (pthread_spinlock_t *lock);
  57 void xpthread_cond_wait (pthread_cond_t * cond, pthread_mutex_t * mutex);
  58 pthread_t xpthread_create (pthread_attr_t *attr,
  59                            void *(*thread_func) (void *), void *closure);
  60 void xpthread_detach (pthread_t thr);
  61 void xpthread_cancel (pthread_t thr);
  62 void *xpthread_join (pthread_t thr);
  63 void xpthread_once (pthread_once_t *guard, void (*func) (void));
  64 void xpthread_attr_destroy (pthread_attr_t *attr);
  65 void xpthread_attr_init (pthread_attr_t *attr);
  66 void xpthread_attr_setdetachstate (pthread_attr_t *attr,
  67                                    int detachstate);
  68 void xpthread_attr_setstacksize (pthread_attr_t *attr,
  69                                  size_t stacksize);
  70 void xpthread_attr_setguardsize (pthread_attr_t *attr,
  71                                  size_t guardsize);
  72
  73 /* This function returns non-zero if pthread_barrier_wait returned
  74    PTHREAD_BARRIER_SERIAL_THREAD.  */
  75 int xpthread_barrier_wait (pthread_barrier_t *barrier);
  76
  77 void xpthread_rwlock_init (pthread_rwlock_t *rwlock,
  78                           const pthread_rwlockattr_t *attr);
  79 void xpthread_rwlockattr_init (pthread_rwlockattr_t *attr);
  80 void xpthread_rwlockattr_setkind_np (pthread_rwlockattr_t *attr, int pref);
  81 void xpthread_rwlock_wrlock (pthread_rwlock_t *rwlock);
  82 void xpthread_rwlock_rdlock (pthread_rwlock_t *rwlock);
  83 void xpthread_rwlock_unlock (pthread_rwlock_t *rwlock);
  84
  85 __END_DECLS
  86
  87 #endif /* SUPPORT_THREAD_H */