nptl/pthreadP.h

   1 /* Copyright (C) 2002-2013 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    <http://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
  36 /* Atomic operations on TLS memory.  */
  37 #ifndef THREAD_ATOMIC_CMPXCHG_VAL
  38 # define THREAD_ATOMIC_CMPXCHG_VAL(descr, member, new, old) \
  39   atomic_compare_and_exchange_val_acq (&(descr)->member, new, old)
  40 #endif
  41
  42 #ifndef THREAD_ATOMIC_BIT_SET
  43 # define THREAD_ATOMIC_BIT_SET(descr, member, bit) \
  44   atomic_bit_set (&(descr)->member, bit)
  45 #endif
  46
  47
  48 /* Adaptive mutex definitions.  */
  49 #ifndef MAX_ADAPTIVE_COUNT
  50 # define MAX_ADAPTIVE_COUNT 100
  51 #endif
  52
  53
  54 /* Magic cookie representing robust mutex with dead owner.  */
  55 #define PTHREAD_MUTEX_INCONSISTENT      INT_MAX
  56 /* Magic cookie representing not recoverable robust mutex.  */
  57 #define PTHREAD_MUTEX_NOTRECOVERABLE    (INT_MAX - 1)
  58
  59
  60 /* Internal mutex type value.  */
  61 enum
  62 {
  63   PTHREAD_MUTEX_KIND_MASK_NP = 3,
  64   PTHREAD_MUTEX_ROBUST_NORMAL_NP = 16,
  65   PTHREAD_MUTEX_ROBUST_RECURSIVE_NP
  66   = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_RECURSIVE_NP,
  67   PTHREAD_MUTEX_ROBUST_ERRORCHECK_NP
  68   = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
  69   PTHREAD_MUTEX_ROBUST_ADAPTIVE_NP
  70   = PTHREAD_MUTEX_ROBUST_NORMAL_NP | PTHREAD_MUTEX_ADAPTIVE_NP,
  71   PTHREAD_MUTEX_PRIO_INHERIT_NP = 32,
  72   PTHREAD_MUTEX_PI_NORMAL_NP
  73   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_NORMAL,
  74   PTHREAD_MUTEX_PI_RECURSIVE_NP
  75   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_RECURSIVE_NP,
  76   PTHREAD_MUTEX_PI_ERRORCHECK_NP
  77   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
  78   PTHREAD_MUTEX_PI_ADAPTIVE_NP
  79   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ADAPTIVE_NP,
  80   PTHREAD_MUTEX_PI_ROBUST_NORMAL_NP
  81   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_NORMAL_NP,
  82   PTHREAD_MUTEX_PI_ROBUST_RECURSIVE_NP
  83   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_RECURSIVE_NP,
  84   PTHREAD_MUTEX_PI_ROBUST_ERRORCHECK_NP
  85   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_ERRORCHECK_NP,
  86   PTHREAD_MUTEX_PI_ROBUST_ADAPTIVE_NP
  87   = PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_ADAPTIVE_NP,
  88   PTHREAD_MUTEX_PRIO_PROTECT_NP = 64,
  89   PTHREAD_MUTEX_PP_NORMAL_NP
  90   = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_NORMAL,
  91   PTHREAD_MUTEX_PP_RECURSIVE_NP
  92   = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_RECURSIVE_NP,
  93   PTHREAD_MUTEX_PP_ERRORCHECK_NP
  94   = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_ERRORCHECK_NP,
  95   PTHREAD_MUTEX_PP_ADAPTIVE_NP
  96   = PTHREAD_MUTEX_PRIO_PROTECT_NP | PTHREAD_MUTEX_ADAPTIVE_NP
  97 };
  98 #define PTHREAD_MUTEX_PSHARED_BIT 128
  99
 100 #define PTHREAD_MUTEX_TYPE(m) \
 101   ((m)->__data.__kind & 127)
 102
 103 #if LLL_PRIVATE == 0 && LLL_SHARED == 128
 104 # define PTHREAD_MUTEX_PSHARED(m) \
 105   ((m)->__data.__kind & 128)
 106 #else
 107 # define PTHREAD_MUTEX_PSHARED(m) \
 108   (((m)->__data.__kind & 128) ? LLL_SHARED : LLL_PRIVATE)
 109 #endif
 110
 111 /* The kernel when waking robust mutexes on exit never uses
 112    FUTEX_PRIVATE_FLAG FUTEX_WAKE.  */
 113 #define PTHREAD_ROBUST_MUTEX_PSHARED(m) LLL_SHARED
 114
 115 /* Ceiling in __data.__lock.  __data.__lock is signed, so don't
 116    use the MSB bit in there, but in the mask also include that bit,
 117    so that the compiler can optimize & PTHREAD_MUTEX_PRIO_CEILING_MASK
 118    masking if the value is then shifted down by
 119    PTHREAD_MUTEX_PRIO_CEILING_SHIFT.  */
 120 #define PTHREAD_MUTEX_PRIO_CEILING_SHIFT        19
 121 #define PTHREAD_MUTEX_PRIO_CEILING_MASK         0xfff80000
 122
 123
 124 /* Flags in mutex attr.  */
 125 #define PTHREAD_MUTEXATTR_PROTOCOL_SHIFT        28
 126 #define PTHREAD_MUTEXATTR_PROTOCOL_MASK         0x30000000
 127 #define PTHREAD_MUTEXATTR_PRIO_CEILING_SHIFT    12
 128 #define PTHREAD_MUTEXATTR_PRIO_CEILING_MASK     0x00fff000
 129 #define PTHREAD_MUTEXATTR_FLAG_ROBUST           0x40000000
 130 #define PTHREAD_MUTEXATTR_FLAG_PSHARED          0x80000000
 131 #define PTHREAD_MUTEXATTR_FLAG_BITS \
 132   (PTHREAD_MUTEXATTR_FLAG_ROBUST | PTHREAD_MUTEXATTR_FLAG_PSHARED \
 133    | PTHREAD_MUTEXATTR_PROTOCOL_MASK | PTHREAD_MUTEXATTR_PRIO_CEILING_MASK)
 134
 135
 136 /* Check whether rwlock prefers readers.   */
 137 #define PTHREAD_RWLOCK_PREFER_READER_P(rwlock) \
 138   ((rwlock)->__data.__flags == 0)
 139
 140
 141 /* Bits used in robust mutex implementation.  */
 142 #define FUTEX_WAITERS           0x80000000
 143 #define FUTEX_OWNER_DIED        0x40000000
 144 #define FUTEX_TID_MASK          0x3fffffff
 145
 146
 147 /* Internal variables.  */
 148
 149
 150 /* Default pthread attributes.  */
 151 extern struct pthread_attr __default_pthread_attr attribute_hidden;
 152
 153 /* Size and alignment of static TLS block.  */
 154 extern size_t __static_tls_size attribute_hidden;
 155 extern size_t __static_tls_align_m1 attribute_hidden;
 156
 157 /* Flag whether the machine is SMP or not.  */
 158 extern int __is_smp attribute_hidden;
 159
 160 /* Thread descriptor handling.  */
 161 extern list_t __stack_user;
 162 hidden_proto (__stack_user)
 163
 164 /* Attribute handling.  */
 165 extern struct pthread_attr *__attr_list attribute_hidden;
 166 extern int __attr_list_lock attribute_hidden;
 167
 168 /* First available RT signal.  */
 169 extern int __current_sigrtmin attribute_hidden;
 170 /* Last available RT signal.  */
 171 extern int __current_sigrtmax attribute_hidden;
 172
 173 /* Concurrency handling.  */
 174 extern int __concurrency_level attribute_hidden;
 175
 176 /* Thread-local data key handling.  */
 177 extern struct pthread_key_struct __pthread_keys[PTHREAD_KEYS_MAX];
 178 hidden_proto (__pthread_keys)
 179
 180 /* Number of threads running.  */
 181 extern unsigned int __nptl_nthreads attribute_hidden;
 182
 183 #ifndef __ASSUME_SET_ROBUST_LIST
 184 /* Negative if we do not have the system call and we can use it.  */
 185 extern int __set_robust_list_avail attribute_hidden;
 186 #endif
 187
 188 /* Thread Priority Protection.  */
 189 extern int __sched_fifo_min_prio attribute_hidden;
 190 extern int __sched_fifo_max_prio attribute_hidden;
 191 extern void __init_sched_fifo_prio (void) attribute_hidden;
 192 extern int __pthread_tpp_change_priority (int prev_prio, int new_prio)
 193      attribute_hidden;
 194 extern int __pthread_current_priority (void) attribute_hidden;
 195
 196 /* The library can run in debugging mode where it performs a lot more
 197    tests.  */
 198 extern int __pthread_debug attribute_hidden;
 199 /** For now disable debugging support.  */
 200 #if 0
 201 # define DEBUGGING_P __builtin_expect (__pthread_debug, 0)
 202 # define INVALID_TD_P(pd) (DEBUGGING_P && __find_in_stack_list (pd) == NULL)
 203 # define INVALID_NOT_TERMINATED_TD_P(pd) INVALID_TD_P (pd)
 204 #else
 205 # define DEBUGGING_P 0
 206 /* Simplified test.  This will not catch all invalid descriptors but
 207    is better than nothing.  And if the test triggers the thread
 208    descriptor is guaranteed to be invalid.  */
 209 # define INVALID_TD_P(pd) __builtin_expect ((pd)->tid <= 0, 0)
 210 # define INVALID_NOT_TERMINATED_TD_P(pd) __builtin_expect ((pd)->tid < 0, 0)
 211 #endif
 212
 213
 214 /* Cancellation test.  */
 215 #define CANCELLATION_P(self) \
 216   do {                                                                        \
 217     int cancelhandling = THREAD_GETMEM (self, cancelhandling);                \
 218     if (CANCEL_ENABLED_AND_CANCELED (cancelhandling))                         \
 219       {                                                                       \
 220         THREAD_SETMEM (self, result, PTHREAD_CANCELED);                       \
 221         __do_cancel ();                                                       \
 222       }                                                                       \
 223   } while (0)
 224
 225
 226 extern void __pthread_unwind (__pthread_unwind_buf_t *__buf)
 227      __cleanup_fct_attribute __attribute ((__noreturn__))
 228 #if !defined SHARED && !defined IS_IN_libpthread
 229      weak_function
 230 #endif
 231      ;
 232 extern void __pthread_unwind_next (__pthread_unwind_buf_t *__buf)
 233      __cleanup_fct_attribute __attribute ((__noreturn__))
 234 #ifndef SHARED
 235      weak_function
 236 #endif
 237      ;
 238 extern void __pthread_register_cancel (__pthread_unwind_buf_t *__buf)
 239      __cleanup_fct_attribute;
 240 extern void __pthread_unregister_cancel (__pthread_unwind_buf_t *__buf)
 241      __cleanup_fct_attribute;
 242 #if defined NOT_IN_libc && defined IS_IN_libpthread
 243 hidden_proto (__pthread_unwind)
 244 hidden_proto (__pthread_unwind_next)
 245 hidden_proto (__pthread_register_cancel)
 246 hidden_proto (__pthread_unregister_cancel)
 247 # ifdef SHARED
 248 extern void attribute_hidden pthread_cancel_init (void);
 249 extern void __unwind_freeres (void);
 250 # endif
 251 #endif
 252
 253
 254 /* Called when a thread reacts on a cancellation request.  */
 255 static inline void
 256 __attribute ((noreturn, always_inline))
 257 __do_cancel (void)
 258 {
 259   struct pthread *self = THREAD_SELF;
 260
 261   /* Make sure we get no more cancellations.  */
 262   THREAD_ATOMIC_BIT_SET (self, cancelhandling, EXITING_BIT);
 263
 264   __pthread_unwind ((__pthread_unwind_buf_t *)
 265                     THREAD_GETMEM (self, cleanup_jmp_buf));
 266 }
 267
 268
 269 /* Set cancellation mode to asynchronous.  */
 270 #define CANCEL_ASYNC() \
 271   __pthread_enable_asynccancel ()
 272 /* Reset to previous cancellation mode.  */
 273 #define CANCEL_RESET(oldtype) \
 274   __pthread_disable_asynccancel (oldtype)
 275
 276 #if !defined NOT_IN_libc
 277 /* Same as CANCEL_ASYNC, but for use in libc.so.  */
 278 # define LIBC_CANCEL_ASYNC() \
 279   __libc_enable_asynccancel ()
 280 /* Same as CANCEL_RESET, but for use in libc.so.  */
 281 # define LIBC_CANCEL_RESET(oldtype) \
 282   __libc_disable_asynccancel (oldtype)
 283 # define LIBC_CANCEL_HANDLED() \
 284   __asm (".globl " __SYMBOL_PREFIX "__libc_enable_asynccancel"); \
 285   __asm (".globl " __SYMBOL_PREFIX "__libc_disable_asynccancel")
 286 #elif defined NOT_IN_libc && defined IS_IN_libpthread
 287 # define LIBC_CANCEL_ASYNC() CANCEL_ASYNC ()
 288 # define LIBC_CANCEL_RESET(val) CANCEL_RESET (val)
 289 # define LIBC_CANCEL_HANDLED() \
 290   __asm (".globl " __SYMBOL_PREFIX "__pthread_enable_asynccancel"); \
 291   __asm (".globl " __SYMBOL_PREFIX "__pthread_disable_asynccancel")
 292 #elif defined NOT_IN_libc && defined IS_IN_librt
 293 # define LIBC_CANCEL_ASYNC() \
 294   __librt_enable_asynccancel ()
 295 # define LIBC_CANCEL_RESET(val) \
 296   __librt_disable_asynccancel (val)
 297 # define LIBC_CANCEL_HANDLED() \
 298   __asm (".globl " __SYMBOL_PREFIX "__librt_enable_asynccancel"); \
 299   __asm (".globl " __SYMBOL_PREFIX "__librt_disable_asynccancel")
 300 #else
 301 # define LIBC_CANCEL_ASYNC()    0 /* Just a dummy value.  */
 302 # define LIBC_CANCEL_RESET(val) ((void)(val)) /* Nothing, but evaluate it.  */
 303 # define LIBC_CANCEL_HANDLED()  /* Nothing.  */
 304 #endif
 305
 306 /* The signal used for asynchronous cancelation.  */
 307 #define SIGCANCEL       __SIGRTMIN
 308
 309
 310 /* Signal needed for the kernel-supported POSIX timer implementation.
 311    We can reuse the cancellation signal since we can distinguish
 312    cancellation from timer expirations.  */
 313 #define SIGTIMER        SIGCANCEL
 314
 315
 316 /* Signal used to implement the setuid et.al. functions.  */
 317 #define SIGSETXID       (__SIGRTMIN + 1)
 318
 319 /* Used to communicate with signal handler.  */
 320 extern struct xid_command *__xidcmd attribute_hidden;
 321
 322
 323 /* Internal prototypes.  */
 324
 325 /* Thread list handling.  */
 326 extern struct pthread *__find_in_stack_list (struct pthread *pd)
 327      attribute_hidden internal_function;
 328
 329 /* Deallocate a thread's stack after optionally making sure the thread
 330    descriptor is still valid.  */
 331 extern void __free_tcb (struct pthread *pd) attribute_hidden internal_function;
 332
 333 /* Free allocated stack.  */
 334 extern void __deallocate_stack (struct pthread *pd)
 335      attribute_hidden internal_function;
 336
 337 /* Mark all the stacks except for the current one as available.  This
 338    function also re-initializes the lock for the stack cache.  */
 339 extern void __reclaim_stacks (void) attribute_hidden;
 340
 341 /* Make all threads's stacks executable.  */
 342 extern int __make_stacks_executable (void **stack_endp)
 343      internal_function attribute_hidden;
 344
 345 /* longjmp handling.  */
 346 extern void __pthread_cleanup_upto (__jmp_buf target, char *targetframe);
 347 #if defined NOT_IN_libc && defined IS_IN_libpthread
 348 hidden_proto (__pthread_cleanup_upto)
 349 #endif
 350
 351
 352 /* Functions with versioned interfaces.  */
 353 extern int __pthread_create_2_1 (pthread_t *newthread,
 354                                  const pthread_attr_t *attr,
 355                                  void *(*start_routine) (void *), void *arg);
 356 extern int __pthread_create_2_0 (pthread_t *newthread,
 357                                  const pthread_attr_t *attr,
 358                                  void *(*start_routine) (void *), void *arg);
 359 extern int __pthread_attr_init_2_1 (pthread_attr_t *attr);
 360 extern int __pthread_attr_init_2_0 (pthread_attr_t *attr);
 361
 362
 363 /* Event handlers for libthread_db interface.  */
 364 extern void __nptl_create_event (void);
 365 extern void __nptl_death_event (void);
 366 hidden_proto (__nptl_create_event)
 367 hidden_proto (__nptl_death_event)
 368
 369 /* Register the generation counter in the libpthread with the libc.  */
 370 #ifdef TLS_MULTIPLE_THREADS_IN_TCB
 371 extern void __libc_pthread_init (unsigned long int *ptr,
 372                                  void (*reclaim) (void),
 373                                  const struct pthread_functions *functions)
 374      internal_function;
 375 #else
 376 extern int *__libc_pthread_init (unsigned long int *ptr,
 377                                  void (*reclaim) (void),
 378                                  const struct pthread_functions *functions)
 379      internal_function;
 380
 381 /* Variable set to a nonzero value either if more than one thread runs or ran,
 382    or if a single-threaded process is trying to cancel itself.  See
 383    nptl/descr.h for more context on the single-threaded process case.  */
 384 extern int __pthread_multiple_threads attribute_hidden;
 385 /* Pointer to the corresponding variable in libc.  */
 386 extern int *__libc_multiple_threads_ptr attribute_hidden;
 387 #endif
 388
 389 /* Find a thread given its TID.  */
 390 extern struct pthread *__find_thread_by_id (pid_t tid) attribute_hidden
 391 #ifdef SHARED
 392 ;
 393 #else
 394 weak_function;
 395 #define __find_thread_by_id(tid) \
 396   (__find_thread_by_id ? (__find_thread_by_id) (tid) : (struct pthread *) NULL)
 397 #endif
 398
 399 extern void __pthread_init_static_tls (struct link_map *) attribute_hidden;
 400
 401 extern size_t __pthread_get_minstack (const pthread_attr_t *attr);
 402
 403 /* Namespace save aliases.  */
 404 extern int __pthread_getschedparam (pthread_t thread_id, int *policy,
 405                                     struct sched_param *param);
 406 extern int __pthread_setschedparam (pthread_t thread_id, int policy,
 407                                     const struct sched_param *param);
 408 extern int __pthread_setcancelstate (int state, int *oldstate);
 409 extern int __pthread_mutex_init (pthread_mutex_t *__mutex,
 410                                  const pthread_mutexattr_t *__mutexattr);
 411 extern int __pthread_mutex_destroy (pthread_mutex_t *__mutex);
 412 extern int __pthread_mutex_trylock (pthread_mutex_t *_mutex);
 413 extern int __pthread_mutex_lock (pthread_mutex_t *__mutex);
 414 extern int __pthread_mutex_cond_lock (pthread_mutex_t *__mutex)
 415      attribute_hidden internal_function;
 416 extern void __pthread_mutex_cond_lock_adjust (pthread_mutex_t *__mutex)
 417      attribute_hidden internal_function;
 418 extern int __pthread_mutex_unlock (pthread_mutex_t *__mutex);
 419 extern int __pthread_mutex_unlock_usercnt (pthread_mutex_t *__mutex,
 420                                            int __decr)
 421      attribute_hidden internal_function;
 422 extern int __pthread_mutexattr_init (pthread_mutexattr_t *attr);
 423 extern int __pthread_mutexattr_destroy (pthread_mutexattr_t *attr);
 424 extern int __pthread_mutexattr_settype (pthread_mutexattr_t *attr, int kind);
 425 extern int __pthread_attr_destroy (pthread_attr_t *attr);
 426 extern int __pthread_attr_getdetachstate (const pthread_attr_t *attr,
 427                                           int *detachstate);
 428 extern int __pthread_attr_setdetachstate (pthread_attr_t *attr,
 429                                           int detachstate);
 430 extern int __pthread_attr_getinheritsched (const pthread_attr_t *attr,
 431                                            int *inherit);
 432 extern int __pthread_attr_setinheritsched (pthread_attr_t *attr, int inherit);
 433 extern int __pthread_attr_getschedparam (const pthread_attr_t *attr,
 434                                          struct sched_param *param);
 435 extern int __pthread_attr_setschedparam (pthread_attr_t *attr,
 436                                          const struct sched_param *param);
 437 extern int __pthread_attr_getschedpolicy (const pthread_attr_t *attr,
 438                                           int *policy);
 439 extern int __pthread_attr_setschedpolicy (pthread_attr_t *attr, int policy);
 440 extern int __pthread_attr_getscope (const pthread_attr_t *attr, int *scope);
 441 extern int __pthread_attr_setscope (pthread_attr_t *attr, int scope);
 442 extern int __pthread_attr_getstackaddr (const pthread_attr_t *__restrict
 443                                         __attr, void **__restrict __stackaddr);
 444 extern int __pthread_attr_setstackaddr (pthread_attr_t *__attr,
 445                                         void *__stackaddr);
 446 extern int __pthread_attr_getstacksize (const pthread_attr_t *__restrict
 447                                         __attr,
 448                                         size_t *__restrict __stacksize);
 449 extern int __pthread_attr_setstacksize (pthread_attr_t *__attr,
 450                                         size_t __stacksize);
 451 extern int __pthread_attr_getstack (const pthread_attr_t *__restrict __attr,
 452                                     void **__restrict __stackaddr,
 453                                     size_t *__restrict __stacksize);
 454 extern int __pthread_attr_setstack (pthread_attr_t *__attr, void *__stackaddr,
 455                                     size_t __stacksize);
 456 extern int __pthread_rwlock_init (pthread_rwlock_t *__restrict __rwlock,
 457                                   const pthread_rwlockattr_t *__restrict
 458                                   __attr);
 459 extern int __pthread_rwlock_destroy (pthread_rwlock_t *__rwlock);
 460 extern int __pthread_rwlock_rdlock (pthread_rwlock_t *__rwlock);
 461 extern int __pthread_rwlock_tryrdlock (pthread_rwlock_t *__rwlock);
 462 extern int __pthread_rwlock_wrlock (pthread_rwlock_t *__rwlock);
 463 extern int __pthread_rwlock_trywrlock (pthread_rwlock_t *__rwlock);
 464 extern int __pthread_rwlock_unlock (pthread_rwlock_t *__rwlock);
 465 extern int __pthread_cond_broadcast (pthread_cond_t *cond);
 466 extern int __pthread_cond_destroy (pthread_cond_t *cond);
 467 extern int __pthread_cond_init (pthread_cond_t *cond,
 468                                 const pthread_condattr_t *cond_attr);
 469 extern int __pthread_cond_signal (pthread_cond_t *cond);
 470 extern int __pthread_cond_wait (pthread_cond_t *cond, pthread_mutex_t *mutex);
 471 extern int __pthread_cond_timedwait (pthread_cond_t *cond,
 472                                      pthread_mutex_t *mutex,
 473                                      const struct timespec *abstime);
 474 extern int __pthread_condattr_destroy (pthread_condattr_t *attr);
 475 extern int __pthread_condattr_init (pthread_condattr_t *attr);
 476 extern int __pthread_key_create (pthread_key_t *key, void (*destr) (void *));
 477 extern void *__pthread_getspecific (pthread_key_t key);
 478 extern int __pthread_setspecific (pthread_key_t key, const void *value);
 479 extern int __pthread_once (pthread_once_t *once_control,
 480                            void (*init_routine) (void));
 481 extern int __pthread_atfork (void (*prepare) (void), void (*parent) (void),
 482                              void (*child) (void));
 483 extern pthread_t __pthread_self (void);
 484 extern int __pthread_equal (pthread_t thread1, pthread_t thread2);
 485 extern int __pthread_kill (pthread_t threadid, int signo);
 486 extern void __pthread_exit (void *value) __attribute__ ((__noreturn__));
 487 extern int __pthread_setcanceltype (int type, int *oldtype);
 488 extern int __pthread_enable_asynccancel (void) attribute_hidden;
 489 extern void __pthread_disable_asynccancel (int oldtype)
 490      internal_function attribute_hidden;
 491
 492 #if defined NOT_IN_libc && defined IS_IN_libpthread
 493 hidden_proto (__pthread_mutex_init)
 494 hidden_proto (__pthread_mutex_destroy)
 495 hidden_proto (__pthread_mutex_lock)
 496 hidden_proto (__pthread_mutex_unlock)
 497 hidden_proto (__pthread_rwlock_rdlock)
 498 hidden_proto (__pthread_rwlock_wrlock)
 499 hidden_proto (__pthread_rwlock_unlock)
 500 hidden_proto (__pthread_key_create)
 501 hidden_proto (__pthread_getspecific)
 502 hidden_proto (__pthread_setspecific)
 503 hidden_proto (__pthread_once)
 504 #endif
 505
 506 extern int __pthread_cond_broadcast_2_0 (pthread_cond_2_0_t *cond);
 507 extern int __pthread_cond_destroy_2_0 (pthread_cond_2_0_t *cond);
 508 extern int __pthread_cond_init_2_0 (pthread_cond_2_0_t *cond,
 509                                     const pthread_condattr_t *cond_attr);
 510 extern int __pthread_cond_signal_2_0 (pthread_cond_2_0_t *cond);
 511 extern int __pthread_cond_timedwait_2_0 (pthread_cond_2_0_t *cond,
 512                                          pthread_mutex_t *mutex,
 513                                          const struct timespec *abstime);
 514 extern int __pthread_cond_wait_2_0 (pthread_cond_2_0_t *cond,
 515                                     pthread_mutex_t *mutex);
 516
 517 extern int __pthread_getaffinity_np (pthread_t th, size_t cpusetsize,
 518                                      cpu_set_t *cpuset);
 519
 520 /* The two functions are in libc.so and not exported.  */
 521 extern int __libc_enable_asynccancel (void) attribute_hidden;
 522 extern void __libc_disable_asynccancel (int oldtype)
 523      internal_function attribute_hidden;
 524
 525
 526 /* The two functions are in librt.so and not exported.  */
 527 extern int __librt_enable_asynccancel (void) attribute_hidden;
 528 extern void __librt_disable_asynccancel (int oldtype)
 529      internal_function attribute_hidden;
 530
 531 #ifdef IS_IN_libpthread
 532 /* Special versions which use non-exported functions.  */
 533 extern void __pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer,
 534                                     void (*routine) (void *), void *arg)
 535      attribute_hidden;
 536 # undef pthread_cleanup_push
 537 # define pthread_cleanup_push(routine,arg) \
 538   { struct _pthread_cleanup_buffer _buffer;                                   \
 539     __pthread_cleanup_push (&_buffer, (routine), (arg));
 540
 541 extern void __pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer,
 542                                    int execute) attribute_hidden;
 543 # undef pthread_cleanup_pop
 544 # define pthread_cleanup_pop(execute) \
 545     __pthread_cleanup_pop (&_buffer, (execute)); }
 546 #endif
 547
 548 extern void __pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer,
 549                                           void (*routine) (void *), void *arg);
 550 extern void __pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer,
 551                                            int execute);
 552
 553 /* Old cleanup interfaces, still used in libc.so.  */
 554 extern void _pthread_cleanup_push (struct _pthread_cleanup_buffer *buffer,
 555                                    void (*routine) (void *), void *arg);
 556 extern void _pthread_cleanup_pop (struct _pthread_cleanup_buffer *buffer,
 557                                   int execute);
 558 extern void _pthread_cleanup_push_defer (struct _pthread_cleanup_buffer *buffer,
 559                                          void (*routine) (void *), void *arg);
 560 extern void _pthread_cleanup_pop_restore (struct _pthread_cleanup_buffer *buffer,
 561                                           int execute);
 562
 563 extern void __nptl_deallocate_tsd (void) attribute_hidden;
 564
 565 extern int __nptl_setxid (struct xid_command *cmdp) attribute_hidden;
 566 #ifndef SHARED
 567 extern void __nptl_set_robust (struct pthread *self);
 568 #endif
 569
 570 extern void __free_stacks (size_t limit) attribute_hidden;
 571
 572 extern void __wait_lookup_done (void) attribute_hidden;
 573
 574 #ifdef SHARED
 575 # define PTHREAD_STATIC_FN_REQUIRE(name)
 576 #else
 577 # define PTHREAD_STATIC_FN_REQUIRE(name) __asm (".globl " #name);
 578 #endif
 579
 580 /* Test if the mutex is suitable for the FUTEX_WAIT_REQUEUE_PI operation.  */
 581 #if (defined lll_futex_wait_requeue_pi \
 582      && defined __ASSUME_REQUEUE_PI)
 583 # define USE_REQUEUE_PI(mut) \
 584    ((mut) && (mut) != (void *) ~0l \
 585     && (((mut)->__data.__kind \
 586          & (PTHREAD_MUTEX_PRIO_INHERIT_NP | PTHREAD_MUTEX_ROBUST_NORMAL_NP)) \
 587         == PTHREAD_MUTEX_PRIO_INHERIT_NP))
 588 #else
 589 # define USE_REQUEUE_PI(mut) 0
 590 #endif
 591
 592 /* Returns 0 if POL is a valid scheduling policy.  */
 593 static inline int
 594 check_sched_policy_attr (int pol)
 595 {
 596   if (pol == SCHED_OTHER || pol == SCHED_FIFO || pol == SCHED_RR)
 597     return 0;
 598
 599   return EINVAL;
 600 }
 601
 602 /* Returns 0 if PR is within the accepted range of priority values for
 603    the scheduling policy POL or EINVAL otherwise.  */
 604 static inline int
 605 check_sched_priority_attr (int pr, int pol)
 606 {
 607   int min = __sched_get_priority_min (pol);
 608   int max = __sched_get_priority_max (pol);
 609
 610   if (min >= 0 && max >= 0 && pr >= min && pr <= max)
 611     return 0;
 612
 613   return EINVAL;
 614 }
 615
 616 /* Returns 0 if ST is a valid stack size for a thread stack and EINVAL
 617    otherwise.  */
 618 static inline int
 619 check_stacksize_attr (size_t st)
 620 {
 621   if (st >= PTHREAD_STACK_MIN)
 622     return 0;
 623
 624   return EINVAL;
 625 }
 626
 627 /* Defined in pthread_setaffinity.c.  */
 628 extern size_t __kernel_cpumask_size attribute_hidden;
 629 extern int __determine_cpumask_size (pid_t tid);
 630
 631 /* Returns 0 if CS and SZ are valid values for the cpuset and cpuset size
 632    respectively.  Otherwise it returns an error number.  */
 633 static inline int
 634 check_cpuset_attr (const cpu_set_t *cs, const size_t sz)
 635 {
 636   if (__kernel_cpumask_size == 0)
 637     {
 638       int res = __determine_cpumask_size (THREAD_SELF->tid);
 639       if (res)
 640         return res;
 641     }
 642
 643   /* Check whether the new bitmask has any bit set beyond the
 644      last one the kernel accepts.  */
 645   for (size_t cnt = __kernel_cpumask_size; cnt < sz; ++cnt)
 646     if (((char *) cs)[cnt] != '\0')
 647       /* Found a nonzero byte.  This means the user request cannot be
 648          fulfilled.  */
 649       return EINVAL;
 650
 651   return 0;
 652 }
 653
 654 #endif  /* pthreadP.h */