support/xthread.h

   1 /* Support functionality for using threads.
   2    Copyright (C) 2016-2020 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    <https://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_barrierattr_destroy (pthread_barrierattr_t *);
  45 void xpthread_barrierattr_init (pthread_barrierattr_t *);
  46 void xpthread_barrierattr_setpshared (pthread_barrierattr_t *, int pshared);
  47 void xpthread_mutexattr_destroy (pthread_mutexattr_t *);
  48 void xpthread_mutexattr_init (pthread_mutexattr_t *);
  49 void xpthread_mutexattr_setprotocol (pthread_mutexattr_t *, int);
  50 void xpthread_mutexattr_setpshared (pthread_mutexattr_t *, int);
  51 void xpthread_mutexattr_setrobust (pthread_mutexattr_t *, int);
  52 void xpthread_mutexattr_settype (pthread_mutexattr_t *, int);
  53 void xpthread_mutex_init (pthread_mutex_t *, const pthread_mutexattr_t *);
  54 void xpthread_mutex_destroy (pthread_mutex_t *);
  55 void xpthread_mutex_lock (pthread_mutex_t *mutex);
  56 void xpthread_mutex_unlock (pthread_mutex_t *mutex);
  57 void xpthread_mutex_consistent (pthread_mutex_t *);
  58 void xpthread_spin_lock (pthread_spinlock_t *lock);
  59 void xpthread_spin_unlock (pthread_spinlock_t *lock);
  60 void xpthread_cond_wait (pthread_cond_t * cond, pthread_mutex_t * mutex);
  61 pthread_t xpthread_create (pthread_attr_t *attr,
  62                            void *(*thread_func) (void *), void *closure);
  63 void xpthread_detach (pthread_t thr);
  64 void xpthread_cancel (pthread_t thr);
  65 void *xpthread_join (pthread_t thr);
  66 void xpthread_once (pthread_once_t *guard, void (*func) (void));
  67 void xpthread_attr_destroy (pthread_attr_t *attr);
  68 void xpthread_attr_init (pthread_attr_t *attr);
  69 void xpthread_attr_setdetachstate (pthread_attr_t *attr,
  70                                    int detachstate);
  71 void xpthread_attr_setstack (pthread_attr_t *attr, void *stackaddr,
  72                              size_t stacksize);
  73 void xpthread_attr_setstacksize (pthread_attr_t *attr,
  74                                  size_t stacksize);
  75 void xpthread_attr_setguardsize (pthread_attr_t *attr,
  76                                  size_t guardsize);
  77
  78 /* Set the stack size in ATTR to a small value, but still large enough
  79    to cover most internal glibc stack usage.  */
  80 void support_set_small_thread_stack_size (pthread_attr_t *attr);
  81
  82 /* Return a pointer to a thread attribute which requests a small
  83    stack.  The caller must not free this pointer.  */
  84 pthread_attr_t *support_small_stack_thread_attribute (void);
  85
  86 /* This function returns non-zero if pthread_barrier_wait returned
  87    PTHREAD_BARRIER_SERIAL_THREAD.  */
  88 int xpthread_barrier_wait (pthread_barrier_t *barrier);
  89
  90 void xpthread_rwlock_init (pthread_rwlock_t *rwlock,
  91                           const pthread_rwlockattr_t *attr);
  92 void xpthread_rwlockattr_init (pthread_rwlockattr_t *attr);
  93 void xpthread_rwlockattr_setkind_np (pthread_rwlockattr_t *attr, int pref);
  94 void xpthread_rwlock_wrlock (pthread_rwlock_t *rwlock);
  95 void xpthread_rwlock_rdlock (pthread_rwlock_t *rwlock);
  96 void xpthread_rwlock_unlock (pthread_rwlock_t *rwlock);
  97 void xpthread_rwlock_destroy (pthread_rwlock_t *rwlock);
  98 pthread_key_t xpthread_key_create (void (*destr_function) (void *));
  99 void xpthread_key_delete (pthread_key_t key);
 100
 101 __END_DECLS
 102
 103 #endif /* SUPPORT_THREAD_H */