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.
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.
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.
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/>. */
22 #define __PTHREAD_NPTL
27 #include <sys/syscall.h>
30 #include <lowlevellock.h>
31 #include <stackinfo.h>
32 #include <internaltypes.h>
33 #include <pthread-functions.h>
35 #include <kernel-features.h>
37 #include <internal-signals.h>
38 #include "pthread_mutex_conf.h"
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)
47 #ifndef THREAD_ATOMIC_BIT_SET
48 # define THREAD_ATOMIC_BIT_SET(descr, member, bit) \
49 atomic_bit_set (&(descr)->member, bit)
53 static inline short max_adaptive_count (void)
56 return __mutex_aconf
.spin_count
;
58 return DEFAULT_ADAPTIVE_COUNT
;
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)
69 /* Internal mutex type value. */
72 PTHREAD_MUTEX_KIND_MASK_NP
= 3,
74 PTHREAD_MUTEX_ELISION_NP
= 256,
75 PTHREAD_MUTEX_NO_ELISION_NP
= 512,
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
,
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
,
118 #define PTHREAD_MUTEX_PSHARED_BIT 128
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))
130 #if LLL_PRIVATE == 0 && LLL_SHARED == 128
131 # define PTHREAD_MUTEX_PSHARED(m) \
132 (atomic_load_relaxed (&((m)->__data.__kind)) & 128)
134 # define PTHREAD_MUTEX_PSHARED(m) \
135 ((atomic_load_relaxed (&((m)->__data.__kind)) & 128) \
136 ? LLL_SHARED : LLL_PRIVATE)
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
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
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)
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
176 /* Bits used in robust mutex implementation. */
177 #define FUTEX_WAITERS 0x80000000
178 #define FUTEX_OWNER_DIED 0x40000000
179 #define FUTEX_TID_MASK 0x3fffffff
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
187 /* Attribute to indicate thread creation was issued from C11 thrd_create. */
188 #define ATTR_C11_THREAD ((void*)(uintptr_t)-1)
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
198 /* Internal variables. */
201 /* Default pthread attributes. */
202 extern union pthread_attr_transparent __default_pthread_attr attribute_hidden
;
203 extern int __default_pthread_attr_lock attribute_hidden
;
204 /* Called from __libpthread_freeres to deallocate the default attribute. */
205 extern void __default_pthread_attr_freeres (void) attribute_hidden
;
207 /* Size and alignment of static TLS block. */
208 extern size_t __static_tls_size attribute_hidden
;
209 extern size_t __static_tls_align_m1 attribute_hidden
;
211 /* Attribute handling. */
212 extern struct pthread_attr
*__attr_list attribute_hidden
;
213 extern int __attr_list_lock attribute_hidden
;
215 /* Concurrency handling. */
216 extern int __concurrency_level attribute_hidden
;
218 /* Thread-local data key handling. */
219 extern struct pthread_key_struct __pthread_keys
[PTHREAD_KEYS_MAX
];
220 hidden_proto (__pthread_keys
)
222 /* Number of threads running. */
223 extern unsigned int __nptl_nthreads attribute_hidden
;
225 #ifndef __ASSUME_SET_ROBUST_LIST
226 /* Negative if we do not have the system call and we can use it. */
227 extern int __set_robust_list_avail attribute_hidden
;
230 /* Thread Priority Protection. */
231 extern int __sched_fifo_min_prio attribute_hidden
;
232 extern int __sched_fifo_max_prio attribute_hidden
;
233 extern void __init_sched_fifo_prio (void) attribute_hidden
;
234 extern int __pthread_tpp_change_priority (int prev_prio
, int new_prio
)
236 extern int __pthread_current_priority (void) attribute_hidden
;
238 /* The library can run in debugging mode where it performs a lot more
240 extern int __pthread_debug attribute_hidden
;
241 /** For now disable debugging support. */
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)
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)
256 /* Cancellation test. */
257 #define CANCELLATION_P(self) \
259 int cancelhandling = THREAD_GETMEM (self, cancelhandling); \
260 if (CANCEL_ENABLED_AND_CANCELED (cancelhandling)) \
262 THREAD_SETMEM (self, result, PTHREAD_CANCELED); \
268 extern void __pthread_unwind (__pthread_unwind_buf_t
*__buf
)
269 __cleanup_fct_attribute
__attribute ((__noreturn__
))
270 #if !defined SHARED && !IS_IN (libpthread)
274 extern void __pthread_unwind_next (__pthread_unwind_buf_t
*__buf
)
275 __cleanup_fct_attribute
__attribute ((__noreturn__
))
280 extern void __pthread_register_cancel (__pthread_unwind_buf_t
*__buf
)
281 __cleanup_fct_attribute
;
282 extern void __pthread_unregister_cancel (__pthread_unwind_buf_t
*__buf
)
283 __cleanup_fct_attribute
;
284 #if IS_IN (libpthread)
285 hidden_proto (__pthread_unwind
)
286 hidden_proto (__pthread_unwind_next
)
287 hidden_proto (__pthread_register_cancel
)
288 hidden_proto (__pthread_unregister_cancel
)
290 extern void attribute_hidden
pthread_cancel_init (void);
292 extern void __nptl_unwind_freeres (void) attribute_hidden
;
296 /* Called when a thread reacts on a cancellation request. */
298 __attribute ((noreturn
, always_inline
))
301 struct pthread
*self
= THREAD_SELF
;
303 /* Make sure we get no more cancellations. */
304 THREAD_ATOMIC_BIT_SET (self
, cancelhandling
, EXITING_BIT
);
306 __pthread_unwind ((__pthread_unwind_buf_t
*)
307 THREAD_GETMEM (self
, cleanup_jmp_buf
));
311 /* Internal prototypes. */
313 /* Thread list handling. */
314 extern struct pthread
*__find_in_stack_list (struct pthread
*pd
)
317 /* Deallocate a thread's stack after optionally making sure the thread
318 descriptor is still valid. */
319 extern void __free_tcb (struct pthread
*pd
) attribute_hidden
;
321 /* Free allocated stack. */
322 extern void __deallocate_stack (struct pthread
*pd
) attribute_hidden
;
324 /* Mark all the stacks except for the current one as available. This
325 function also re-initializes the lock for the stack cache. */
326 extern void __reclaim_stacks (void) attribute_hidden
;
328 /* Make all threads's stacks executable. */
329 extern int __make_stacks_executable (void **stack_endp
) attribute_hidden
;
331 /* longjmp handling. */
332 extern void __pthread_cleanup_upto (__jmp_buf target
, char *targetframe
);
333 #if IS_IN (libpthread)
334 hidden_proto (__pthread_cleanup_upto
)
338 /* Functions with versioned interfaces. */
339 extern int __pthread_create_2_1 (pthread_t
*newthread
,
340 const pthread_attr_t
*attr
,
341 void *(*start_routine
) (void *), void *arg
);
342 extern int __pthread_create_2_0 (pthread_t
*newthread
,
343 const pthread_attr_t
*attr
,
344 void *(*start_routine
) (void *), void *arg
);
345 extern int __pthread_attr_init (pthread_attr_t
*attr
);
346 libc_hidden_proto (__pthread_attr_init
)
347 extern int __pthread_attr_init_2_0 (pthread_attr_t
*attr
);
350 /* Event handlers for libthread_db interface. */
351 extern void __nptl_create_event (void);
352 extern void __nptl_death_event (void);
353 hidden_proto (__nptl_create_event
)
354 hidden_proto (__nptl_death_event
)
356 /* Register the generation counter in the libpthread with the libc. */
357 #ifdef TLS_MULTIPLE_THREADS_IN_TCB
358 extern void __libc_pthread_init (unsigned long int *ptr
,
359 void (*reclaim
) (void),
360 const struct pthread_functions
*functions
);
362 extern int *__libc_pthread_init (unsigned long int *ptr
,
363 void (*reclaim
) (void),
364 const struct pthread_functions
*functions
);
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. */
369 extern int __pthread_multiple_threads attribute_hidden
;
370 /* Pointer to the corresponding variable in libc. */
371 extern int *__libc_multiple_threads_ptr attribute_hidden
;
374 extern void __pthread_init_static_tls (struct link_map
*) attribute_hidden
;
376 extern size_t __pthread_get_minstack (const pthread_attr_t
*attr
);
378 /* Namespace save aliases. */
379 extern int __pthread_getschedparam (pthread_t thread_id
, int *policy
,
380 struct sched_param
*param
);
381 extern int __pthread_setschedparam (pthread_t thread_id
, int policy
,
382 const struct sched_param
*param
);
383 extern int __pthread_setcancelstate (int state
, int *oldstate
);
384 extern int __pthread_mutex_init (pthread_mutex_t
*__mutex
,
385 const pthread_mutexattr_t
*__mutexattr
);
386 extern int __pthread_mutex_destroy (pthread_mutex_t
*__mutex
);
387 extern int __pthread_mutex_trylock (pthread_mutex_t
*_mutex
);
388 extern int __pthread_mutex_lock (pthread_mutex_t
*__mutex
);
389 extern int __pthread_mutex_timedlock (pthread_mutex_t
*__mutex
,
390 const struct timespec
*__abstime
);
391 extern int __pthread_mutex_cond_lock (pthread_mutex_t
*__mutex
)
393 extern void __pthread_mutex_cond_lock_adjust (pthread_mutex_t
*__mutex
)
395 extern int __pthread_mutex_unlock (pthread_mutex_t
*__mutex
);
396 extern int __pthread_mutex_unlock_usercnt (pthread_mutex_t
*__mutex
,
397 int __decr
) attribute_hidden
;
398 extern int __pthread_mutexattr_init (pthread_mutexattr_t
*attr
);
399 extern int __pthread_mutexattr_destroy (pthread_mutexattr_t
*attr
);
400 extern int __pthread_mutexattr_settype (pthread_mutexattr_t
*attr
, int kind
);
401 extern int __pthread_attr_destroy (pthread_attr_t
*attr
);
402 libc_hidden_proto (__pthread_attr_destroy
)
403 extern int __pthread_attr_getdetachstate (const pthread_attr_t
*attr
,
405 extern int __pthread_attr_setdetachstate (pthread_attr_t
*attr
,
407 extern int __pthread_attr_getinheritsched (const pthread_attr_t
*attr
,
409 extern int __pthread_attr_setinheritsched (pthread_attr_t
*attr
, int inherit
);
410 extern int __pthread_attr_getschedparam (const pthread_attr_t
*attr
,
411 struct sched_param
*param
);
412 extern int __pthread_attr_setschedparam (pthread_attr_t
*attr
,
413 const struct sched_param
*param
);
414 extern int __pthread_attr_getschedpolicy (const pthread_attr_t
*attr
,
416 extern int __pthread_attr_setschedpolicy (pthread_attr_t
*attr
, int policy
);
417 extern int __pthread_attr_getscope (const pthread_attr_t
*attr
, int *scope
);
418 extern int __pthread_attr_setscope (pthread_attr_t
*attr
, int scope
);
419 extern int __pthread_attr_getstackaddr (const pthread_attr_t
*__restrict
420 __attr
, void **__restrict __stackaddr
);
421 extern int __pthread_attr_setstackaddr (pthread_attr_t
*__attr
,
423 extern int __pthread_attr_getstacksize (const pthread_attr_t
*__restrict
425 size_t *__restrict __stacksize
);
426 extern int __pthread_attr_setstacksize (pthread_attr_t
*__attr
,
428 extern int __pthread_attr_getstack (const pthread_attr_t
*__restrict __attr
,
429 void **__restrict __stackaddr
,
430 size_t *__restrict __stacksize
);
431 extern int __pthread_attr_setstack (pthread_attr_t
*__attr
, void *__stackaddr
,
433 int __pthread_attr_setaffinity_np (pthread_attr_t
*, size_t, const cpu_set_t
*);
434 libc_hidden_proto (__pthread_attr_setaffinity_np
)
435 extern __typeof (pthread_getattr_default_np
) __pthread_getattr_default_np
;
436 libpthread_hidden_proto (__pthread_getattr_default_np
)
437 extern int __pthread_rwlock_init (pthread_rwlock_t
*__restrict __rwlock
,
438 const pthread_rwlockattr_t
*__restrict
440 extern int __pthread_rwlock_destroy (pthread_rwlock_t
*__rwlock
);
441 extern int __pthread_rwlock_rdlock (pthread_rwlock_t
*__rwlock
);
442 extern int __pthread_rwlock_tryrdlock (pthread_rwlock_t
*__rwlock
);
443 extern int __pthread_rwlock_wrlock (pthread_rwlock_t
*__rwlock
);
444 extern int __pthread_rwlock_trywrlock (pthread_rwlock_t
*__rwlock
);
445 extern int __pthread_rwlock_unlock (pthread_rwlock_t
*__rwlock
);
446 extern int __pthread_cond_broadcast (pthread_cond_t
*cond
);
447 extern int __pthread_cond_destroy (pthread_cond_t
*cond
);
448 libc_hidden_proto (__pthread_cond_destroy
)
449 extern int __pthread_cond_init (pthread_cond_t
*cond
,
450 const pthread_condattr_t
*cond_attr
);
451 libc_hidden_proto (__pthread_cond_init
)
452 extern int __pthread_cond_signal (pthread_cond_t
*cond
);
453 extern int __pthread_cond_wait (pthread_cond_t
*cond
, pthread_mutex_t
*mutex
);
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
467 extern int __pthread_clockjoin_np64 (pthread_t threadid
, void **thread_return
,
469 const struct __timespec64
*abstime
);
470 libc_hidden_proto (__pthread_clockjoin_np64
)
471 extern int __pthread_timedjoin_np64 (pthread_t threadid
, void **thread_return
,
472 const struct __timespec64
*abstime
);
473 libc_hidden_proto (__pthread_timedjoin_np64
)
474 extern int __pthread_cond_timedwait64 (pthread_cond_t
*cond
,
475 pthread_mutex_t
*mutex
,
476 const struct __timespec64
*abstime
);
477 libpthread_hidden_proto (__pthread_cond_timedwait64
)
478 extern int __pthread_cond_clockwait64 (pthread_cond_t
*cond
,
479 pthread_mutex_t
*mutex
,
481 const struct __timespec64
*abstime
);
482 libpthread_hidden_proto (__pthread_cond_clockwait64
)
483 extern int __pthread_rwlock_clockrdlock64 (pthread_rwlock_t
*rwlock
,
485 const struct __timespec64
*abstime
);
486 libpthread_hidden_proto (__pthread_rwlock_clockrdlock64
)
487 extern int __pthread_rwlock_clockwrlock64 (pthread_rwlock_t
*rwlock
,
489 const struct __timespec64
*abstime
);
490 libpthread_hidden_proto (__pthread_rwlock_clockwrlock64
)
491 extern int __pthread_rwlock_timedrdlock64 (pthread_rwlock_t
*rwlock
,
492 const struct __timespec64
*abstime
);
493 libpthread_hidden_proto (__pthread_rwlock_timedrdlock64
)
494 extern int __pthread_rwlock_timedwrlock64 (pthread_rwlock_t
*rwlock
,
495 const struct __timespec64
*abstime
);
496 libpthread_hidden_proto (__pthread_rwlock_timedwrlock64
)
497 extern int __pthread_mutex_clocklock64 (pthread_mutex_t
*mutex
,
499 const struct __timespec64
*abstime
);
500 libpthread_hidden_proto (__pthread_mutex_clocklock64
)
501 extern int __pthread_mutex_timedlock64 (pthread_mutex_t
*mutex
,
502 const struct __timespec64
*abstime
);
503 libpthread_hidden_proto (__pthread_mutex_timedlock64
)
506 extern int __pthread_cond_timedwait (pthread_cond_t
*cond
,
507 pthread_mutex_t
*mutex
,
508 const struct timespec
*abstime
);
509 extern int __pthread_cond_clockwait (pthread_cond_t
*cond
,
510 pthread_mutex_t
*mutex
,
512 const struct timespec
*abstime
)
513 __nonnull ((1, 2, 4));
514 extern int __pthread_condattr_destroy (pthread_condattr_t
*attr
);
515 extern int __pthread_condattr_init (pthread_condattr_t
*attr
);
516 extern int __pthread_key_create (pthread_key_t
*key
, void (*destr
) (void *));
517 extern int __pthread_key_delete (pthread_key_t key
);
518 extern void *__pthread_getspecific (pthread_key_t key
);
519 extern int __pthread_setspecific (pthread_key_t key
, const void *value
);
520 extern int __pthread_once (pthread_once_t
*once_control
,
521 void (*init_routine
) (void));
522 extern int __pthread_atfork (void (*prepare
) (void), void (*parent
) (void),
523 void (*child
) (void));
524 extern pthread_t
__pthread_self (void);
525 extern int __pthread_equal (pthread_t thread1
, pthread_t thread2
);
526 extern int __pthread_detach (pthread_t th
);
527 extern int __pthread_cancel (pthread_t th
);
528 extern int __pthread_kill (pthread_t threadid
, int signo
);
529 extern void __pthread_exit (void *value
) __attribute__ ((__noreturn__
));
530 extern int __pthread_join (pthread_t threadid
, void **thread_return
);
531 extern int __pthread_setcanceltype (int type
, int *oldtype
);
532 extern int __pthread_enable_asynccancel (void) attribute_hidden
;
533 extern void __pthread_disable_asynccancel (int oldtype
) attribute_hidden
;
534 extern void __pthread_testcancel (void);
535 extern int __pthread_clockjoin_ex (pthread_t
, void **, clockid_t
,
536 const struct __timespec64
*, bool)
538 extern int __pthread_sigmask (int, const sigset_t
*, sigset_t
*);
539 libc_hidden_proto (__pthread_sigmask
);
542 #if IS_IN (libpthread)
543 hidden_proto (__pthread_mutex_init
)
544 hidden_proto (__pthread_mutex_destroy
)
545 hidden_proto (__pthread_mutex_lock
)
546 hidden_proto (__pthread_mutex_trylock
)
547 hidden_proto (__pthread_mutex_unlock
)
548 hidden_proto (__pthread_rwlock_rdlock
)
549 hidden_proto (__pthread_rwlock_wrlock
)
550 hidden_proto (__pthread_rwlock_unlock
)
551 hidden_proto (__pthread_key_create
)
552 hidden_proto (__pthread_getspecific
)
553 hidden_proto (__pthread_setspecific
)
554 hidden_proto (__pthread_once
)
555 hidden_proto (__pthread_setcancelstate
)
556 hidden_proto (__pthread_testcancel
)
557 hidden_proto (__pthread_mutexattr_init
)
558 hidden_proto (__pthread_mutexattr_settype
)
561 extern int __pthread_cond_broadcast_2_0 (pthread_cond_2_0_t
*cond
);
562 extern int __pthread_cond_destroy_2_0 (pthread_cond_2_0_t
*cond
);
563 extern int __pthread_cond_init_2_0 (pthread_cond_2_0_t
*cond
,
564 const pthread_condattr_t
*cond_attr
);
565 extern int __pthread_cond_signal_2_0 (pthread_cond_2_0_t
*cond
);
566 extern int __pthread_cond_timedwait_2_0 (pthread_cond_2_0_t
*cond
,
567 pthread_mutex_t
*mutex
,
568 const struct timespec
*abstime
);
569 extern int __pthread_cond_wait_2_0 (pthread_cond_2_0_t
*cond
,
570 pthread_mutex_t
*mutex
);
572 extern int __pthread_getaffinity_np (pthread_t th
, size_t cpusetsize
,
574 libc_hidden_proto (__pthread_getaffinity_np
)
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
);
581 libc_hidden_proto (__pthread_attr_setsigmask_internal
)
583 extern __typeof (pthread_attr_getsigmask_np
) __pthread_attr_getsigmask_np
;
584 libc_hidden_proto (__pthread_attr_getsigmask_np
)
586 #if IS_IN (libpthread)
587 /* Special versions which use non-exported functions. */
588 extern void __pthread_cleanup_push (struct _pthread_cleanup_buffer
*buffer
,
589 void (*routine
) (void *), void *arg
)
592 /* Replace cleanup macros defined in <pthread.h> with internal
593 versions that don't depend on unwind info and better support
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));
600 extern 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)); }
607 extern void __pthread_cleanup_push_defer (struct _pthread_cleanup_buffer
*buffer
,
608 void (*routine
) (void *), void *arg
);
609 extern void __pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer
*buffer
,
612 /* Old cleanup interfaces, still used in libc.so. */
613 extern void _pthread_cleanup_push (struct _pthread_cleanup_buffer
*buffer
,
614 void (*routine
) (void *), void *arg
);
615 extern void _pthread_cleanup_pop (struct _pthread_cleanup_buffer
*buffer
,
617 extern void _pthread_cleanup_push_defer (struct _pthread_cleanup_buffer
*buffer
,
618 void (*routine
) (void *), void *arg
);
619 extern void _pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer
*buffer
,
622 extern void __nptl_deallocate_tsd (void) attribute_hidden
;
624 extern void __nptl_setxid_error (struct xid_command
*cmdp
, int error
)
626 extern int __nptl_setxid (struct xid_command
*cmdp
) attribute_hidden
;
628 extern void __nptl_set_robust (struct pthread
*self
);
631 extern void __nptl_stacks_freeres (void) attribute_hidden
;
632 extern void __shm_directory_freeres (void) attribute_hidden
;
634 extern void __wait_lookup_done (void) attribute_hidden
;
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. */
639 int __pthread_attr_extension (struct pthread_attr
*attr
) attribute_hidden
640 __attribute_warn_unused_result__
;
643 # define PTHREAD_STATIC_FN_REQUIRE(name)
645 # define PTHREAD_STATIC_FN_REQUIRE(name) __asm (".globl " #name);
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. */
651 int __pthread_attr_copy (pthread_attr_t
*target
, const pthread_attr_t
*source
);
652 libc_hidden_proto (__pthread_attr_copy
)
654 /* Returns 0 if POL is a valid scheduling policy. */
656 check_sched_policy_attr (int pol
)
658 if (pol
== SCHED_OTHER
|| pol
== SCHED_FIFO
|| pol
== SCHED_RR
)
664 /* Returns 0 if PR is within the accepted range of priority values for
665 the scheduling policy POL or EINVAL otherwise. */
667 check_sched_priority_attr (int pr
, int pol
)
669 int min
= __sched_get_priority_min (pol
);
670 int max
= __sched_get_priority_max (pol
);
672 if (min
>= 0 && max
>= 0 && pr
>= min
&& pr
<= max
)
678 /* Returns 0 if ST is a valid stack size for a thread stack and EINVAL
681 check_stacksize_attr (size_t st
)
683 if (st
>= PTHREAD_STACK_MIN
)
689 #define ASSERT_TYPE_SIZE(type, size) \
690 _Static_assert (sizeof (type) == size, \
691 "sizeof (" #type ") != " #size)
693 #define ASSERT_PTHREAD_INTERNAL_SIZE(type, internal) \
694 _Static_assert (sizeof ((type) { { 0 } }).__size >= sizeof (internal),\
695 "sizeof (" #type ".__size) < sizeof (" #internal ")")
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 "))")
706 #endif /* pthreadP.h */