| 1 | /* Copyright (C) 2002-2020 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 | #include <pthread.h> | 
|---|
| 23 | #include <setjmp.h> | 
|---|
| 24 | #include <stdbool.h> | 
|---|
| 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> | 
|---|
| 31 | #include <pthread-functions.h> | 
|---|
| 32 | #include <atomic.h> | 
|---|
| 33 | #include <kernel-features.h> | 
|---|
| 34 | #include <errno.h> | 
|---|
| 35 | #include <internal-signals.h> | 
|---|
| 36 | #include "pthread_mutex_conf.h" | 
|---|
| 37 |  | 
|---|
| 38 |  | 
|---|
| 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 |  | 
|---|
| 51 | static inline short max_adaptive_count (void) | 
|---|
| 52 | { | 
|---|
| 53 | #if HAVE_TUNABLES | 
|---|
| 54 | return __mutex_aconf.spin_count; | 
|---|
| 55 | #else | 
|---|
| 56 | return DEFAULT_ADAPTIVE_COUNT; | 
|---|
| 57 | #endif | 
|---|
| 58 | } | 
|---|
| 59 |  | 
|---|
| 60 |  | 
|---|
| 61 | /* Magic cookie representing robust mutex with dead owner.  */ | 
|---|
| 62 | #define PTHREAD_MUTEX_INCONSISTENT	INT_MAX | 
|---|
| 63 | /* Magic cookie representing not recoverable robust mutex.  */ | 
|---|
| 64 | #define PTHREAD_MUTEX_NOTRECOVERABLE	(INT_MAX - 1) | 
|---|
| 65 |  | 
|---|
| 66 |  | 
|---|
| 67 | /* Internal mutex type value.  */ | 
|---|
| 68 | enum | 
|---|
| 69 | { | 
|---|
| 70 | PTHREAD_MUTEX_KIND_MASK_NP = 3, | 
|---|
| 71 |  | 
|---|
| 72 | PTHREAD_MUTEX_ELISION_NP    = 256, | 
|---|
| 73 | PTHREAD_MUTEX_NO_ELISION_NP = 512, | 
|---|
| 74 |  | 
|---|
| 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, | 
|---|
| 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, | 
|---|
| 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 | 
|---|
| 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, | 
|---|
| 115 | }; | 
|---|
| 116 | #define PTHREAD_MUTEX_PSHARED_BIT 128 | 
|---|
| 117 |  | 
|---|
| 118 | /* See concurrency notes regarding __kind in struct __pthread_mutex_s | 
|---|
| 119 | in sysdeps/nptl/bits/thread-shared-types.h.  */ | 
|---|
| 120 | #define PTHREAD_MUTEX_TYPE(m) \ | 
|---|
| 121 | (atomic_load_relaxed (&((m)->__data.__kind)) & 127) | 
|---|
| 122 | /* Don't include NO_ELISION, as that type is always the same | 
|---|
| 123 | as the underlying lock type.  */ | 
|---|
| 124 | #define PTHREAD_MUTEX_TYPE_ELISION(m) \ | 
|---|
| 125 | (atomic_load_relaxed (&((m)->__data.__kind))	\ | 
|---|
| 126 | & (127 | PTHREAD_MUTEX_ELISION_NP)) | 
|---|
| 127 |  | 
|---|
| 128 | #if LLL_PRIVATE == 0 && LLL_SHARED == 128 | 
|---|
| 129 | # define PTHREAD_MUTEX_PSHARED(m) \ | 
|---|
| 130 | (atomic_load_relaxed (&((m)->__data.__kind)) & 128) | 
|---|
| 131 | #else | 
|---|
| 132 | # define PTHREAD_MUTEX_PSHARED(m) \ | 
|---|
| 133 | ((atomic_load_relaxed (&((m)->__data.__kind)) & 128)	\ | 
|---|
| 134 | ? LLL_SHARED : LLL_PRIVATE) | 
|---|
| 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 | 
|---|
| 140 |  | 
|---|
| 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 | 
|---|
| 148 |  | 
|---|
| 149 |  | 
|---|
| 150 | /* Flags in mutex attr.  */ | 
|---|
| 151 | #define PTHREAD_MUTEXATTR_PROTOCOL_SHIFT	28 | 
|---|
| 152 | #define PTHREAD_MUTEXATTR_PROTOCOL_MASK		0x30000000 | 
|---|
| 153 | #define PTHREAD_MUTEXATTR_PRIO_CEILING_SHIFT	12 | 
|---|
| 154 | #define PTHREAD_MUTEXATTR_PRIO_CEILING_MASK	0x00fff000 | 
|---|
| 155 | #define PTHREAD_MUTEXATTR_FLAG_ROBUST		0x40000000 | 
|---|
| 156 | #define PTHREAD_MUTEXATTR_FLAG_PSHARED		0x80000000 | 
|---|
| 157 | #define PTHREAD_MUTEXATTR_FLAG_BITS \ | 
|---|
| 158 | (PTHREAD_MUTEXATTR_FLAG_ROBUST | PTHREAD_MUTEXATTR_FLAG_PSHARED \ | 
|---|
| 159 | | PTHREAD_MUTEXATTR_PROTOCOL_MASK | PTHREAD_MUTEXATTR_PRIO_CEILING_MASK) | 
|---|
| 160 |  | 
|---|
| 161 |  | 
|---|
| 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 | 
|---|
| 172 |  | 
|---|
| 173 |  | 
|---|
| 174 | /* Bits used in robust mutex implementation.  */ | 
|---|
| 175 | #define FUTEX_WAITERS		0x80000000 | 
|---|
| 176 | #define FUTEX_OWNER_DIED	0x40000000 | 
|---|
| 177 | #define FUTEX_TID_MASK		0x3fffffff | 
|---|
| 178 |  | 
|---|
| 179 |  | 
|---|
| 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 |  | 
|---|
| 185 | /* Attribute to indicate thread creation was issued from C11 thrd_create.  */ | 
|---|
| 186 | #define ATTR_C11_THREAD ((void*)(uintptr_t)-1) | 
|---|
| 187 |  | 
|---|
| 188 |  | 
|---|
| 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 |  | 
|---|
| 196 | /* Internal variables.  */ | 
|---|
| 197 |  | 
|---|
| 198 |  | 
|---|
| 199 | /* Default pthread attributes.  */ | 
|---|
| 200 | extern struct pthread_attr __default_pthread_attr attribute_hidden; | 
|---|
| 201 | extern int __default_pthread_attr_lock attribute_hidden; | 
|---|
| 202 |  | 
|---|
| 203 | /* Size and alignment of static TLS block.  */ | 
|---|
| 204 | extern size_t __static_tls_size attribute_hidden; | 
|---|
| 205 | extern size_t __static_tls_align_m1 attribute_hidden; | 
|---|
| 206 |  | 
|---|
| 207 | /* Flag whether the machine is SMP or not.  */ | 
|---|
| 208 | extern int __is_smp attribute_hidden; | 
|---|
| 209 |  | 
|---|
| 210 | /* Thread descriptor handling.  */ | 
|---|
| 211 | extern list_t __stack_user; | 
|---|
| 212 | hidden_proto (__stack_user) | 
|---|
| 213 |  | 
|---|
| 214 | /* Attribute handling.  */ | 
|---|
| 215 | extern struct pthread_attr *__attr_list attribute_hidden; | 
|---|
| 216 | extern int __attr_list_lock attribute_hidden; | 
|---|
| 217 |  | 
|---|
| 218 | /* Concurrency handling.  */ | 
|---|
| 219 | extern int __concurrency_level attribute_hidden; | 
|---|
| 220 |  | 
|---|
| 221 | /* Thread-local data key handling.  */ | 
|---|
| 222 | extern struct pthread_key_struct __pthread_keys[PTHREAD_KEYS_MAX]; | 
|---|
| 223 | hidden_proto (__pthread_keys) | 
|---|
| 224 |  | 
|---|
| 225 | /* Number of threads running.  */ | 
|---|
| 226 | extern unsigned int __nptl_nthreads attribute_hidden; | 
|---|
| 227 |  | 
|---|
| 228 | #ifndef __ASSUME_SET_ROBUST_LIST | 
|---|
| 229 | /* Negative if we do not have the system call and we can use it.  */ | 
|---|
| 230 | extern int __set_robust_list_avail attribute_hidden; | 
|---|
| 231 | #endif | 
|---|
| 232 |  | 
|---|
| 233 | /* Thread Priority Protection.  */ | 
|---|
| 234 | extern int __sched_fifo_min_prio attribute_hidden; | 
|---|
| 235 | extern int __sched_fifo_max_prio attribute_hidden; | 
|---|
| 236 | extern void __init_sched_fifo_prio (void) attribute_hidden; | 
|---|
| 237 | extern int __pthread_tpp_change_priority (int prev_prio, int new_prio) | 
|---|
| 238 | attribute_hidden; | 
|---|
| 239 | extern int __pthread_current_priority (void) attribute_hidden; | 
|---|
| 240 |  | 
|---|
| 241 | /* The library can run in debugging mode where it performs a lot more | 
|---|
| 242 | tests.  */ | 
|---|
| 243 | extern int __pthread_debug attribute_hidden; | 
|---|
| 244 | /** For now disable debugging support.  */ | 
|---|
| 245 | #if 0 | 
|---|
| 246 | # define DEBUGGING_P __builtin_expect (__pthread_debug, 0) | 
|---|
| 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) | 
|---|
| 249 | #else | 
|---|
| 250 | # define DEBUGGING_P 0 | 
|---|
| 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) | 
|---|
| 256 | #endif | 
|---|
| 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);			      \ | 
|---|
| 266 | __do_cancel ();							      \ | 
|---|
| 267 | }									      \ | 
|---|
| 268 | } while (0) | 
|---|
| 269 |  | 
|---|
| 270 |  | 
|---|
| 271 | extern void __pthread_unwind (__pthread_unwind_buf_t *__buf) | 
|---|
| 272 | __cleanup_fct_attribute __attribute ((__noreturn__)) | 
|---|
| 273 | #if !defined SHARED && !IS_IN (libpthread) | 
|---|
| 274 | weak_function | 
|---|
| 275 | #endif | 
|---|
| 276 | ; | 
|---|
| 277 | extern void __pthread_unwind_next (__pthread_unwind_buf_t *__buf) | 
|---|
| 278 | __cleanup_fct_attribute __attribute ((__noreturn__)) | 
|---|
| 279 | #ifndef SHARED | 
|---|
| 280 | weak_function | 
|---|
| 281 | #endif | 
|---|
| 282 | ; | 
|---|
| 283 | extern void __pthread_register_cancel (__pthread_unwind_buf_t *__buf) | 
|---|
| 284 | __cleanup_fct_attribute; | 
|---|
| 285 | extern void __pthread_unregister_cancel (__pthread_unwind_buf_t *__buf) | 
|---|
| 286 | __cleanup_fct_attribute; | 
|---|
| 287 | #if IS_IN (libpthread) | 
|---|
| 288 | hidden_proto (__pthread_unwind) | 
|---|
| 289 | hidden_proto (__pthread_unwind_next) | 
|---|
| 290 | hidden_proto (__pthread_register_cancel) | 
|---|
| 291 | hidden_proto (__pthread_unregister_cancel) | 
|---|
| 292 | # ifdef SHARED | 
|---|
| 293 | extern void attribute_hidden pthread_cancel_init (void); | 
|---|
| 294 | # endif | 
|---|
| 295 | extern void __nptl_unwind_freeres (void) attribute_hidden; | 
|---|
| 296 | #endif | 
|---|
| 297 |  | 
|---|
| 298 |  | 
|---|
| 299 | /* Called when a thread reacts on a cancellation request.  */ | 
|---|
| 300 | static inline void | 
|---|
| 301 | __attribute ((noreturn, always_inline)) | 
|---|
| 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 |  | 
|---|
| 314 | /* Internal prototypes.  */ | 
|---|
| 315 |  | 
|---|
| 316 | /* Thread list handling.  */ | 
|---|
| 317 | extern struct pthread *__find_in_stack_list (struct pthread *pd) | 
|---|
| 318 | attribute_hidden; | 
|---|
| 319 |  | 
|---|
| 320 | /* Deallocate a thread's stack after optionally making sure the thread | 
|---|
| 321 | descriptor is still valid.  */ | 
|---|
| 322 | extern void __free_tcb (struct pthread *pd) attribute_hidden; | 
|---|
| 323 |  | 
|---|
| 324 | /* Free allocated stack.  */ | 
|---|
| 325 | extern void __deallocate_stack (struct pthread *pd) attribute_hidden; | 
|---|
| 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.  */ | 
|---|
| 329 | extern void __reclaim_stacks (void) attribute_hidden; | 
|---|
| 330 |  | 
|---|
| 331 | /* Make all threads's stacks executable.  */ | 
|---|
| 332 | extern int __make_stacks_executable (void **stack_endp) attribute_hidden; | 
|---|
| 333 |  | 
|---|
| 334 | /* longjmp handling.  */ | 
|---|
| 335 | extern void __pthread_cleanup_upto (__jmp_buf target, char *targetframe); | 
|---|
| 336 | #if IS_IN (libpthread) | 
|---|
| 337 | hidden_proto (__pthread_cleanup_upto) | 
|---|
| 338 | #endif | 
|---|
| 339 |  | 
|---|
| 340 |  | 
|---|
| 341 | /* Functions with versioned interfaces.  */ | 
|---|
| 342 | extern int __pthread_create_2_1 (pthread_t *newthread, | 
|---|
| 343 | const pthread_attr_t *attr, | 
|---|
| 344 | void *(*start_routine) (void *), void *arg); | 
|---|
| 345 | extern int __pthread_create_2_0 (pthread_t *newthread, | 
|---|
| 346 | const pthread_attr_t *attr, | 
|---|
| 347 | void *(*start_routine) (void *), void *arg); | 
|---|
| 348 | extern int __pthread_attr_init_2_1 (pthread_attr_t *attr); | 
|---|
| 349 | extern int __pthread_attr_init_2_0 (pthread_attr_t *attr); | 
|---|
| 350 |  | 
|---|
| 351 |  | 
|---|
| 352 | /* Event handlers for libthread_db interface.  */ | 
|---|
| 353 | extern void __nptl_create_event (void); | 
|---|
| 354 | extern void __nptl_death_event (void); | 
|---|
| 355 | hidden_proto (__nptl_create_event) | 
|---|
| 356 | hidden_proto (__nptl_death_event) | 
|---|
| 357 |  | 
|---|
| 358 | /* Register the generation counter in the libpthread with the libc.  */ | 
|---|
| 359 | #ifdef TLS_MULTIPLE_THREADS_IN_TCB | 
|---|
| 360 | extern void __libc_pthread_init (unsigned long int *ptr, | 
|---|
| 361 | void (*reclaim) (void), | 
|---|
| 362 | const struct pthread_functions *functions); | 
|---|
| 363 | #else | 
|---|
| 364 | extern int *__libc_pthread_init (unsigned long int *ptr, | 
|---|
| 365 | void (*reclaim) (void), | 
|---|
| 366 | const struct pthread_functions *functions); | 
|---|
| 367 |  | 
|---|
| 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.  */ | 
|---|
| 371 | extern int __pthread_multiple_threads attribute_hidden; | 
|---|
| 372 | /* Pointer to the corresponding variable in libc.  */ | 
|---|
| 373 | extern int *__libc_multiple_threads_ptr attribute_hidden; | 
|---|
| 374 | #endif | 
|---|
| 375 |  | 
|---|
| 376 | extern void __pthread_init_static_tls (struct link_map *) attribute_hidden; | 
|---|
| 377 |  | 
|---|
| 378 | extern size_t __pthread_get_minstack (const pthread_attr_t *attr); | 
|---|
| 379 |  | 
|---|
| 380 | /* Namespace save aliases.  */ | 
|---|
| 381 | extern int __pthread_getschedparam (pthread_t thread_id, int *policy, | 
|---|
| 382 | struct sched_param *param); | 
|---|
| 383 | extern int __pthread_setschedparam (pthread_t thread_id, int policy, | 
|---|
| 384 | const struct sched_param *param); | 
|---|
| 385 | extern int __pthread_setcancelstate (int state, int *oldstate); | 
|---|
| 386 | extern int __pthread_mutex_init (pthread_mutex_t *__mutex, | 
|---|
| 387 | const pthread_mutexattr_t *__mutexattr); | 
|---|
| 388 | extern int __pthread_mutex_destroy (pthread_mutex_t *__mutex); | 
|---|
| 389 | extern int __pthread_mutex_trylock (pthread_mutex_t *_mutex); | 
|---|
| 390 | extern int __pthread_mutex_lock (pthread_mutex_t *__mutex); | 
|---|
| 391 | extern int __pthread_mutex_timedlock (pthread_mutex_t *__mutex, | 
|---|
| 392 | const struct timespec *__abstime); | 
|---|
| 393 | extern int __pthread_mutex_cond_lock (pthread_mutex_t *__mutex) | 
|---|
| 394 | attribute_hidden; | 
|---|
| 395 | extern void __pthread_mutex_cond_lock_adjust (pthread_mutex_t *__mutex) | 
|---|
| 396 | attribute_hidden; | 
|---|
| 397 | extern int __pthread_mutex_unlock (pthread_mutex_t *__mutex); | 
|---|
| 398 | extern int __pthread_mutex_unlock_usercnt (pthread_mutex_t *__mutex, | 
|---|
| 399 | int __decr) attribute_hidden; | 
|---|
| 400 | extern int __pthread_mutexattr_init (pthread_mutexattr_t *attr); | 
|---|
| 401 | extern int __pthread_mutexattr_destroy (pthread_mutexattr_t *attr); | 
|---|
| 402 | extern int __pthread_mutexattr_settype (pthread_mutexattr_t *attr, int kind); | 
|---|
| 403 | extern int __pthread_attr_destroy (pthread_attr_t *attr); | 
|---|
| 404 | extern int __pthread_attr_getdetachstate (const pthread_attr_t *attr, | 
|---|
| 405 | int *detachstate); | 
|---|
| 406 | extern int __pthread_attr_setdetachstate (pthread_attr_t *attr, | 
|---|
| 407 | int detachstate); | 
|---|
| 408 | extern int __pthread_attr_getinheritsched (const pthread_attr_t *attr, | 
|---|
| 409 | int *inherit); | 
|---|
| 410 | extern int __pthread_attr_setinheritsched (pthread_attr_t *attr, int inherit); | 
|---|
| 411 | extern int __pthread_attr_getschedparam (const pthread_attr_t *attr, | 
|---|
| 412 | struct sched_param *param); | 
|---|
| 413 | extern int __pthread_attr_setschedparam (pthread_attr_t *attr, | 
|---|
| 414 | const struct sched_param *param); | 
|---|
| 415 | extern int __pthread_attr_getschedpolicy (const pthread_attr_t *attr, | 
|---|
| 416 | int *policy); | 
|---|
| 417 | extern int __pthread_attr_setschedpolicy (pthread_attr_t *attr, int policy); | 
|---|
| 418 | extern int __pthread_attr_getscope (const pthread_attr_t *attr, int *scope); | 
|---|
| 419 | extern int __pthread_attr_setscope (pthread_attr_t *attr, int scope); | 
|---|
| 420 | extern int __pthread_attr_getstackaddr (const pthread_attr_t *__restrict | 
|---|
| 421 | __attr, void **__restrict __stackaddr); | 
|---|
| 422 | extern int __pthread_attr_setstackaddr (pthread_attr_t *__attr, | 
|---|
| 423 | void *__stackaddr); | 
|---|
| 424 | extern int __pthread_attr_getstacksize (const pthread_attr_t *__restrict | 
|---|
| 425 | __attr, | 
|---|
| 426 | size_t *__restrict __stacksize); | 
|---|
| 427 | extern int __pthread_attr_setstacksize (pthread_attr_t *__attr, | 
|---|
| 428 | size_t __stacksize); | 
|---|
| 429 | extern int __pthread_attr_getstack (const pthread_attr_t *__restrict __attr, | 
|---|
| 430 | void **__restrict __stackaddr, | 
|---|
| 431 | size_t *__restrict __stacksize); | 
|---|
| 432 | extern int __pthread_attr_setstack (pthread_attr_t *__attr, void *__stackaddr, | 
|---|
| 433 | size_t __stacksize); | 
|---|
| 434 | extern int __pthread_rwlock_init (pthread_rwlock_t *__restrict __rwlock, | 
|---|
| 435 | const pthread_rwlockattr_t *__restrict | 
|---|
| 436 | __attr); | 
|---|
| 437 | extern int __pthread_rwlock_destroy (pthread_rwlock_t *__rwlock); | 
|---|
| 438 | extern int __pthread_rwlock_rdlock (pthread_rwlock_t *__rwlock); | 
|---|
| 439 | extern int __pthread_rwlock_tryrdlock (pthread_rwlock_t *__rwlock); | 
|---|
| 440 | extern int __pthread_rwlock_wrlock (pthread_rwlock_t *__rwlock); | 
|---|
| 441 | extern int __pthread_rwlock_trywrlock (pthread_rwlock_t *__rwlock); | 
|---|
| 442 | extern int __pthread_rwlock_unlock (pthread_rwlock_t *__rwlock); | 
|---|
| 443 | extern int __pthread_cond_broadcast (pthread_cond_t *cond); | 
|---|
| 444 | extern int __pthread_cond_destroy (pthread_cond_t *cond); | 
|---|
| 445 | extern int __pthread_cond_init (pthread_cond_t *cond, | 
|---|
| 446 | const pthread_condattr_t *cond_attr); | 
|---|
| 447 | extern int __pthread_cond_signal (pthread_cond_t *cond); | 
|---|
| 448 | extern int __pthread_cond_wait (pthread_cond_t *cond, pthread_mutex_t *mutex); | 
|---|
| 449 | extern int __pthread_cond_timedwait (pthread_cond_t *cond, | 
|---|
| 450 | pthread_mutex_t *mutex, | 
|---|
| 451 | const struct timespec *abstime); | 
|---|
| 452 | extern 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)); | 
|---|
| 457 | extern int __pthread_condattr_destroy (pthread_condattr_t *attr); | 
|---|
| 458 | extern int __pthread_condattr_init (pthread_condattr_t *attr); | 
|---|
| 459 | extern int __pthread_key_create (pthread_key_t *key, void (*destr) (void *)); | 
|---|
| 460 | extern int __pthread_key_delete (pthread_key_t key); | 
|---|
| 461 | extern void *__pthread_getspecific (pthread_key_t key); | 
|---|
| 462 | extern int __pthread_setspecific (pthread_key_t key, const void *value); | 
|---|
| 463 | extern int __pthread_once (pthread_once_t *once_control, | 
|---|
| 464 | void (*init_routine) (void)); | 
|---|
| 465 | extern int __pthread_atfork (void (*prepare) (void), void (*parent) (void), | 
|---|
| 466 | void (*child) (void)); | 
|---|
| 467 | extern pthread_t __pthread_self (void); | 
|---|
| 468 | extern int __pthread_equal (pthread_t thread1, pthread_t thread2); | 
|---|
| 469 | extern int __pthread_detach (pthread_t th); | 
|---|
| 470 | extern int __pthread_cancel (pthread_t th); | 
|---|
| 471 | extern int __pthread_kill (pthread_t threadid, int signo); | 
|---|
| 472 | extern void __pthread_exit (void *value) __attribute__ ((__noreturn__)); | 
|---|
| 473 | extern int __pthread_join (pthread_t threadid, void **thread_return); | 
|---|
| 474 | extern int __pthread_setcanceltype (int type, int *oldtype); | 
|---|
| 475 | extern int __pthread_enable_asynccancel (void) attribute_hidden; | 
|---|
| 476 | extern void __pthread_disable_asynccancel (int oldtype) attribute_hidden; | 
|---|
| 477 | extern void __pthread_testcancel (void); | 
|---|
| 478 | extern int __pthread_clockjoin_ex (pthread_t, void **, clockid_t, | 
|---|
| 479 | const struct timespec *, bool) | 
|---|
| 480 | attribute_hidden; | 
|---|
| 481 |  | 
|---|
| 482 |  | 
|---|
| 483 | #if IS_IN (libpthread) | 
|---|
| 484 | hidden_proto (__pthread_mutex_init) | 
|---|
| 485 | hidden_proto (__pthread_mutex_destroy) | 
|---|
| 486 | hidden_proto (__pthread_mutex_lock) | 
|---|
| 487 | hidden_proto (__pthread_mutex_trylock) | 
|---|
| 488 | hidden_proto (__pthread_mutex_unlock) | 
|---|
| 489 | hidden_proto (__pthread_rwlock_rdlock) | 
|---|
| 490 | hidden_proto (__pthread_rwlock_wrlock) | 
|---|
| 491 | hidden_proto (__pthread_rwlock_unlock) | 
|---|
| 492 | hidden_proto (__pthread_key_create) | 
|---|
| 493 | hidden_proto (__pthread_getspecific) | 
|---|
| 494 | hidden_proto (__pthread_setspecific) | 
|---|
| 495 | hidden_proto (__pthread_once) | 
|---|
| 496 | hidden_proto (__pthread_setcancelstate) | 
|---|
| 497 | hidden_proto (__pthread_testcancel) | 
|---|
| 498 | hidden_proto (__pthread_mutexattr_init) | 
|---|
| 499 | hidden_proto (__pthread_mutexattr_settype) | 
|---|
| 500 | #endif | 
|---|
| 501 |  | 
|---|
| 502 | extern int __pthread_cond_broadcast_2_0 (pthread_cond_2_0_t *cond); | 
|---|
| 503 | extern int __pthread_cond_destroy_2_0 (pthread_cond_2_0_t *cond); | 
|---|
| 504 | extern int __pthread_cond_init_2_0 (pthread_cond_2_0_t *cond, | 
|---|
| 505 | const pthread_condattr_t *cond_attr); | 
|---|
| 506 | extern int __pthread_cond_signal_2_0 (pthread_cond_2_0_t *cond); | 
|---|
| 507 | extern int __pthread_cond_timedwait_2_0 (pthread_cond_2_0_t *cond, | 
|---|
| 508 | pthread_mutex_t *mutex, | 
|---|
| 509 | const struct timespec *abstime); | 
|---|
| 510 | extern int __pthread_cond_wait_2_0 (pthread_cond_2_0_t *cond, | 
|---|
| 511 | pthread_mutex_t *mutex); | 
|---|
| 512 |  | 
|---|
| 513 | extern int __pthread_getaffinity_np (pthread_t th, size_t cpusetsize, | 
|---|
| 514 | cpu_set_t *cpuset); | 
|---|
| 515 |  | 
|---|
| 516 | #if IS_IN (libpthread) | 
|---|
| 517 | /* Special versions which use non-exported functions.  */ | 
|---|
| 518 | extern void __pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 519 | void (*routine) (void *), void *arg) | 
|---|
| 520 | attribute_hidden; | 
|---|
| 521 |  | 
|---|
| 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 |  | 
|---|
| 530 | extern void __pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 531 | int execute) attribute_hidden; | 
|---|
| 532 | # undef pthread_cleanup_pop | 
|---|
| 533 | # define pthread_cleanup_pop(execute)                   \ | 
|---|
| 534 | __pthread_cleanup_pop (&_buffer, (execute)); } | 
|---|
| 535 | #endif | 
|---|
| 536 |  | 
|---|
| 537 | extern void __pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 538 | void (*routine) (void *), void *arg); | 
|---|
| 539 | extern void __pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 540 | int execute); | 
|---|
| 541 |  | 
|---|
| 542 | /* Old cleanup interfaces, still used in libc.so.  */ | 
|---|
| 543 | extern void _pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 544 | void (*routine) (void *), void *arg); | 
|---|
| 545 | extern void _pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 546 | int execute); | 
|---|
| 547 | extern void _pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 548 | void (*routine) (void *), void *arg); | 
|---|
| 549 | extern void _pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer, | 
|---|
| 550 | int execute); | 
|---|
| 551 |  | 
|---|
| 552 | extern void __nptl_deallocate_tsd (void) attribute_hidden; | 
|---|
| 553 |  | 
|---|
| 554 | extern void __nptl_setxid_error (struct xid_command *cmdp, int error) | 
|---|
| 555 | attribute_hidden; | 
|---|
| 556 | extern int __nptl_setxid (struct xid_command *cmdp) attribute_hidden; | 
|---|
| 557 | #ifndef SHARED | 
|---|
| 558 | extern void __nptl_set_robust (struct pthread *self); | 
|---|
| 559 | #endif | 
|---|
| 560 |  | 
|---|
| 561 | extern void __nptl_stacks_freeres (void) attribute_hidden; | 
|---|
| 562 | extern void __shm_directory_freeres (void) attribute_hidden; | 
|---|
| 563 |  | 
|---|
| 564 | extern void __wait_lookup_done (void) attribute_hidden; | 
|---|
| 565 |  | 
|---|
| 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 |  | 
|---|
| 572 | /* Returns 0 if POL is a valid scheduling policy.  */ | 
|---|
| 573 | static inline int | 
|---|
| 574 | check_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.  */ | 
|---|
| 584 | static inline int | 
|---|
| 585 | check_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.  */ | 
|---|
| 598 | static inline int | 
|---|
| 599 | check_stacksize_attr (size_t st) | 
|---|
| 600 | { | 
|---|
| 601 | if (st >= PTHREAD_STACK_MIN) | 
|---|
| 602 | return 0; | 
|---|
| 603 |  | 
|---|
| 604 | return EINVAL; | 
|---|
| 605 | } | 
|---|
| 606 |  | 
|---|
| 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) 			\ | 
|---|
| 612 | _Static_assert (sizeof ((type) { { 0 } }).__size >= sizeof (internal),\ | 
|---|
| 613 | "sizeof (" #type ".__size) < sizeof (" #internal ")") | 
|---|
| 614 |  | 
|---|
| 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)) | 
|---|
| 620 | #define ASSERT_PTHREAD_INTERNAL_MEMBER_SIZE(type, member, mtype)	\ | 
|---|
| 621 | _Static_assert (sizeof (((type) { 0 }).member) != 8,	\ | 
|---|
| 622 | "sizeof (" #type "." #member ") != sizeof (" #mtype "))") | 
|---|
| 623 |  | 
|---|
| 624 | #endif	/* pthreadP.h */ | 
|---|
| 625 |  | 
|---|