| 1 | /* Copyright (C) 2002-2018 Free Software Foundation, Inc. | 
|---|
| 2 | This file is part of the GNU C Library. | 
|---|
| 3 |  | 
|---|
| 4 | The GNU C Library is free software; you can redistribute it and/or | 
|---|
| 5 | modify it under the terms of the GNU Lesser General Public | 
|---|
| 6 | License as published by the Free Software Foundation; either | 
|---|
| 7 | version 2.1 of the License, or (at your option) any later version. | 
|---|
| 8 |  | 
|---|
| 9 | The GNU C Library is distributed in the hope that it will be useful, | 
|---|
| 10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 
|---|
| 11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU | 
|---|
| 12 | Lesser General Public License for more details. | 
|---|
| 13 |  | 
|---|
| 14 | You should have received a copy of the GNU Lesser General Public | 
|---|
| 15 | License along with the GNU C Library; if not, see | 
|---|
| 16 | <http://www.gnu.org/licenses/>.  */ | 
|---|
| 17 |  | 
|---|
| 18 | #ifndef _PTHREAD_H | 
|---|
| 19 | #define _PTHREAD_H	1 | 
|---|
| 20 |  | 
|---|
| 21 | #include <features.h> | 
|---|
| 22 | #include <endian.h> | 
|---|
| 23 | #include <sched.h> | 
|---|
| 24 | #include <time.h> | 
|---|
| 25 |  | 
|---|
| 26 | #include <bits/pthreadtypes.h> | 
|---|
| 27 | #include <bits/setjmp.h> | 
|---|
| 28 | #include <bits/wordsize.h> | 
|---|
| 29 | #include <bits/types/struct_timespec.h> | 
|---|
| 30 |  | 
|---|
| 31 |  | 
|---|
| 32 | /* Detach state.  */ | 
|---|
| 33 | enum | 
|---|
| 34 | { | 
|---|
| 35 | PTHREAD_CREATE_JOINABLE, | 
|---|
| 36 | #define PTHREAD_CREATE_JOINABLE	PTHREAD_CREATE_JOINABLE | 
|---|
| 37 | PTHREAD_CREATE_DETACHED | 
|---|
| 38 | #define PTHREAD_CREATE_DETACHED	PTHREAD_CREATE_DETACHED | 
|---|
| 39 | }; | 
|---|
| 40 |  | 
|---|
| 41 |  | 
|---|
| 42 | /* Mutex types.  */ | 
|---|
| 43 | enum | 
|---|
| 44 | { | 
|---|
| 45 | PTHREAD_MUTEX_TIMED_NP, | 
|---|
| 46 | PTHREAD_MUTEX_RECURSIVE_NP, | 
|---|
| 47 | PTHREAD_MUTEX_ERRORCHECK_NP, | 
|---|
| 48 | PTHREAD_MUTEX_ADAPTIVE_NP | 
|---|
| 49 | #if defined __USE_UNIX98 || defined __USE_XOPEN2K8 | 
|---|
| 50 | , | 
|---|
| 51 | PTHREAD_MUTEX_NORMAL = PTHREAD_MUTEX_TIMED_NP, | 
|---|
| 52 | PTHREAD_MUTEX_RECURSIVE = PTHREAD_MUTEX_RECURSIVE_NP, | 
|---|
| 53 | PTHREAD_MUTEX_ERRORCHECK = PTHREAD_MUTEX_ERRORCHECK_NP, | 
|---|
| 54 | PTHREAD_MUTEX_DEFAULT = PTHREAD_MUTEX_NORMAL | 
|---|
| 55 | #endif | 
|---|
| 56 | #ifdef __USE_GNU | 
|---|
| 57 | /* For compatibility.  */ | 
|---|
| 58 | , PTHREAD_MUTEX_FAST_NP = PTHREAD_MUTEX_TIMED_NP | 
|---|
| 59 | #endif | 
|---|
| 60 | }; | 
|---|
| 61 |  | 
|---|
| 62 |  | 
|---|
| 63 | #ifdef __USE_XOPEN2K | 
|---|
| 64 | /* Robust mutex or not flags.  */ | 
|---|
| 65 | enum | 
|---|
| 66 | { | 
|---|
| 67 | PTHREAD_MUTEX_STALLED, | 
|---|
| 68 | PTHREAD_MUTEX_STALLED_NP = PTHREAD_MUTEX_STALLED, | 
|---|
| 69 | PTHREAD_MUTEX_ROBUST, | 
|---|
| 70 | PTHREAD_MUTEX_ROBUST_NP = PTHREAD_MUTEX_ROBUST | 
|---|
| 71 | }; | 
|---|
| 72 | #endif | 
|---|
| 73 |  | 
|---|
| 74 |  | 
|---|
| 75 | #if defined __USE_POSIX199506 || defined __USE_UNIX98 | 
|---|
| 76 | /* Mutex protocols.  */ | 
|---|
| 77 | enum | 
|---|
| 78 | { | 
|---|
| 79 | PTHREAD_PRIO_NONE, | 
|---|
| 80 | PTHREAD_PRIO_INHERIT, | 
|---|
| 81 | PTHREAD_PRIO_PROTECT | 
|---|
| 82 | }; | 
|---|
| 83 | #endif | 
|---|
| 84 |  | 
|---|
| 85 |  | 
|---|
| 86 | #if __PTHREAD_MUTEX_HAVE_PREV | 
|---|
| 87 | # define PTHREAD_MUTEX_INITIALIZER \ | 
|---|
| 88 | { { 0, 0, 0, 0, 0, __PTHREAD_SPINS, { 0, 0 } } } | 
|---|
| 89 | # ifdef __USE_GNU | 
|---|
| 90 | #  define PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP \ | 
|---|
| 91 | { { 0, 0, 0, 0, PTHREAD_MUTEX_RECURSIVE_NP, __PTHREAD_SPINS, { 0, 0 } } } | 
|---|
| 92 | #  define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP \ | 
|---|
| 93 | { { 0, 0, 0, 0, PTHREAD_MUTEX_ERRORCHECK_NP, __PTHREAD_SPINS, { 0, 0 } } } | 
|---|
| 94 | #  define PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP \ | 
|---|
| 95 | { { 0, 0, 0, 0, PTHREAD_MUTEX_ADAPTIVE_NP, __PTHREAD_SPINS, { 0, 0 } } } | 
|---|
| 96 |  | 
|---|
| 97 | # endif | 
|---|
| 98 | #else | 
|---|
| 99 | # define PTHREAD_MUTEX_INITIALIZER \ | 
|---|
| 100 | { { 0, 0, 0, 0, 0, { __PTHREAD_SPINS } } } | 
|---|
| 101 | # ifdef __USE_GNU | 
|---|
| 102 | #  define PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP \ | 
|---|
| 103 | { { 0, 0, 0, PTHREAD_MUTEX_RECURSIVE_NP, 0, { __PTHREAD_SPINS } } } | 
|---|
| 104 | #  define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP \ | 
|---|
| 105 | { { 0, 0, 0, PTHREAD_MUTEX_ERRORCHECK_NP, 0, { __PTHREAD_SPINS } } } | 
|---|
| 106 | #  define PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP \ | 
|---|
| 107 | { { 0, 0, 0, PTHREAD_MUTEX_ADAPTIVE_NP, 0, { __PTHREAD_SPINS } } } | 
|---|
| 108 |  | 
|---|
| 109 | # endif | 
|---|
| 110 | #endif | 
|---|
| 111 |  | 
|---|
| 112 |  | 
|---|
| 113 | /* Read-write lock types.  */ | 
|---|
| 114 | #if defined __USE_UNIX98 || defined __USE_XOPEN2K | 
|---|
| 115 | enum | 
|---|
| 116 | { | 
|---|
| 117 | PTHREAD_RWLOCK_PREFER_READER_NP, | 
|---|
| 118 | PTHREAD_RWLOCK_PREFER_WRITER_NP, | 
|---|
| 119 | PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP, | 
|---|
| 120 | PTHREAD_RWLOCK_DEFAULT_NP = PTHREAD_RWLOCK_PREFER_READER_NP | 
|---|
| 121 | }; | 
|---|
| 122 |  | 
|---|
| 123 | /* Define __PTHREAD_RWLOCK_INT_FLAGS_SHARED to 1 if pthread_rwlock_t | 
|---|
| 124 | has the shared field.  All 64-bit architectures have the shared field | 
|---|
| 125 | in pthread_rwlock_t.  */ | 
|---|
| 126 | #ifndef __PTHREAD_RWLOCK_INT_FLAGS_SHARED | 
|---|
| 127 | # if __WORDSIZE == 64 | 
|---|
| 128 | #  define __PTHREAD_RWLOCK_INT_FLAGS_SHARED 1 | 
|---|
| 129 | # endif | 
|---|
| 130 | #endif | 
|---|
| 131 |  | 
|---|
| 132 | /* Read-write lock initializers.  */ | 
|---|
| 133 | # define PTHREAD_RWLOCK_INITIALIZER \ | 
|---|
| 134 | { { 0, 0, 0, 0, 0, 0, 0, 0, __PTHREAD_RWLOCK_ELISION_EXTRA, 0, 0 } } | 
|---|
| 135 | # ifdef __USE_GNU | 
|---|
| 136 | #  ifdef __PTHREAD_RWLOCK_INT_FLAGS_SHARED | 
|---|
| 137 | #   define PTHREAD_RWLOCK_WRITER_NONRECURSIVE_INITIALIZER_NP \ | 
|---|
| 138 | { { 0, 0, 0, 0, 0, 0, 0, 0, __PTHREAD_RWLOCK_ELISION_EXTRA, 0,					      \ | 
|---|
| 139 | PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP } } | 
|---|
| 140 | #  else | 
|---|
| 141 | #   if __BYTE_ORDER == __LITTLE_ENDIAN | 
|---|
| 142 | #    define PTHREAD_RWLOCK_WRITER_NONRECURSIVE_INITIALIZER_NP \ | 
|---|
| 143 | { { 0, 0, 0, 0, 0, 0, PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP, \ | 
|---|
| 144 | 0, __PTHREAD_RWLOCK_ELISION_EXTRA, 0, 0 } } | 
|---|
| 145 | #   else | 
|---|
| 146 | #    define PTHREAD_RWLOCK_WRITER_NONRECURSIVE_INITIALIZER_NP \ | 
|---|
| 147 | { { 0, 0, 0, 0, 0, 0, 0, 0, 0, PTHREAD_RWLOCK_PREFER_WRITER_NONRECURSIVE_NP,\ | 
|---|
| 148 | 0 } } | 
|---|
| 149 | #   endif | 
|---|
| 150 | #  endif | 
|---|
| 151 | # endif | 
|---|
| 152 | #endif  /* Unix98 or XOpen2K */ | 
|---|
| 153 |  | 
|---|
| 154 |  | 
|---|
| 155 | /* Scheduler inheritance.  */ | 
|---|
| 156 | enum | 
|---|
| 157 | { | 
|---|
| 158 | PTHREAD_INHERIT_SCHED, | 
|---|
| 159 | #define PTHREAD_INHERIT_SCHED   PTHREAD_INHERIT_SCHED | 
|---|
| 160 | PTHREAD_EXPLICIT_SCHED | 
|---|
| 161 | #define PTHREAD_EXPLICIT_SCHED  PTHREAD_EXPLICIT_SCHED | 
|---|
| 162 | }; | 
|---|
| 163 |  | 
|---|
| 164 |  | 
|---|
| 165 | /* Scope handling.  */ | 
|---|
| 166 | enum | 
|---|
| 167 | { | 
|---|
| 168 | PTHREAD_SCOPE_SYSTEM, | 
|---|
| 169 | #define PTHREAD_SCOPE_SYSTEM    PTHREAD_SCOPE_SYSTEM | 
|---|
| 170 | PTHREAD_SCOPE_PROCESS | 
|---|
| 171 | #define PTHREAD_SCOPE_PROCESS   PTHREAD_SCOPE_PROCESS | 
|---|
| 172 | }; | 
|---|
| 173 |  | 
|---|
| 174 |  | 
|---|
| 175 | /* Process shared or private flag.  */ | 
|---|
| 176 | enum | 
|---|
| 177 | { | 
|---|
| 178 | PTHREAD_PROCESS_PRIVATE, | 
|---|
| 179 | #define PTHREAD_PROCESS_PRIVATE PTHREAD_PROCESS_PRIVATE | 
|---|
| 180 | PTHREAD_PROCESS_SHARED | 
|---|
| 181 | #define PTHREAD_PROCESS_SHARED  PTHREAD_PROCESS_SHARED | 
|---|
| 182 | }; | 
|---|
| 183 |  | 
|---|
| 184 |  | 
|---|
| 185 |  | 
|---|
| 186 | /* Conditional variable handling.  */ | 
|---|
| 187 | #define PTHREAD_COND_INITIALIZER { { {0}, {0}, {0, 0}, {0, 0}, 0, 0, {0, 0} } } | 
|---|
| 188 |  | 
|---|
| 189 |  | 
|---|
| 190 | /* Cleanup buffers */ | 
|---|
| 191 | struct _pthread_cleanup_buffer | 
|---|
| 192 | { | 
|---|
| 193 | void (*__routine) (void *);             /* Function to call.  */ | 
|---|
| 194 | void *__arg;                            /* Its argument.  */ | 
|---|
| 195 | int __canceltype;                       /* Saved cancellation type. */ | 
|---|
| 196 | struct _pthread_cleanup_buffer *__prev; /* Chaining of cleanup functions.  */ | 
|---|
| 197 | }; | 
|---|
| 198 |  | 
|---|
| 199 | /* Cancellation */ | 
|---|
| 200 | enum | 
|---|
| 201 | { | 
|---|
| 202 | PTHREAD_CANCEL_ENABLE, | 
|---|
| 203 | #define PTHREAD_CANCEL_ENABLE   PTHREAD_CANCEL_ENABLE | 
|---|
| 204 | PTHREAD_CANCEL_DISABLE | 
|---|
| 205 | #define PTHREAD_CANCEL_DISABLE  PTHREAD_CANCEL_DISABLE | 
|---|
| 206 | }; | 
|---|
| 207 | enum | 
|---|
| 208 | { | 
|---|
| 209 | PTHREAD_CANCEL_DEFERRED, | 
|---|
| 210 | #define PTHREAD_CANCEL_DEFERRED	PTHREAD_CANCEL_DEFERRED | 
|---|
| 211 | PTHREAD_CANCEL_ASYNCHRONOUS | 
|---|
| 212 | #define PTHREAD_CANCEL_ASYNCHRONOUS	PTHREAD_CANCEL_ASYNCHRONOUS | 
|---|
| 213 | }; | 
|---|
| 214 | #define PTHREAD_CANCELED ((void *) -1) | 
|---|
| 215 |  | 
|---|
| 216 |  | 
|---|
| 217 | /* Single execution handling.  */ | 
|---|
| 218 | #define PTHREAD_ONCE_INIT 0 | 
|---|
| 219 |  | 
|---|
| 220 |  | 
|---|
| 221 | #ifdef __USE_XOPEN2K | 
|---|
| 222 | /* Value returned by 'pthread_barrier_wait' for one of the threads after | 
|---|
| 223 | the required number of threads have called this function. | 
|---|
| 224 | -1 is distinct from 0 and all errno constants */ | 
|---|
| 225 | # define PTHREAD_BARRIER_SERIAL_THREAD -1 | 
|---|
| 226 | #endif | 
|---|
| 227 |  | 
|---|
| 228 |  | 
|---|
| 229 | __BEGIN_DECLS | 
|---|
| 230 |  | 
|---|
| 231 | /* Create a new thread, starting with execution of START-ROUTINE | 
|---|
| 232 | getting passed ARG.  Creation attributed come from ATTR.  The new | 
|---|
| 233 | handle is stored in *NEWTHREAD.  */ | 
|---|
| 234 | extern int pthread_create (pthread_t *__restrict __newthread, | 
|---|
| 235 | const pthread_attr_t *__restrict __attr, | 
|---|
| 236 | void *(*__start_routine) (void *), | 
|---|
| 237 | void *__restrict __arg) __THROWNL __nonnull ((1, 3)); | 
|---|
| 238 |  | 
|---|
| 239 | /* Terminate calling thread. | 
|---|
| 240 |  | 
|---|
| 241 | The registered cleanup handlers are called via exception handling | 
|---|
| 242 | so we cannot mark this function with __THROW.*/ | 
|---|
| 243 | extern void pthread_exit (void *__retval) __attribute__ ((__noreturn__)); | 
|---|
| 244 |  | 
|---|
| 245 | /* Make calling thread wait for termination of the thread TH.  The | 
|---|
| 246 | exit status of the thread is stored in *THREAD_RETURN, if THREAD_RETURN | 
|---|
| 247 | is not NULL. | 
|---|
| 248 |  | 
|---|
| 249 | This function is a cancellation point and therefore not marked with | 
|---|
| 250 | __THROW.  */ | 
|---|
| 251 | extern int pthread_join (pthread_t __th, void **__thread_return); | 
|---|
| 252 |  | 
|---|
| 253 | #ifdef __USE_GNU | 
|---|
| 254 | /* Check whether thread TH has terminated.  If yes return the status of | 
|---|
| 255 | the thread in *THREAD_RETURN, if THREAD_RETURN is not NULL.  */ | 
|---|
| 256 | extern int pthread_tryjoin_np (pthread_t __th, void **__thread_return) __THROW; | 
|---|
| 257 |  | 
|---|
| 258 | /* Make calling thread wait for termination of the thread TH, but only | 
|---|
| 259 | until TIMEOUT.  The exit status of the thread is stored in | 
|---|
| 260 | *THREAD_RETURN, if THREAD_RETURN is not NULL. | 
|---|
| 261 |  | 
|---|
| 262 | This function is a cancellation point and therefore not marked with | 
|---|
| 263 | __THROW.  */ | 
|---|
| 264 | extern int pthread_timedjoin_np (pthread_t __th, void **__thread_return, | 
|---|
| 265 | const struct timespec *__abstime); | 
|---|
| 266 | #endif | 
|---|
| 267 |  | 
|---|
| 268 | /* Indicate that the thread TH is never to be joined with PTHREAD_JOIN. | 
|---|
| 269 | The resources of TH will therefore be freed immediately when it | 
|---|
| 270 | terminates, instead of waiting for another thread to perform PTHREAD_JOIN | 
|---|
| 271 | on it.  */ | 
|---|
| 272 | extern int pthread_detach (pthread_t __th) __THROW; | 
|---|
| 273 |  | 
|---|
| 274 |  | 
|---|
| 275 | /* Obtain the identifier of the current thread.  */ | 
|---|
| 276 | extern pthread_t pthread_self (void) __THROW __attribute__ ((__const__)); | 
|---|
| 277 |  | 
|---|
| 278 | /* Compare two thread identifiers.  */ | 
|---|
| 279 | extern int pthread_equal (pthread_t __thread1, pthread_t __thread2) | 
|---|
| 280 | __THROW __attribute__ ((__const__)); | 
|---|
| 281 |  | 
|---|
| 282 |  | 
|---|
| 283 | /* Thread attribute handling.  */ | 
|---|
| 284 |  | 
|---|
| 285 | /* Initialize thread attribute *ATTR with default attributes | 
|---|
| 286 | (detachstate is PTHREAD_JOINABLE, scheduling policy is SCHED_OTHER, | 
|---|
| 287 | no user-provided stack).  */ | 
|---|
| 288 | extern int pthread_attr_init (pthread_attr_t *__attr) __THROW __nonnull ((1)); | 
|---|
| 289 |  | 
|---|
| 290 | /* Destroy thread attribute *ATTR.  */ | 
|---|
| 291 | extern int pthread_attr_destroy (pthread_attr_t *__attr) | 
|---|
| 292 | __THROW __nonnull ((1)); | 
|---|
| 293 |  | 
|---|
| 294 | /* Get detach state attribute.  */ | 
|---|
| 295 | extern int pthread_attr_getdetachstate (const pthread_attr_t *__attr, | 
|---|
| 296 | int *__detachstate) | 
|---|
| 297 | __THROW __nonnull ((1, 2)); | 
|---|
| 298 |  | 
|---|
| 299 | /* Set detach state attribute.  */ | 
|---|
| 300 | extern int pthread_attr_setdetachstate (pthread_attr_t *__attr, | 
|---|
| 301 | int __detachstate) | 
|---|
| 302 | __THROW __nonnull ((1)); | 
|---|
| 303 |  | 
|---|
| 304 |  | 
|---|
| 305 | /* Get the size of the guard area created for stack overflow protection.  */ | 
|---|
| 306 | extern int pthread_attr_getguardsize (const pthread_attr_t *__attr, | 
|---|
| 307 | size_t *__guardsize) | 
|---|
| 308 | __THROW __nonnull ((1, 2)); | 
|---|
| 309 |  | 
|---|
| 310 | /* Set the size of the guard area created for stack overflow protection.  */ | 
|---|
| 311 | extern int pthread_attr_setguardsize (pthread_attr_t *__attr, | 
|---|
| 312 | size_t __guardsize) | 
|---|
| 313 | __THROW __nonnull ((1)); | 
|---|
| 314 |  | 
|---|
| 315 |  | 
|---|
| 316 | /* Return in *PARAM the scheduling parameters of *ATTR.  */ | 
|---|
| 317 | extern int pthread_attr_getschedparam (const pthread_attr_t *__restrict __attr, | 
|---|
| 318 | struct sched_param *__restrict __param) | 
|---|
| 319 | __THROW __nonnull ((1, 2)); | 
|---|
| 320 |  | 
|---|
| 321 | /* Set scheduling parameters (priority, etc) in *ATTR according to PARAM.  */ | 
|---|
| 322 | extern int pthread_attr_setschedparam (pthread_attr_t *__restrict __attr, | 
|---|
| 323 | const struct sched_param *__restrict | 
|---|
| 324 | __param) __THROW __nonnull ((1, 2)); | 
|---|
| 325 |  | 
|---|
| 326 | /* Return in *POLICY the scheduling policy of *ATTR.  */ | 
|---|
| 327 | extern int pthread_attr_getschedpolicy (const pthread_attr_t *__restrict | 
|---|
| 328 | __attr, int *__restrict __policy) | 
|---|
| 329 | __THROW __nonnull ((1, 2)); | 
|---|
| 330 |  | 
|---|
| 331 | /* Set scheduling policy in *ATTR according to POLICY.  */ | 
|---|
| 332 | extern int pthread_attr_setschedpolicy (pthread_attr_t *__attr, int __policy) | 
|---|
| 333 | __THROW __nonnull ((1)); | 
|---|
| 334 |  | 
|---|
| 335 | /* Return in *INHERIT the scheduling inheritance mode of *ATTR.  */ | 
|---|
| 336 | extern int pthread_attr_getinheritsched (const pthread_attr_t *__restrict | 
|---|
| 337 | __attr, int *__restrict __inherit) | 
|---|
| 338 | __THROW __nonnull ((1, 2)); | 
|---|
| 339 |  | 
|---|
| 340 | /* Set scheduling inheritance mode in *ATTR according to INHERIT.  */ | 
|---|
| 341 | extern int pthread_attr_setinheritsched (pthread_attr_t *__attr, | 
|---|
| 342 | int __inherit) | 
|---|
| 343 | __THROW __nonnull ((1)); | 
|---|
| 344 |  | 
|---|
| 345 |  | 
|---|
| 346 | /* Return in *SCOPE the scheduling contention scope of *ATTR.  */ | 
|---|
| 347 | extern int pthread_attr_getscope (const pthread_attr_t *__restrict __attr, | 
|---|
| 348 | int *__restrict __scope) | 
|---|
| 349 | __THROW __nonnull ((1, 2)); | 
|---|
| 350 |  | 
|---|
| 351 | /* Set scheduling contention scope in *ATTR according to SCOPE.  */ | 
|---|
| 352 | extern int pthread_attr_setscope (pthread_attr_t *__attr, int __scope) | 
|---|
| 353 | __THROW __nonnull ((1)); | 
|---|
| 354 |  | 
|---|
| 355 | /* Return the previously set address for the stack.  */ | 
|---|
| 356 | extern int pthread_attr_getstackaddr (const pthread_attr_t *__restrict | 
|---|
| 357 | __attr, void **__restrict __stackaddr) | 
|---|
| 358 | __THROW __nonnull ((1, 2)) __attribute_deprecated__; | 
|---|
| 359 |  | 
|---|
| 360 | /* Set the starting address of the stack of the thread to be created. | 
|---|
| 361 | Depending on whether the stack grows up or down the value must either | 
|---|
| 362 | be higher or lower than all the address in the memory block.  The | 
|---|
| 363 | minimal size of the block must be PTHREAD_STACK_MIN.  */ | 
|---|
| 364 | extern int pthread_attr_setstackaddr (pthread_attr_t *__attr, | 
|---|
| 365 | void *__stackaddr) | 
|---|
| 366 | __THROW __nonnull ((1)) __attribute_deprecated__; | 
|---|
| 367 |  | 
|---|
| 368 | /* Return the currently used minimal stack size.  */ | 
|---|
| 369 | extern int pthread_attr_getstacksize (const pthread_attr_t *__restrict | 
|---|
| 370 | __attr, size_t *__restrict __stacksize) | 
|---|
| 371 | __THROW __nonnull ((1, 2)); | 
|---|
| 372 |  | 
|---|
| 373 | /* Add information about the minimum stack size needed for the thread | 
|---|
| 374 | to be started.  This size must never be less than PTHREAD_STACK_MIN | 
|---|
| 375 | and must also not exceed the system limits.  */ | 
|---|
| 376 | extern int pthread_attr_setstacksize (pthread_attr_t *__attr, | 
|---|
| 377 | size_t __stacksize) | 
|---|
| 378 | __THROW __nonnull ((1)); | 
|---|
| 379 |  | 
|---|
| 380 | #ifdef __USE_XOPEN2K | 
|---|
| 381 | /* Return the previously set address for the stack.  */ | 
|---|
| 382 | extern int pthread_attr_getstack (const pthread_attr_t *__restrict __attr, | 
|---|
| 383 | void **__restrict __stackaddr, | 
|---|
| 384 | size_t *__restrict __stacksize) | 
|---|
| 385 | __THROW __nonnull ((1, 2, 3)); | 
|---|
| 386 |  | 
|---|
| 387 | /* The following two interfaces are intended to replace the last two.  They | 
|---|
| 388 | require setting the address as well as the size since only setting the | 
|---|
| 389 | address will make the implementation on some architectures impossible.  */ | 
|---|
| 390 | extern int pthread_attr_setstack (pthread_attr_t *__attr, void *__stackaddr, | 
|---|
| 391 | size_t __stacksize) __THROW __nonnull ((1)); | 
|---|
| 392 | #endif | 
|---|
| 393 |  | 
|---|
| 394 | #ifdef __USE_GNU | 
|---|
| 395 | /* Thread created with attribute ATTR will be limited to run only on | 
|---|
| 396 | the processors represented in CPUSET.  */ | 
|---|
| 397 | extern int pthread_attr_setaffinity_np (pthread_attr_t *__attr, | 
|---|
| 398 | size_t __cpusetsize, | 
|---|
| 399 | const cpu_set_t *__cpuset) | 
|---|
| 400 | __THROW __nonnull ((1, 3)); | 
|---|
| 401 |  | 
|---|
| 402 | /* Get bit set in CPUSET representing the processors threads created with | 
|---|
| 403 | ATTR can run on.  */ | 
|---|
| 404 | extern int pthread_attr_getaffinity_np (const pthread_attr_t *__attr, | 
|---|
| 405 | size_t __cpusetsize, | 
|---|
| 406 | cpu_set_t *__cpuset) | 
|---|
| 407 | __THROW __nonnull ((1, 3)); | 
|---|
| 408 |  | 
|---|
| 409 | /* Get the default attributes used by pthread_create in this process.  */ | 
|---|
| 410 | extern int pthread_getattr_default_np (pthread_attr_t *__attr) | 
|---|
| 411 | __THROW __nonnull ((1)); | 
|---|
| 412 |  | 
|---|
| 413 | /* Set the default attributes to be used by pthread_create in this | 
|---|
| 414 | process.  */ | 
|---|
| 415 | extern int pthread_setattr_default_np (const pthread_attr_t *__attr) | 
|---|
| 416 | __THROW __nonnull ((1)); | 
|---|
| 417 |  | 
|---|
| 418 | /* Initialize thread attribute *ATTR with attributes corresponding to the | 
|---|
| 419 | already running thread TH.  It shall be called on uninitialized ATTR | 
|---|
| 420 | and destroyed with pthread_attr_destroy when no longer needed.  */ | 
|---|
| 421 | extern int pthread_getattr_np (pthread_t __th, pthread_attr_t *__attr) | 
|---|
| 422 | __THROW __nonnull ((2)); | 
|---|
| 423 | #endif | 
|---|
| 424 |  | 
|---|
| 425 |  | 
|---|
| 426 | /* Functions for scheduling control.  */ | 
|---|
| 427 |  | 
|---|
| 428 | /* Set the scheduling parameters for TARGET_THREAD according to POLICY | 
|---|
| 429 | and *PARAM.  */ | 
|---|
| 430 | extern int pthread_setschedparam (pthread_t __target_thread, int __policy, | 
|---|
| 431 | const struct sched_param *__param) | 
|---|
| 432 | __THROW __nonnull ((3)); | 
|---|
| 433 |  | 
|---|
| 434 | /* Return in *POLICY and *PARAM the scheduling parameters for TARGET_THREAD. */ | 
|---|
| 435 | extern int pthread_getschedparam (pthread_t __target_thread, | 
|---|
| 436 | int *__restrict __policy, | 
|---|
| 437 | struct sched_param *__restrict __param) | 
|---|
| 438 | __THROW __nonnull ((2, 3)); | 
|---|
| 439 |  | 
|---|
| 440 | /* Set the scheduling priority for TARGET_THREAD.  */ | 
|---|
| 441 | extern int pthread_setschedprio (pthread_t __target_thread, int __prio) | 
|---|
| 442 | __THROW; | 
|---|
| 443 |  | 
|---|
| 444 |  | 
|---|
| 445 | #ifdef __USE_GNU | 
|---|
| 446 | /* Get thread name visible in the kernel and its interfaces.  */ | 
|---|
| 447 | extern int pthread_getname_np (pthread_t __target_thread, char *__buf, | 
|---|
| 448 | size_t __buflen) | 
|---|
| 449 | __THROW __nonnull ((2)); | 
|---|
| 450 |  | 
|---|
| 451 | /* Set thread name visible in the kernel and its interfaces.  */ | 
|---|
| 452 | extern int pthread_setname_np (pthread_t __target_thread, const char *__name) | 
|---|
| 453 | __THROW __nonnull ((2)); | 
|---|
| 454 | #endif | 
|---|
| 455 |  | 
|---|
| 456 |  | 
|---|
| 457 | #ifdef __USE_UNIX98 | 
|---|
| 458 | /* Determine level of concurrency.  */ | 
|---|
| 459 | extern int pthread_getconcurrency (void) __THROW; | 
|---|
| 460 |  | 
|---|
| 461 | /* Set new concurrency level to LEVEL.  */ | 
|---|
| 462 | extern int pthread_setconcurrency (int __level) __THROW; | 
|---|
| 463 | #endif | 
|---|
| 464 |  | 
|---|
| 465 | #ifdef __USE_GNU | 
|---|
| 466 | /* Yield the processor to another thread or process. | 
|---|
| 467 | This function is similar to the POSIX `sched_yield' function but | 
|---|
| 468 | might be differently implemented in the case of a m-on-n thread | 
|---|
| 469 | implementation.  */ | 
|---|
| 470 | extern int pthread_yield (void) __THROW; | 
|---|
| 471 |  | 
|---|
| 472 |  | 
|---|
| 473 | /* Limit specified thread TH to run only on the processors represented | 
|---|
| 474 | in CPUSET.  */ | 
|---|
| 475 | extern int pthread_setaffinity_np (pthread_t __th, size_t __cpusetsize, | 
|---|
| 476 | const cpu_set_t *__cpuset) | 
|---|
| 477 | __THROW __nonnull ((3)); | 
|---|
| 478 |  | 
|---|
| 479 | /* Get bit set in CPUSET representing the processors TH can run on.  */ | 
|---|
| 480 | extern int pthread_getaffinity_np (pthread_t __th, size_t __cpusetsize, | 
|---|
| 481 | cpu_set_t *__cpuset) | 
|---|
| 482 | __THROW __nonnull ((3)); | 
|---|
| 483 | #endif | 
|---|
| 484 |  | 
|---|
| 485 |  | 
|---|
| 486 | /* Functions for handling initialization.  */ | 
|---|
| 487 |  | 
|---|
| 488 | /* Guarantee that the initialization function INIT_ROUTINE will be called | 
|---|
| 489 | only once, even if pthread_once is executed several times with the | 
|---|
| 490 | same ONCE_CONTROL argument. ONCE_CONTROL must point to a static or | 
|---|
| 491 | extern variable initialized to PTHREAD_ONCE_INIT. | 
|---|
| 492 |  | 
|---|
| 493 | The initialization functions might throw exception which is why | 
|---|
| 494 | this function is not marked with __THROW.  */ | 
|---|
| 495 | extern int pthread_once (pthread_once_t *__once_control, | 
|---|
| 496 | void (*__init_routine) (void)) __nonnull ((1, 2)); | 
|---|
| 497 |  | 
|---|
| 498 |  | 
|---|
| 499 | /* Functions for handling cancellation. | 
|---|
| 500 |  | 
|---|
| 501 | Note that these functions are explicitly not marked to not throw an | 
|---|
| 502 | exception in C++ code.  If cancellation is implemented by unwinding | 
|---|
| 503 | this is necessary to have the compiler generate the unwind information.  */ | 
|---|
| 504 |  | 
|---|
| 505 | /* Set cancelability state of current thread to STATE, returning old | 
|---|
| 506 | state in *OLDSTATE if OLDSTATE is not NULL.  */ | 
|---|
| 507 | extern int pthread_setcancelstate (int __state, int *__oldstate); | 
|---|
| 508 |  | 
|---|
| 509 | /* Set cancellation state of current thread to TYPE, returning the old | 
|---|
| 510 | type in *OLDTYPE if OLDTYPE is not NULL.  */ | 
|---|
| 511 | extern int pthread_setcanceltype (int __type, int *__oldtype); | 
|---|
| 512 |  | 
|---|
| 513 | /* Cancel THREAD immediately or at the next possibility.  */ | 
|---|
| 514 | extern int pthread_cancel (pthread_t __th); | 
|---|
| 515 |  | 
|---|
| 516 | /* Test for pending cancellation for the current thread and terminate | 
|---|
| 517 | the thread as per pthread_exit(PTHREAD_CANCELED) if it has been | 
|---|
| 518 | cancelled.  */ | 
|---|
| 519 | extern void pthread_testcancel (void); | 
|---|
| 520 |  | 
|---|
| 521 |  | 
|---|
| 522 | /* Cancellation handling with integration into exception handling.  */ | 
|---|
| 523 |  | 
|---|
| 524 | typedef struct | 
|---|
| 525 | { | 
|---|
| 526 | struct | 
|---|
| 527 | { | 
|---|
| 528 | __jmp_buf __cancel_jmp_buf; | 
|---|
| 529 | int __mask_was_saved; | 
|---|
| 530 | } __cancel_jmp_buf[1]; | 
|---|
| 531 | void *__pad[4]; | 
|---|
| 532 | } __pthread_unwind_buf_t __attribute__ ((__aligned__)); | 
|---|
| 533 |  | 
|---|
| 534 | /* No special attributes by default.  */ | 
|---|
| 535 | #ifndef __cleanup_fct_attribute | 
|---|
| 536 | # define __cleanup_fct_attribute | 
|---|
| 537 | #endif | 
|---|
| 538 |  | 
|---|
| 539 |  | 
|---|
| 540 | /* Structure to hold the cleanup handler information.  */ | 
|---|
| 541 | struct __pthread_cleanup_frame | 
|---|
| 542 | { | 
|---|
| 543 | void (*__cancel_routine) (void *); | 
|---|
| 544 | void *__cancel_arg; | 
|---|
| 545 | int __do_it; | 
|---|
| 546 | int __cancel_type; | 
|---|
| 547 | }; | 
|---|
| 548 |  | 
|---|
| 549 | #if defined __GNUC__ && defined __EXCEPTIONS | 
|---|
| 550 | # ifdef __cplusplus | 
|---|
| 551 | /* Class to handle cancellation handler invocation.  */ | 
|---|
| 552 | class __pthread_cleanup_class | 
|---|
| 553 | { | 
|---|
| 554 | void (*__cancel_routine) (void *); | 
|---|
| 555 | void *__cancel_arg; | 
|---|
| 556 | int __do_it; | 
|---|
| 557 | int __cancel_type; | 
|---|
| 558 |  | 
|---|
| 559 | public: | 
|---|
| 560 | __pthread_cleanup_class (void (*__fct) (void *), void *__arg) | 
|---|
| 561 | : __cancel_routine (__fct), __cancel_arg (__arg), __do_it (1) { } | 
|---|
| 562 | ~__pthread_cleanup_class () { if (__do_it) __cancel_routine (__cancel_arg); } | 
|---|
| 563 | void __setdoit (int __newval) { __do_it = __newval; } | 
|---|
| 564 | void __defer () { pthread_setcanceltype (PTHREAD_CANCEL_DEFERRED, | 
|---|
| 565 | &__cancel_type); } | 
|---|
| 566 | void __restore () const { pthread_setcanceltype (__cancel_type, 0); } | 
|---|
| 567 | }; | 
|---|
| 568 |  | 
|---|
| 569 | /* Install a cleanup handler: ROUTINE will be called with arguments ARG | 
|---|
| 570 | when the thread is canceled or calls pthread_exit.  ROUTINE will also | 
|---|
| 571 | be called with arguments ARG when the matching pthread_cleanup_pop | 
|---|
| 572 | is executed with non-zero EXECUTE argument. | 
|---|
| 573 |  | 
|---|
| 574 | pthread_cleanup_push and pthread_cleanup_pop are macros and must always | 
|---|
| 575 | be used in matching pairs at the same nesting level of braces.  */ | 
|---|
| 576 | #  define pthread_cleanup_push(routine, arg) \ | 
|---|
| 577 | do {									      \ | 
|---|
| 578 | __pthread_cleanup_class __clframe (routine, arg) | 
|---|
| 579 |  | 
|---|
| 580 | /* Remove a cleanup handler installed by the matching pthread_cleanup_push. | 
|---|
| 581 | If EXECUTE is non-zero, the handler function is called. */ | 
|---|
| 582 | #  define pthread_cleanup_pop(execute) \ | 
|---|
| 583 | __clframe.__setdoit (execute);					      \ | 
|---|
| 584 | } while (0) | 
|---|
| 585 |  | 
|---|
| 586 | #  ifdef __USE_GNU | 
|---|
| 587 | /* Install a cleanup handler as pthread_cleanup_push does, but also | 
|---|
| 588 | saves the current cancellation type and sets it to deferred | 
|---|
| 589 | cancellation.  */ | 
|---|
| 590 | #   define pthread_cleanup_push_defer_np(routine, arg) \ | 
|---|
| 591 | do {									      \ | 
|---|
| 592 | __pthread_cleanup_class __clframe (routine, arg);			      \ | 
|---|
| 593 | __clframe.__defer () | 
|---|
| 594 |  | 
|---|
| 595 | /* Remove a cleanup handler as pthread_cleanup_pop does, but also | 
|---|
| 596 | restores the cancellation type that was in effect when the matching | 
|---|
| 597 | pthread_cleanup_push_defer was called.  */ | 
|---|
| 598 | #   define pthread_cleanup_pop_restore_np(execute) \ | 
|---|
| 599 | __clframe.__restore ();						      \ | 
|---|
| 600 | __clframe.__setdoit (execute);					      \ | 
|---|
| 601 | } while (0) | 
|---|
| 602 | #  endif | 
|---|
| 603 | # else | 
|---|
| 604 | /* Function called to call the cleanup handler.  As an extern inline | 
|---|
| 605 | function the compiler is free to decide inlining the change when | 
|---|
| 606 | needed or fall back on the copy which must exist somewhere | 
|---|
| 607 | else.  */ | 
|---|
| 608 | __extern_inline void | 
|---|
| 609 | __pthread_cleanup_routine (struct __pthread_cleanup_frame *__frame) | 
|---|
| 610 | { | 
|---|
| 611 | if (__frame->__do_it) | 
|---|
| 612 | __frame->__cancel_routine (__frame->__cancel_arg); | 
|---|
| 613 | } | 
|---|
| 614 |  | 
|---|
| 615 | /* Install a cleanup handler: ROUTINE will be called with arguments ARG | 
|---|
| 616 | when the thread is canceled or calls pthread_exit.  ROUTINE will also | 
|---|
| 617 | be called with arguments ARG when the matching pthread_cleanup_pop | 
|---|
| 618 | is executed with non-zero EXECUTE argument. | 
|---|
| 619 |  | 
|---|
| 620 | pthread_cleanup_push and pthread_cleanup_pop are macros and must always | 
|---|
| 621 | be used in matching pairs at the same nesting level of braces.  */ | 
|---|
| 622 | #  define pthread_cleanup_push(routine, arg) \ | 
|---|
| 623 | do {									      \ | 
|---|
| 624 | struct __pthread_cleanup_frame __clframe				      \ | 
|---|
| 625 | __attribute__ ((__cleanup__ (__pthread_cleanup_routine)))		      \ | 
|---|
| 626 | = { .__cancel_routine = (routine), .__cancel_arg = (arg),	 	      \ | 
|---|
| 627 | .__do_it = 1 }; | 
|---|
| 628 |  | 
|---|
| 629 | /* Remove a cleanup handler installed by the matching pthread_cleanup_push. | 
|---|
| 630 | If EXECUTE is non-zero, the handler function is called. */ | 
|---|
| 631 | #  define pthread_cleanup_pop(execute) \ | 
|---|
| 632 | __clframe.__do_it = (execute);					      \ | 
|---|
| 633 | } while (0) | 
|---|
| 634 |  | 
|---|
| 635 | #  ifdef __USE_GNU | 
|---|
| 636 | /* Install a cleanup handler as pthread_cleanup_push does, but also | 
|---|
| 637 | saves the current cancellation type and sets it to deferred | 
|---|
| 638 | cancellation.  */ | 
|---|
| 639 | #   define pthread_cleanup_push_defer_np(routine, arg) \ | 
|---|
| 640 | do {									      \ | 
|---|
| 641 | struct __pthread_cleanup_frame __clframe				      \ | 
|---|
| 642 | __attribute__ ((__cleanup__ (__pthread_cleanup_routine)))		      \ | 
|---|
| 643 | = { .__cancel_routine = (routine), .__cancel_arg = (arg),		      \ | 
|---|
| 644 | .__do_it = 1 };						      \ | 
|---|
| 645 | (void) pthread_setcanceltype (PTHREAD_CANCEL_DEFERRED,		      \ | 
|---|
| 646 | &__clframe.__cancel_type) | 
|---|
| 647 |  | 
|---|
| 648 | /* Remove a cleanup handler as pthread_cleanup_pop does, but also | 
|---|
| 649 | restores the cancellation type that was in effect when the matching | 
|---|
| 650 | pthread_cleanup_push_defer was called.  */ | 
|---|
| 651 | #   define pthread_cleanup_pop_restore_np(execute) \ | 
|---|
| 652 | (void) pthread_setcanceltype (__clframe.__cancel_type, NULL);	      \ | 
|---|
| 653 | __clframe.__do_it = (execute);					      \ | 
|---|
| 654 | } while (0) | 
|---|
| 655 | #  endif | 
|---|
| 656 | # endif | 
|---|
| 657 | #else | 
|---|
| 658 | /* Install a cleanup handler: ROUTINE will be called with arguments ARG | 
|---|
| 659 | when the thread is canceled or calls pthread_exit.  ROUTINE will also | 
|---|
| 660 | be called with arguments ARG when the matching pthread_cleanup_pop | 
|---|
| 661 | is executed with non-zero EXECUTE argument. | 
|---|
| 662 |  | 
|---|
| 663 | pthread_cleanup_push and pthread_cleanup_pop are macros and must always | 
|---|
| 664 | be used in matching pairs at the same nesting level of braces.  */ | 
|---|
| 665 | # define pthread_cleanup_push(routine, arg) \ | 
|---|
| 666 | do {									      \ | 
|---|
| 667 | __pthread_unwind_buf_t __cancel_buf;				      \ | 
|---|
| 668 | void (*__cancel_routine) (void *) = (routine);			      \ | 
|---|
| 669 | void *__cancel_arg = (arg);						      \ | 
|---|
| 670 | int __not_first_call = __sigsetjmp ((struct __jmp_buf_tag *) (void *)     \ | 
|---|
| 671 | __cancel_buf.__cancel_jmp_buf, 0);    \ | 
|---|
| 672 | if (__glibc_unlikely (__not_first_call))				      \ | 
|---|
| 673 | {									      \ | 
|---|
| 674 | __cancel_routine (__cancel_arg);				      \ | 
|---|
| 675 | __pthread_unwind_next (&__cancel_buf);				      \ | 
|---|
| 676 | /* NOTREACHED */						      \ | 
|---|
| 677 | }									      \ | 
|---|
| 678 | \ | 
|---|
| 679 | __pthread_register_cancel (&__cancel_buf);				      \ | 
|---|
| 680 | do { | 
|---|
| 681 | extern void __pthread_register_cancel (__pthread_unwind_buf_t *__buf) | 
|---|
| 682 | __cleanup_fct_attribute; | 
|---|
| 683 |  | 
|---|
| 684 | /* Remove a cleanup handler installed by the matching pthread_cleanup_push. | 
|---|
| 685 | If EXECUTE is non-zero, the handler function is called. */ | 
|---|
| 686 | # define pthread_cleanup_pop(execute) \ | 
|---|
| 687 | do { } while (0);/* Empty to allow label before pthread_cleanup_pop.  */\ | 
|---|
| 688 | } while (0);							      \ | 
|---|
| 689 | __pthread_unregister_cancel (&__cancel_buf);			      \ | 
|---|
| 690 | if (execute)							      \ | 
|---|
| 691 | __cancel_routine (__cancel_arg);					      \ | 
|---|
| 692 | } while (0) | 
|---|
| 693 | extern void __pthread_unregister_cancel (__pthread_unwind_buf_t *__buf) | 
|---|
| 694 | __cleanup_fct_attribute; | 
|---|
| 695 |  | 
|---|
| 696 | # ifdef __USE_GNU | 
|---|
| 697 | /* Install a cleanup handler as pthread_cleanup_push does, but also | 
|---|
| 698 | saves the current cancellation type and sets it to deferred | 
|---|
| 699 | cancellation.  */ | 
|---|
| 700 | #  define pthread_cleanup_push_defer_np(routine, arg) \ | 
|---|
| 701 | do {									      \ | 
|---|
| 702 | __pthread_unwind_buf_t __cancel_buf;				      \ | 
|---|
| 703 | void (*__cancel_routine) (void *) = (routine);			      \ | 
|---|
| 704 | void *__cancel_arg = (arg);						      \ | 
|---|
| 705 | int __not_first_call = __sigsetjmp ((struct __jmp_buf_tag *) (void *)     \ | 
|---|
| 706 | __cancel_buf.__cancel_jmp_buf, 0);    \ | 
|---|
| 707 | if (__glibc_unlikely (__not_first_call))				      \ | 
|---|
| 708 | {									      \ | 
|---|
| 709 | __cancel_routine (__cancel_arg);				      \ | 
|---|
| 710 | __pthread_unwind_next (&__cancel_buf);				      \ | 
|---|
| 711 | /* NOTREACHED */						      \ | 
|---|
| 712 | }									      \ | 
|---|
| 713 | \ | 
|---|
| 714 | __pthread_register_cancel_defer (&__cancel_buf);			      \ | 
|---|
| 715 | do { | 
|---|
| 716 | extern void __pthread_register_cancel_defer (__pthread_unwind_buf_t *__buf) | 
|---|
| 717 | __cleanup_fct_attribute; | 
|---|
| 718 |  | 
|---|
| 719 | /* Remove a cleanup handler as pthread_cleanup_pop does, but also | 
|---|
| 720 | restores the cancellation type that was in effect when the matching | 
|---|
| 721 | pthread_cleanup_push_defer was called.  */ | 
|---|
| 722 | #  define pthread_cleanup_pop_restore_np(execute) \ | 
|---|
| 723 | do { } while (0);/* Empty to allow label before pthread_cleanup_pop.  */\ | 
|---|
| 724 | } while (0);							      \ | 
|---|
| 725 | __pthread_unregister_cancel_restore (&__cancel_buf);		      \ | 
|---|
| 726 | if (execute)							      \ | 
|---|
| 727 | __cancel_routine (__cancel_arg);					      \ | 
|---|
| 728 | } while (0) | 
|---|
| 729 | extern void __pthread_unregister_cancel_restore (__pthread_unwind_buf_t *__buf) | 
|---|
| 730 | __cleanup_fct_attribute; | 
|---|
| 731 | # endif | 
|---|
| 732 |  | 
|---|
| 733 | /* Internal interface to initiate cleanup.  */ | 
|---|
| 734 | extern void __pthread_unwind_next (__pthread_unwind_buf_t *__buf) | 
|---|
| 735 | __cleanup_fct_attribute __attribute__ ((__noreturn__)) | 
|---|
| 736 | # ifndef SHARED | 
|---|
| 737 | __attribute__ ((__weak__)) | 
|---|
| 738 | # endif | 
|---|
| 739 | ; | 
|---|
| 740 | #endif | 
|---|
| 741 |  | 
|---|
| 742 | /* Function used in the macros.  */ | 
|---|
| 743 | struct __jmp_buf_tag; | 
|---|
| 744 | extern int __sigsetjmp (struct __jmp_buf_tag *__env, int __savemask) __THROWNL; | 
|---|
| 745 |  | 
|---|
| 746 |  | 
|---|
| 747 | /* Mutex handling.  */ | 
|---|
| 748 |  | 
|---|
| 749 | /* Initialize a mutex.  */ | 
|---|
| 750 | extern int pthread_mutex_init (pthread_mutex_t *__mutex, | 
|---|
| 751 | const pthread_mutexattr_t *__mutexattr) | 
|---|
| 752 | __THROW __nonnull ((1)); | 
|---|
| 753 |  | 
|---|
| 754 | /* Destroy a mutex.  */ | 
|---|
| 755 | extern int pthread_mutex_destroy (pthread_mutex_t *__mutex) | 
|---|
| 756 | __THROW __nonnull ((1)); | 
|---|
| 757 |  | 
|---|
| 758 | /* Try locking a mutex.  */ | 
|---|
| 759 | extern int pthread_mutex_trylock (pthread_mutex_t *__mutex) | 
|---|
| 760 | __THROWNL __nonnull ((1)); | 
|---|
| 761 |  | 
|---|
| 762 | /* Lock a mutex.  */ | 
|---|
| 763 | extern int pthread_mutex_lock (pthread_mutex_t *__mutex) | 
|---|
| 764 | __THROWNL __nonnull ((1)); | 
|---|
| 765 |  | 
|---|
| 766 | #ifdef __USE_XOPEN2K | 
|---|
| 767 | /* Wait until lock becomes available, or specified time passes. */ | 
|---|
| 768 | extern int pthread_mutex_timedlock (pthread_mutex_t *__restrict __mutex, | 
|---|
| 769 | const struct timespec *__restrict | 
|---|
| 770 | __abstime) __THROWNL __nonnull ((1, 2)); | 
|---|
| 771 | #endif | 
|---|
| 772 |  | 
|---|
| 773 | /* Unlock a mutex.  */ | 
|---|
| 774 | extern int pthread_mutex_unlock (pthread_mutex_t *__mutex) | 
|---|
| 775 | __THROWNL __nonnull ((1)); | 
|---|
| 776 |  | 
|---|
| 777 |  | 
|---|
| 778 | /* Get the priority ceiling of MUTEX.  */ | 
|---|
| 779 | extern int pthread_mutex_getprioceiling (const pthread_mutex_t * | 
|---|
| 780 | __restrict __mutex, | 
|---|
| 781 | int *__restrict __prioceiling) | 
|---|
| 782 | __THROW __nonnull ((1, 2)); | 
|---|
| 783 |  | 
|---|
| 784 | /* Set the priority ceiling of MUTEX to PRIOCEILING, return old | 
|---|
| 785 | priority ceiling value in *OLD_CEILING.  */ | 
|---|
| 786 | extern int pthread_mutex_setprioceiling (pthread_mutex_t *__restrict __mutex, | 
|---|
| 787 | int __prioceiling, | 
|---|
| 788 | int *__restrict __old_ceiling) | 
|---|
| 789 | __THROW __nonnull ((1, 3)); | 
|---|
| 790 |  | 
|---|
| 791 |  | 
|---|
| 792 | #ifdef __USE_XOPEN2K8 | 
|---|
| 793 | /* Declare the state protected by MUTEX as consistent.  */ | 
|---|
| 794 | extern int pthread_mutex_consistent (pthread_mutex_t *__mutex) | 
|---|
| 795 | __THROW __nonnull ((1)); | 
|---|
| 796 | # ifdef __USE_GNU | 
|---|
| 797 | extern int pthread_mutex_consistent_np (pthread_mutex_t *__mutex) | 
|---|
| 798 | __THROW __nonnull ((1)); | 
|---|
| 799 | # endif | 
|---|
| 800 | #endif | 
|---|
| 801 |  | 
|---|
| 802 |  | 
|---|
| 803 | /* Functions for handling mutex attributes.  */ | 
|---|
| 804 |  | 
|---|
| 805 | /* Initialize mutex attribute object ATTR with default attributes | 
|---|
| 806 | (kind is PTHREAD_MUTEX_TIMED_NP).  */ | 
|---|
| 807 | extern int pthread_mutexattr_init (pthread_mutexattr_t *__attr) | 
|---|
| 808 | __THROW __nonnull ((1)); | 
|---|
| 809 |  | 
|---|
| 810 | /* Destroy mutex attribute object ATTR.  */ | 
|---|
| 811 | extern int pthread_mutexattr_destroy (pthread_mutexattr_t *__attr) | 
|---|
| 812 | __THROW __nonnull ((1)); | 
|---|
| 813 |  | 
|---|
| 814 | /* Get the process-shared flag of the mutex attribute ATTR.  */ | 
|---|
| 815 | extern int pthread_mutexattr_getpshared (const pthread_mutexattr_t * | 
|---|
| 816 | __restrict __attr, | 
|---|
| 817 | int *__restrict __pshared) | 
|---|
| 818 | __THROW __nonnull ((1, 2)); | 
|---|
| 819 |  | 
|---|
| 820 | /* Set the process-shared flag of the mutex attribute ATTR.  */ | 
|---|
| 821 | extern int pthread_mutexattr_setpshared (pthread_mutexattr_t *__attr, | 
|---|
| 822 | int __pshared) | 
|---|
| 823 | __THROW __nonnull ((1)); | 
|---|
| 824 |  | 
|---|
| 825 | #if defined __USE_UNIX98 || defined __USE_XOPEN2K8 | 
|---|
| 826 | /* Return in *KIND the mutex kind attribute in *ATTR.  */ | 
|---|
| 827 | extern int pthread_mutexattr_gettype (const pthread_mutexattr_t *__restrict | 
|---|
| 828 | __attr, int *__restrict __kind) | 
|---|
| 829 | __THROW __nonnull ((1, 2)); | 
|---|
| 830 |  | 
|---|
| 831 | /* Set the mutex kind attribute in *ATTR to KIND (either PTHREAD_MUTEX_NORMAL, | 
|---|
| 832 | PTHREAD_MUTEX_RECURSIVE, PTHREAD_MUTEX_ERRORCHECK, or | 
|---|
| 833 | PTHREAD_MUTEX_DEFAULT).  */ | 
|---|
| 834 | extern int pthread_mutexattr_settype (pthread_mutexattr_t *__attr, int __kind) | 
|---|
| 835 | __THROW __nonnull ((1)); | 
|---|
| 836 | #endif | 
|---|
| 837 |  | 
|---|
| 838 | /* Return in *PROTOCOL the mutex protocol attribute in *ATTR.  */ | 
|---|
| 839 | extern int pthread_mutexattr_getprotocol (const pthread_mutexattr_t * | 
|---|
| 840 | __restrict __attr, | 
|---|
| 841 | int *__restrict __protocol) | 
|---|
| 842 | __THROW __nonnull ((1, 2)); | 
|---|
| 843 |  | 
|---|
| 844 | /* Set the mutex protocol attribute in *ATTR to PROTOCOL (either | 
|---|
| 845 | PTHREAD_PRIO_NONE, PTHREAD_PRIO_INHERIT, or PTHREAD_PRIO_PROTECT).  */ | 
|---|
| 846 | extern int pthread_mutexattr_setprotocol (pthread_mutexattr_t *__attr, | 
|---|
| 847 | int __protocol) | 
|---|
| 848 | __THROW __nonnull ((1)); | 
|---|
| 849 |  | 
|---|
| 850 | /* Return in *PRIOCEILING the mutex prioceiling attribute in *ATTR.  */ | 
|---|
| 851 | extern int pthread_mutexattr_getprioceiling (const pthread_mutexattr_t * | 
|---|
| 852 | __restrict __attr, | 
|---|
| 853 | int *__restrict __prioceiling) | 
|---|
| 854 | __THROW __nonnull ((1, 2)); | 
|---|
| 855 |  | 
|---|
| 856 | /* Set the mutex prioceiling attribute in *ATTR to PRIOCEILING.  */ | 
|---|
| 857 | extern int pthread_mutexattr_setprioceiling (pthread_mutexattr_t *__attr, | 
|---|
| 858 | int __prioceiling) | 
|---|
| 859 | __THROW __nonnull ((1)); | 
|---|
| 860 |  | 
|---|
| 861 | #ifdef __USE_XOPEN2K | 
|---|
| 862 | /* Get the robustness flag of the mutex attribute ATTR.  */ | 
|---|
| 863 | extern int pthread_mutexattr_getrobust (const pthread_mutexattr_t *__attr, | 
|---|
| 864 | int *__robustness) | 
|---|
| 865 | __THROW __nonnull ((1, 2)); | 
|---|
| 866 | # ifdef __USE_GNU | 
|---|
| 867 | extern int pthread_mutexattr_getrobust_np (const pthread_mutexattr_t *__attr, | 
|---|
| 868 | int *__robustness) | 
|---|
| 869 | __THROW __nonnull ((1, 2)); | 
|---|
| 870 | # endif | 
|---|
| 871 |  | 
|---|
| 872 | /* Set the robustness flag of the mutex attribute ATTR.  */ | 
|---|
| 873 | extern int pthread_mutexattr_setrobust (pthread_mutexattr_t *__attr, | 
|---|
| 874 | int __robustness) | 
|---|
| 875 | __THROW __nonnull ((1)); | 
|---|
| 876 | # ifdef __USE_GNU | 
|---|
| 877 | extern int pthread_mutexattr_setrobust_np (pthread_mutexattr_t *__attr, | 
|---|
| 878 | int __robustness) | 
|---|
| 879 | __THROW __nonnull ((1)); | 
|---|
| 880 | # endif | 
|---|
| 881 | #endif | 
|---|
| 882 |  | 
|---|
| 883 |  | 
|---|
| 884 | #if defined __USE_UNIX98 || defined __USE_XOPEN2K | 
|---|
| 885 | /* Functions for handling read-write locks.  */ | 
|---|
| 886 |  | 
|---|
| 887 | /* Initialize read-write lock RWLOCK using attributes ATTR, or use | 
|---|
| 888 | the default values if later is NULL.  */ | 
|---|
| 889 | extern int pthread_rwlock_init (pthread_rwlock_t *__restrict __rwlock, | 
|---|
| 890 | const pthread_rwlockattr_t *__restrict | 
|---|
| 891 | __attr) __THROW __nonnull ((1)); | 
|---|
| 892 |  | 
|---|
| 893 | /* Destroy read-write lock RWLOCK.  */ | 
|---|
| 894 | extern int pthread_rwlock_destroy (pthread_rwlock_t *__rwlock) | 
|---|
| 895 | __THROW __nonnull ((1)); | 
|---|
| 896 |  | 
|---|
| 897 | /* Acquire read lock for RWLOCK.  */ | 
|---|
| 898 | extern int pthread_rwlock_rdlock (pthread_rwlock_t *__rwlock) | 
|---|
| 899 | __THROWNL __nonnull ((1)); | 
|---|
| 900 |  | 
|---|
| 901 | /* Try to acquire read lock for RWLOCK.  */ | 
|---|
| 902 | extern int pthread_rwlock_tryrdlock (pthread_rwlock_t *__rwlock) | 
|---|
| 903 | __THROWNL __nonnull ((1)); | 
|---|
| 904 |  | 
|---|
| 905 | # ifdef __USE_XOPEN2K | 
|---|
| 906 | /* Try to acquire read lock for RWLOCK or return after specfied time.  */ | 
|---|
| 907 | extern int pthread_rwlock_timedrdlock (pthread_rwlock_t *__restrict __rwlock, | 
|---|
| 908 | const struct timespec *__restrict | 
|---|
| 909 | __abstime) __THROWNL __nonnull ((1, 2)); | 
|---|
| 910 | # endif | 
|---|
| 911 |  | 
|---|
| 912 | /* Acquire write lock for RWLOCK.  */ | 
|---|
| 913 | extern int pthread_rwlock_wrlock (pthread_rwlock_t *__rwlock) | 
|---|
| 914 | __THROWNL __nonnull ((1)); | 
|---|
| 915 |  | 
|---|
| 916 | /* Try to acquire write lock for RWLOCK.  */ | 
|---|
| 917 | extern int pthread_rwlock_trywrlock (pthread_rwlock_t *__rwlock) | 
|---|
| 918 | __THROWNL __nonnull ((1)); | 
|---|
| 919 |  | 
|---|
| 920 | # ifdef __USE_XOPEN2K | 
|---|
| 921 | /* Try to acquire write lock for RWLOCK or return after specfied time.  */ | 
|---|
| 922 | extern int pthread_rwlock_timedwrlock (pthread_rwlock_t *__restrict __rwlock, | 
|---|
| 923 | const struct timespec *__restrict | 
|---|
| 924 | __abstime) __THROWNL __nonnull ((1, 2)); | 
|---|
| 925 | # endif | 
|---|
| 926 |  | 
|---|
| 927 | /* Unlock RWLOCK.  */ | 
|---|
| 928 | extern int pthread_rwlock_unlock (pthread_rwlock_t *__rwlock) | 
|---|
| 929 | __THROWNL __nonnull ((1)); | 
|---|
| 930 |  | 
|---|
| 931 |  | 
|---|
| 932 | /* Functions for handling read-write lock attributes.  */ | 
|---|
| 933 |  | 
|---|
| 934 | /* Initialize attribute object ATTR with default values.  */ | 
|---|
| 935 | extern int pthread_rwlockattr_init (pthread_rwlockattr_t *__attr) | 
|---|
| 936 | __THROW __nonnull ((1)); | 
|---|
| 937 |  | 
|---|
| 938 | /* Destroy attribute object ATTR.  */ | 
|---|
| 939 | extern int pthread_rwlockattr_destroy (pthread_rwlockattr_t *__attr) | 
|---|
| 940 | __THROW __nonnull ((1)); | 
|---|
| 941 |  | 
|---|
| 942 | /* Return current setting of process-shared attribute of ATTR in PSHARED.  */ | 
|---|
| 943 | extern int pthread_rwlockattr_getpshared (const pthread_rwlockattr_t * | 
|---|
| 944 | __restrict __attr, | 
|---|
| 945 | int *__restrict __pshared) | 
|---|
| 946 | __THROW __nonnull ((1, 2)); | 
|---|
| 947 |  | 
|---|
| 948 | /* Set process-shared attribute of ATTR to PSHARED.  */ | 
|---|
| 949 | extern int pthread_rwlockattr_setpshared (pthread_rwlockattr_t *__attr, | 
|---|
| 950 | int __pshared) | 
|---|
| 951 | __THROW __nonnull ((1)); | 
|---|
| 952 |  | 
|---|
| 953 | /* Return current setting of reader/writer preference.  */ | 
|---|
| 954 | extern int pthread_rwlockattr_getkind_np (const pthread_rwlockattr_t * | 
|---|
| 955 | __restrict __attr, | 
|---|
| 956 | int *__restrict __pref) | 
|---|
| 957 | __THROW __nonnull ((1, 2)); | 
|---|
| 958 |  | 
|---|
| 959 | /* Set reader/write preference.  */ | 
|---|
| 960 | extern int pthread_rwlockattr_setkind_np (pthread_rwlockattr_t *__attr, | 
|---|
| 961 | int __pref) __THROW __nonnull ((1)); | 
|---|
| 962 | #endif | 
|---|
| 963 |  | 
|---|
| 964 |  | 
|---|
| 965 | /* Functions for handling conditional variables.  */ | 
|---|
| 966 |  | 
|---|
| 967 | /* Initialize condition variable COND using attributes ATTR, or use | 
|---|
| 968 | the default values if later is NULL.  */ | 
|---|
| 969 | extern int pthread_cond_init (pthread_cond_t *__restrict __cond, | 
|---|
| 970 | const pthread_condattr_t *__restrict __cond_attr) | 
|---|
| 971 | __THROW __nonnull ((1)); | 
|---|
| 972 |  | 
|---|
| 973 | /* Destroy condition variable COND.  */ | 
|---|
| 974 | extern int pthread_cond_destroy (pthread_cond_t *__cond) | 
|---|
| 975 | __THROW __nonnull ((1)); | 
|---|
| 976 |  | 
|---|
| 977 | /* Wake up one thread waiting for condition variable COND.  */ | 
|---|
| 978 | extern int pthread_cond_signal (pthread_cond_t *__cond) | 
|---|
| 979 | __THROWNL __nonnull ((1)); | 
|---|
| 980 |  | 
|---|
| 981 | /* Wake up all threads waiting for condition variables COND.  */ | 
|---|
| 982 | extern int pthread_cond_broadcast (pthread_cond_t *__cond) | 
|---|
| 983 | __THROWNL __nonnull ((1)); | 
|---|
| 984 |  | 
|---|
| 985 | /* Wait for condition variable COND to be signaled or broadcast. | 
|---|
| 986 | MUTEX is assumed to be locked before. | 
|---|
| 987 |  | 
|---|
| 988 | This function is a cancellation point and therefore not marked with | 
|---|
| 989 | __THROW.  */ | 
|---|
| 990 | extern int pthread_cond_wait (pthread_cond_t *__restrict __cond, | 
|---|
| 991 | pthread_mutex_t *__restrict __mutex) | 
|---|
| 992 | __nonnull ((1, 2)); | 
|---|
| 993 |  | 
|---|
| 994 | /* Wait for condition variable COND to be signaled or broadcast until | 
|---|
| 995 | ABSTIME.  MUTEX is assumed to be locked before.  ABSTIME is an | 
|---|
| 996 | absolute time specification; zero is the beginning of the epoch | 
|---|
| 997 | (00:00:00 GMT, January 1, 1970). | 
|---|
| 998 |  | 
|---|
| 999 | This function is a cancellation point and therefore not marked with | 
|---|
| 1000 | __THROW.  */ | 
|---|
| 1001 | extern int pthread_cond_timedwait (pthread_cond_t *__restrict __cond, | 
|---|
| 1002 | pthread_mutex_t *__restrict __mutex, | 
|---|
| 1003 | const struct timespec *__restrict __abstime) | 
|---|
| 1004 | __nonnull ((1, 2, 3)); | 
|---|
| 1005 |  | 
|---|
| 1006 | /* Functions for handling condition variable attributes.  */ | 
|---|
| 1007 |  | 
|---|
| 1008 | /* Initialize condition variable attribute ATTR.  */ | 
|---|
| 1009 | extern int pthread_condattr_init (pthread_condattr_t *__attr) | 
|---|
| 1010 | __THROW __nonnull ((1)); | 
|---|
| 1011 |  | 
|---|
| 1012 | /* Destroy condition variable attribute ATTR.  */ | 
|---|
| 1013 | extern int pthread_condattr_destroy (pthread_condattr_t *__attr) | 
|---|
| 1014 | __THROW __nonnull ((1)); | 
|---|
| 1015 |  | 
|---|
| 1016 | /* Get the process-shared flag of the condition variable attribute ATTR.  */ | 
|---|
| 1017 | extern int pthread_condattr_getpshared (const pthread_condattr_t * | 
|---|
| 1018 | __restrict __attr, | 
|---|
| 1019 | int *__restrict __pshared) | 
|---|
| 1020 | __THROW __nonnull ((1, 2)); | 
|---|
| 1021 |  | 
|---|
| 1022 | /* Set the process-shared flag of the condition variable attribute ATTR.  */ | 
|---|
| 1023 | extern int pthread_condattr_setpshared (pthread_condattr_t *__attr, | 
|---|
| 1024 | int __pshared) __THROW __nonnull ((1)); | 
|---|
| 1025 |  | 
|---|
| 1026 | #ifdef __USE_XOPEN2K | 
|---|
| 1027 | /* Get the clock selected for the condition variable attribute ATTR.  */ | 
|---|
| 1028 | extern int pthread_condattr_getclock (const pthread_condattr_t * | 
|---|
| 1029 | __restrict __attr, | 
|---|
| 1030 | __clockid_t *__restrict __clock_id) | 
|---|
| 1031 | __THROW __nonnull ((1, 2)); | 
|---|
| 1032 |  | 
|---|
| 1033 | /* Set the clock selected for the condition variable attribute ATTR.  */ | 
|---|
| 1034 | extern int pthread_condattr_setclock (pthread_condattr_t *__attr, | 
|---|
| 1035 | __clockid_t __clock_id) | 
|---|
| 1036 | __THROW __nonnull ((1)); | 
|---|
| 1037 | #endif | 
|---|
| 1038 |  | 
|---|
| 1039 |  | 
|---|
| 1040 | #ifdef __USE_XOPEN2K | 
|---|
| 1041 | /* Functions to handle spinlocks.  */ | 
|---|
| 1042 |  | 
|---|
| 1043 | /* Initialize the spinlock LOCK.  If PSHARED is nonzero the spinlock can | 
|---|
| 1044 | be shared between different processes.  */ | 
|---|
| 1045 | extern int pthread_spin_init (pthread_spinlock_t *__lock, int __pshared) | 
|---|
| 1046 | __THROW __nonnull ((1)); | 
|---|
| 1047 |  | 
|---|
| 1048 | /* Destroy the spinlock LOCK.  */ | 
|---|
| 1049 | extern int pthread_spin_destroy (pthread_spinlock_t *__lock) | 
|---|
| 1050 | __THROW __nonnull ((1)); | 
|---|
| 1051 |  | 
|---|
| 1052 | /* Wait until spinlock LOCK is retrieved.  */ | 
|---|
| 1053 | extern int pthread_spin_lock (pthread_spinlock_t *__lock) | 
|---|
| 1054 | __THROWNL __nonnull ((1)); | 
|---|
| 1055 |  | 
|---|
| 1056 | /* Try to lock spinlock LOCK.  */ | 
|---|
| 1057 | extern int pthread_spin_trylock (pthread_spinlock_t *__lock) | 
|---|
| 1058 | __THROWNL __nonnull ((1)); | 
|---|
| 1059 |  | 
|---|
| 1060 | /* Release spinlock LOCK.  */ | 
|---|
| 1061 | extern int pthread_spin_unlock (pthread_spinlock_t *__lock) | 
|---|
| 1062 | __THROWNL __nonnull ((1)); | 
|---|
| 1063 |  | 
|---|
| 1064 |  | 
|---|
| 1065 | /* Functions to handle barriers.  */ | 
|---|
| 1066 |  | 
|---|
| 1067 | /* Initialize BARRIER with the attributes in ATTR.  The barrier is | 
|---|
| 1068 | opened when COUNT waiters arrived.  */ | 
|---|
| 1069 | extern int pthread_barrier_init (pthread_barrier_t *__restrict __barrier, | 
|---|
| 1070 | const pthread_barrierattr_t *__restrict | 
|---|
| 1071 | __attr, unsigned int __count) | 
|---|
| 1072 | __THROW __nonnull ((1)); | 
|---|
| 1073 |  | 
|---|
| 1074 | /* Destroy a previously dynamically initialized barrier BARRIER.  */ | 
|---|
| 1075 | extern int pthread_barrier_destroy (pthread_barrier_t *__barrier) | 
|---|
| 1076 | __THROW __nonnull ((1)); | 
|---|
| 1077 |  | 
|---|
| 1078 | /* Wait on barrier BARRIER.  */ | 
|---|
| 1079 | extern int pthread_barrier_wait (pthread_barrier_t *__barrier) | 
|---|
| 1080 | __THROWNL __nonnull ((1)); | 
|---|
| 1081 |  | 
|---|
| 1082 |  | 
|---|
| 1083 | /* Initialize barrier attribute ATTR.  */ | 
|---|
| 1084 | extern int pthread_barrierattr_init (pthread_barrierattr_t *__attr) | 
|---|
| 1085 | __THROW __nonnull ((1)); | 
|---|
| 1086 |  | 
|---|
| 1087 | /* Destroy previously dynamically initialized barrier attribute ATTR.  */ | 
|---|
| 1088 | extern int pthread_barrierattr_destroy (pthread_barrierattr_t *__attr) | 
|---|
| 1089 | __THROW __nonnull ((1)); | 
|---|
| 1090 |  | 
|---|
| 1091 | /* Get the process-shared flag of the barrier attribute ATTR.  */ | 
|---|
| 1092 | extern int pthread_barrierattr_getpshared (const pthread_barrierattr_t * | 
|---|
| 1093 | __restrict __attr, | 
|---|
| 1094 | int *__restrict __pshared) | 
|---|
| 1095 | __THROW __nonnull ((1, 2)); | 
|---|
| 1096 |  | 
|---|
| 1097 | /* Set the process-shared flag of the barrier attribute ATTR.  */ | 
|---|
| 1098 | extern int pthread_barrierattr_setpshared (pthread_barrierattr_t *__attr, | 
|---|
| 1099 | int __pshared) | 
|---|
| 1100 | __THROW __nonnull ((1)); | 
|---|
| 1101 | #endif | 
|---|
| 1102 |  | 
|---|
| 1103 |  | 
|---|
| 1104 | /* Functions for handling thread-specific data.  */ | 
|---|
| 1105 |  | 
|---|
| 1106 | /* Create a key value identifying a location in the thread-specific | 
|---|
| 1107 | data area.  Each thread maintains a distinct thread-specific data | 
|---|
| 1108 | area.  DESTR_FUNCTION, if non-NULL, is called with the value | 
|---|
| 1109 | associated to that key when the key is destroyed. | 
|---|
| 1110 | DESTR_FUNCTION is not called if the value associated is NULL when | 
|---|
| 1111 | the key is destroyed.  */ | 
|---|
| 1112 | extern int pthread_key_create (pthread_key_t *__key, | 
|---|
| 1113 | void (*__destr_function) (void *)) | 
|---|
| 1114 | __THROW __nonnull ((1)); | 
|---|
| 1115 |  | 
|---|
| 1116 | /* Destroy KEY.  */ | 
|---|
| 1117 | extern int pthread_key_delete (pthread_key_t __key) __THROW; | 
|---|
| 1118 |  | 
|---|
| 1119 | /* Return current value of the thread-specific data slot identified by KEY.  */ | 
|---|
| 1120 | extern void *pthread_getspecific (pthread_key_t __key) __THROW; | 
|---|
| 1121 |  | 
|---|
| 1122 | /* Store POINTER in the thread-specific data slot identified by KEY. */ | 
|---|
| 1123 | extern int pthread_setspecific (pthread_key_t __key, | 
|---|
| 1124 | const void *__pointer) __THROW ; | 
|---|
| 1125 |  | 
|---|
| 1126 |  | 
|---|
| 1127 | #ifdef __USE_XOPEN2K | 
|---|
| 1128 | /* Get ID of CPU-time clock for thread THREAD_ID.  */ | 
|---|
| 1129 | extern int pthread_getcpuclockid (pthread_t __thread_id, | 
|---|
| 1130 | __clockid_t *__clock_id) | 
|---|
| 1131 | __THROW __nonnull ((2)); | 
|---|
| 1132 | #endif | 
|---|
| 1133 |  | 
|---|
| 1134 |  | 
|---|
| 1135 | /* Install handlers to be called when a new process is created with FORK. | 
|---|
| 1136 | The PREPARE handler is called in the parent process just before performing | 
|---|
| 1137 | FORK. The PARENT handler is called in the parent process just after FORK. | 
|---|
| 1138 | The CHILD handler is called in the child process.  Each of the three | 
|---|
| 1139 | handlers can be NULL, meaning that no handler needs to be called at that | 
|---|
| 1140 | point. | 
|---|
| 1141 | PTHREAD_ATFORK can be called several times, in which case the PREPARE | 
|---|
| 1142 | handlers are called in LIFO order (last added with PTHREAD_ATFORK, | 
|---|
| 1143 | first called before FORK), and the PARENT and CHILD handlers are called | 
|---|
| 1144 | in FIFO (first added, first called).  */ | 
|---|
| 1145 |  | 
|---|
| 1146 | extern int pthread_atfork (void (*__prepare) (void), | 
|---|
| 1147 | void (*__parent) (void), | 
|---|
| 1148 | void (*__child) (void)) __THROW; | 
|---|
| 1149 |  | 
|---|
| 1150 |  | 
|---|
| 1151 | #ifdef __USE_EXTERN_INLINES | 
|---|
| 1152 | /* Optimizations.  */ | 
|---|
| 1153 | __extern_inline int | 
|---|
| 1154 | __NTH (pthread_equal (pthread_t __thread1, pthread_t __thread2)) | 
|---|
| 1155 | { | 
|---|
| 1156 | return __thread1 == __thread2; | 
|---|
| 1157 | } | 
|---|
| 1158 | #endif | 
|---|
| 1159 |  | 
|---|
| 1160 | __END_DECLS | 
|---|
| 1161 |  | 
|---|
| 1162 | #endif	/* pthread.h */ | 
|---|
| 1163 |  | 
|---|