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