1 /* ldap_pvt_thread.h - ldap threads header file */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 1998-2006 The OpenLDAP Foundation.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted only as authorized by the OpenLDAP
12 * A copy of this license is available in file LICENSE in the
13 * top-level directory of the distribution or, alternatively, at
14 * <http://www.OpenLDAP.org/license.html>.
17 #ifndef _LDAP_PVT_THREAD_H
18 #define _LDAP_PVT_THREAD_H /* libldap_r/ldap_thr_debug.h #undefines this */
20 #include "ldap_cdefs.h"
21 #include "ldap_int_thread.h"
25 #ifndef LDAP_PVT_THREAD_H_DONE
26 typedef ldap_int_thread_t ldap_pvt_thread_t;
27 #ifdef LDAP_THREAD_DEBUG_WRAP
28 typedef ldap_debug_thread_mutex_t ldap_pvt_thread_mutex_t;
29 typedef ldap_debug_thread_cond_t ldap_pvt_thread_cond_t;
30 typedef ldap_debug_thread_rdwr_t ldap_pvt_thread_rdwr_t;
32 typedef ldap_int_thread_mutex_t ldap_pvt_thread_mutex_t;
33 typedef ldap_int_thread_cond_t ldap_pvt_thread_cond_t;
34 typedef ldap_int_thread_rdwr_t ldap_pvt_thread_rdwr_t;
36 typedef ldap_int_thread_rmutex_t ldap_pvt_thread_rmutex_t;
37 #endif /* !LDAP_PVT_THREAD_H_DONE */
39 #if 0 && defined(LDAP_DEVEL)
40 /* must also be defined in slapd.h */
41 #define LDAP_PVT_THREAD_POOL_SEM_LOAD_CONTROL
44 #define ldap_pvt_thread_equal ldap_int_thread_equal
47 ldap_pvt_thread_initialize LDAP_P(( void ));
50 ldap_pvt_thread_destroy LDAP_P(( void ));
52 LDAP_F( unsigned int )
53 ldap_pvt_thread_sleep LDAP_P(( unsigned int s ));
56 ldap_pvt_thread_get_concurrency LDAP_P(( void ));
59 ldap_pvt_thread_set_concurrency LDAP_P(( int ));
61 #define LDAP_PVT_THREAD_CREATE_JOINABLE 0
62 #define LDAP_PVT_THREAD_CREATE_DETACHED 1
64 #ifndef LDAP_PVT_THREAD_H_DONE
65 #define LDAP_PVT_THREAD_SET_STACK_SIZE
66 #ifndef LDAP_PVT_THREAD_STACK_SIZE
67 /* LARGE stack. Will be twice as large on 64 bit machine. */
68 #define LDAP_PVT_THREAD_STACK_SIZE ( 1 * 1024 * 1024 * sizeof(void *) )
69 /* May be explicitly defined to zero to disable it */
70 #elif LDAP_PVT_THREAD_STACK_SIZE == 0
71 #undef LDAP_PVT_THREAD_SET_STACK_SIZE
73 #endif /* !LDAP_PVT_THREAD_H_DONE */
76 ldap_pvt_thread_create LDAP_P((
77 ldap_pvt_thread_t * thread,
79 void *(*start_routine)( void * ),
83 ldap_pvt_thread_exit LDAP_P(( void *retval ));
86 ldap_pvt_thread_join LDAP_P(( ldap_pvt_thread_t thread, void **status ));
89 ldap_pvt_thread_kill LDAP_P(( ldap_pvt_thread_t thread, int signo ));
92 ldap_pvt_thread_yield LDAP_P(( void ));
95 ldap_pvt_thread_cond_init LDAP_P(( ldap_pvt_thread_cond_t *cond ));
98 ldap_pvt_thread_cond_destroy LDAP_P(( ldap_pvt_thread_cond_t *cond ));
101 ldap_pvt_thread_cond_signal LDAP_P(( ldap_pvt_thread_cond_t *cond ));
104 ldap_pvt_thread_cond_broadcast LDAP_P(( ldap_pvt_thread_cond_t *cond ));
107 ldap_pvt_thread_cond_wait LDAP_P((
108 ldap_pvt_thread_cond_t *cond,
109 ldap_pvt_thread_mutex_t *mutex ));
112 ldap_pvt_thread_mutex_init LDAP_P(( ldap_pvt_thread_mutex_t *mutex ));
115 ldap_pvt_thread_mutex_destroy LDAP_P(( ldap_pvt_thread_mutex_t *mutex ));
118 ldap_pvt_thread_mutex_lock LDAP_P(( ldap_pvt_thread_mutex_t *mutex ));
121 ldap_pvt_thread_mutex_trylock LDAP_P(( ldap_pvt_thread_mutex_t *mutex ));
124 ldap_pvt_thread_mutex_unlock LDAP_P(( ldap_pvt_thread_mutex_t *mutex ));
127 ldap_pvt_thread_rmutex_init LDAP_P(( ldap_pvt_thread_rmutex_t *rmutex ));
130 ldap_pvt_thread_rmutex_destroy LDAP_P(( ldap_pvt_thread_rmutex_t *rmutex ));
133 ldap_pvt_thread_rmutex_lock LDAP_P(( ldap_pvt_thread_rmutex_t *rmutex,
134 ldap_pvt_thread_t owner));
137 ldap_pvt_thread_rmutex_trylock LDAP_P(( ldap_pvt_thread_rmutex_t *rmutex,
138 ldap_pvt_thread_t owner));
141 ldap_pvt_thread_rmutex_unlock LDAP_P(( ldap_pvt_thread_rmutex_t *rmutex,
142 ldap_pvt_thread_t owner));
144 LDAP_F( ldap_pvt_thread_t )
145 ldap_pvt_thread_self LDAP_P(( void ));
147 #ifdef LDAP_INT_THREAD_ASSERT_MUTEX_OWNER
148 #define LDAP_PVT_THREAD_ASSERT_MUTEX_OWNER LDAP_INT_THREAD_ASSERT_MUTEX_OWNER
150 #define LDAP_PVT_THREAD_ASSERT_MUTEX_OWNER(mutex) ((void) 0)
154 ldap_pvt_thread_rdwr_init LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
157 ldap_pvt_thread_rdwr_destroy LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
160 ldap_pvt_thread_rdwr_rlock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
163 ldap_pvt_thread_rdwr_rtrylock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
166 ldap_pvt_thread_rdwr_runlock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
169 ldap_pvt_thread_rdwr_wlock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
172 ldap_pvt_thread_rdwr_wtrylock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
175 ldap_pvt_thread_rdwr_wunlock LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
179 ldap_pvt_thread_rdwr_readers LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
182 ldap_pvt_thread_rdwr_writers LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
185 ldap_pvt_thread_rdwr_active LDAP_P((ldap_pvt_thread_rdwr_t *rdwrp));
186 #endif /* LDAP_DEBUG */
188 #define LDAP_PVT_THREAD_EINVAL EINVAL
189 #define LDAP_PVT_THREAD_EBUSY EINVAL
191 #ifndef LDAP_PVT_THREAD_H_DONE
192 typedef ldap_int_thread_pool_t ldap_pvt_thread_pool_t;
194 typedef void * (ldap_pvt_thread_start_t) LDAP_P((void *ctx, void *arg));
195 typedef void (ldap_pvt_thread_pool_keyfree_t) LDAP_P((void *key, void *data));
196 #endif /* !LDAP_PVT_THREAD_H_DONE */
199 ldap_pvt_thread_pool_init LDAP_P((
200 ldap_pvt_thread_pool_t *pool_out,
205 ldap_pvt_thread_pool_submit LDAP_P((
206 ldap_pvt_thread_pool_t *pool,
207 ldap_pvt_thread_start_t *start,
211 ldap_pvt_thread_pool_maxthreads LDAP_P((
212 ldap_pvt_thread_pool_t *pool,
216 ldap_pvt_thread_pool_backload LDAP_P((
217 ldap_pvt_thread_pool_t *pool ));
220 ldap_pvt_thread_pool_pause LDAP_P((
221 ldap_pvt_thread_pool_t *pool ));
224 ldap_pvt_thread_pool_resume LDAP_P((
225 ldap_pvt_thread_pool_t *pool ));
228 ldap_pvt_thread_pool_destroy LDAP_P((
229 ldap_pvt_thread_pool_t *pool,
233 ldap_pvt_thread_pool_getkey LDAP_P((
237 ldap_pvt_thread_pool_keyfree_t **kfree ));
240 ldap_pvt_thread_pool_setkey LDAP_P((
244 ldap_pvt_thread_pool_keyfree_t *kfree ));
247 ldap_pvt_thread_pool_purgekey LDAP_P(( void *key ));
250 ldap_pvt_thread_pool_context LDAP_P(( void ));
253 ldap_pvt_thread_pool_context_reset LDAP_P(( void *key ));
255 LDAP_F( ldap_pvt_thread_t )
256 ldap_pvt_thread_pool_tid LDAP_P(( void *ctx ));
260 #define LDAP_PVT_THREAD_H_DONE
261 #endif /* _LDAP_PVT_THREAD_H */