pthread.h

SIP 1.5.0源代码

/* This is the POSIX thread API (POSIX 1003).
 * 
 * Pthreads-win32 - POSIX Threads Library for Win32
 * Copyright (C) 1998
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; 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

#define PtW32NoCatchWarn

/*
 * -------------------------------------------------------------
 *
 *
 * Module: pthread.h
 *
 * Purpose:
 *      Provides an implementation of PThreads based upon the
 *      standard:
 *
 *              POSIX 1003.1c-1995      (POSIX.1c)
 *
 * Authors:
 *      Contributors are listed in the file "MAINTAINERS".
 *
 * The following functions are implemented:
 *      ---------------------------
 *      PThreads
 *      ---------------------------
 *      pthread_attr_init
 *      pthread_attr_destroy
 *      pthread_attr_getdetachstate
 *      pthread_attr_getstackaddr
 *      pthread_attr_getstacksize
 *      pthread_attr_setdetachstate     
 *      pthread_attr_setstackaddr
 *      pthread_attr_setstacksize
 *
 *      pthread_create
 *      pthread_detach
 *      pthread_equal
 *      pthread_exit
 *      pthread_join
 *      pthread_self
 *      sched_yield
 *
 *      pthread_cancel
 *      pthread_cleanup_pop
 *      pthread_cleanup_push
 *      pthread_setcancelstate
 *      pthread_setcanceltype
 *      pthread_testcancel
 *
 *      ---------------------------
 *      Thread Specific Data
 *      ---------------------------
 *      pthread_key_create
 *      pthread_key_delete
 *      pthread_setspecific
 *      pthread_getspecific
 *
 *      ---------------------------
 *      Mutexes
 *      ---------------------------
 *      pthread_mutexattr_init
 *      pthread_mutexattr_destroy
 *      pthread_mutexattr_getpshared
 *      pthread_mutexattr_setpshared
 *
 *      pthread_mutex_init
 *      pthread_mutex_destroy
 *      pthread_mutex_lock
 *      pthread_mutex_trylock
 *      pthread_mutex_unlock
 *
 *      ---------------------------
 *      Condition Variables
 *      ---------------------------
 *      pthread_condattr_init
 *      pthread_condattr_destroy
 *      pthread_condattr_getpshared
 *      pthread_condattr_setpshared
 *
 *      pthread_cond_init
 *      pthread_cond_destroy
 *      pthread_cond_wait
 *      pthread_cond_timedwait
 *      pthread_cond_signal
 *      pthread_cond_broadcast
 *
 *      ---------------------------
 *      Protected Methods
 *      ---------------------------
 *      pthreadCancelableWait
 *
 *      ---------------------------
 *      RealTime Scheduling:
 *      ---------------------------
 *      pthread_attr_getschedparam
 *      pthread_attr_setschedparam
 *      pthread_getschedparam
 *      pthread_setschedparam
 *      sched_get_priority_max
 *      sched_get_priority_min
 *
 *      ---------------------------
 *      Signals:
 *      ---------------------------
 *      pthread_sigmask
 *
 *      ---------------------------
 *      Read/Write Locks:
 *      ---------------------------
 *      pthread_rwlock_init
 *      pthread_rwlock_destroy
 *      pthread_rwlock_tryrdlock
 *      pthread_rwlock_trywrlock
 *      pthread_rwlock_rdlock
 *      pthread_rwlock_rwlock
 *      pthread_rwlock_unlock
 *
 * Limitations
 * ===========
 *      The following functions are not implemented:
 *
 *      ---------------------------
 *      RealTime Scheduling:
 *      ---------------------------
 *      pthread_attr_getinheritsched
 *      pthread_attr_getschedpolicy
 *      pthread_attr_getscope
 *      pthread_attr_setinheritsched
 *      pthread_attr_setschedpolicy
 *      pthread_attr_setscope
 *      pthread_mutex_getprioceiling
 *      pthread_mutex_setprioceiling
 *      pthread_mutex_attr_getprioceiling
 *      pthread_mutex_attr_getprotocol
 *      pthread_mutex_attr_setprioceiling
 *      pthread_mutex_attr_setprotocol
 *
 *      ---------------------------
 *      Fork Handlers:
 *      ---------------------------
 *      pthread_atfork
 *
 *      ---------------------------
 *      Stdio:
 *      ---------------------------
 *      flockfile
 *      ftrylockfile
 *      funlockfile
 *      getc_unlocked
 *      getchar_unlocked
 *      putc_unlocked
 *      putchar_unlocked
 *
 *      ---------------------------
 *      Thread-Safe C Runtime Library:
 *      ---------------------------
 *      readdir_r
 *      getgrgid_r
 *      getgrnam_r
 *      getpwuid_r
 *      getpwnam_r
 *
 *      ---------------------------
 *      Signals:
 *      ---------------------------
 *      pthread_kill
 *      sigtimedwait
 *      sigwait
 *      sigwaitinfo
 *
 *
 * -------------------------------------------------------------
 */

#ifdef _MSC_VER
/*
 * Disable following warnings when including Windows headers
 *
 * warning C4115: named type definition in parentheses
 * warning C4116: unnamed type definition in parentheses
 * warning C4127: conditional expression is constant
 * warning C4201: nonstandard extension used : nameless struct/union
 * warning C4214: nonstandard extension used : bit field types other than int
 * warning C4514: unreferenced inline function has been removed
 */
#pragma warning( disable : 4115 4116 4127 4201 4214 4514)
#endif

/*
 * -----------------
 * autoconf switches
 * -----------------
 */

#if HAVE_CONFIG_H
#include "config.h"
#endif /* HAVE_CONFIG_H */

#include <windows.h>

#ifndef NEED_FTIME
#include <time.h>
#else /* NEED_FTIME */
/* use native WIN32 time API */
#endif /* NEED_FTIME */

#if HAVE_SIGNAL_H
#include <signal.h>
#endif /* HAVE_SIGNAL_H */

#include <malloc.h>

#ifndef HAVE_STRUCT_TIMESPEC
struct timespec {
	int tv_sec;
	int tv_nsec;
};
#endif /* HAVE_STRUCT_TIMESPEC */

#ifndef SIG_BLOCK
#define SIG_BLOCK 0
#endif /* SIG_BLOCK */

#ifndef SIG_UNBLOCK 
#define SIG_UNBLOCK 1
#endif /* SIG_UNBLOCK */

#ifndef SIG_SETMASK
#define SIG_SETMASK 2
#endif /* SIG_SETMASK */

#include <process.h>

/*
 * note: ETIMEDOUT is correctly defined in winsock.h
 */
/* #include <winsock.h> */

#ifdef NEED_ERRNO
#include "need_errno.h"
#else
#include <errno.h>
#endif

/*
 * In case ETIMEDOUT hasn't been defined above somehow.
 */
#ifndef ETIMEDOUT
#define ETIMEDOUT 10060     /* This is the value in winsock.h. */
#endif

#ifdef __MINGW32__
#define PT_STDCALL
#else
#ifdef __cplusplus
#define PT_STDCALL __stdcall
#else
#define PT_STDCALL __stdcall
#endif
#endif

#ifdef _MSC_VER
/*
 * Re-enable all but 4127, 4514
 */
#pragma warning( default : 4115 4116 4201 4214)
#endif

#if !defined( TRUE )
#define TRUE	!FALSE
#define FALSE	0
#endif /* !TRUE */

#ifdef __cplusplus
extern "C"
{
#endif				/* __cplusplus */

/*
 * -------------------------------------------------------------
 *
 * POSIX 1003.1c-1995 Options
 * ===========================
 *
 * _POSIX_THREADS (set)
 *                      If set, you can use threads
 *
 * _POSIX_THREAD_ATTR_STACKSIZE (set)
 *                      If set, you can control the size of a thread's
 *                      stack
 *                              pthread_attr_getstacksize
 *                              pthread_attr_setstacksize
 *
 * _POSIX_THREAD_ATTR_STACKADDR (not set)
 *                      If set, 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 (not set)
 *                      If set, you can use realtime scheduling.
 *                      Indicates the availability of:
 *                              pthread_attr_getinheritsched
 *                              pthread_attr_getschedparam
 *                              pthread_attr_getschedpolicy
 *                              pthread_attr_getscope
 *                              pthread_attr_setinheritsched
 *                              pthread_attr_setschedparam
 *                              pthread_attr_setschedpolicy
 *                              pthread_attr_setscope
 *                              pthread_getschedparam
 *                              pthread_setschedparam
 *                              pthread_get_priority_max
 *                              pthread_get_priority_min
 *
 * _POSIX_THREAD_PRIO_INHERIT (not set)
 *                      If set, you can create priority inheritance
 *                      mutexes.
 *                              pthread_mutexattr_getprotocol +
 *                              pthread_mutexattr_setprotocol +
 *
 * _POSIX_THREAD_PRIO_PROTECT (not set)
 *                      If set, 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 (not set)
 *                      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 (set)
 *                      If set you can use the special *_r library
 *                      functions that provide thread-safe behaviour
 *
 *      + These functions provide both 'inherit' and/or
 *        'protect' protocol, based upon these macro
 *        settings.
 *
 * POSIX 1003.1c-1995 Limits
 * ===========================
 *
 * 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).
 *
 * -------------------------------------------------------------
 */

/*
 * POSIX Options
 */
#ifndef _POSIX_THREADS
#define _POSIX_THREADS
#endif
#define _POSIX_THREAD_SAFE_FUNCTIONS

#define _POSIX_THREAD_ATTR_STACKSIZE

#if defined( KLUDGE )
/*
 * The following are not supported
 */
#define _POSIX_THREAD_ATTR_STACKADDR
#define _POSIX_THREAD_PRIORITY_SCHEDULING
#define _POSIX_THREAD_PRIO_INHERIT
#define _POSIX_THREAD_PRIO_PROTECT
#define _POSIX_THREAD_PROCESS_SHARED

#endif				/* KLUDGE */

/*
 * POSIX Limits
 *
 *      PTHREAD_DESTRUCTOR_ITERATIONS
 *              Standard states this must be at least
 *              4.
 *
 *      PTHREAD_KEYS_MAX
 *              WIN32 permits only 64 TLS keys per process.
 *              This limitation could be worked around by
 *              simply simulating keys.
 *
 *      PTHREADS_STACK_MIN
 *              POSIX specifies 0 which is also the value WIN32
 *              interprets as allowing the system to
 *              set the size to that of the main thread. The
 *              maximum stack size in Win32 is 1Meg. WIN32
 *              allocates more stack as required up to the 1Meg
 *              limit.
 *
 *      PTHREAD_THREADS_MAX
 *              Not documented by WIN32. Wrote a test program
 *              that kept creating threads until it failed
 *              revealed this approximate number.
 *
 */
#define PTHREAD_DESTRUCTOR_ITERATIONS	                   4
#define PTHREAD_KEYS_MAX				  64
#define PTHREAD_STACK_MIN				   0
#define PTHREAD_THREADS_MAX				2019


typedef struct pthread_t_ *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;


/*
 * ====================
 * ====================
 * POSIX Threads
 * ====================
 * ====================
 */

/*
 * pthread_attr_{get,set}detachstate
 */
#define PTHREAD_CREATE_JOINABLE		0
#define PTHREAD_CREATE_DETACHED		1

/*
 * pthread_attr{get,set}inheritsched
 */
#define PTHREAD_INHERIT_SCHED		0
#define PTHREAD_EXPLICIT_SCHED		1

/*
 * pthread_setcancelstate paramters
 */
#define PTHREAD_CANCEL_ENABLE		0
#define PTHREAD_CANCEL_DISABLE		1

/*
 * pthread_setcanceltype parameters
 */
#define PTHREAD_CANCEL_ASYNCHRONOUS	0
#define PTHREAD_CANCEL_DEFERRED		1

/*
 * pthread_mutexattr_{get,set}pshared
 * pthread_condattr_{get,set}pshared
 */
#define PTHREAD_PROCESS_PRIVATE		0
#define PTHREAD_PROCESS_SHARED		1

/*
 * pthread_mutexattr_setforcecs_np
 */
#define PTHREAD_MUTEX_AUTO_CS_NP        0
#define PTHREAD_MUTEX_FORCE_CS_NP       1

/*
 * ====================
 * ====================
 * Cancelation
 * ====================
 * ====================
 */
#define PTHREAD_CANCELED       ((void *) -1)


/*
 * ====================
 * ====================
 * Once Key
 * ====================
 * ====================
 */
#define PTHREAD_ONCE_INIT       { FALSE, -1 }

struct pthread_once_t_