457 lines
15 KiB
C
457 lines
15 KiB
C
/*
|
|
* Written by Joel Sherrill <joel.sherrill@OARcorp.com>.
|
|
*
|
|
* COPYRIGHT (c) 1989-2013, 2015.
|
|
* On-Line Applications Research Corporation (OAR).
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose without fee is hereby granted, provided that this entire notice
|
|
* is included in all copies of any software which is or includes a copy
|
|
* or modification of this software.
|
|
*
|
|
* THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
|
|
* WARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION
|
|
* OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS
|
|
* SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
|
|
*/
|
|
|
|
#ifndef __PTHREAD_h
|
|
#define __PTHREAD_h
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <unistd.h>
|
|
|
|
#if defined(_POSIX_THREADS)
|
|
|
|
#include <sys/types.h>
|
|
#include <time.h>
|
|
#include <sched.h>
|
|
#include <sys/cdefs.h>
|
|
|
|
struct _pthread_cleanup_context {
|
|
void (*_routine)(void *);
|
|
void *_arg;
|
|
int _canceltype;
|
|
struct _pthread_cleanup_context *_previous;
|
|
};
|
|
|
|
/* Register Fork Handlers */
|
|
int pthread_atfork (void (*prepare)(void), void (*parent)(void),
|
|
void (*child)(void));
|
|
|
|
/* Mutex Initialization Attributes, P1003.1c/Draft 10, p. 81 */
|
|
|
|
int pthread_mutexattr_init (pthread_mutexattr_t *__attr);
|
|
int pthread_mutexattr_destroy (pthread_mutexattr_t *__attr);
|
|
int pthread_mutexattr_getpshared (const pthread_mutexattr_t *__attr,
|
|
int *__pshared);
|
|
int pthread_mutexattr_setpshared (pthread_mutexattr_t *__attr,
|
|
int __pshared);
|
|
|
|
#if defined(_UNIX98_THREAD_MUTEX_ATTRIBUTES)
|
|
|
|
/* Single UNIX Specification 2 Mutex Attributes types */
|
|
|
|
int pthread_mutexattr_gettype (const pthread_mutexattr_t *__attr, int *__kind);
|
|
int pthread_mutexattr_settype (pthread_mutexattr_t *__attr, int __kind);
|
|
|
|
#endif
|
|
|
|
/* Initializing and Destroying a Mutex, P1003.1c/Draft 10, p. 87 */
|
|
|
|
int pthread_mutex_init (pthread_mutex_t *__mutex,
|
|
const pthread_mutexattr_t *__attr);
|
|
int pthread_mutex_destroy (pthread_mutex_t *__mutex);
|
|
|
|
/* This is used to statically initialize a pthread_mutex_t. Example:
|
|
|
|
pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
|
|
*/
|
|
|
|
#define PTHREAD_MUTEX_INITIALIZER _PTHREAD_MUTEX_INITIALIZER
|
|
|
|
/* Locking and Unlocking a Mutex, P1003.1c/Draft 10, p. 93
|
|
NOTE: P1003.4b/D8 adds pthread_mutex_timedlock(), p. 29 */
|
|
|
|
int pthread_mutex_lock (pthread_mutex_t *__mutex);
|
|
int pthread_mutex_trylock (pthread_mutex_t *__mutex);
|
|
int pthread_mutex_unlock (pthread_mutex_t *__mutex);
|
|
|
|
#if defined(_POSIX_TIMEOUTS)
|
|
|
|
int pthread_mutex_timedlock (pthread_mutex_t *__mutex,
|
|
const struct timespec *__timeout);
|
|
|
|
#endif /* _POSIX_TIMEOUTS */
|
|
|
|
#if __GNU_VISIBLE
|
|
/* The Issue 8 standard adds pthread_mutex_clocklock() */
|
|
int pthread_mutex_clocklock(pthread_mutex_t *__restrict, clockid_t,
|
|
const struct timespec *__restrict);
|
|
#endif /* __GNU_VISIBLE */
|
|
|
|
/* Condition Variable Initialization Attributes, P1003.1c/Draft 10, p. 96 */
|
|
|
|
int pthread_condattr_init (pthread_condattr_t *__attr);
|
|
int pthread_condattr_destroy (pthread_condattr_t *__attr);
|
|
|
|
int pthread_condattr_getclock (const pthread_condattr_t *__restrict __attr,
|
|
clockid_t *__restrict __clock_id);
|
|
int pthread_condattr_setclock (pthread_condattr_t *__attr,
|
|
clockid_t __clock_id);
|
|
|
|
int pthread_condattr_getpshared (const pthread_condattr_t *__attr,
|
|
int *__pshared);
|
|
int pthread_condattr_setpshared (pthread_condattr_t *__attr, int __pshared);
|
|
|
|
/* Initializing and Destroying a Condition Variable, P1003.1c/Draft 10, p. 87 */
|
|
|
|
int pthread_cond_init (pthread_cond_t *__cond,
|
|
const pthread_condattr_t *__attr);
|
|
int pthread_cond_destroy (pthread_cond_t *__mutex);
|
|
|
|
/* This is used to statically initialize a pthread_cond_t. Example:
|
|
|
|
pthread_cond_t cond = PTHREAD_COND_INITIALIZER;
|
|
*/
|
|
|
|
#define PTHREAD_COND_INITIALIZER _PTHREAD_COND_INITIALIZER
|
|
|
|
/* Broadcasting and Signaling a Condition, P1003.1c/Draft 10, p. 101 */
|
|
|
|
int pthread_cond_signal (pthread_cond_t *__cond);
|
|
int pthread_cond_broadcast (pthread_cond_t *__cond);
|
|
|
|
/* Waiting on a Condition, P1003.1c/Draft 10, p. 105 */
|
|
|
|
int pthread_cond_wait (pthread_cond_t *__cond, pthread_mutex_t *__mutex);
|
|
|
|
int pthread_cond_timedwait (pthread_cond_t *__cond,
|
|
pthread_mutex_t *__mutex,
|
|
const struct timespec *__abstime);
|
|
|
|
#if __GNU_VISIBLE
|
|
/* The Issue 8 standard adds pthread_cond_clockwait() */
|
|
int pthread_cond_clockwait(pthread_cond_t *__restrict,
|
|
pthread_mutex_t *__restrict, clockid_t,
|
|
const struct timespec *__restrict);
|
|
#endif /* __GNU_VISIBLE */
|
|
|
|
#if defined(_POSIX_THREAD_PRIORITY_SCHEDULING)
|
|
|
|
/* Thread Creation Scheduling Attributes, P1003.1c/Draft 10, p. 120 */
|
|
|
|
int pthread_attr_setscope (pthread_attr_t *__attr, int __contentionscope);
|
|
int pthread_attr_getscope (const pthread_attr_t *__attr,
|
|
int *__contentionscope);
|
|
int pthread_attr_setinheritsched (pthread_attr_t *__attr,
|
|
int __inheritsched);
|
|
int pthread_attr_getinheritsched (const pthread_attr_t *__attr,
|
|
int *__inheritsched);
|
|
int pthread_attr_setschedpolicy (pthread_attr_t *__attr, int __policy);
|
|
int pthread_attr_getschedpolicy (const pthread_attr_t *__attr,
|
|
int *__policy);
|
|
|
|
#endif /* defined(_POSIX_THREAD_PRIORITY_SCHEDULING) */
|
|
|
|
int pthread_attr_setschedparam (pthread_attr_t *__attr,
|
|
const struct sched_param *__param);
|
|
int pthread_attr_getschedparam (const pthread_attr_t *__attr,
|
|
struct sched_param *__param);
|
|
|
|
#if defined(_POSIX_THREAD_PRIORITY_SCHEDULING)
|
|
|
|
/* Dynamic Thread Scheduling Parameters Access, P1003.1c/Draft 10, p. 124 */
|
|
|
|
int pthread_getschedparam (pthread_t __pthread, int *__policy,
|
|
struct sched_param *__param);
|
|
int pthread_setschedparam (pthread_t __pthread, int __policy,
|
|
const struct sched_param *__param);
|
|
|
|
/* Set Scheduling Priority of a Thread */
|
|
int pthread_setschedprio (pthread_t thread, int prio);
|
|
|
|
#endif /* defined(_POSIX_THREAD_PRIORITY_SCHEDULING) */
|
|
|
|
#if __GNU_VISIBLE
|
|
int pthread_getname_np(pthread_t, char *, size_t) __nonnull((2));
|
|
|
|
int pthread_setname_np(pthread_t, const char *) __nonnull((2));
|
|
#endif
|
|
|
|
#if defined(_POSIX_THREAD_PRIO_INHERIT) || defined(_POSIX_THREAD_PRIO_PROTECT)
|
|
|
|
/* Mutex Initialization Scheduling Attributes, P1003.1c/Draft 10, p. 128 */
|
|
|
|
int pthread_mutexattr_setprotocol (pthread_mutexattr_t *__attr,
|
|
int __protocol);
|
|
int pthread_mutexattr_getprotocol (const pthread_mutexattr_t *__attr,
|
|
int *__protocol);
|
|
int pthread_mutexattr_setprioceiling (pthread_mutexattr_t *__attr,
|
|
int __prioceiling);
|
|
int pthread_mutexattr_getprioceiling (const pthread_mutexattr_t *__attr,
|
|
int *__prioceiling);
|
|
|
|
#endif /* _POSIX_THREAD_PRIO_INHERIT || _POSIX_THREAD_PRIO_PROTECT */
|
|
|
|
#if defined(_POSIX_THREAD_PRIO_PROTECT)
|
|
|
|
/* Change the Priority Ceiling of a Mutex, P1003.1c/Draft 10, p. 131 */
|
|
|
|
int pthread_mutex_setprioceiling (pthread_mutex_t *__mutex,
|
|
int __prioceiling, int *__old_ceiling);
|
|
int pthread_mutex_getprioceiling (const pthread_mutex_t *__restrict __mutex,
|
|
int *__prioceiling);
|
|
|
|
#endif /* _POSIX_THREAD_PRIO_PROTECT */
|
|
|
|
/* Thread Creation Attributes, P1003.1c/Draft 10, p, 140 */
|
|
|
|
int pthread_attr_init (pthread_attr_t *__attr);
|
|
int pthread_attr_destroy (pthread_attr_t *__attr);
|
|
int pthread_attr_setstack (pthread_attr_t *attr,
|
|
void *__stackaddr, size_t __stacksize);
|
|
int pthread_attr_getstack (const pthread_attr_t *attr,
|
|
void **__stackaddr, size_t *__stacksize);
|
|
int pthread_attr_getstacksize (const pthread_attr_t *__attr,
|
|
size_t *__stacksize);
|
|
int pthread_attr_setstacksize (pthread_attr_t *__attr, size_t __stacksize);
|
|
int pthread_attr_getstackaddr (const pthread_attr_t *__attr,
|
|
void **__stackaddr);
|
|
int pthread_attr_setstackaddr (pthread_attr_t *__attr, void *__stackaddr);
|
|
int pthread_attr_getdetachstate (const pthread_attr_t *__attr,
|
|
int *__detachstate);
|
|
int pthread_attr_setdetachstate (pthread_attr_t *__attr, int __detachstate);
|
|
int pthread_attr_getguardsize (const pthread_attr_t *__attr,
|
|
size_t *__guardsize);
|
|
int pthread_attr_setguardsize (pthread_attr_t *__attr, size_t __guardsize);
|
|
|
|
/* POSIX thread APIs beyond the POSIX standard but provided
|
|
* in GNU/Linux. They may be provided by other OSes for
|
|
* compatibility.
|
|
*/
|
|
#if __GNU_VISIBLE
|
|
#if defined(__rtems__)
|
|
int pthread_attr_setaffinity_np (pthread_attr_t *__attr,
|
|
size_t __cpusetsize,
|
|
const cpu_set_t *__cpuset);
|
|
int pthread_attr_getaffinity_np (const pthread_attr_t *__attr,
|
|
size_t __cpusetsize, cpu_set_t *__cpuset);
|
|
|
|
int pthread_setaffinity_np (pthread_t __id, size_t __cpusetsize,
|
|
const cpu_set_t *__cpuset);
|
|
int pthread_getaffinity_np (const pthread_t __id, size_t __cpusetsize,
|
|
cpu_set_t *__cpuset);
|
|
|
|
int pthread_getattr_np (pthread_t __id, pthread_attr_t *__attr);
|
|
#endif /* defined(__rtems__) */
|
|
#endif /* __GNU_VISIBLE */
|
|
|
|
/* Thread Creation, P1003.1c/Draft 10, p. 144 */
|
|
|
|
int pthread_create (pthread_t *__pthread, const pthread_attr_t *__attr,
|
|
void *(*__start_routine)(void *), void *__arg);
|
|
|
|
/* Wait for Thread Termination, P1003.1c/Draft 10, p. 147 */
|
|
|
|
int pthread_join (pthread_t __pthread, void **__value_ptr);
|
|
|
|
/* Detaching a Thread, P1003.1c/Draft 10, p. 149 */
|
|
|
|
int pthread_detach (pthread_t __pthread);
|
|
|
|
/* Thread Termination, p1003.1c/Draft 10, p. 150 */
|
|
|
|
void pthread_exit (void *__value_ptr) __dead2;
|
|
|
|
/* Get Calling Thread's ID, p1003.1c/Draft 10, p. XXX */
|
|
|
|
pthread_t pthread_self (void);
|
|
|
|
/* Compare Thread IDs, p1003.1c/Draft 10, p. 153 */
|
|
|
|
int pthread_equal (pthread_t __t1, pthread_t __t2);
|
|
|
|
/* Retrieve ID of a Thread's CPU Time Clock */
|
|
int pthread_getcpuclockid (pthread_t thread, clockid_t *clock_id);
|
|
|
|
/* Get/Set Current Thread's Concurrency Level */
|
|
int pthread_setconcurrency (int new_level);
|
|
int pthread_getconcurrency (void);
|
|
|
|
#if __BSD_VISIBLE || __GNU_VISIBLE
|
|
void pthread_yield (void);
|
|
#endif
|
|
|
|
/* Dynamic Package Initialization */
|
|
|
|
/* This is used to statically initialize a pthread_once_t. Example:
|
|
|
|
pthread_once_t once = PTHREAD_ONCE_INIT;
|
|
|
|
NOTE: This is named inconsistently -- it should be INITIALIZER. */
|
|
|
|
#define PTHREAD_ONCE_INIT _PTHREAD_ONCE_INIT
|
|
|
|
int pthread_once (pthread_once_t *__once_control,
|
|
void (*__init_routine)(void));
|
|
|
|
/* Thread-Specific Data Key Create, P1003.1c/Draft 10, p. 163 */
|
|
|
|
int pthread_key_create (pthread_key_t *__key,
|
|
void (*__destructor)(void *));
|
|
|
|
/* Thread-Specific Data Management, P1003.1c/Draft 10, p. 165 */
|
|
|
|
int pthread_setspecific (pthread_key_t __key, const void *__value);
|
|
void * pthread_getspecific (pthread_key_t __key);
|
|
|
|
/* Thread-Specific Data Key Deletion, P1003.1c/Draft 10, p. 167 */
|
|
|
|
int pthread_key_delete (pthread_key_t __key);
|
|
|
|
/* Execution of a Thread, P1003.1c/Draft 10, p. 181 */
|
|
|
|
#define PTHREAD_CANCEL_ENABLE 0
|
|
#define PTHREAD_CANCEL_DISABLE 1
|
|
|
|
#define PTHREAD_CANCEL_DEFERRED 0
|
|
#define PTHREAD_CANCEL_ASYNCHRONOUS 1
|
|
|
|
#define PTHREAD_CANCELED ((void *) -1)
|
|
|
|
int pthread_cancel (pthread_t __pthread);
|
|
|
|
/* Setting Cancelability State, P1003.1c/Draft 10, p. 183 */
|
|
|
|
int pthread_setcancelstate (int __state, int *__oldstate);
|
|
int pthread_setcanceltype (int __type, int *__oldtype);
|
|
void pthread_testcancel (void);
|
|
|
|
/* Establishing Cancellation Handlers, P1003.1c/Draft 10, p. 184 */
|
|
|
|
void _pthread_cleanup_push (struct _pthread_cleanup_context *_context,
|
|
void (*_routine)(void *), void *_arg);
|
|
|
|
void _pthread_cleanup_pop (struct _pthread_cleanup_context *_context,
|
|
int _execute);
|
|
|
|
/* It is intentional to open and close the scope in two different macros */
|
|
#define pthread_cleanup_push(_routine, _arg) \
|
|
do { \
|
|
struct _pthread_cleanup_context _pthread_clup_ctx; \
|
|
_pthread_cleanup_push(&_pthread_clup_ctx, (_routine), (_arg))
|
|
|
|
#define pthread_cleanup_pop(_execute) \
|
|
_pthread_cleanup_pop(&_pthread_clup_ctx, (_execute)); \
|
|
} while (0)
|
|
|
|
#if __GNU_VISIBLE
|
|
void _pthread_cleanup_push_defer (struct _pthread_cleanup_context *_context,
|
|
void (*_routine)(void *), void *_arg);
|
|
|
|
void _pthread_cleanup_pop_restore (struct _pthread_cleanup_context *_context,
|
|
int _execute);
|
|
|
|
/* It is intentional to open and close the scope in two different macros */
|
|
#define pthread_cleanup_push_defer_np(_routine, _arg) \
|
|
do { \
|
|
struct _pthread_cleanup_context _pthread_clup_ctx; \
|
|
_pthread_cleanup_push_defer(&_pthread_clup_ctx, (_routine), (_arg))
|
|
|
|
#define pthread_cleanup_pop_restore_np(_execute) \
|
|
_pthread_cleanup_pop_restore(&_pthread_clup_ctx, (_execute)); \
|
|
} while (0)
|
|
#endif /* __GNU_VISIBLE */
|
|
|
|
#if defined(_POSIX_THREAD_CPUTIME)
|
|
|
|
/* Accessing a Thread CPU-time Clock, P1003.4b/D8, p. 58 */
|
|
|
|
int pthread_getcpuclockid (pthread_t __pthread_id, clockid_t *__clock_id);
|
|
|
|
#endif /* defined(_POSIX_THREAD_CPUTIME) */
|
|
|
|
|
|
#endif /* defined(_POSIX_THREADS) */
|
|
|
|
#if defined(_POSIX_BARRIERS)
|
|
|
|
int pthread_barrierattr_init (pthread_barrierattr_t *__attr);
|
|
int pthread_barrierattr_destroy (pthread_barrierattr_t *__attr);
|
|
int pthread_barrierattr_getpshared (const pthread_barrierattr_t *__attr,
|
|
int *__pshared);
|
|
int pthread_barrierattr_setpshared (pthread_barrierattr_t *__attr,
|
|
int __pshared);
|
|
|
|
#define PTHREAD_BARRIER_SERIAL_THREAD -1
|
|
|
|
int pthread_barrier_init (pthread_barrier_t *__barrier,
|
|
const pthread_barrierattr_t *__attr,
|
|
unsigned __count);
|
|
int pthread_barrier_destroy (pthread_barrier_t *__barrier);
|
|
int pthread_barrier_wait (pthread_barrier_t *__barrier);
|
|
|
|
#endif /* defined(_POSIX_BARRIERS) */
|
|
|
|
#if defined(_POSIX_SPIN_LOCKS)
|
|
|
|
int pthread_spin_init (pthread_spinlock_t *__spinlock, int __pshared);
|
|
int pthread_spin_destroy (pthread_spinlock_t *__spinlock);
|
|
int pthread_spin_lock (pthread_spinlock_t *__spinlock);
|
|
int pthread_spin_trylock (pthread_spinlock_t *__spinlock);
|
|
int pthread_spin_unlock (pthread_spinlock_t *__spinlock);
|
|
|
|
#endif /* defined(_POSIX_SPIN_LOCKS) */
|
|
|
|
#if defined(_POSIX_READER_WRITER_LOCKS)
|
|
|
|
/* This is used to statically initialize a pthread_rwlock_t. Example:
|
|
|
|
pthread_mutex_t mutex = PTHREAD_RWLOCK_INITIALIZER;
|
|
*/
|
|
|
|
#define PTHREAD_RWLOCK_INITIALIZER _PTHREAD_RWLOCK_INITIALIZER
|
|
|
|
int pthread_rwlockattr_init (pthread_rwlockattr_t *__attr);
|
|
int pthread_rwlockattr_destroy (pthread_rwlockattr_t *__attr);
|
|
int pthread_rwlockattr_getpshared (const pthread_rwlockattr_t *__attr,
|
|
int *__pshared);
|
|
int pthread_rwlockattr_setpshared (pthread_rwlockattr_t *__attr,
|
|
int __pshared);
|
|
|
|
int pthread_rwlock_init (pthread_rwlock_t *__rwlock,
|
|
const pthread_rwlockattr_t *__attr);
|
|
int pthread_rwlock_destroy (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_rdlock (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_tryrdlock (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_timedrdlock (pthread_rwlock_t *__rwlock,
|
|
const struct timespec *__abstime);
|
|
int pthread_rwlock_unlock (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_wrlock (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_trywrlock (pthread_rwlock_t *__rwlock);
|
|
int pthread_rwlock_timedwrlock (pthread_rwlock_t *__rwlock,
|
|
const struct timespec *__abstime);
|
|
|
|
#if __GNU_VISIBLE
|
|
/* The Issue 8 standard adds pthread_rwlock_clockrdlock()
|
|
* and pthread_rwlock_clockwrlock()*/
|
|
int pthread_rwlock_clockrdlock(pthread_rwlock_t *__restrict, clockid_t,
|
|
const struct timespec *__restrict);
|
|
int pthread_rwlock_clockwrlock(pthread_rwlock_t *__restrict, clockid_t,
|
|
const struct timespec *__restrict);
|
|
#endif /* __GNU_VISIBLE */
|
|
|
|
#endif /* defined(_POSIX_READER_WRITER_LOCKS) */
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|
|
/* end of include file */
|