]>
Commit | Line | Data |
---|---|---|
c23de0aa | 1 | /* Support functionality for using threads. |
d614a753 | 2 | Copyright (C) 2016-2020 Free Software Foundation, Inc. |
c23de0aa FW |
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 | |
5a82c748 | 17 | <https://www.gnu.org/licenses/>. */ |
c23de0aa FW |
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); | |
0ce2fa69 FW |
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); | |
faf0e9c8 FW |
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 *); | |
c23de0aa FW |
55 | void xpthread_mutex_lock (pthread_mutex_t *mutex); |
56 | void xpthread_mutex_unlock (pthread_mutex_t *mutex); | |
faf0e9c8 | 57 | void xpthread_mutex_consistent (pthread_mutex_t *); |
c23de0aa FW |
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); | |
5840c75c | 66 | void xpthread_once (pthread_once_t *guard, void (*func) (void)); |
f8bf15fe CD |
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); | |
bc79db3f SL |
71 | void xpthread_attr_setstack (pthread_attr_t *attr, void *stackaddr, |
72 | size_t stacksize); | |
f8bf15fe CD |
73 | void xpthread_attr_setstacksize (pthread_attr_t *attr, |
74 | size_t stacksize); | |
0edbf123 AZ |
75 | void xpthread_attr_setguardsize (pthread_attr_t *attr, |
76 | size_t guardsize); | |
c23de0aa | 77 | |
36ada9ee FW |
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 | ||
c23de0aa FW |
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 | ||
faf8c066 CD |
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); | |
5fc9ed4c | 97 | void xpthread_rwlock_destroy (pthread_rwlock_t *rwlock); |
a9bfa435 MD |
98 | pthread_key_t xpthread_key_create (void (*destr_function) (void *)); |
99 | void xpthread_key_delete (pthread_key_t key); | |
faf8c066 | 100 | |
c23de0aa FW |
101 | __END_DECLS |
102 | ||
103 | #endif /* SUPPORT_THREAD_H */ |