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_mutex_lock (pthread_mutex_t *mutex);
  45 void xpthread_mutex_unlock (pthread_mutex_t *mutex);
  46 void xpthread_spin_lock (pthread_spinlock_t *lock);
  47 void xpthread_spin_unlock (pthread_spinlock_t *lock);
  48 void xpthread_cond_wait (pthread_cond_t * cond, pthread_mutex_t * mutex);
  49 pthread_t xpthread_create (pthread_attr_t *attr,
  50                            void *(*thread_func) (void *), void *closure);
  51 void xpthread_detach (pthread_t thr);
  52 void xpthread_cancel (pthread_t thr);
  53 void *xpthread_join (pthread_t thr);
  54 void xpthread_once (pthread_once_t *guard, void (*func) (void));
  55
  56 /* This function returns non-zero if pthread_barrier_wait returned
  57    PTHREAD_BARRIER_SERIAL_THREAD.  */
  58 int xpthread_barrier_wait (pthread_barrier_t *barrier);
  59
  60 __END_DECLS
  61
  62 #endif /* SUPPORT_THREAD_H */