📄 implement.h
字号:
* T - Thread that has called pthread_setspecific(Kn) * (head of chain is thread->keys) * A - Association. Each association is a node at the * intersection of two doubly-linked lists. * * T1 T2 T3 * | | | * | | | * K1 -----+-----A-----A-----> * | | | * | | | * K2 -----A-----A-----+-----> * | | | * | | | * K3 -----A-----+-----A-----> * | | | * | | | * V V V * * Access to the association is guarded by two locks: the key's * general lock (guarding the row) and the thread's general * lock (guarding the column). This avoids the need for a * dedicated lock for each association, which not only consumes * more handles but requires that: before the lock handle can * be released - both the key must be deleted and the thread * must have called the destructor. The two-lock arrangement * allows the resources to be freed as soon as either thread or * key is concluded. * * To avoid deadlock: whenever both locks are required, the key * and thread locks are always acquired in the order: key lock * then thread lock. An exception to this exists when a thread * calls the destructors, however this is done carefully to * avoid deadlock. * * An association is created when a thread first calls * pthread_setspecific() on a key that has a specified * destructor. * * An association is destroyed either immediately after the * thread calls the key destructor function on thread exit, or * when the key is deleted. * * Attributes: * thread * reference to the thread that owns the * association. This is actually the pointer to the * thread struct itself. Since the association is * destroyed before the thread exits, this can never * point to a different logical thread to the one that * created the assoc, i.e. after thread struct reuse. * * key * reference to the key that owns the association. * * nextKey * The pthread_t->keys attribute is the head of a * chain of associations that runs through the nextKey * link. This chain provides the 1 to many relationship * between a pthread_t and all pthread_key_t on which * it called pthread_setspecific. * * prevKey * Similarly. * * nextThread * The pthread_key_t->threads attribute is the head of * a chain of assoctiations that runs through the * nextThreads link. This chain provides the 1 to many * relationship between a pthread_key_t and all the * PThreads that have called pthread_setspecific for * this pthread_key_t. * * prevThread * Similarly. * * Notes: * 1) As soon as either the key or the thread is no longer * referencing the association, it can be destroyed. The * association will be removed from both chains. * * 2) Under WIN32, an association is only created by * pthread_setspecific if the user provided a * destroyRoutine when they created the key. * * */ ptw32_thread_t * thread; pthread_key_t key; ThreadKeyAssoc *nextKey; ThreadKeyAssoc *nextThread; ThreadKeyAssoc *prevKey; ThreadKeyAssoc *prevThread;};#ifdef __CLEANUP_SEH/* * -------------------------------------------------------------- * MAKE_SOFTWARE_EXCEPTION * This macro constructs a software exception code following * the same format as the standard Win32 error codes as defined * in WINERROR.H * Values are 32 bit values layed out as follows: * * 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 * +---+-+-+-----------------------+-------------------------------+ * |Sev|C|R| Facility | Code | * +---+-+-+-----------------------+-------------------------------+ * * Severity Values: */#define SE_SUCCESS 0x00#define SE_INFORMATION 0x01#define SE_WARNING 0x02#define SE_ERROR 0x03#define MAKE_SOFTWARE_EXCEPTION( _severity, _facility, _exception ) \( (DWORD) ( ( (_severity) << 30 ) | /* Severity code */ \ ( 1 << 29 ) | /* MS=0, User=1 */ \ ( 0 << 28 ) | /* Reserved */ \ ( (_facility) << 16 ) | /* Facility Code */ \ ( (_exception) << 0 ) /* Exception Code */ \ ) )/* * We choose one specific Facility/Error code combination to * identify our software exceptions vs. WIN32 exceptions. * We store our actual component and error code within * the optional information array. */#define EXCEPTION_PTW32_SERVICES \ MAKE_SOFTWARE_EXCEPTION( SE_ERROR, \ PTW32_SERVICES_FACILITY, \ PTW32_SERVICES_ERROR )#define PTW32_SERVICES_FACILITY 0xBAD#define PTW32_SERVICES_ERROR 0xDEED#endif /* __CLEANUP_SEH *//* * Services available through EXCEPTION_PTW32_SERVICES * and also used [as parameters to ptw32_throw()] as * generic exception selectors. */#define PTW32_EPS_EXIT (1)#define PTW32_EPS_CANCEL (2)/* Useful macros */#define PTW32_MAX(a,b) ((a)<(b)?(b):(a))#define PTW32_MIN(a,b) ((a)>(b)?(b):(a))/* Declared in global.c */extern PTW32_INTERLOCKED_LONG (WINAPI * ptw32_interlocked_compare_exchange) (PTW32_INTERLOCKED_LPLONG, PTW32_INTERLOCKED_LONG, PTW32_INTERLOCKED_LONG);/* Declared in pthread_cancel.c */extern DWORD (*ptw32_register_cancelation) (PAPCFUNC, HANDLE, DWORD);/* Thread Reuse stack bottom marker. Must not be NULL or any valid pointer to memory. */#define PTW32_THREAD_REUSE_EMPTY ((ptw32_thread_t *) 1)extern int ptw32_processInitialized;extern ptw32_thread_t * ptw32_threadReuseTop;extern ptw32_thread_t * ptw32_threadReuseBottom;extern pthread_key_t ptw32_selfThreadKey;extern pthread_key_t ptw32_cleanupKey;extern pthread_cond_t ptw32_cond_list_head;extern pthread_cond_t ptw32_cond_list_tail;extern int ptw32_mutex_default_kind;extern int ptw32_concurrency;extern int ptw32_features;extern BOOL ptw32_smp_system; /* True: SMP system, False: Uni-processor system */extern CRITICAL_SECTION ptw32_thread_reuse_lock;extern CRITICAL_SECTION ptw32_mutex_test_init_lock;extern CRITICAL_SECTION ptw32_cond_list_lock;extern CRITICAL_SECTION ptw32_cond_test_init_lock;extern CRITICAL_SECTION ptw32_rwlock_test_init_lock;extern CRITICAL_SECTION ptw32_spinlock_test_init_lock;#ifdef _UWINextern int pthread_count;#endif#ifdef __cplusplusextern "C"{#endif /* __cplusplus *//* * ===================== * ===================== * Forward Declarations * ===================== * ===================== */ int ptw32_is_attr (const pthread_attr_t * attr); int ptw32_cond_check_need_init (pthread_cond_t * cond); int ptw32_mutex_check_need_init (pthread_mutex_t * mutex); int ptw32_rwlock_check_need_init (pthread_rwlock_t * rwlock); PTW32_INTERLOCKED_LONG WINAPI ptw32_InterlockedCompareExchange (PTW32_INTERLOCKED_LPLONG location, PTW32_INTERLOCKED_LONG value, PTW32_INTERLOCKED_LONG comparand); LONG WINAPI ptw32_InterlockedExchange (LPLONG location, LONG value); DWORD ptw32_RegisterCancelation (PAPCFUNC callback, HANDLE threadH, DWORD callback_arg); int ptw32_processInitialize (void); void ptw32_processTerminate (void); void ptw32_threadDestroy (pthread_t tid); void ptw32_pop_cleanup_all (int execute); pthread_t ptw32_new (void); pthread_t ptw32_threadReusePop (void); void ptw32_threadReusePush (pthread_t thread); int ptw32_getprocessors (int *count); int ptw32_setthreadpriority (pthread_t thread, int policy, int priority); void ptw32_rwlock_cancelwrwait (void *arg);#if ! defined (__MINGW32__) || defined (__MSVCRT__) unsigned __stdcall#else void#endif ptw32_threadStart (void *vthreadParms); void ptw32_callUserDestroyRoutines (pthread_t thread); int ptw32_tkAssocCreate (ptw32_thread_t * thread, pthread_key_t key); void ptw32_tkAssocDestroy (ThreadKeyAssoc * assoc); int ptw32_semwait (sem_t * sem); DWORD ptw32_relmillisecs (const struct timespec * abstime); void ptw32_mcs_lock_acquire (ptw32_mcs_lock_t * lock, ptw32_mcs_local_node_t * node); void ptw32_mcs_lock_release (ptw32_mcs_local_node_t * node);#ifdef NEED_FTIME void ptw32_timespec_to_filetime (const struct timespec *ts, FILETIME * ft); void ptw32_filetime_to_timespec (const FILETIME * ft, struct timespec *ts);#endif/* Declared in misc.c */#ifdef NEED_CALLOC#define calloc(n, s) ptw32_calloc(n, s) void *ptw32_calloc (size_t n, size_t s);#endif/* Declared in private.c */ void ptw32_throw (DWORD exception);#ifdef __cplusplus}#endif /* __cplusplus */#ifdef _UWIN_# ifdef _MT# ifdef __cplusplusextern "C"{# endif _CRTIMP unsigned long __cdecl _beginthread (void (__cdecl *) (void *), unsigned, void *); _CRTIMP void __cdecl _endthread (void); _CRTIMP unsigned long __cdecl _beginthreadex (void *, unsigned, unsigned (__stdcall *) (void *), void *, unsigned, unsigned *); _CRTIMP void __cdecl _endthreadex (unsigned);# ifdef __cplusplus}# endif# endif#else# include <process.h>#endif/* * Defaults. Could be overridden when building the inlined version of the dll. * See ptw32_InterlockedCompareExchange.c */#ifndef PTW32_INTERLOCKED_COMPARE_EXCHANGE#define PTW32_INTERLOCKED_COMPARE_EXCHANGE ptw32_interlocked_compare_exchange#endif#ifndef PTW32_INTERLOCKED_EXCHANGE#define PTW32_INTERLOCKED_EXCHANGE InterlockedExchange#endif/* * Check for old and new versions of cygwin. See the FAQ file: * * Question 1 - How do I get pthreads-win32 to link under Cygwin or Mingw32? * * Patch by Anders Norlander <anorland@hem2.passagen.se> */#if defined(__CYGWIN32__) || defined(__CYGWIN__) || defined(NEED_CREATETHREAD)/* * Macro uses args so we can cast start_proc to LPTHREAD_START_ROUTINE * in order to avoid warnings because of return type */#define _beginthreadex(security, \ stack_size, \ start_proc, \ arg, \ flags, \ pid) \ CreateThread(security, \ stack_size, \ (LPTHREAD_START_ROUTINE) start_proc, \ arg, \ flags, \ pid)#define _endthreadex ExitThread#endif /* __CYGWIN32__ || __CYGWIN__ || NEED_CREATETHREAD */#endif /* _IMPLEMENT_H */
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -