]> git.ipfire.org Git - thirdparty/glibc.git/blame - nptl/pthreadP.h
projects / thirdparty / glibc.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Rename sys/ucontext.h to bits/ucontext.h.
[thirdparty/glibc.git] / nptl / pthreadP.h
CommitLineData
d614a753 1/* Copyright (C) 2002-2020 Free Software Foundation, Inc.
76a50749
UD		 2 This file is part of the GNU C Library.
3 Contributed by Ulrich Drepper <drepper@redhat.com>, 2002.
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
59ba27a6 16 License along with the GNU C Library; if not, see
5a82c748 17 <https://www.gnu.org/licenses/>. */
76a50749
UD		 18
19#ifndef _PTHREADP_H
20#define _PTHREADP_H 1
21
22#include <pthread.h>
23#include <setjmp.h>
b758b9cb 24#include <stdbool.h>
76a50749
UD		 25#include <sys/syscall.h>
26#include "descr.h"
27#include <tls.h>
28#include <lowlevellock.h>
29#include <stackinfo.h>
30#include <internaltypes.h>
73e9ae88 31#include <pthread-functions.h>
86246935 32#include <atomic.h>
0f6699ea 33#include <kernel-features.h>
da1304bc 34#include <errno.h>
92aabad9 35#include <internal-signals.h>
6310e6be 36#include "pthread_mutex_conf.h"
23fe486b 37
76a50749 38
a1b5424f
UD		 39/* Atomic operations on TLS memory. */
40#ifndef THREAD_ATOMIC_CMPXCHG_VAL
41# define THREAD_ATOMIC_CMPXCHG_VAL(descr, member, new, old) \
42 atomic_compare_and_exchange_val_acq (&(descr)->member, new, old)
43#endif
44
45#ifndef THREAD_ATOMIC_BIT_SET
46# define THREAD_ATOMIC_BIT_SET(descr, member, bit) \
47 atomic_bit_set (&(descr)->member, bit)
48#endif
49
50
6310e6be
KW		 51static inline short max_adaptive_count (void)
52{
53#if HAVE_TUNABLES
54 return __mutex_aconf.spin_count;
55#else
56 return DEFAULT_ADAPTIVE_COUNT;
2c0b891a 57#endif
6310e6be 58}
2c0b891a
UD		 59
60
1bcfb5a5 61/* Magic cookie representing robust mutex with dead owner. */
683040c3 62#define PTHREAD_MUTEX_INCONSISTENT INT_MAX
1bcfb5a5
UD		 63/* Magic cookie representing not recoverable robust mutex. */
64#define PTHREAD_MUTEX_NOTRECOVERABLE (INT_MAX - 1)
65
66
67/* Internal mutex type value. */
68enum
69{
df47504c 70 PTHREAD_MUTEX_KIND_MASK_NP = 3,
b023e4ca
AK		 71
72 PTHREAD_MUTEX_ELISION_NP = 256,
73 PTHREAD_MUTEX_NO_ELISION_NP = 512,
74
0f6699ea
UD		 75 PTHREAD_MUTEX_ROBUST_NORMAL_NP = 16,
76 PTHREAD_MUTEX_ROBUST_RECURSIVE_NP
77 = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_RECURSIVE_NP,
78 PTHREAD_MUTEX_ROBUST_ERRORCHECK_NP
79 = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
80 PTHREAD_MUTEX_ROBUST_ADAPTIVE_NP
81 = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_ADAPTIVE_NP,
df47504c
UD		 82 PTHREAD_MUTEX_PRIO_INHERIT_NP = 32,
83 PTHREAD_MUTEX_PI_NORMAL_NP
84 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_NORMAL,
85 PTHREAD_MUTEX_PI_RECURSIVE_NP
86 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_RECURSIVE_NP,
87 PTHREAD_MUTEX_PI_ERRORCHECK_NP
88 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
89 PTHREAD_MUTEX_PI_ADAPTIVE_NP
90 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ADAPTIVE_NP,
91 PTHREAD_MUTEX_PI_ROBUST_NORMAL_NP
92 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_NORMAL_NP,
93 PTHREAD_MUTEX_PI_ROBUST_RECURSIVE_NP
94 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_RECURSIVE_NP,
95 PTHREAD_MUTEX_PI_ROBUST_ERRORCHECK_NP
96 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_ERRORCHECK_NP,
97 PTHREAD_MUTEX_PI_ROBUST_ADAPTIVE_NP
98 = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_ADAPTIVE_NP,
f17efcb4
UD		 99 PTHREAD_MUTEX_PRIO_PROTECT_NP = 64,
100 PTHREAD_MUTEX_PP_NORMAL_NP
101 = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_NORMAL,
102 PTHREAD_MUTEX_PP_RECURSIVE_NP
103 = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_RECURSIVE_NP,
104 PTHREAD_MUTEX_PP_ERRORCHECK_NP
105 = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
106 PTHREAD_MUTEX_PP_ADAPTIVE_NP
b023e4ca
AK		 107 = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_ADAPTIVE_NP,
108 PTHREAD_MUTEX_ELISION_FLAGS_NP
109 = PTHREAD_MUTEX_ELISION_NP | PTHREAD_MUTEX_NO_ELISION_NP,
110
111 PTHREAD_MUTEX_TIMED_ELISION_NP =
112 PTHREAD_MUTEX_TIMED_NP | PTHREAD_MUTEX_ELISION_NP,
113 PTHREAD_MUTEX_TIMED_NO_ELISION_NP =
114 PTHREAD_MUTEX_TIMED_NP | PTHREAD_MUTEX_NO_ELISION_NP,
1bcfb5a5 115};
5bd8a249 116#define PTHREAD_MUTEX_PSHARED_BIT 128
f17efcb4 117
403b4feb
SL		 118/* See concurrency notes regarding __kind in struct __pthread_mutex_s
119 in sysdeps/nptl/bits/thread-shared-types.h. */
ae1ad3ae 120#define PTHREAD_MUTEX_TYPE(m) \
403b4feb 121 (atomic_load_relaxed (&((m)->__data.__kind)) & 127)
e8c659d7
AK		 122/* Don't include NO_ELISION, as that type is always the same
123 as the underlying lock type. */
b023e4ca 124#define PTHREAD_MUTEX_TYPE_ELISION(m) \
403b4feb
SL		 125 (atomic_load_relaxed (&((m)->__data.__kind)) \
126 & (127 | PTHREAD_MUTEX_ELISION_NP))
5bd8a249
UD		 127
128#if LLL_PRIVATE == 0 && LLL_SHARED == 128
129# define PTHREAD_MUTEX_PSHARED(m) \
403b4feb 130 (atomic_load_relaxed (&((m)->__data.__kind)) & 128)
5bd8a249
UD		 131#else
132# define PTHREAD_MUTEX_PSHARED(m) \
403b4feb
SL		 133 ((atomic_load_relaxed (&((m)->__data.__kind)) & 128) \
134 ? LLL_SHARED : LLL_PRIVATE)
5bd8a249
UD		 135#endif
136
137/* The kernel when waking robust mutexes on exit never uses
138 FUTEX_PRIVATE_FLAG FUTEX_WAKE. */
139#define PTHREAD_ROBUST_MUTEX_PSHARED(m) LLL_SHARED
ae1ad3ae 140
f17efcb4
UD		 141/* Ceiling in __data.__lock. __data.__lock is signed, so don't
142 use the MSB bit in there, but in the mask also include that bit,
143 so that the compiler can optimize & PTHREAD_MUTEX_PRIO_CEILING_MASK
144 masking if the value is then shifted down by
145 PTHREAD_MUTEX_PRIO_CEILING_SHIFT. */
146#define PTHREAD_MUTEX_PRIO_CEILING_SHIFT 19
147#define PTHREAD_MUTEX_PRIO_CEILING_MASK 0xfff80000
1bcfb5a5
UD		 148
149
150/* Flags in mutex attr. */
a5f2bd86
RM		 151#define PTHREAD_MUTEXATTR_PROTOCOL_SHIFT 28
152#define PTHREAD_MUTEXATTR_PROTOCOL_MASK 0x30000000
f17efcb4
UD		 153#define PTHREAD_MUTEXATTR_PRIO_CEILING_SHIFT 12
154#define PTHREAD_MUTEXATTR_PRIO_CEILING_MASK 0x00fff000
a5f2bd86
RM		 155#define PTHREAD_MUTEXATTR_FLAG_ROBUST 0x40000000
156#define PTHREAD_MUTEXATTR_FLAG_PSHARED 0x80000000
1bcfb5a5 157#define PTHREAD_MUTEXATTR_FLAG_BITS \
a5f2bd86
RM		 158 (PTHREAD_MUTEXATTR_FLAG_ROBUST | PTHREAD_MUTEXATTR_FLAG_PSHARED \
159 | PTHREAD_MUTEXATTR_PROTOCOL_MASK | PTHREAD_MUTEXATTR_PRIO_CEILING_MASK)
1bcfb5a5
UD		 160
161
cc25c8b4
TR		 162/* For the following, see pthread_rwlock_common.c. */
163#define PTHREAD_RWLOCK_WRPHASE 1
164#define PTHREAD_RWLOCK_WRLOCKED 2
165#define PTHREAD_RWLOCK_RWAITING 4
166#define PTHREAD_RWLOCK_READER_SHIFT 3
167#define PTHREAD_RWLOCK_READER_OVERFLOW ((unsigned int) 1 \
168 << (sizeof (unsigned int) * 8 - 1))
169#define PTHREAD_RWLOCK_WRHANDOVER ((unsigned int) 1 \
170 << (sizeof (unsigned int) * 8 - 1))
171#define PTHREAD_RWLOCK_FUTEX_USED 2
546346b6
UD		 172
173
683040c3
UD		 174/* Bits used in robust mutex implementation. */
175#define FUTEX_WAITERS 0x80000000
176#define FUTEX_OWNER_DIED 0x40000000
2035d91c 177#define FUTEX_TID_MASK 0x3fffffff
683040c3
UD		 178
179
63668b70
TR		 180/* pthread_once definitions. See __pthread_once for how these are used. */
181#define __PTHREAD_ONCE_INPROGRESS 1
182#define __PTHREAD_ONCE_DONE 2
183#define __PTHREAD_ONCE_FORK_GEN_INCR 4
184
ce7528f6
AZ		 185/* Attribute to indicate thread creation was issued from C11 thrd_create. */
186#define ATTR_C11_THREAD ((void*)(uintptr_t)-1)
187
63668b70 188
ed19993b
TR		 189/* Condition variable definitions. See __pthread_cond_wait_common.
190 Need to be defined here so there is one place from which
191 nptl_lock_constants can grab them. */
192#define __PTHREAD_COND_CLOCK_MONOTONIC_MASK 2
193#define __PTHREAD_COND_SHARED_MASK 1
194
195
76a50749
UD		 196/* Internal variables. */
197
198
e903a713
SP		 199/* Default pthread attributes. */
200extern struct pthread_attr __default_pthread_attr attribute_hidden;
61dd6208 201extern int __default_pthread_attr_lock attribute_hidden;
76a50749
UD		 202
203/* Size and alignment of static TLS block. */
204extern size_t __static_tls_size attribute_hidden;
bc6389ad 205extern size_t __static_tls_align_m1 attribute_hidden;
76a50749 206
2c0b891a
UD		 207/* Flag whether the machine is SMP or not. */
208extern int __is_smp attribute_hidden;
209
76a50749 210/* Thread descriptor handling. */
fa9a4ff0
RM		 211extern list_t __stack_user;
212hidden_proto (__stack_user)
76a50749
UD		 213
214/* Attribute handling. */
215extern struct pthread_attr *__attr_list attribute_hidden;
e51deae7 216extern int __attr_list_lock attribute_hidden;
76a50749 217
76a50749
UD		 218/* Concurrency handling. */
219extern int __concurrency_level attribute_hidden;
220
221/* Thread-local data key handling. */
fa9a4ff0
RM		 222extern struct pthread_key_struct __pthread_keys[PTHREAD_KEYS_MAX];
223hidden_proto (__pthread_keys)
76a50749 224
47202270
UD		 225/* Number of threads running. */
226extern unsigned int __nptl_nthreads attribute_hidden;
227
0f6699ea
UD		 228#ifndef __ASSUME_SET_ROBUST_LIST
229/* Negative if we do not have the system call and we can use it. */
230extern int __set_robust_list_avail attribute_hidden;
231#endif
232
f17efcb4
UD		 233/* Thread Priority Protection. */
234extern int __sched_fifo_min_prio attribute_hidden;
235extern int __sched_fifo_max_prio attribute_hidden;
236extern void __init_sched_fifo_prio (void) attribute_hidden;
237extern int __pthread_tpp_change_priority (int prev_prio, int new_prio)
238 attribute_hidden;
239extern int __pthread_current_priority (void) attribute_hidden;
240
76a50749
UD		 241/* The library can run in debugging mode where it performs a lot more
242 tests. */
243extern int __pthread_debug attribute_hidden;
729924a0
UD		 244/** For now disable debugging support. */
245#if 0
246# define DEBUGGING_P __builtin_expect (__pthread_debug, 0)
8c2e9a29
UD		 247# define INVALID_TD_P(pd) (DEBUGGING_P && __find_in_stack_list (pd) == NULL)
248# define INVALID_NOT_TERMINATED_TD_P(pd) INVALID_TD_P (pd)
729924a0
UD		 249#else
250# define DEBUGGING_P 0
8c2e9a29
UD		 251/* Simplified test. This will not catch all invalid descriptors but
252 is better than nothing. And if the test triggers the thread
253 descriptor is guaranteed to be invalid. */
254# define INVALID_TD_P(pd) __builtin_expect ((pd)->tid <= 0, 0)
255# define INVALID_NOT_TERMINATED_TD_P(pd) __builtin_expect ((pd)->tid < 0, 0)
729924a0 256#endif
76a50749
UD		 257
258
259/* Cancellation test. */
260#define CANCELLATION_P(self) \
261 do { \
262 int cancelhandling = THREAD_GETMEM (self, cancelhandling); \
263 if (CANCEL_ENABLED_AND_CANCELED (cancelhandling)) \
264 { \
265 THREAD_SETMEM (self, result, PTHREAD_CANCELED); \
9ae0909b 266 __do_cancel (); \
76a50749
UD		 267 } \
268 } while (0)
269
6efd4814
UD		 270
271extern void __pthread_unwind (__pthread_unwind_buf_t *__buf)
272 __cleanup_fct_attribute __attribute ((__noreturn__))
ce9f10f7 273#if !defined SHARED && !IS_IN (libpthread)
6efd4814
UD		 274 weak_function
275#endif
276 ;
da0c02ee
UD		 277extern void __pthread_unwind_next (__pthread_unwind_buf_t *__buf)
278 __cleanup_fct_attribute __attribute ((__noreturn__))
279#ifndef SHARED
280 weak_function
281#endif
282 ;
283extern void __pthread_register_cancel (__pthread_unwind_buf_t *__buf)
284 __cleanup_fct_attribute;
285extern void __pthread_unregister_cancel (__pthread_unwind_buf_t *__buf)
286 __cleanup_fct_attribute;
ce9f10f7 287#if IS_IN (libpthread)
56421b23 288hidden_proto (__pthread_unwind)
da0c02ee
UD		 289hidden_proto (__pthread_unwind_next)
290hidden_proto (__pthread_register_cancel)
291hidden_proto (__pthread_unregister_cancel)
9d79e037
UD		 292# ifdef SHARED
293extern void attribute_hidden pthread_cancel_init (void);
294# endif
2827ab99 295extern void __nptl_unwind_freeres (void) attribute_hidden;
56421b23
UD		 296#endif
297
6efd4814
UD		 298
299/* Called when a thread reacts on a cancellation request. */
300static inline void
dd9423a6 301__attribute ((noreturn, always_inline))
6efd4814
UD		 302__do_cancel (void)
303{
304 struct pthread *self = THREAD_SELF;
305
306 /* Make sure we get no more cancellations. */
307 THREAD_ATOMIC_BIT_SET (self, cancelhandling, EXITING_BIT);
308
309 __pthread_unwind ((__pthread_unwind_buf_t *)
310 THREAD_GETMEM (self, cleanup_jmp_buf));
311}
312
313
76a50749
UD		 314/* Internal prototypes. */
315
316/* Thread list handling. */
317extern struct pthread *__find_in_stack_list (struct pthread *pd)
83b09837 318 attribute_hidden;
76a50749
UD		 319
320/* Deallocate a thread's stack after optionally making sure the thread
321 descriptor is still valid. */
83b09837 322extern void __free_tcb (struct pthread *pd) attribute_hidden;
76a50749
UD		 323
324/* Free allocated stack. */
83b09837 325extern void __deallocate_stack (struct pthread *pd) attribute_hidden;
76a50749
UD		 326
327/* Mark all the stacks except for the current one as available. This
328 function also re-initializes the lock for the stack cache. */
329extern void __reclaim_stacks (void) attribute_hidden;
330
54ee14b3 331/* Make all threads's stacks executable. */
e1d2ae8d 332extern int __make_stacks_executable (void **stack_endp) attribute_hidden;
54ee14b3 333
76a50749
UD		 334/* longjmp handling. */
335extern void __pthread_cleanup_upto (__jmp_buf target, char *targetframe);
ce9f10f7 336#if IS_IN (libpthread)
334fcf2a
UD		 337hidden_proto (__pthread_cleanup_upto)
338#endif
76a50749
UD		 339
340
341/* Functions with versioned interfaces. */
342extern int __pthread_create_2_1 (pthread_t *newthread,
343 const pthread_attr_t *attr,
344 void *(*start_routine) (void *), void *arg);
345extern int __pthread_create_2_0 (pthread_t *newthread,
346 const pthread_attr_t *attr,
347 void *(*start_routine) (void *), void *arg);
348extern int __pthread_attr_init_2_1 (pthread_attr_t *attr);
349extern int __pthread_attr_init_2_0 (pthread_attr_t *attr);
350
351
352/* Event handlers for libthread_db interface. */
fa9a4ff0
RM		 353extern void __nptl_create_event (void);
354extern void __nptl_death_event (void);
355hidden_proto (__nptl_create_event)
356hidden_proto (__nptl_death_event)
76a50749 357
8454830b 358/* Register the generation counter in the libpthread with the libc. */
5a03acfe 359#ifdef TLS_MULTIPLE_THREADS_IN_TCB
8454830b
UD		 360extern void __libc_pthread_init (unsigned long int *ptr,
361 void (*reclaim) (void),
83b09837 362 const struct pthread_functions *functions);
5a03acfe
UD		 363#else
364extern int *__libc_pthread_init (unsigned long int *ptr,
365 void (*reclaim) (void),
83b09837 366 const struct pthread_functions *functions);
5a03acfe 367
439bf404
SP		 368/* Variable set to a nonzero value either if more than one thread runs or ran,
369 or if a single-threaded process is trying to cancel itself. See
370 nptl/descr.h for more context on the single-threaded process case. */
5a03acfe
UD		 371extern int __pthread_multiple_threads attribute_hidden;
372/* Pointer to the corresponding variable in libc. */
373extern int *__libc_multiple_threads_ptr attribute_hidden;
374#endif
8454830b 375
adc12574
UD		 376extern void __pthread_init_static_tls (struct link_map *) attribute_hidden;
377
2c1094bd 378extern size_t __pthread_get_minstack (const pthread_attr_t *attr);
76a50749
UD		 379
380/* Namespace save aliases. */
8454830b
UD		 381extern int __pthread_getschedparam (pthread_t thread_id, int *policy,
382 struct sched_param *param);
383extern int __pthread_setschedparam (pthread_t thread_id, int policy,
384 const struct sched_param *param);
385extern int __pthread_setcancelstate (int state, int *oldstate);
76a50749 386extern int __pthread_mutex_init (pthread_mutex_t *__mutex,
a784e502 387 const pthread_mutexattr_t *__mutexattr);
76a50749
UD		 388extern int __pthread_mutex_destroy (pthread_mutex_t *__mutex);
389extern int __pthread_mutex_trylock (pthread_mutex_t *_mutex);
390extern int __pthread_mutex_lock (pthread_mutex_t *__mutex);
fa872e1b
AZ		 391extern int __pthread_mutex_timedlock (pthread_mutex_t *__mutex,
392 const struct timespec *__abstime);
69431c9a 393extern int __pthread_mutex_cond_lock (pthread_mutex_t *__mutex)
83b09837 394 attribute_hidden;
b0948ffd 395extern void __pthread_mutex_cond_lock_adjust (pthread_mutex_t *__mutex)
83b09837 396 attribute_hidden;
76a50749 397extern int __pthread_mutex_unlock (pthread_mutex_t *__mutex);
b758b9cb 398extern int __pthread_mutex_unlock_usercnt (pthread_mutex_t *__mutex,
83b09837 399 int __decr) attribute_hidden;
76a50749
UD		 400extern int __pthread_mutexattr_init (pthread_mutexattr_t *attr);
401extern int __pthread_mutexattr_destroy (pthread_mutexattr_t *attr);
402extern int __pthread_mutexattr_settype (pthread_mutexattr_t *attr, int kind);
8454830b
UD		 403extern int __pthread_attr_destroy (pthread_attr_t *attr);
404extern int __pthread_attr_getdetachstate (const pthread_attr_t *attr,
405 int *detachstate);
406extern int __pthread_attr_setdetachstate (pthread_attr_t *attr,
407 int detachstate);
408extern int __pthread_attr_getinheritsched (const pthread_attr_t *attr,
409 int *inherit);
410extern int __pthread_attr_setinheritsched (pthread_attr_t *attr, int inherit);
411extern int __pthread_attr_getschedparam (const pthread_attr_t *attr,
412 struct sched_param *param);
413extern int __pthread_attr_setschedparam (pthread_attr_t *attr,
414 const struct sched_param *param);
415extern int __pthread_attr_getschedpolicy (const pthread_attr_t *attr,
416 int *policy);
417extern int __pthread_attr_setschedpolicy (pthread_attr_t *attr, int policy);
418extern int __pthread_attr_getscope (const pthread_attr_t *attr, int *scope);
419extern int __pthread_attr_setscope (pthread_attr_t *attr, int scope);
a784e502 420extern int __pthread_attr_getstackaddr (const pthread_attr_t *__restrict
76a50749
UD		 421 __attr, void **__restrict __stackaddr);
422extern int __pthread_attr_setstackaddr (pthread_attr_t *__attr,
423 void *__stackaddr);
a784e502 424extern int __pthread_attr_getstacksize (const pthread_attr_t *__restrict
76a50749
UD		 425 __attr,
426 size_t *__restrict __stacksize);
427extern int __pthread_attr_setstacksize (pthread_attr_t *__attr,
428 size_t __stacksize);
a784e502 429extern int __pthread_attr_getstack (const pthread_attr_t *__restrict __attr,
76a50749
UD		 430 void **__restrict __stackaddr,
431 size_t *__restrict __stacksize);
432extern int __pthread_attr_setstack (pthread_attr_t *__attr, void *__stackaddr,
433 size_t __stacksize);
434extern int __pthread_rwlock_init (pthread_rwlock_t *__restrict __rwlock,
a784e502 435 const pthread_rwlockattr_t *__restrict
76a50749
UD		 436 __attr);
437extern int __pthread_rwlock_destroy (pthread_rwlock_t *__rwlock);
438extern int __pthread_rwlock_rdlock (pthread_rwlock_t *__rwlock);
439extern int __pthread_rwlock_tryrdlock (pthread_rwlock_t *__rwlock);
440extern int __pthread_rwlock_wrlock (pthread_rwlock_t *__rwlock);
441extern int __pthread_rwlock_trywrlock (pthread_rwlock_t *__rwlock);
442extern int __pthread_rwlock_unlock (pthread_rwlock_t *__rwlock);
8454830b
UD		 443extern int __pthread_cond_broadcast (pthread_cond_t *cond);
444extern int __pthread_cond_destroy (pthread_cond_t *cond);
445extern int __pthread_cond_init (pthread_cond_t *cond,
446 const pthread_condattr_t *cond_attr);
447extern int __pthread_cond_signal (pthread_cond_t *cond);
448extern int __pthread_cond_wait (pthread_cond_t *cond, pthread_mutex_t *mutex);
b5facfda
UD		 449extern int __pthread_cond_timedwait (pthread_cond_t *cond,
450 pthread_mutex_t *mutex,
451 const struct timespec *abstime);
afe4de7d
MC		 452extern int __pthread_cond_clockwait (pthread_cond_t *cond,
453 pthread_mutex_t *mutex,
454 clockid_t clockid,
455 const struct timespec *abstime)
456 __nonnull ((1, 2, 4));
8454830b
UD		 457extern int __pthread_condattr_destroy (pthread_condattr_t *attr);
458extern int __pthread_condattr_init (pthread_condattr_t *attr);
76a50749 459extern int __pthread_key_create (pthread_key_t *key, void (*destr) (void *));
fa872e1b 460extern int __pthread_key_delete (pthread_key_t key);
76a50749
UD		 461extern void *__pthread_getspecific (pthread_key_t key);
462extern int __pthread_setspecific (pthread_key_t key, const void *value);
463extern int __pthread_once (pthread_once_t *once_control,
464 void (*init_routine) (void));
465extern int __pthread_atfork (void (*prepare) (void), void (*parent) (void),
466 void (*child) (void));
8454830b
UD		 467extern pthread_t __pthread_self (void);
468extern int __pthread_equal (pthread_t thread1, pthread_t thread2);
fa872e1b
AZ		 469extern int __pthread_detach (pthread_t th);
470extern int __pthread_cancel (pthread_t th);
09efc3ba 471extern int __pthread_kill (pthread_t threadid, int signo);
356fa562 472extern void __pthread_exit (void *value) __attribute__ ((__noreturn__));
fa872e1b 473extern int __pthread_join (pthread_t threadid, void **thread_return);
09efc3ba 474extern int __pthread_setcanceltype (int type, int *oldtype);
bdb04f92 475extern int __pthread_enable_asynccancel (void) attribute_hidden;
83b09837 476extern void __pthread_disable_asynccancel (int oldtype) attribute_hidden;
47677f2e 477extern void __pthread_testcancel (void);
69ca4b54
MC		 478extern int __pthread_clockjoin_ex (pthread_t, void **, clockid_t,
479 const struct timespec *, bool)
480 attribute_hidden;
481
9ae0909b 482
ce9f10f7 483#if IS_IN (libpthread)
4d17e683
AS		 484hidden_proto (__pthread_mutex_init)
485hidden_proto (__pthread_mutex_destroy)
486hidden_proto (__pthread_mutex_lock)
fa872e1b 487hidden_proto (__pthread_mutex_trylock)
4d17e683
AS		 488hidden_proto (__pthread_mutex_unlock)
489hidden_proto (__pthread_rwlock_rdlock)
490hidden_proto (__pthread_rwlock_wrlock)
491hidden_proto (__pthread_rwlock_unlock)
492hidden_proto (__pthread_key_create)
493hidden_proto (__pthread_getspecific)
494hidden_proto (__pthread_setspecific)
495hidden_proto (__pthread_once)
e5d19c08 496hidden_proto (__pthread_setcancelstate)
47677f2e 497hidden_proto (__pthread_testcancel)
fa872e1b
AZ		 498hidden_proto (__pthread_mutexattr_init)
499hidden_proto (__pthread_mutexattr_settype)
4d17e683
AS		 500#endif
501
997256dd
UD		 502extern int __pthread_cond_broadcast_2_0 (pthread_cond_2_0_t *cond);
503extern int __pthread_cond_destroy_2_0 (pthread_cond_2_0_t *cond);
504extern int __pthread_cond_init_2_0 (pthread_cond_2_0_t *cond,
05df18c3 505 const pthread_condattr_t *cond_attr);
997256dd
UD		 506extern int __pthread_cond_signal_2_0 (pthread_cond_2_0_t *cond);
507extern int __pthread_cond_timedwait_2_0 (pthread_cond_2_0_t *cond,
05df18c3
UD		 508 pthread_mutex_t *mutex,
509 const struct timespec *abstime);
997256dd 510extern int __pthread_cond_wait_2_0 (pthread_cond_2_0_t *cond,
05df18c3
UD		 511 pthread_mutex_t *mutex);
512
439ff07b
UD		 513extern int __pthread_getaffinity_np (pthread_t th, size_t cpusetsize,
514 cpu_set_t *cpuset);
73e9ae88 515
ce9f10f7 516#if IS_IN (libpthread)
09efc3ba 517/* Special versions which use non-exported functions. */
73e9ae88
UD		 518extern void __pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer,
519 void (*routine) (void *), void *arg)
09efc3ba 520 attribute_hidden;
09efc3ba 521
203c1a89
MS		 522/* Replace cleanup macros defined in <pthread.h> with internal
523 versions that don't depend on unwind info and better support
524 cancellation. */
525# undef pthread_cleanup_push
526# define pthread_cleanup_push(routine,arg) \
527 { struct _pthread_cleanup_buffer _buffer; \
528 __pthread_cleanup_push (&_buffer, (routine), (arg));
529
73e9ae88
UD		 530extern void __pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer,
531 int execute) attribute_hidden;
203c1a89
MS		 532# undef pthread_cleanup_pop
533# define pthread_cleanup_pop(execute) \
534 __pthread_cleanup_pop (&_buffer, (execute)); }
1e506629 535#endif
76a50749 536
73e9ae88
UD		 537extern void __pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer,
538 void (*routine) (void *), void *arg);
539extern void __pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer,
540 int execute);
541
6efd4814
UD		 542/* Old cleanup interfaces, still used in libc.so. */
543extern void _pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer,
6f8326ca 544 void (*routine) (void *), void *arg);
6efd4814 545extern void _pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer,
6f8326ca 546 int execute);
6efd4814 547extern void _pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer,
6f8326ca 548 void (*routine) (void *), void *arg);
6efd4814 549extern void _pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer,
6f8326ca 550 int execute);
6efd4814 551
3fa21fd8
UD		 552extern void __nptl_deallocate_tsd (void) attribute_hidden;
553
771eb141
FW		 554extern void __nptl_setxid_error (struct xid_command *cmdp, int error)
555 attribute_hidden;
ccd8de9a 556extern int __nptl_setxid (struct xid_command *cmdp) attribute_hidden;
6f8326ca
UD		 557#ifndef SHARED
558extern void __nptl_set_robust (struct pthread *self);
559#endif
2edb61e3 560
2827ab99
CD		 561extern void __nptl_stacks_freeres (void) attribute_hidden;
562extern void __shm_directory_freeres (void) attribute_hidden;
ba408f84 563
df94b641
UD		 564extern void __wait_lookup_done (void) attribute_hidden;
565
b639d0c9
UD		 566#ifdef SHARED
567# define PTHREAD_STATIC_FN_REQUIRE(name)
568#else
569# define PTHREAD_STATIC_FN_REQUIRE(name) __asm (".globl " #name);
570#endif
571
da1304bc
SP		 572/* Returns 0 if POL is a valid scheduling policy. */
573static inline int
574check_sched_policy_attr (int pol)
575{
576 if (pol == SCHED_OTHER || pol == SCHED_FIFO || pol == SCHED_RR)
577 return 0;
578
579 return EINVAL;
580}
581
582/* Returns 0 if PR is within the accepted range of priority values for
583 the scheduling policy POL or EINVAL otherwise. */
584static inline int
585check_sched_priority_attr (int pr, int pol)
586{
587 int min = __sched_get_priority_min (pol);
588 int max = __sched_get_priority_max (pol);
589
590 if (min >= 0 && max >= 0 && pr >= min && pr <= max)
591 return 0;
592
593 return EINVAL;
594}
595
596/* Returns 0 if ST is a valid stack size for a thread stack and EINVAL
597 otherwise. */
598static inline int
599check_stacksize_attr (size_t st)
600{
601 if (st >= PTHREAD_STACK_MIN)
602 return 0;
603
604 return EINVAL;
605}
606
72b3c6ee
AZ		 607#define ASSERT_TYPE_SIZE(type, size) \
608 _Static_assert (sizeof (type) == size, \
609 "sizeof (" #type ") != " #size)
610
611#define ASSERT_PTHREAD_INTERNAL_SIZE(type, internal) \
a3aaa598 612 _Static_assert (sizeof ((type) { { 0 } }).__size >= sizeof (internal),\
72b3c6ee
AZ		 613 "sizeof (" #type ".__size) < sizeof (" #internal ")")
614
dff91cd4
AZ		 615#define ASSERT_PTHREAD_STRING(x) __STRING (x)
616#define ASSERT_PTHREAD_INTERNAL_OFFSET(type, member, offset) \
617 _Static_assert (offsetof (type, member) == offset, \
618 "offset of " #member " field of " #type " != " \
619 ASSERT_PTHREAD_STRING (offset))
71d260c1
AZ		 620#define ASSERT_PTHREAD_INTERNAL_MEMBER_SIZE(type, member, mtype) \
621 _Static_assert (sizeof (((type) { 0 }).member) != 8, \
622 "sizeof (" #type "." #member ") != sizeof (" #mtype "))")
dff91cd4 623
76a50749 624#endif /* pthreadP.h */
A mirror of the official glibc repository