1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright (c) 1992, 2010, Oracle and/or its affiliates. All rights reserved. 24 */ 25 26 #ifndef _SYNCH_H 27 #define _SYNCH_H 28 29 /* 30 * synch.h: 31 * definitions needed to use the thread synchronization interface 32 */ 33 34 #ifndef _ASM 35 #include <sys/machlock.h> 36 #include <sys/time_impl.h> 37 #include <sys/synch.h> 38 #endif /* _ASM */ 39 40 #ifdef __cplusplus 41 extern "C" { 42 #endif 43 44 #ifndef _ASM 45 46 /* 47 * Semaphores 48 */ 49 typedef struct _sema { 50 /* this structure must be the same as sem_t in <semaphore.h> */ 51 uint32_t count; /* semaphore count */ 52 uint16_t type; 53 uint16_t magic; 54 upad64_t pad1[3]; /* reserved for a mutex_t */ 55 upad64_t pad2[2]; /* reserved for a cond_t */ 56 } sema_t; 57 58 /* 59 * POSIX.1c Note: 60 * POSIX.1c requires that <pthread.h> define the structures pthread_mutex_t 61 * and pthread_cond_t. These structures are identical to mutex_t (lwp_mutex_t) 62 * and cond_t (lwp_cond_t) which are defined in <synch.h>. A nested included 63 * of <synch.h> (to allow a "#typedef mutex_t pthread_mutex_t") would pull in 64 * non-posix symbols/constants violating the namespace restrictions. Hence, 65 * pthread_mutex_t/pthread_cond_t have been redefined in <pthread.h> (actually 66 * in <sys/types.h>). Any modifications done to mutex_t/lwp_mutex_t or 67 * cond_t/lwp_cond_t should also be done to pthread_mutex_t/pthread_cond_t. 68 */ 69 typedef lwp_mutex_t mutex_t; 70 typedef lwp_cond_t cond_t; 71 72 /* 73 * Readers/writer locks 74 * 75 * NOTE: The layout of this structure should be kept in sync with the layout 76 * of the correponding structure of pthread_rwlock_t in sys/types.h. 77 * Also, there is an identical structure for lwp_rwlock_t in <sys/synch.h>. 78 * Because we have to deal with C++, we cannot redefine this one as that one. 79 */ 80 typedef struct _rwlock { 81 int32_t readers; /* rwstate word */ 82 uint16_t type; 83 uint16_t magic; 84 mutex_t mutex; /* used with process-shared rwlocks */ 85 cond_t readercv; /* used only to indicate ownership */ 86 cond_t writercv; /* used only to indicate ownership */ 87 } rwlock_t; 88 89 #ifdef __STDC__ 90 int _lwp_mutex_lock(lwp_mutex_t *); 91 int _lwp_mutex_unlock(lwp_mutex_t *); 92 int _lwp_mutex_trylock(lwp_mutex_t *); 93 int _lwp_cond_wait(lwp_cond_t *, lwp_mutex_t *); 94 int _lwp_cond_timedwait(lwp_cond_t *, lwp_mutex_t *, timespec_t *); 95 int _lwp_cond_reltimedwait(lwp_cond_t *, lwp_mutex_t *, timespec_t *); 96 int _lwp_cond_signal(lwp_cond_t *); 97 int _lwp_cond_broadcast(lwp_cond_t *); 98 int _lwp_sema_init(lwp_sema_t *, int); 99 int _lwp_sema_wait(lwp_sema_t *); 100 int _lwp_sema_trywait(lwp_sema_t *); 101 int _lwp_sema_post(lwp_sema_t *); 102 int cond_init(cond_t *, int, void *); 103 int cond_destroy(cond_t *); 104 int cond_wait(cond_t *, mutex_t *); 105 int cond_timedwait(cond_t *, mutex_t *, const timespec_t *); 106 int cond_reltimedwait(cond_t *, mutex_t *, const timespec_t *); 107 int cond_signal(cond_t *); 108 int cond_broadcast(cond_t *); 109 int mutex_init(mutex_t *, int, void *); 110 int mutex_destroy(mutex_t *); 111 int mutex_consistent(mutex_t *); 112 int mutex_lock(mutex_t *); 113 int mutex_trylock(mutex_t *); 114 int mutex_unlock(mutex_t *); 115 int rwlock_init(rwlock_t *, int, void *); 116 int rwlock_destroy(rwlock_t *); 117 int rw_rdlock(rwlock_t *); 118 int rw_wrlock(rwlock_t *); 119 int rw_unlock(rwlock_t *); 120 int rw_tryrdlock(rwlock_t *); 121 int rw_trywrlock(rwlock_t *); 122 int sema_init(sema_t *, unsigned int, int, void *); 123 int sema_destroy(sema_t *); 124 int sema_wait(sema_t *); 125 int sema_timedwait(sema_t *, const timespec_t *); 126 int sema_reltimedwait(sema_t *, const timespec_t *); 127 int sema_post(sema_t *); 128 int sema_trywait(sema_t *); 129 130 #else /* __STDC__ */ 131 132 int _lwp_mutex_lock(); 133 int _lwp_mutex_unlock(); 134 int _lwp_mutex_trylock(); 135 int _lwp_cond_wait(); 136 int _lwp_cond_timedwait(); 137 int _lwp_cond_reltimedwait(); 138 int _lwp_cond_signal(); 139 int _lwp_cond_broadcast(); 140 int _lwp_sema_init(); 141 int _lwp_sema_wait(); 142 int _lwp_sema_trywait(); 143 int _lwp_sema_post(); 144 int cond_init(); 145 int cond_destroy(); 146 int cond_wait(); 147 int cond_timedwait(); 148 int cond_reltimedwait(); 149 int cond_signal(); 150 int cond_broadcast(); 151 int mutex_init(); 152 int mutex_destroy(); 153 int mutex_consistent(); 154 int mutex_lock(); 155 int mutex_trylock(); 156 int mutex_unlock(); 157 int rwlock_init(); 158 int rwlock_destroy(); 159 int rw_rdlock(); 160 int rw_wrlock(); 161 int rw_unlock(); 162 int rw_tryrdlock(); 163 int rw_trywrlock(); 164 int sema_init(); 165 int sema_destroy(); 166 int sema_wait(); 167 int sema_timedwait(); 168 int sema_reltimedwait(); 169 int sema_post(); 170 int sema_trywait(); 171 172 #endif /* __STDC__ */ 173 174 #endif /* _ASM */ 175 176 /* "Magic numbers" tagging synchronization object types */ 177 #define MUTEX_MAGIC _MUTEX_MAGIC 178 #define SEMA_MAGIC _SEMA_MAGIC 179 #define COND_MAGIC _COND_MAGIC 180 #define RWL_MAGIC _RWL_MAGIC 181 182 /* 183 * POSIX.1c Note: 184 * DEFAULTMUTEX is defined same as PTHREAD_MUTEX_INITIALIZER in <pthread.h>. 185 * DEFAULTCV is defined same as PTHREAD_COND_INITIALIZER in <pthread.h>. 186 * DEFAULTRWLOCK is defined same as PTHREAD_RWLOCK_INITIALIZER in <pthread.h>. 187 * Any changes to these macros should be reflected in <pthread.h> 188 */ 189 #define DEFAULTMUTEX \ 190 {{0, 0, 0, {USYNC_THREAD}, MUTEX_MAGIC}, \ 191 {{{0, 0, 0, 0, 0, 0, 0, 0}}}, 0} 192 #define SHAREDMUTEX \ 193 {{0, 0, 0, {USYNC_PROCESS}, MUTEX_MAGIC}, \ 194 {{{0, 0, 0, 0, 0, 0, 0, 0}}}, 0} 195 #define RECURSIVEMUTEX \ 196 {{0, 0, 0, {USYNC_THREAD|LOCK_RECURSIVE}, MUTEX_MAGIC}, \ 197 {{{0, 0, 0, 0, 0, 0, 0, 0}}}, 0} 198 #define ERRORCHECKMUTEX \ 199 {{0, 0, 0, {USYNC_THREAD|LOCK_ERRORCHECK}, MUTEX_MAGIC}, \ 200 {{{0, 0, 0, 0, 0, 0, 0, 0}}}, 0} 201 #define RECURSIVE_ERRORCHECKMUTEX \ 202 {{0, 0, 0, {USYNC_THREAD|LOCK_RECURSIVE|LOCK_ERRORCHECK}, \ 203 MUTEX_MAGIC}, {{{0, 0, 0, 0, 0, 0, 0, 0}}}, 0} 204 #define DEFAULTCV \ 205 {{{0, 0, 0, 0}, USYNC_THREAD, COND_MAGIC}, 0} 206 #define SHAREDCV \ 207 {{{0, 0, 0, 0}, USYNC_PROCESS, COND_MAGIC}, 0} 208 #define DEFAULTSEMA \ 209 {0, USYNC_THREAD, SEMA_MAGIC, {0, 0, 0}, {0, 0}} 210 #define SHAREDSEMA \ 211 {0, USYNC_PROCESS, SEMA_MAGIC, {0, 0, 0}, {0, 0}} 212 #define DEFAULTRWLOCK \ 213 {0, USYNC_THREAD, RWL_MAGIC, DEFAULTMUTEX, DEFAULTCV, DEFAULTCV} 214 #define SHAREDRWLOCK \ 215 {0, USYNC_PROCESS, RWL_MAGIC, SHAREDMUTEX, SHAREDCV, SHAREDCV} 216 217 /* 218 * Tests on lock states. 219 */ 220 #define SEMA_HELD(x) _sema_held(x) 221 #define RW_READ_HELD(x) _rw_read_held(x) 222 #define RW_WRITE_HELD(x) _rw_write_held(x) 223 #define RW_LOCK_HELD(x) (RW_READ_HELD(x) || RW_WRITE_HELD(x)) 224 #define MUTEX_HELD(x) _mutex_held(x) 225 226 /* 227 * The following definitions are for assertions which can be checked 228 * statically by tools like lock_lint. You can also define your own 229 * run-time test for each. If you don't, we define them to 1 so that 230 * such assertions simply pass. 231 */ 232 #ifndef NO_LOCKS_HELD 233 #define NO_LOCKS_HELD 1 234 #endif 235 #ifndef NO_COMPETING_THREADS 236 #define NO_COMPETING_THREADS 1 237 #endif 238 239 #ifndef _ASM 240 241 #ifdef __STDC__ 242 243 /* 244 * The *_held() functions apply equally well to Solaris threads 245 * and to Posix threads synchronization objects, but the formal 246 * type declarations are different, so we just declare the argument 247 * to each *_held() function to be a void *, expecting that they will 248 * be called with the proper type of argument in each case. 249 */ 250 int _sema_held(void *); /* sema_t or sem_t */ 251 int _rw_read_held(void *); /* rwlock_t or pthread_rwlock_t */ 252 int _rw_write_held(void *); /* rwlock_t or pthread_rwlock_t */ 253 int _mutex_held(void *); /* mutex_t or pthread_mutex_t */ 254 255 #else /* __STDC__ */ 256 257 int _sema_held(); 258 int _rw_read_held(); 259 int _rw_write_held(); 260 int _mutex_held(); 261 262 #endif /* __STDC__ */ 263 264 /* Pause API */ 265 #ifdef __STDC__ 266 void smt_pause(void); 267 #else /* __STDC__ */ 268 void smt_pause(); 269 #endif /* __STDC__ */ 270 271 #endif /* _ASM */ 272 273 #ifdef __cplusplus 274 } 275 #endif 276 277 #endif /* _SYNCH_H */ 278