2003-11-26 15:16:36 +08:00
|
|
|
/* ldap_int_thread.h - ldap internal thread wrappers header file */
|
2000-06-07 03:59:34 +08:00
|
|
|
/* $OpenLDAP$ */
|
2003-11-26 15:16:36 +08:00
|
|
|
/* This work is part of OpenLDAP Software <http://www.openldap.org/>.
|
|
|
|
*
|
2022-01-08 02:40:00 +08:00
|
|
|
* Copyright 1998-2022 The OpenLDAP Foundation.
|
2000-06-07 03:59:34 +08:00
|
|
|
* All rights reserved.
|
|
|
|
*
|
2001-05-29 11:29:53 +08:00
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted only as authorized by the OpenLDAP
|
2003-11-26 15:16:36 +08:00
|
|
|
* Public License.
|
|
|
|
*
|
|
|
|
* A copy of this license is available in file LICENSE in the
|
|
|
|
* top-level directory of the distribution or, alternatively, at
|
|
|
|
* <http://www.OpenLDAP.org/license.html>.
|
2000-06-07 03:59:34 +08:00
|
|
|
*/
|
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
|
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
2020-05-31 01:44:45 +08:00
|
|
|
/* Can be done twice. See libldap/ldap_thr_debug.h. */
|
2005-09-18 07:28:08 +08:00
|
|
|
LDAP_F(int) ldap_int_thread_initialize LDAP_P(( void ));
|
|
|
|
LDAP_F(int) ldap_int_thread_destroy LDAP_P(( void ));
|
|
|
|
|
|
|
|
LDAP_END_DECL
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
#ifndef _LDAP_INT_THREAD_H
|
|
|
|
#define _LDAP_INT_THREAD_H
|
|
|
|
|
|
|
|
#if defined( HAVE_PTHREADS )
|
|
|
|
/**********************************
|
|
|
|
* *
|
|
|
|
* definitions for POSIX Threads *
|
|
|
|
* *
|
|
|
|
**********************************/
|
|
|
|
|
|
|
|
#include <pthread.h>
|
|
|
|
#ifdef HAVE_SCHED_H
|
|
|
|
#include <sched.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
|
|
|
typedef pthread_t ldap_int_thread_t;
|
|
|
|
typedef pthread_mutex_t ldap_int_thread_mutex_t;
|
|
|
|
typedef pthread_cond_t ldap_int_thread_cond_t;
|
2007-10-25 14:42:40 +08:00
|
|
|
typedef pthread_key_t ldap_int_thread_key_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
#define ldap_int_thread_equal(a, b) pthread_equal((a), (b))
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
#if defined( _POSIX_REENTRANT_FUNCTIONS ) || \
|
|
|
|
defined( _POSIX_THREAD_SAFE_FUNCTIONS ) || \
|
|
|
|
defined( _POSIX_THREADSAFE_FUNCTIONS )
|
|
|
|
#define HAVE_REENTRANT_FUNCTIONS 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined( HAVE_PTHREAD_GETCONCURRENCY ) || \
|
|
|
|
defined( HAVE_THR_GETCONCURRENCY )
|
2000-06-13 10:42:13 +08:00
|
|
|
#define LDAP_THREAD_HAVE_GETCONCURRENCY 1
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined( HAVE_PTHREAD_SETCONCURRENCY ) || \
|
|
|
|
defined( HAVE_THR_SETCONCURRENCY )
|
2000-06-13 10:42:13 +08:00
|
|
|
#define LDAP_THREAD_HAVE_SETCONCURRENCY 1
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif
|
|
|
|
|
2007-01-11 08:55:26 +08:00
|
|
|
#if defined( HAVE_PTHREAD_RWLOCK_DESTROY )
|
2000-06-07 08:28:35 +08:00
|
|
|
#define LDAP_THREAD_HAVE_RDWR 1
|
2005-09-18 07:28:08 +08:00
|
|
|
typedef pthread_rwlock_t ldap_int_thread_rdwr_t;
|
2000-06-07 08:28:35 +08:00
|
|
|
#endif
|
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#ifndef LDAP_INT_MUTEX_NULL
|
|
|
|
#define LDAP_INT_MUTEX_NULL PTHREAD_MUTEX_INITIALIZER
|
|
|
|
#define LDAP_INT_MUTEX_FIRSTCREATE(m) ((void) 0)
|
2010-10-23 05:45:48 +08:00
|
|
|
#endif
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
LDAP_END_DECL
|
|
|
|
|
|
|
|
#elif defined( HAVE_GNU_PTH )
|
|
|
|
/***********************************
|
|
|
|
* *
|
|
|
|
* thread definitions for GNU Pth *
|
|
|
|
* *
|
|
|
|
***********************************/
|
|
|
|
|
|
|
|
#define PTH_SYSCALL_SOFT 1
|
|
|
|
#include <pth.h>
|
|
|
|
|
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
|
|
|
typedef pth_t ldap_int_thread_t;
|
|
|
|
typedef pth_mutex_t ldap_int_thread_mutex_t;
|
|
|
|
typedef pth_cond_t ldap_int_thread_cond_t;
|
2007-10-25 14:42:40 +08:00
|
|
|
typedef pth_key_t ldap_int_thread_key_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
|
2000-06-08 08:26:00 +08:00
|
|
|
#if 0
|
2000-06-07 09:34:00 +08:00
|
|
|
#define LDAP_THREAD_HAVE_RDWR 1
|
2005-09-18 07:28:08 +08:00
|
|
|
typedef pth_rwlock_t ldap_int_thread_rdwr_t;
|
2000-06-08 08:26:00 +08:00
|
|
|
#endif
|
2000-06-07 09:34:00 +08:00
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#ifndef LDAP_INT_MUTEX_NULL
|
|
|
|
#define LDAP_INT_MUTEX_NULL PTH_MUTEX_INIT
|
|
|
|
#define LDAP_INT_MUTEX_FIRSTCREATE(m) ((void) 0)
|
2010-10-23 05:45:48 +08:00
|
|
|
#endif
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
LDAP_END_DECL
|
|
|
|
|
|
|
|
#elif defined( HAVE_THR )
|
|
|
|
/********************************************
|
|
|
|
* *
|
|
|
|
* thread definitions for Solaris LWP (THR) *
|
|
|
|
* *
|
|
|
|
********************************************/
|
|
|
|
|
|
|
|
#include <thread.h>
|
|
|
|
#include <synch.h>
|
|
|
|
|
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
|
|
|
typedef thread_t ldap_int_thread_t;
|
|
|
|
typedef mutex_t ldap_int_thread_mutex_t;
|
|
|
|
typedef cond_t ldap_int_thread_cond_t;
|
2007-10-25 14:42:40 +08:00
|
|
|
typedef thread_key_t ldap_int_thread_key_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
|
|
|
|
#define HAVE_REENTRANT_FUNCTIONS 1
|
|
|
|
|
|
|
|
#ifdef HAVE_THR_GETCONCURRENCY
|
2000-06-13 10:42:13 +08:00
|
|
|
#define LDAP_THREAD_HAVE_GETCONCURRENCY 1
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif
|
|
|
|
#ifdef HAVE_THR_SETCONCURRENCY
|
2000-06-13 10:42:13 +08:00
|
|
|
#define LDAP_THREAD_HAVE_SETCONCURRENCY 1
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif
|
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#ifndef LDAP_INT_MUTEX_NULL
|
|
|
|
#define LDAP_INT_MUTEX_NULL DEFAULTMUTEX
|
|
|
|
#define LDAP_INT_MUTEX_FIRSTCREATE(m) ((void) 0)
|
2010-10-23 05:45:48 +08:00
|
|
|
#endif
|
2000-06-07 03:59:34 +08:00
|
|
|
|
|
|
|
#elif defined(HAVE_NT_THREADS)
|
2005-09-18 07:28:08 +08:00
|
|
|
/*************************************
|
|
|
|
* *
|
|
|
|
* thread definitions for NT threads *
|
|
|
|
* *
|
|
|
|
*************************************/
|
2000-06-07 03:59:34 +08:00
|
|
|
|
|
|
|
#include <process.h>
|
|
|
|
#include <windows.h>
|
|
|
|
|
2000-06-13 10:42:13 +08:00
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
typedef unsigned long ldap_int_thread_t;
|
|
|
|
typedef HANDLE ldap_int_thread_mutex_t;
|
|
|
|
typedef HANDLE ldap_int_thread_cond_t;
|
2007-10-25 14:42:40 +08:00
|
|
|
typedef DWORD ldap_int_thread_key_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
|
2020-03-17 01:07:43 +08:00
|
|
|
LDAP_F( int )
|
2020-04-17 01:46:18 +08:00
|
|
|
ldap_int_mutex_firstcreate LDAP_P(( ldap_int_thread_mutex_t *mutex ));
|
2020-03-17 01:07:43 +08:00
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#ifndef LDAP_INT_MUTEX_NULL
|
|
|
|
#define LDAP_INT_MUTEX_NULL ((HANDLE)0)
|
|
|
|
#define LDAP_INT_MUTEX_FIRSTCREATE(m) \
|
2020-04-17 01:46:18 +08:00
|
|
|
ldap_int_mutex_firstcreate(&(m))
|
2010-10-23 05:45:48 +08:00
|
|
|
#endif
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
LDAP_END_DECL
|
|
|
|
|
|
|
|
#else
|
|
|
|
/***********************************
|
|
|
|
* *
|
|
|
|
* thread definitions for no *
|
|
|
|
* underlying library support *
|
|
|
|
* *
|
|
|
|
***********************************/
|
|
|
|
|
|
|
|
#ifndef NO_THREADS
|
|
|
|
#define NO_THREADS 1
|
|
|
|
#endif
|
|
|
|
|
2000-06-13 10:42:13 +08:00
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
typedef int ldap_int_thread_t;
|
|
|
|
typedef int ldap_int_thread_mutex_t;
|
|
|
|
typedef int ldap_int_thread_cond_t;
|
2007-10-25 14:42:40 +08:00
|
|
|
typedef int ldap_int_thread_key_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
|
2000-06-13 10:42:13 +08:00
|
|
|
#define LDAP_THREAD_HAVE_TPOOL 1
|
|
|
|
typedef int ldap_int_thread_pool_t;
|
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#ifndef LDAP_INT_MUTEX_NULL
|
|
|
|
#define LDAP_INT_MUTEX_NULL 0
|
|
|
|
#define LDAP_INT_MUTEX_FIRSTCREATE(m) ((void) 0)
|
2010-10-23 05:45:48 +08:00
|
|
|
#endif
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
LDAP_END_DECL
|
|
|
|
|
|
|
|
#endif /* no threads support */
|
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
#ifndef ldap_int_thread_equal
|
|
|
|
#define ldap_int_thread_equal(a, b) ((a) == (b))
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef LDAP_THREAD_HAVE_RDWR
|
|
|
|
typedef struct ldap_int_thread_rdwr_s * ldap_int_thread_rdwr_t;
|
|
|
|
#endif
|
|
|
|
|
2000-06-19 03:48:07 +08:00
|
|
|
LDAP_F(int) ldap_int_thread_pool_startup ( void );
|
|
|
|
LDAP_F(int) ldap_int_thread_pool_shutdown ( void );
|
2000-06-07 03:59:34 +08:00
|
|
|
|
2000-06-13 10:42:13 +08:00
|
|
|
#ifndef LDAP_THREAD_HAVE_TPOOL
|
|
|
|
typedef struct ldap_int_thread_pool_s * ldap_int_thread_pool_t;
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif
|
|
|
|
LDAP_END_DECL
|
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
|
|
|
|
#if defined(LDAP_THREAD_DEBUG) && !((LDAP_THREAD_DEBUG +0) & 2U)
|
|
|
|
#define LDAP_THREAD_DEBUG_WRAP 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef LDAP_THREAD_DEBUG_WRAP
|
|
|
|
/**************************************
|
|
|
|
* *
|
|
|
|
* definitions for type-wrapped debug *
|
|
|
|
* *
|
|
|
|
**************************************/
|
|
|
|
|
|
|
|
LDAP_BEGIN_DECL
|
|
|
|
|
|
|
|
#ifndef LDAP_UINTPTR_T /* May be configured in CPPFLAGS */
|
|
|
|
#define LDAP_UINTPTR_T unsigned long
|
|
|
|
#endif
|
|
|
|
|
2006-04-06 03:52:07 +08:00
|
|
|
typedef enum {
|
|
|
|
ldap_debug_magic = -(int) (((unsigned)-1)/19)
|
|
|
|
} ldap_debug_magic_t;
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
/* Could fill in "locked" etc here later */
|
|
|
|
ldap_debug_state_inited = (int) (((unsigned)-1)/11),
|
|
|
|
ldap_debug_state_destroyed
|
|
|
|
} ldap_debug_state_t;
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
/* Enclosed in magic numbers in the hope of catching overwrites */
|
|
|
|
ldap_debug_magic_t magic; /* bit pattern to recognize usages */
|
|
|
|
LDAP_UINTPTR_T self; /* ~(LDAP_UINTPTR_T)&(this struct) */
|
|
|
|
union ldap_debug_mem_u { /* Dummy memory reference */
|
|
|
|
unsigned char *ptr;
|
|
|
|
LDAP_UINTPTR_T num;
|
|
|
|
} mem;
|
|
|
|
ldap_debug_state_t state; /* doubles as another magic number */
|
2005-09-18 07:28:08 +08:00
|
|
|
} ldap_debug_usage_info_t;
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ldap_int_thread_mutex_t wrapped;
|
|
|
|
ldap_debug_usage_info_t usage;
|
2006-04-02 03:00:37 +08:00
|
|
|
ldap_int_thread_t owner;
|
2005-09-18 07:28:08 +08:00
|
|
|
} ldap_debug_thread_mutex_t;
|
|
|
|
|
2010-12-06 18:41:41 +08:00
|
|
|
#define LDAP_DEBUG_MUTEX_NULL {LDAP_INT_MUTEX_NULL, {0,0,{0},0} /*,owner*/}
|
|
|
|
#define LDAP_DEBUG_MUTEX_FIRSTCREATE(m) \
|
|
|
|
((void) ((m).usage.state || ldap_pvt_thread_mutex_init(&(m))))
|
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
typedef struct {
|
|
|
|
ldap_int_thread_cond_t wrapped;
|
|
|
|
ldap_debug_usage_info_t usage;
|
|
|
|
} ldap_debug_thread_cond_t;
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ldap_int_thread_rdwr_t wrapped;
|
|
|
|
ldap_debug_usage_info_t usage;
|
|
|
|
} ldap_debug_thread_rdwr_t;
|
|
|
|
|
2006-04-03 20:49:30 +08:00
|
|
|
#ifndef NDEBUG
|
2006-04-02 03:00:37 +08:00
|
|
|
#define LDAP_INT_THREAD_ASSERT_MUTEX_OWNER(mutex) \
|
2006-04-03 20:49:30 +08:00
|
|
|
ldap_debug_thread_assert_mutex_owner( \
|
2006-04-04 04:30:35 +08:00
|
|
|
__FILE__, __LINE__, "owns(" #mutex ")", mutex )
|
2006-04-03 20:49:30 +08:00
|
|
|
LDAP_F(void) ldap_debug_thread_assert_mutex_owner LDAP_P((
|
|
|
|
LDAP_CONST char *file,
|
|
|
|
int line,
|
|
|
|
LDAP_CONST char *msg,
|
|
|
|
ldap_debug_thread_mutex_t *mutex ));
|
|
|
|
#endif /* NDEBUG */
|
2006-04-02 03:00:37 +08:00
|
|
|
|
2005-09-18 07:28:08 +08:00
|
|
|
LDAP_END_DECL
|
|
|
|
|
|
|
|
#endif /* LDAP_THREAD_DEBUG_WRAP */
|
|
|
|
|
2000-06-07 03:59:34 +08:00
|
|
|
#endif /* _LDAP_INT_THREAD_H */
|