pthread/pthread.h

   1 /*
   2  * Copyright (c) 2000-2012 Apple Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. Please obtain a copy of the License at
  10  * http://www.opensource.apple.com/apsl/ and read it before using this
  11  * file.
  12  *
  13  * The Original Code and all software distributed under the License are
  14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18  * Please see the License for the specific language governing rights and
  19  * limitations under the License.
  20  *
  21  * @APPLE_LICENSE_HEADER_END@
  22  */
  23 /*
  24  * Copyright 1996 1995 by Open Software Foundation, Inc. 1997 1996 1995 1994 1993 1992 1991
  25  *              All Rights Reserved
  26  *
  27  * Permission to use, copy, modify, and distribute this software and
  28  * its documentation for any purpose and without fee is hereby granted,
  29  * provided that the above copyright notice appears in all copies and
  30  * that both the copyright notice and this permission notice appear in
  31  * supporting documentation.
  32  *
  33  * OSF DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
  34  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  35  * FOR A PARTICULAR PURPOSE.
  36  *
  37  * IN NO EVENT SHALL OSF BE LIABLE FOR ANY SPECIAL, INDIRECT, OR
  38  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  39  * LOSS OF USE, DATA OR PROFITS, WHETHER IN ACTION OF CONTRACT,
  40  * NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
  41  * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  42  *
  43  */
  44 /*
  45  * MkLinux
  46  */
  47
  48 /*
  49  * POSIX Threads - IEEE 1003.1c
  50  */
  51
  52 #ifndef _PTHREAD_H
  53 #define _PTHREAD_H
  54
  55 #include <_types.h>
  56 #ifndef __POSIX_LIB__
  57 #include <pthread/pthread_impl.h>
  58 #endif
  59 #include <pthread/sched.h>
  60 #include <time.h>
  61 #include <sys/_pthread/_pthread_types.h>
  62 #include <sys/_pthread/_pthread_attr_t.h>
  63 #include <sys/_pthread/_pthread_cond_t.h>
  64 #include <sys/_pthread/_pthread_condattr_t.h>
  65 #include <sys/_pthread/_pthread_key_t.h>
  66 #include <sys/_pthread/_pthread_mutex_t.h>
  67 #include <sys/_pthread/_pthread_mutexattr_t.h>
  68 #include <sys/_pthread/_pthread_once_t.h>
  69 #include <sys/_pthread/_pthread_rwlock_t.h>
  70 #include <sys/_pthread/_pthread_rwlockattr_t.h>
  71 #include <sys/_pthread/_pthread_t.h>
  72
  73 #include <pthread/qos.h>
  74
  75 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || defined(_DARWIN_C_SOURCE) || defined(__cplusplus)
  76
  77 #include <sys/_types/_mach_port_t.h>
  78 #include <sys/_types/_sigset_t.h>
  79
  80 #endif /* (!_POSIX_C_SOURCE && !_XOPEN_SOURCE) || _DARWIN_C_SOURCE || __cplusplus */
  81
  82 /*
  83  * These symbols indicate which [optional] features are available
  84  * They can be tested at compile time via '#ifdef XXX'
  85  * The way to check for pthreads is like so:
  86
  87  * #include <unistd.h>
  88  * #ifdef _POSIX_THREADS
  89  * #include <pthread.h>
  90  * #endif
  91
  92  */
  93
  94 /* These will be moved to unistd.h */
  95
  96 /*
  97  * Note: These data structures are meant to be opaque.  Only enough
  98  * structure is exposed to support initializers.
  99  * All of the typedefs will be moved to <sys/types.h>
 100  */
 101
 102 #include <sys/cdefs.h>
 103 #include <Availability.h>
 104
 105 #if __has_feature(assume_nonnull)
 106 _Pragma("clang assume_nonnull begin")
 107 #endif
 108 __BEGIN_DECLS
 109 /*
 110  * Threads
 111  */
 112
 113
 114 /*
 115  * Cancel cleanup handler management.  Note, since these are implemented as macros,
 116  * they *MUST* occur in matched pairs!
 117  */
 118
 119 #define pthread_cleanup_push(func, val) \
 120    { \
 121              struct __darwin_pthread_handler_rec __handler; \
 122              pthread_t __self = pthread_self(); \
 123              __handler.__routine = func; \
 124              __handler.__arg = val; \
 125              __handler.__next = __self->__cleanup_stack; \
 126              __self->__cleanup_stack = &__handler;
 127
 128 #define pthread_cleanup_pop(execute) \
 129              /* Note: 'handler' must be in this same lexical context! */ \
 130              __self->__cleanup_stack = __handler.__next; \
 131              if (execute) (__handler.__routine)(__handler.__arg); \
 132    }
 133
 134 /*
 135  * Thread attributes
 136  */
 137
 138 #define PTHREAD_CREATE_JOINABLE      1
 139 #define PTHREAD_CREATE_DETACHED      2
 140
 141 #define PTHREAD_INHERIT_SCHED        1
 142 #define PTHREAD_EXPLICIT_SCHED       2
 143
 144 #define PTHREAD_CANCEL_ENABLE        0x01  /* Cancel takes place at next cancellation point */
 145 #define PTHREAD_CANCEL_DISABLE       0x00  /* Cancel postponed */
 146 #define PTHREAD_CANCEL_DEFERRED      0x02  /* Cancel waits until cancellation point */
 147 #define PTHREAD_CANCEL_ASYNCHRONOUS  0x00  /* Cancel occurs immediately */
 148
 149 /* Value returned from pthread_join() when a thread is canceled */
 150 #define PTHREAD_CANCELED             ((void *) 1)
 151
 152 /* We only support PTHREAD_SCOPE_SYSTEM */
 153 #define PTHREAD_SCOPE_SYSTEM         1
 154 #define PTHREAD_SCOPE_PROCESS        2
 155
 156 #define PTHREAD_PROCESS_SHARED         1
 157 #define PTHREAD_PROCESS_PRIVATE        2
 158
 159 /*
 160  * Mutex protocol attributes
 161  */
 162 #define PTHREAD_PRIO_NONE            0
 163 #define PTHREAD_PRIO_INHERIT         1
 164 #define PTHREAD_PRIO_PROTECT         2
 165
 166 /*
 167  * Mutex type attributes
 168  */
 169 #define PTHREAD_MUTEX_NORMAL            0
 170 #define PTHREAD_MUTEX_ERRORCHECK        1
 171 #define PTHREAD_MUTEX_RECURSIVE         2
 172 #define PTHREAD_MUTEX_DEFAULT           PTHREAD_MUTEX_NORMAL
 173
 174 /*
 175  * Mutex policy attributes
 176  */
 177 #define PTHREAD_MUTEX_POLICY_FAIRSHARE_NP   1
 178 #define PTHREAD_MUTEX_POLICY_FIRSTFIT_NP    3
 179
 180 /*
 181  * RWLock variables
 182  */
 183 #define PTHREAD_RWLOCK_INITIALIZER {_PTHREAD_RWLOCK_SIG_init, {0}}
 184
 185 /*
 186  * Mutex variables
 187  */
 188 #define PTHREAD_MUTEX_INITIALIZER {_PTHREAD_MUTEX_SIG_init, {0}}
 189
 190 /* <rdar://problem/10854763> */
 191 #if ((__MAC_OS_X_VERSION_MIN_REQUIRED && __MAC_OS_X_VERSION_MIN_REQUIRED >= 1070) || (__IPHONE_OS_VERSION_MIN_REQUIRED && __IPHONE_OS_VERSION_MIN_REQUIRED >= 50000))
 192 #       if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || defined(_DARWIN_C_SOURCE)
 193 #               define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER {_PTHREAD_ERRORCHECK_MUTEX_SIG_init, {0}}
 194 #               define PTHREAD_RECURSIVE_MUTEX_INITIALIZER {_PTHREAD_RECURSIVE_MUTEX_SIG_init, {0}}
 195 #       endif /* (!_POSIX_C_SOURCE && !_XOPEN_SOURCE) || _DARWIN_C_SOURCE */
 196 #endif
 197
 198 /* <rdar://problem/25944576> */
 199 #define _PTHREAD_SWIFT_IMPORTER_NULLABILITY_COMPAT \
 200         defined(SWIFT_CLASS_EXTRA) && (!defined(SWIFT_SDK_OVERLAY_PTHREAD_EPOCH) || (SWIFT_SDK_OVERLAY_PTHREAD_EPOCH < 1))
 201
 202 /*
 203  * Condition variable attributes
 204  */
 205
 206 /*
 207  * Condition variables
 208  */
 209
 210 #define PTHREAD_COND_INITIALIZER {_PTHREAD_COND_SIG_init, {0}}
 211
 212 /*
 213  * Initialization control (once) variables
 214  */
 215
 216 #define PTHREAD_ONCE_INIT {_PTHREAD_ONCE_SIG_init, {0}}
 217
 218 /*
 219  * Prototypes for all PTHREAD interfaces
 220  */
 221 __API_AVAILABLE(macos(10.4), ios(2.0))
 222 int pthread_atfork(void (* _Nullable)(void), void (* _Nullable)(void),
 223                 void (* _Nullable)(void));
 224
 225 __API_AVAILABLE(macos(10.4), ios(2.0))
 226 int pthread_attr_destroy(pthread_attr_t *);
 227
 228 __API_AVAILABLE(macos(10.4), ios(2.0))
 229 int pthread_attr_getdetachstate(const pthread_attr_t *, int *);
 230
 231 __API_AVAILABLE(macos(10.4), ios(2.0))
 232 int pthread_attr_getguardsize(const pthread_attr_t * __restrict, size_t * __restrict);
 233
 234 __API_AVAILABLE(macos(10.4), ios(2.0))
 235 int pthread_attr_getinheritsched(const pthread_attr_t * __restrict, int * __restrict);
 236
 237 __API_AVAILABLE(macos(10.4), ios(2.0))
 238 int pthread_attr_getschedparam(const pthread_attr_t * __restrict,
 239                 struct sched_param * __restrict);
 240
 241 __API_AVAILABLE(macos(10.4), ios(2.0))
 242 int pthread_attr_getschedpolicy(const pthread_attr_t * __restrict, int * __restrict);
 243
 244 __API_AVAILABLE(macos(10.4), ios(2.0))
 245 int pthread_attr_getscope(const pthread_attr_t * __restrict, int * __restrict);
 246
 247 __API_AVAILABLE(macos(10.4), ios(2.0))
 248 int pthread_attr_getstack(const pthread_attr_t * __restrict,
 249                 void * _Nullable * _Nonnull __restrict, size_t * __restrict);
 250
 251 __API_AVAILABLE(macos(10.4), ios(2.0))
 252 int pthread_attr_getstackaddr(const pthread_attr_t * __restrict,
 253                 void * _Nullable * _Nonnull __restrict);
 254
 255 __API_AVAILABLE(macos(10.4), ios(2.0))
 256 int pthread_attr_getstacksize(const pthread_attr_t * __restrict, size_t * __restrict);
 257
 258 __API_AVAILABLE(macos(10.4), ios(2.0))
 259 int pthread_attr_init(pthread_attr_t *);
 260
 261 __API_AVAILABLE(macos(10.4), ios(2.0))
 262 int pthread_attr_setdetachstate(pthread_attr_t *, int);
 263
 264 __API_AVAILABLE(macos(10.4), ios(2.0))
 265 int pthread_attr_setguardsize(pthread_attr_t *, size_t);
 266
 267 __API_AVAILABLE(macos(10.4), ios(2.0))
 268 int pthread_attr_setinheritsched(pthread_attr_t *, int);
 269
 270 __API_AVAILABLE(macos(10.4), ios(2.0))
 271 int pthread_attr_setschedparam(pthread_attr_t * __restrict,
 272                 const struct sched_param * __restrict);
 273
 274 __API_AVAILABLE(macos(10.4), ios(2.0))
 275 int pthread_attr_setschedpolicy(pthread_attr_t *, int);
 276
 277 __API_AVAILABLE(macos(10.4), ios(2.0))
 278 int pthread_attr_setscope(pthread_attr_t *, int);
 279
 280 __API_AVAILABLE(macos(10.4), ios(2.0))
 281 int pthread_attr_setstack(pthread_attr_t *, void *, size_t);
 282
 283 __API_AVAILABLE(macos(10.4), ios(2.0))
 284 int pthread_attr_setstackaddr(pthread_attr_t *, void *);
 285
 286 __API_AVAILABLE(macos(10.4), ios(2.0))
 287 int pthread_attr_setstacksize(pthread_attr_t *, size_t);
 288
 289 __API_AVAILABLE(macos(10.4), ios(2.0))
 290 int pthread_cancel(pthread_t) __DARWIN_ALIAS(pthread_cancel);
 291
 292 __API_AVAILABLE(macos(10.4), ios(2.0))
 293 int pthread_cond_broadcast(pthread_cond_t *);
 294
 295 __API_AVAILABLE(macos(10.4), ios(2.0))
 296 int pthread_cond_destroy(pthread_cond_t *);
 297
 298 __API_AVAILABLE(macos(10.4), ios(2.0))
 299 int pthread_cond_init(
 300                 pthread_cond_t * __restrict,
 301                 const pthread_condattr_t * _Nullable __restrict)
 302                 __DARWIN_ALIAS(pthread_cond_init);
 303
 304 __API_AVAILABLE(macos(10.4), ios(2.0))
 305 int pthread_cond_signal(pthread_cond_t *);
 306
 307 __API_AVAILABLE(macos(10.4), ios(2.0))
 308 int pthread_cond_timedwait(
 309                 pthread_cond_t * __restrict, pthread_mutex_t * __restrict,
 310                 const struct timespec * _Nullable __restrict)
 311                 __DARWIN_ALIAS_C(pthread_cond_timedwait);
 312
 313 __API_AVAILABLE(macos(10.4), ios(2.0))
 314 int pthread_cond_wait(pthread_cond_t * __restrict,
 315                 pthread_mutex_t * __restrict) __DARWIN_ALIAS_C(pthread_cond_wait);
 316
 317 __API_AVAILABLE(macos(10.4), ios(2.0))
 318 int pthread_condattr_destroy(pthread_condattr_t *);
 319
 320 __API_AVAILABLE(macos(10.4), ios(2.0))
 321 int pthread_condattr_init(pthread_condattr_t *);
 322
 323 __API_AVAILABLE(macos(10.4), ios(2.0))
 324 int pthread_condattr_getpshared(const pthread_condattr_t * __restrict,
 325                 int * __restrict);
 326
 327 __API_AVAILABLE(macos(10.4), ios(2.0))
 328 int pthread_condattr_setpshared(pthread_condattr_t *, int);
 329
 330 __API_AVAILABLE(macos(10.4), ios(2.0))
 331 #if !_PTHREAD_SWIFT_IMPORTER_NULLABILITY_COMPAT
 332 int pthread_create(pthread_t _Nullable * _Nonnull __restrict,
 333                 const pthread_attr_t * _Nullable __restrict,
 334                 void * _Nullable (* _Nonnull)(void * _Nullable),
 335                 void * _Nullable __restrict);
 336 #else
 337 int pthread_create(pthread_t * __restrict,
 338                 const pthread_attr_t * _Nullable __restrict,
 339                 void *(* _Nonnull)(void *), void * _Nullable __restrict);
 340 #endif // _PTHREAD_SWIFT_IMPORTER_NULLABILITY_COMPAT
 341
 342 __API_AVAILABLE(macos(10.4), ios(2.0))
 343 int pthread_detach(pthread_t);
 344
 345 __API_AVAILABLE(macos(10.4), ios(2.0))
 346 int pthread_equal(pthread_t _Nullable, pthread_t _Nullable);
 347
 348 __API_AVAILABLE(macos(10.4), ios(2.0))
 349 void pthread_exit(void * _Nullable) __dead2;
 350
 351 __API_AVAILABLE(macos(10.4), ios(2.0))
 352 int pthread_getconcurrency(void);
 353
 354 __API_AVAILABLE(macos(10.4), ios(2.0))
 355 int pthread_getschedparam(pthread_t , int * _Nullable __restrict,
 356                 struct sched_param * _Nullable __restrict);
 357
 358 __API_AVAILABLE(macos(10.4), ios(2.0))
 359 void* _Nullable pthread_getspecific(pthread_key_t);
 360
 361 __API_AVAILABLE(macos(10.4), ios(2.0))
 362 int pthread_join(pthread_t , void * _Nullable * _Nullable)
 363                 __DARWIN_ALIAS_C(pthread_join);
 364
 365 __API_AVAILABLE(macos(10.4), ios(2.0))
 366 int pthread_key_create(pthread_key_t *, void (* _Nullable)(void *));
 367
 368 __API_AVAILABLE(macos(10.4), ios(2.0))
 369 int pthread_key_delete(pthread_key_t);
 370
 371 __API_AVAILABLE(macos(10.4), ios(2.0))
 372 int pthread_mutex_destroy(pthread_mutex_t *);
 373
 374 __API_AVAILABLE(macos(10.4), ios(2.0))
 375 int pthread_mutex_getprioceiling(const pthread_mutex_t * __restrict,
 376                 int * __restrict);
 377
 378 __API_AVAILABLE(macos(10.4), ios(2.0))
 379 int pthread_mutex_init(pthread_mutex_t * __restrict,
 380                 const pthread_mutexattr_t * _Nullable __restrict);
 381
 382 __API_AVAILABLE(macos(10.4), ios(2.0))
 383 int pthread_mutex_lock(pthread_mutex_t *);
 384
 385 __API_AVAILABLE(macos(10.4), ios(2.0))
 386 int pthread_mutex_setprioceiling(pthread_mutex_t * __restrict, int,
 387                 int * __restrict);
 388
 389 __API_AVAILABLE(macos(10.4), ios(2.0))
 390 int pthread_mutex_trylock(pthread_mutex_t *);
 391
 392 __API_AVAILABLE(macos(10.4), ios(2.0))
 393 int pthread_mutex_unlock(pthread_mutex_t *);
 394
 395 __API_AVAILABLE(macos(10.4), ios(2.0))
 396 int pthread_mutexattr_destroy(pthread_mutexattr_t *) __DARWIN_ALIAS(pthread_mutexattr_destroy);
 397
 398 __API_AVAILABLE(macos(10.4), ios(2.0))
 399 int pthread_mutexattr_getprioceiling(const pthread_mutexattr_t * __restrict,
 400                 int * __restrict);
 401
 402 __API_AVAILABLE(macos(10.4), ios(2.0))
 403 int pthread_mutexattr_getprotocol(const pthread_mutexattr_t * __restrict,
 404                 int * __restrict);
 405
 406 __API_AVAILABLE(macos(10.4), ios(2.0))
 407 int pthread_mutexattr_getpshared(const pthread_mutexattr_t * __restrict,
 408                 int * __restrict);
 409
 410 __API_AVAILABLE(macos(10.4), ios(2.0))
 411 int pthread_mutexattr_gettype(const pthread_mutexattr_t * __restrict,
 412                 int * __restrict);
 413
 414 __API_AVAILABLE(macos(10.13.4), ios(11.3), watchos(4.3), tvos(11.3))
 415 int pthread_mutexattr_getpolicy_np(const pthread_mutexattr_t * __restrict,
 416                 int * __restrict);
 417
 418 __API_AVAILABLE(macos(10.4), ios(2.0))
 419 int pthread_mutexattr_init(pthread_mutexattr_t *);
 420
 421 __API_AVAILABLE(macos(10.4), ios(2.0))
 422 int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *, int);
 423
 424 __API_AVAILABLE(macos(10.4), ios(2.0))
 425 int pthread_mutexattr_setprotocol(pthread_mutexattr_t *, int);
 426
 427 __API_AVAILABLE(macos(10.4), ios(2.0))
 428 int pthread_mutexattr_setpshared(pthread_mutexattr_t *, int);
 429
 430 __API_AVAILABLE(macos(10.4), ios(2.0))
 431 int pthread_mutexattr_settype(pthread_mutexattr_t *, int);
 432
 433 __API_AVAILABLE(macos(10.7), ios(5.0))
 434 int pthread_mutexattr_setpolicy_np(pthread_mutexattr_t *, int);
 435
 436 __SWIFT_UNAVAILABLE_MSG("Use lazily initialized globals instead")
 437 __API_AVAILABLE(macos(10.4), ios(2.0))
 438 int pthread_once(pthread_once_t *, void (* _Nonnull)(void));
 439
 440 __API_AVAILABLE(macos(10.4), ios(2.0))
 441 int pthread_rwlock_destroy(pthread_rwlock_t * ) __DARWIN_ALIAS(pthread_rwlock_destroy);
 442
 443 __API_AVAILABLE(macos(10.4), ios(2.0))
 444 int pthread_rwlock_init(pthread_rwlock_t * __restrict,
 445                 const pthread_rwlockattr_t * _Nullable __restrict)
 446                 __DARWIN_ALIAS(pthread_rwlock_init);
 447
 448 __API_AVAILABLE(macos(10.4), ios(2.0))
 449 int pthread_rwlock_rdlock(pthread_rwlock_t *) __DARWIN_ALIAS(pthread_rwlock_rdlock);
 450
 451 __API_AVAILABLE(macos(10.4), ios(2.0))
 452 int pthread_rwlock_tryrdlock(pthread_rwlock_t *) __DARWIN_ALIAS(pthread_rwlock_tryrdlock);
 453
 454 __API_AVAILABLE(macos(10.4), ios(2.0))
 455 int pthread_rwlock_trywrlock(pthread_rwlock_t *) __DARWIN_ALIAS(pthread_rwlock_trywrlock);
 456
 457 __API_AVAILABLE(macos(10.4), ios(2.0))
 458 int pthread_rwlock_wrlock(pthread_rwlock_t *) __DARWIN_ALIAS(pthread_rwlock_wrlock);
 459
 460 __API_AVAILABLE(macos(10.4), ios(2.0))
 461 int pthread_rwlock_unlock(pthread_rwlock_t *) __DARWIN_ALIAS(pthread_rwlock_unlock);
 462
 463 __API_AVAILABLE(macos(10.4), ios(2.0))
 464 int pthread_rwlockattr_destroy(pthread_rwlockattr_t *);
 465
 466 __API_AVAILABLE(macos(10.4), ios(2.0))
 467 int pthread_rwlockattr_getpshared(const pthread_rwlockattr_t * __restrict,
 468                 int * __restrict);
 469
 470 __API_AVAILABLE(macos(10.4), ios(2.0))
 471 int pthread_rwlockattr_init(pthread_rwlockattr_t *);
 472
 473 __API_AVAILABLE(macos(10.4), ios(2.0))
 474 int pthread_rwlockattr_setpshared(pthread_rwlockattr_t *, int);
 475
 476 __API_AVAILABLE(macos(10.4), ios(2.0))
 477 pthread_t pthread_self(void);
 478
 479 __API_AVAILABLE(macos(10.4), ios(2.0))
 480 int pthread_setcancelstate(int , int * _Nullable)
 481                 __DARWIN_ALIAS(pthread_setcancelstate);
 482
 483 __API_AVAILABLE(macos(10.4), ios(2.0))
 484 int pthread_setcanceltype(int , int * _Nullable)
 485                 __DARWIN_ALIAS(pthread_setcanceltype);
 486
 487 __API_AVAILABLE(macos(10.4), ios(2.0))
 488 int pthread_setconcurrency(int);
 489
 490 __API_AVAILABLE(macos(10.4), ios(2.0))
 491 int pthread_setschedparam(pthread_t, int, const struct sched_param *);
 492
 493 __API_AVAILABLE(macos(10.4), ios(2.0))
 494 int pthread_setspecific(pthread_key_t , const void * _Nullable);
 495
 496 __API_AVAILABLE(macos(10.4), ios(2.0))
 497 void pthread_testcancel(void) __DARWIN_ALIAS(pthread_testcancel);
 498
 499 #if (!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)) || defined(_DARWIN_C_SOURCE) || defined(__cplusplus)
 500
 501 /* returns non-zero if pthread_create or cthread_fork have been called */
 502 __API_AVAILABLE(macos(10.4), ios(2.0))
 503 int pthread_is_threaded_np(void);
 504
 505 __API_AVAILABLE(macos(10.6), ios(3.2))
 506 int pthread_threadid_np(pthread_t _Nullable,__uint64_t* _Nullable);
 507
 508 /*SPI to set and get pthread name*/
 509 __API_AVAILABLE(macos(10.6), ios(3.2))
 510 int     pthread_getname_np(pthread_t,char*,size_t);
 511
 512 __API_AVAILABLE(macos(10.6), ios(3.2))
 513 int     pthread_setname_np(const char*);
 514
 515 /* returns non-zero if the current thread is the main thread */
 516 __API_AVAILABLE(macos(10.4), ios(2.0))
 517 int     pthread_main_np(void);
 518
 519 /* return the mach thread bound to the pthread */
 520 __API_AVAILABLE(macos(10.4), ios(2.0))
 521 mach_port_t pthread_mach_thread_np(pthread_t);
 522
 523 __API_AVAILABLE(macos(10.4), ios(2.0))
 524 size_t pthread_get_stacksize_np(pthread_t);
 525
 526 __API_AVAILABLE(macos(10.4), ios(2.0))
 527 void* pthread_get_stackaddr_np(pthread_t);
 528
 529 /* Like pthread_cond_signal(), but only wake up the specified pthread */
 530 __API_AVAILABLE(macos(10.4), ios(2.0))
 531 int pthread_cond_signal_thread_np(pthread_cond_t *, pthread_t _Nullable);
 532
 533 /* Like pthread_cond_timedwait, but use a relative timeout */
 534 __API_AVAILABLE(macos(10.4), ios(2.0))
 535 int pthread_cond_timedwait_relative_np(pthread_cond_t *, pthread_mutex_t *,
 536                 const struct timespec * _Nullable);
 537
 538 /* Like pthread_create(), but leaves the thread suspended */
 539 __API_AVAILABLE(macos(10.4), ios(2.0))
 540 #if !_PTHREAD_SWIFT_IMPORTER_NULLABILITY_COMPAT
 541 int pthread_create_suspended_np(
 542                 pthread_t _Nullable * _Nonnull, const pthread_attr_t * _Nullable,
 543                 void * _Nullable (* _Nonnull)(void * _Nullable), void * _Nullable);
 544 #else
 545 int pthread_create_suspended_np(pthread_t *, const pthread_attr_t * _Nullable,
 546                 void *(* _Nonnull)(void *), void * _Nullable);
 547 #endif
 548
 549 __API_AVAILABLE(macos(10.4), ios(2.0))
 550 int pthread_kill(pthread_t, int);
 551
 552 __API_AVAILABLE(macos(10.5), ios(2.0))
 553 _Nullable pthread_t pthread_from_mach_thread_np(mach_port_t);
 554
 555 __API_AVAILABLE(macos(10.4), ios(2.0))
 556 int pthread_sigmask(int, const sigset_t * _Nullable, sigset_t * _Nullable)
 557                 __DARWIN_ALIAS(pthread_sigmask);
 558
 559 __API_AVAILABLE(macos(10.4), ios(2.0))
 560 void pthread_yield_np(void);
 561
 562 #endif /* (!_POSIX_C_SOURCE && !_XOPEN_SOURCE) || _DARWIN_C_SOURCE || __cplusplus */
 563 __END_DECLS
 564 #if __has_feature(assume_nonnull)
 565 _Pragma("clang assume_nonnull end")
 566 #endif
 567
 568 #endif /* _PTHREAD_H */