mirror of
https://github.com/libretro/RetroArch.git
synced 2024-12-01 04:00:32 +00:00
892 lines
26 KiB
C
892 lines
26 KiB
C
/* This is an implementation of the threads API of POSIX 1003.1-2001.
|
|
*
|
|
* --------------------------------------------------------------------------
|
|
*
|
|
* Pthreads-embedded (PTE) - POSIX Threads Library for embedded systems
|
|
* Copyright(C) 2008 Jason Schmidlapp
|
|
*
|
|
* Contact Email: jschmidlapp@users.sourceforge.net
|
|
*
|
|
*
|
|
* Pthreads-embedded (PTE) - POSIX Threads Library for embedded systems
|
|
* Copyright(C) 2008 Jason Schmidlapp
|
|
*
|
|
* Contact Email: jschmidlapp@users.sourceforge.net
|
|
*
|
|
*
|
|
* Based upon Pthreads-win32 - POSIX Threads Library for Win32
|
|
* Copyright(C) 1998 John E. Bossom
|
|
* Copyright(C) 1999,2005 Pthreads-win32 contributors
|
|
*
|
|
* Contact Email: rpj@callisto.canberra.edu.au
|
|
*
|
|
* The original list of contributors to the Pthreads-win32 project
|
|
* is contained in the file CONTRIBUTORS.ptw32 included with the
|
|
* source code distribution. The list can also be seen at the
|
|
* following World Wide Web location:
|
|
* http://sources.redhat.com/pthreads-win32/contributors.html
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library in the file COPYING.LIB;
|
|
* if not, write to the Free Software Foundation, Inc.,
|
|
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
|
|
*/
|
|
#if !defined( PTHREAD_H )
|
|
#define PTHREAD_H
|
|
|
|
#include <pte_types.h>
|
|
|
|
#include <sched.h>
|
|
|
|
#define PTE_VERSION 2,8,0,0
|
|
#define PTE_VERSION_STRING "2, 8, 0, 0\0"
|
|
|
|
/* There are two implementations of cancel cleanup.
|
|
* Note that pthread.h is included in both application
|
|
* compilation units and also internally for the library.
|
|
* The code here and within the library aims to work
|
|
* for all reasonable combinations of environments.
|
|
*
|
|
* The two implementations are:
|
|
*
|
|
* C
|
|
* C++
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* Define defaults for cleanup code.
|
|
* Note: Unless the build explicitly defines one of the following, then
|
|
* we default to standard C style cleanup. This style uses setjmp/longjmp
|
|
* in the cancelation and thread exit implementations and therefore won't
|
|
* do stack unwinding if linked to applications that have it (e.g.
|
|
* C++ apps). This is currently consistent with most/all commercial Unix
|
|
* POSIX threads implementations.
|
|
*/
|
|
|
|
#undef PTE_LEVEL
|
|
|
|
#if defined(_POSIX_SOURCE)
|
|
#define PTE_LEVEL 0
|
|
/* Early POSIX */
|
|
#endif
|
|
|
|
#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 199309
|
|
#undef PTE_LEVEL
|
|
#define PTE_LEVEL 1
|
|
/* Include 1b, 1c and 1d */
|
|
#endif
|
|
|
|
#if defined(INCLUDE_NP)
|
|
#undef PTE_LEVEL
|
|
#define PTE_LEVEL 2
|
|
/* Include Non-Portable extensions */
|
|
#endif
|
|
|
|
#define PTE_LEVEL_MAX 3
|
|
|
|
#if !defined(PTE_LEVEL)
|
|
#define PTE_LEVEL PTE_LEVEL_MAX
|
|
/* Include everything */
|
|
#endif
|
|
|
|
/*
|
|
* -------------------------------------------------------------
|
|
*
|
|
*
|
|
* Module: pthread.h
|
|
*
|
|
* Purpose:
|
|
* Provides an implementation of PThreads based upon the
|
|
* standard:
|
|
*
|
|
* POSIX 1003.1-2001
|
|
* and
|
|
* The Single Unix Specification version 3
|
|
*
|
|
* (these two are equivalent)
|
|
*
|
|
* in order to enhance code portability between Windows,
|
|
* various commercial Unix implementations, and Linux.
|
|
*
|
|
* See the ANNOUNCE file for a full list of conforming
|
|
* routines and defined constants, and a list of missing
|
|
* routines and constants not defined in this implementation.
|
|
*
|
|
* Authors:
|
|
* There have been many contributors to this library.
|
|
* The initial implementation was contributed by
|
|
* John Bossom, and several others have provided major
|
|
* sections or revisions of parts of the implementation.
|
|
* Often significant effort has been contributed to
|
|
* find and fix important bugs and other problems to
|
|
* improve the reliability of the library, which sometimes
|
|
* is not reflected in the amount of code which changed as
|
|
* result.
|
|
* As much as possible, the contributors are acknowledged
|
|
* in the ChangeLog file in the source code distribution
|
|
* where their changes are noted in detail.
|
|
*
|
|
* Contributors are listed in the CONTRIBUTORS file.
|
|
*
|
|
* As usual, all bouquets go to the contributors, and all
|
|
* brickbats go to the project maintainer.
|
|
*
|
|
* Maintainer:
|
|
* The code base for this project is coordinated and
|
|
* eventually pre-tested, packaged, and made available by
|
|
*
|
|
* Ross Johnson <rpj@callisto.canberra.edu.au>
|
|
*
|
|
* QA Testers:
|
|
* Ultimately, the library is tested in the real world by
|
|
* a host of competent and demanding scientists and
|
|
* engineers who report bugs and/or provide solutions
|
|
* which are then fixed or incorporated into subsequent
|
|
* versions of the library. Each time a bug is fixed, a
|
|
* test case is written to prove the fix and ensure
|
|
* that later changes to the code don't reintroduce the
|
|
* same error. The number of test cases is slowly growing
|
|
* and therefore so is the code reliability.
|
|
*
|
|
* Compliance:
|
|
* See the file ANNOUNCE for the list of implemented
|
|
* and not-implemented routines and defined options.
|
|
* Of course, these are all defined is this file as well.
|
|
*
|
|
* Web site:
|
|
* The source code and other information about this library
|
|
* are available from
|
|
*
|
|
* http://sources.redhat.com/pthreads-win32/
|
|
*
|
|
* -------------------------------------------------------------
|
|
*/
|
|
|
|
#include <time.h>
|
|
|
|
#include <setjmp.h>
|
|
#include <limits.h>
|
|
|
|
/*
|
|
* Boolean values to make us independent of system includes.
|
|
*/
|
|
enum
|
|
{
|
|
PTE_FALSE = 0,
|
|
PTE_TRUE = (! PTE_FALSE)
|
|
};
|
|
|
|
|
|
/*
|
|
* -------------------------------------------------------------
|
|
*
|
|
* POSIX 1003.1-2001 Options
|
|
* =========================
|
|
*
|
|
* Options are normally set in <unistd.h>, which is not provided
|
|
* with pthreads-embedded.
|
|
*
|
|
* For conformance with the Single Unix Specification (version 3), all of the
|
|
* options below are defined, and have a value of either -1 (not supported)
|
|
* or 200112L (supported).
|
|
*
|
|
* These options can neither be left undefined nor have a value of 0, because
|
|
* either indicates that sysconf(), which is not implemented, may be used at
|
|
* runtime to check the status of the option.
|
|
*
|
|
* _POSIX_THREADS (== 200112L)
|
|
* If == 200112L, you can use threads
|
|
*
|
|
* _POSIX_THREAD_ATTR_STACKSIZE (== 200112L)
|
|
* If == 200112L, you can control the size of a thread's
|
|
* stack
|
|
* pthread_attr_getstacksize
|
|
* pthread_attr_setstacksize
|
|
*
|
|
* _POSIX_THREAD_ATTR_STACKADDR (== -1)
|
|
* If == 200112L, you can allocate and control a thread's
|
|
* stack. If not supported, the following functions
|
|
* will return ENOSYS, indicating they are not
|
|
* supported:
|
|
* pthread_attr_getstackaddr
|
|
* pthread_attr_setstackaddr
|
|
*
|
|
* _POSIX_THREAD_PRIORITY_SCHEDULING (== -1)
|
|
* If == 200112L, you can use realtime scheduling.
|
|
* This option indicates that the behaviour of some
|
|
* implemented functions conforms to the additional TPS
|
|
* requirements in the standard. E.g. rwlocks favour
|
|
* writers over readers when threads have equal priority.
|
|
*
|
|
* _POSIX_THREAD_PRIO_INHERIT (== -1)
|
|
* If == 200112L, you can create priority inheritance
|
|
* mutexes.
|
|
* pthread_mutexattr_getprotocol +
|
|
* pthread_mutexattr_setprotocol +
|
|
*
|
|
* _POSIX_THREAD_PRIO_PROTECT (== -1)
|
|
* If == 200112L, you can create priority ceiling mutexes
|
|
* Indicates the availability of:
|
|
* pthread_mutex_getprioceiling
|
|
* pthread_mutex_setprioceiling
|
|
* pthread_mutexattr_getprioceiling
|
|
* pthread_mutexattr_getprotocol +
|
|
* pthread_mutexattr_setprioceiling
|
|
* pthread_mutexattr_setprotocol +
|
|
*
|
|
* _POSIX_THREAD_PROCESS_SHARED (== -1)
|
|
* If set, you can create mutexes and condition
|
|
* variables that can be shared with another
|
|
* process.If set, indicates the availability
|
|
* of:
|
|
* pthread_mutexattr_getpshared
|
|
* pthread_mutexattr_setpshared
|
|
* pthread_condattr_getpshared
|
|
* pthread_condattr_setpshared
|
|
*
|
|
* _POSIX_THREAD_SAFE_FUNCTIONS (== 200112L)
|
|
* If == 200112L you can use the special *_r library
|
|
* functions that provide thread-safe behaviour
|
|
*
|
|
* _POSIX_READER_WRITER_LOCKS (== 200112L)
|
|
* If == 200112L, you can use read/write locks
|
|
*
|
|
* _POSIX_SPIN_LOCKS (== 200112L)
|
|
* If == 200112L, you can use spin locks
|
|
*
|
|
* _POSIX_BARRIERS (== 200112L)
|
|
* If == 200112L, you can use barriers
|
|
*
|
|
* + These functions provide both 'inherit' and/or
|
|
* 'protect' protocol, based upon these macro
|
|
* settings.
|
|
*
|
|
* -------------------------------------------------------------
|
|
*/
|
|
|
|
/*
|
|
* POSIX Options
|
|
*/
|
|
#undef _POSIX_THREADS
|
|
#define _POSIX_THREADS 200112L
|
|
|
|
#undef _POSIX_READER_WRITER_LOCKS
|
|
#define _POSIX_READER_WRITER_LOCKS 200112L
|
|
|
|
#undef _POSIX_SPIN_LOCKS
|
|
#define _POSIX_SPIN_LOCKS 200112L
|
|
|
|
#undef _POSIX_BARRIERS
|
|
#define _POSIX_BARRIERS 200112L
|
|
|
|
#undef _POSIX_THREAD_SAFE_FUNCTIONS
|
|
#define _POSIX_THREAD_SAFE_FUNCTIONS 200112L
|
|
|
|
#undef _POSIX_THREAD_ATTR_STACKSIZE
|
|
#define _POSIX_THREAD_ATTR_STACKSIZE 200112L
|
|
|
|
/*
|
|
* The following options are not supported
|
|
*/
|
|
#undef _POSIX_THREAD_ATTR_STACKADDR
|
|
#define _POSIX_THREAD_ATTR_STACKADDR -1
|
|
|
|
#undef _POSIX_THREAD_PRIO_INHERIT
|
|
#define _POSIX_THREAD_PRIO_INHERIT -1
|
|
|
|
#undef _POSIX_THREAD_PRIO_PROTECT
|
|
#define _POSIX_THREAD_PRIO_PROTECT -1
|
|
|
|
/* TPS is not fully supported. */
|
|
#undef _POSIX_THREAD_PRIORITY_SCHEDULING
|
|
#define _POSIX_THREAD_PRIORITY_SCHEDULING -1
|
|
|
|
#undef _POSIX_THREAD_PROCESS_SHARED
|
|
#define _POSIX_THREAD_PROCESS_SHARED -1
|
|
|
|
|
|
/*
|
|
* POSIX 1003.1-2001 Limits
|
|
* ===========================
|
|
*
|
|
* These limits are normally set in <limits.h>, which is not provided with
|
|
* pthreads-embedded.
|
|
*
|
|
* PTHREAD_DESTRUCTOR_ITERATIONS
|
|
* Maximum number of attempts to destroy
|
|
* a thread's thread-specific data on
|
|
* termination (must be at least 4)
|
|
*
|
|
* PTHREAD_KEYS_MAX
|
|
* Maximum number of thread-specific data keys
|
|
* available per process (must be at least 128)
|
|
*
|
|
* PTHREAD_STACK_MIN
|
|
* Minimum supported stack size for a thread
|
|
*
|
|
* PTHREAD_THREADS_MAX
|
|
* Maximum number of threads supported per
|
|
* process (must be at least 64).
|
|
*
|
|
* SEM_NSEMS_MAX
|
|
* The maximum number of semaphores a process can have.
|
|
* (must be at least 256)
|
|
*
|
|
* SEM_VALUE_MAX
|
|
* The maximum value a semaphore can have.
|
|
* (must be at least 32767)
|
|
*
|
|
*/
|
|
#undef _POSIX_THREAD_DESTRUCTOR_ITERATIONS
|
|
#define _POSIX_THREAD_DESTRUCTOR_ITERATIONS 4
|
|
|
|
#undef PTHREAD_DESTRUCTOR_ITERATIONS
|
|
#define PTHREAD_DESTRUCTOR_ITERATIONS _POSIX_THREAD_DESTRUCTOR_ITERATIONS
|
|
|
|
#undef _POSIX_THREAD_KEYS_MAX
|
|
#define _POSIX_THREAD_KEYS_MAX 128
|
|
|
|
#undef PTHREAD_KEYS_MAX
|
|
#define PTHREAD_KEYS_MAX _POSIX_THREAD_KEYS_MAX
|
|
|
|
#undef PTHREAD_STACK_MIN
|
|
#define PTHREAD_STACK_MIN 0
|
|
|
|
#undef _POSIX_THREAD_THREADS_MAX
|
|
#define _POSIX_THREAD_THREADS_MAX 64
|
|
|
|
/* Arbitrary value */
|
|
#undef PTHREAD_THREADS_MAX
|
|
#define PTHREAD_THREADS_MAX 2019
|
|
|
|
#undef _POSIX_SEM_NSEMS_MAX
|
|
#define _POSIX_SEM_NSEMS_MAX 256
|
|
|
|
/* Arbitrary value */
|
|
#undef SEM_NSEMS_MAX
|
|
#define SEM_NSEMS_MAX 1024
|
|
|
|
#undef _POSIX_SEM_VALUE_MAX
|
|
#define _POSIX_SEM_VALUE_MAX 32767
|
|
|
|
#undef SEM_VALUE_MAX
|
|
#define SEM_VALUE_MAX INT_MAX
|
|
|
|
|
|
/*
|
|
* Generic handle type - intended to extend uniqueness beyond
|
|
* that available with a simple pointer. It should scale for either
|
|
* IA-32 or IA-64.
|
|
*/
|
|
typedef struct
|
|
{
|
|
void * p; /* Pointer to actual object */
|
|
unsigned int x; /* Extra information - reuse count etc */
|
|
} pte_handle_t;
|
|
|
|
typedef /* pte_handle_t */ void * pthread_t;
|
|
typedef struct pthread_attr_t_ * pthread_attr_t;
|
|
typedef struct pthread_once_t_ pthread_once_t;
|
|
typedef struct pthread_key_t_ * pthread_key_t;
|
|
typedef struct pthread_mutex_t_ * pthread_mutex_t;
|
|
typedef struct pthread_mutexattr_t_ * pthread_mutexattr_t;
|
|
typedef struct pthread_cond_t_ * pthread_cond_t;
|
|
typedef struct pthread_condattr_t_ * pthread_condattr_t;
|
|
typedef struct pthread_rwlock_t_ * pthread_rwlock_t;
|
|
typedef struct pthread_rwlockattr_t_ * pthread_rwlockattr_t;
|
|
typedef struct pthread_spinlock_t_ * pthread_spinlock_t;
|
|
typedef struct pthread_barrier_t_ * pthread_barrier_t;
|
|
typedef struct pthread_barrierattr_t_ * pthread_barrierattr_t;
|
|
|
|
/*
|
|
* ====================
|
|
* ====================
|
|
* POSIX Threads
|
|
* ====================
|
|
* ====================
|
|
*/
|
|
|
|
enum
|
|
{
|
|
/*
|
|
* pthread_attr_{get,set}detachstate
|
|
*/
|
|
PTHREAD_CREATE_JOINABLE = 0, /* Default */
|
|
PTHREAD_CREATE_DETACHED = 1,
|
|
|
|
/*
|
|
* pthread_attr_{get,set}inheritsched
|
|
*/
|
|
PTHREAD_INHERIT_SCHED = 0,
|
|
PTHREAD_EXPLICIT_SCHED = 1, /* Default */
|
|
|
|
/*
|
|
* pthread_{get,set}scope
|
|
*/
|
|
PTHREAD_SCOPE_PROCESS = 0,
|
|
PTHREAD_SCOPE_SYSTEM = 1, /* Default */
|
|
PTHREAD_SCOPE_PROCESS_VFPU = 2, /* PSP specific */
|
|
|
|
/*
|
|
* pthread_setcancelstate paramters
|
|
*/
|
|
PTHREAD_CANCEL_ENABLE = 0, /* Default */
|
|
PTHREAD_CANCEL_DISABLE = 1,
|
|
|
|
/*
|
|
* pthread_setcanceltype parameters
|
|
*/
|
|
PTHREAD_CANCEL_ASYNCHRONOUS = 0,
|
|
PTHREAD_CANCEL_DEFERRED = 1, /* Default */
|
|
|
|
/*
|
|
* pthread_mutexattr_{get,set}pshared
|
|
* pthread_condattr_{get,set}pshared
|
|
*/
|
|
PTHREAD_PROCESS_PRIVATE = 0,
|
|
PTHREAD_PROCESS_SHARED = 1,
|
|
|
|
/*
|
|
* pthread_barrier_wait
|
|
*/
|
|
PTHREAD_BARRIER_SERIAL_THREAD = -1
|
|
};
|
|
|
|
/*
|
|
* ====================
|
|
* ====================
|
|
* Cancelation
|
|
* ====================
|
|
* ====================
|
|
*/
|
|
#define PTHREAD_CANCELED ((void *) -1)
|
|
|
|
|
|
/*
|
|
* ====================
|
|
* ====================
|
|
* Once Key
|
|
* ====================
|
|
* ====================
|
|
*/
|
|
#define PTHREAD_ONCE_INIT { PTE_FALSE, 0, 0, 0}
|
|
|
|
struct pthread_once_t_
|
|
{
|
|
int state;
|
|
void * semaphore;
|
|
int numSemaphoreUsers;
|
|
int done; /* indicates if user function has been executed */
|
|
// void * lock;
|
|
// int reserved1;
|
|
// int reserved2;
|
|
};
|
|
|
|
|
|
/*
|
|
* ====================
|
|
* ====================
|
|
* Object initialisers
|
|
* ====================
|
|
* ====================
|
|
*/
|
|
#define PTHREAD_MUTEX_INITIALIZER ((pthread_mutex_t) -1)
|
|
#define PTHREAD_RECURSIVE_MUTEX_INITIALIZER ((pthread_mutex_t) -2)
|
|
#define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER ((pthread_mutex_t) -3)
|
|
|
|
/*
|
|
* Compatibility with LinuxThreads
|
|
*/
|
|
#define PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP PTHREAD_RECURSIVE_MUTEX_INITIALIZER
|
|
#define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP PTHREAD_ERRORCHECK_MUTEX_INITIALIZER
|
|
|
|
#define PTHREAD_COND_INITIALIZER ((pthread_cond_t) -1)
|
|
|
|
#define PTHREAD_RWLOCK_INITIALIZER ((pthread_rwlock_t) -1)
|
|
|
|
#define PTHREAD_SPINLOCK_INITIALIZER ((pthread_spinlock_t) -1)
|
|
|
|
/*
|
|
* Mutex types.
|
|
*/
|
|
enum
|
|
{
|
|
/* Compatibility with LinuxThreads */
|
|
PTHREAD_MUTEX_FAST_NP,
|
|
PTHREAD_MUTEX_RECURSIVE_NP,
|
|
PTHREAD_MUTEX_ERRORCHECK_NP,
|
|
PTHREAD_MUTEX_TIMED_NP = PTHREAD_MUTEX_FAST_NP,
|
|
PTHREAD_MUTEX_ADAPTIVE_NP = PTHREAD_MUTEX_FAST_NP,
|
|
/* For compatibility with POSIX */
|
|
PTHREAD_MUTEX_NORMAL = PTHREAD_MUTEX_FAST_NP,
|
|
PTHREAD_MUTEX_RECURSIVE = PTHREAD_MUTEX_RECURSIVE_NP,
|
|
PTHREAD_MUTEX_ERRORCHECK = PTHREAD_MUTEX_ERRORCHECK_NP,
|
|
PTHREAD_MUTEX_DEFAULT = PTHREAD_MUTEX_NORMAL
|
|
};
|
|
|
|
|
|
typedef struct pte_cleanup_t pte_cleanup_t;
|
|
|
|
typedef void (* pte_cleanup_callback_t)(void *);
|
|
|
|
struct pte_cleanup_t
|
|
{
|
|
pte_cleanup_callback_t routine;
|
|
void *arg;
|
|
struct pte_cleanup_t *prev;
|
|
};
|
|
|
|
/*
|
|
* C implementation of PThreads cancel cleanup
|
|
*/
|
|
|
|
#define pthread_cleanup_push( _rout, _arg ) \
|
|
{ \
|
|
pte_cleanup_t _cleanup; \
|
|
\
|
|
pte_push_cleanup( &_cleanup, (pte_cleanup_callback_t) (_rout), (_arg) ); \
|
|
|
|
#define pthread_cleanup_pop( _execute ) \
|
|
(void) pte_pop_cleanup( _execute ); \
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/*
|
|
* ===============
|
|
* ===============
|
|
* Methods
|
|
* ===============
|
|
* ===============
|
|
*/
|
|
|
|
int pthread_init (void);
|
|
void pthread_terminate (void);
|
|
|
|
/*
|
|
* PThread Attribute Functions
|
|
*/
|
|
int pthread_attr_init (pthread_attr_t * attr);
|
|
|
|
int pthread_attr_destroy (pthread_attr_t * attr);
|
|
|
|
int pthread_attr_getdetachstate (const pthread_attr_t * attr,
|
|
int *detachstate);
|
|
|
|
int pthread_attr_getstackaddr (const pthread_attr_t * attr,
|
|
void **stackaddr);
|
|
|
|
int pthread_attr_getstacksize (const pthread_attr_t * attr,
|
|
size_t * stacksize);
|
|
|
|
int pthread_attr_setdetachstate (pthread_attr_t * attr,
|
|
int detachstate);
|
|
|
|
int pthread_attr_setstackaddr (pthread_attr_t * attr,
|
|
void *stackaddr);
|
|
|
|
int pthread_attr_setstacksize (pthread_attr_t * attr,
|
|
size_t stacksize);
|
|
|
|
int pthread_attr_getschedparam (const pthread_attr_t *attr,
|
|
struct sched_param *param);
|
|
|
|
int pthread_attr_setschedparam (pthread_attr_t *attr,
|
|
const struct sched_param *param);
|
|
|
|
int pthread_attr_setschedpolicy (pthread_attr_t *,
|
|
int);
|
|
|
|
int pthread_attr_getschedpolicy (pthread_attr_t *,
|
|
int *);
|
|
|
|
int pthread_attr_setinheritsched(pthread_attr_t * attr,
|
|
int inheritsched);
|
|
|
|
int pthread_attr_getinheritsched(pthread_attr_t * attr,
|
|
int * inheritsched);
|
|
|
|
int pthread_attr_setscope (pthread_attr_t *,
|
|
int);
|
|
|
|
int pthread_attr_getscope (const pthread_attr_t *,
|
|
int *);
|
|
|
|
/*
|
|
* PThread Functions
|
|
*/
|
|
int pthread_create (pthread_t * tid,
|
|
const pthread_attr_t * attr,
|
|
void *(*start) (void *),
|
|
void *arg);
|
|
|
|
int pthread_detach (pthread_t tid);
|
|
|
|
int pthread_equal (pthread_t t1,
|
|
pthread_t t2);
|
|
|
|
void pthread_exit (void *value_ptr);
|
|
|
|
int pthread_join (pthread_t thread,
|
|
void **value_ptr);
|
|
|
|
pthread_t pthread_self (void);
|
|
|
|
int pthread_cancel (pthread_t thread);
|
|
|
|
int pthread_setcancelstate (int state,
|
|
int *oldstate);
|
|
|
|
int pthread_setcanceltype (int type,
|
|
int *oldtype);
|
|
|
|
void pthread_testcancel (void);
|
|
|
|
int pthread_once (pthread_once_t * once_control,
|
|
void (*init_routine) (void));
|
|
|
|
#if PTE_LEVEL >= PTE_LEVEL_MAX
|
|
pte_cleanup_t * pte_pop_cleanup (int execute);
|
|
|
|
void pte_push_cleanup (pte_cleanup_t * cleanup,
|
|
void (*routine) (void *),
|
|
void *arg);
|
|
#endif /* PTE_LEVEL >= PTE_LEVEL_MAX */
|
|
|
|
/*
|
|
* Thread Specific Data Functions
|
|
*/
|
|
int pthread_key_create (pthread_key_t * key,
|
|
void (*destructor) (void *));
|
|
|
|
int pthread_key_delete (pthread_key_t key);
|
|
|
|
int pthread_setspecific (pthread_key_t key,
|
|
const void *value);
|
|
|
|
void * pthread_getspecific (pthread_key_t key);
|
|
|
|
|
|
/*
|
|
* Mutex Attribute Functions
|
|
*/
|
|
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);
|
|
|
|
int pthread_mutexattr_settype (pthread_mutexattr_t * attr, int kind);
|
|
int pthread_mutexattr_gettype (pthread_mutexattr_t * attr, int *kind);
|
|
|
|
/*
|
|
* Barrier Attribute Functions
|
|
*/
|
|
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);
|
|
|
|
/*
|
|
* Mutex Functions
|
|
*/
|
|
int pthread_mutex_init (pthread_mutex_t * mutex,
|
|
const pthread_mutexattr_t * attr);
|
|
|
|
int pthread_mutex_destroy (pthread_mutex_t * mutex);
|
|
|
|
int pthread_mutex_lock (pthread_mutex_t * mutex);
|
|
|
|
int pthread_mutex_timedlock(pthread_mutex_t *mutex,
|
|
const struct timespec *abstime);
|
|
|
|
int pthread_mutex_trylock (pthread_mutex_t * mutex);
|
|
|
|
int pthread_mutex_unlock (pthread_mutex_t * mutex);
|
|
|
|
/*
|
|
* Spinlock Functions
|
|
*/
|
|
int pthread_spin_init (pthread_spinlock_t * lock, int pshared);
|
|
|
|
int pthread_spin_destroy (pthread_spinlock_t * lock);
|
|
|
|
int pthread_spin_lock (pthread_spinlock_t * lock);
|
|
|
|
int pthread_spin_trylock (pthread_spinlock_t * lock);
|
|
|
|
int pthread_spin_unlock (pthread_spinlock_t * lock);
|
|
|
|
/*
|
|
* Barrier Functions
|
|
*/
|
|
int pthread_barrier_init (pthread_barrier_t * barrier,
|
|
const pthread_barrierattr_t * attr,
|
|
unsigned int count);
|
|
|
|
int pthread_barrier_destroy (pthread_barrier_t * barrier);
|
|
|
|
int pthread_barrier_wait (pthread_barrier_t * barrier);
|
|
|
|
/*
|
|
* Condition Variable Attribute Functions
|
|
*/
|
|
int pthread_condattr_init (pthread_condattr_t * attr);
|
|
|
|
int pthread_condattr_destroy (pthread_condattr_t * attr);
|
|
|
|
int pthread_condattr_getpshared (const pthread_condattr_t * attr,
|
|
int *pshared);
|
|
|
|
int pthread_condattr_setpshared (pthread_condattr_t * attr,
|
|
int pshared);
|
|
|
|
/*
|
|
* Condition Variable Functions
|
|
*/
|
|
int pthread_cond_init (pthread_cond_t * cond,
|
|
const pthread_condattr_t * attr);
|
|
|
|
int pthread_cond_destroy (pthread_cond_t * cond);
|
|
|
|
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);
|
|
|
|
int pthread_cond_signal (pthread_cond_t * cond);
|
|
|
|
int pthread_cond_broadcast (pthread_cond_t * cond);
|
|
|
|
/*
|
|
* Scheduling
|
|
*/
|
|
int pthread_setschedparam (pthread_t thread,
|
|
int policy,
|
|
const struct sched_param *param);
|
|
|
|
int pthread_getschedparam (pthread_t thread,
|
|
int *policy,
|
|
struct sched_param *param);
|
|
|
|
int pthread_setconcurrency (int);
|
|
|
|
int pthread_getconcurrency (void);
|
|
|
|
/*
|
|
* Read-Write Lock Functions
|
|
*/
|
|
int pthread_rwlock_init(pthread_rwlock_t *lock,
|
|
const pthread_rwlockattr_t *attr);
|
|
|
|
int pthread_rwlock_destroy(pthread_rwlock_t *lock);
|
|
|
|
int pthread_rwlock_tryrdlock(pthread_rwlock_t *);
|
|
|
|
int pthread_rwlock_trywrlock(pthread_rwlock_t *);
|
|
|
|
int pthread_rwlock_rdlock(pthread_rwlock_t *lock);
|
|
|
|
int pthread_rwlock_timedrdlock(pthread_rwlock_t *lock,
|
|
const struct timespec *abstime);
|
|
|
|
int pthread_rwlock_wrlock(pthread_rwlock_t *lock);
|
|
|
|
int pthread_rwlock_timedwrlock(pthread_rwlock_t *lock,
|
|
const struct timespec *abstime);
|
|
|
|
int pthread_rwlock_unlock(pthread_rwlock_t *lock);
|
|
|
|
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);
|
|
|
|
#if PTE_LEVEL >= PTE_LEVEL_MAX - 1
|
|
|
|
/*
|
|
* Signal Functions. Should be defined in <signal.h> but we might
|
|
* already have signal.h that don't define these.
|
|
*/
|
|
int pthread_kill(pthread_t thread, int sig);
|
|
|
|
/*
|
|
* Non-portable functions
|
|
*/
|
|
|
|
/*
|
|
* Compatibility with Linux.
|
|
*/
|
|
int pthread_mutexattr_setkind_np(pthread_mutexattr_t * attr,
|
|
int kind);
|
|
int pthread_mutexattr_getkind_np(pthread_mutexattr_t * attr,
|
|
int *kind);
|
|
|
|
/*
|
|
* Possibly supported by other POSIX threads implementations
|
|
*/
|
|
int pthread_delay_np (struct timespec * interval);
|
|
int pthread_num_processors_np(void);
|
|
|
|
/*
|
|
* Register a system time change with the library.
|
|
* Causes the library to perform various functions
|
|
* in response to the change. Should be called whenever
|
|
* the application's top level window receives a
|
|
* WM_TIMECHANGE message. It can be passed directly to
|
|
* pthread_create() as a new thread if desired.
|
|
*/
|
|
void * pthread_timechange_handler_np(void *);
|
|
|
|
#endif /*PTE_LEVEL >= PTE_LEVEL_MAX - 1 */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* cplusplus */
|
|
|
|
#if PTE_LEVEL >= PTE_LEVEL_MAX
|
|
|
|
#endif /* PTE_LEVEL >= PTE_LEVEL_MAX */
|
|
|
|
/*
|
|
* Some compiler environments don't define some things.
|
|
*/
|
|
# define _ftime ftime
|
|
# define _timeb timeb
|
|
|
|
#undef PTE_LEVEL
|
|
#undef PTE_LEVEL_MAX
|
|
|
|
#endif /* PTHREAD_H */
|