2 * Copyright (c) 1998 Alex Nash
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: src/lib/libpthread/thread/thr_rwlock.c,v 1.14 2004/01/08 15:37:09 deischen Exp $
27 * $DragonFly: src/lib/libthread_xu/thread/thr_rwlock.c,v 1.4 2005/04/12 14:01:31 davidxu Exp $
30 #include <machine/tls.h>
37 #include "thr_private.h"
39 /* maximum number of times a read lock may be obtained */
40 #define MAX_READ_LOCKS (INT_MAX - 1)
42 __weak_reference(_pthread_rwlock_destroy, pthread_rwlock_destroy);
43 __weak_reference(_pthread_rwlock_init, pthread_rwlock_init);
44 __weak_reference(_pthread_rwlock_rdlock, pthread_rwlock_rdlock);
45 __weak_reference(_pthread_rwlock_timedrdlock, pthread_rwlock_timedrdlock);
46 __weak_reference(_pthread_rwlock_tryrdlock, pthread_rwlock_tryrdlock);
47 __weak_reference(_pthread_rwlock_trywrlock, pthread_rwlock_trywrlock);
48 __weak_reference(_pthread_rwlock_unlock, pthread_rwlock_unlock);
49 __weak_reference(_pthread_rwlock_wrlock, pthread_rwlock_wrlock);
50 __weak_reference(_pthread_rwlock_timedwrlock, pthread_rwlock_timedwrlock);
57 rwlock_init(pthread_rwlock_t *rwlock, const pthread_rwlockattr_t *attr)
59 pthread_rwlock_t prwlock;
62 /* allocate rwlock object */
63 prwlock = (pthread_rwlock_t)malloc(sizeof(struct pthread_rwlock));
68 /* initialize the lock */
69 if ((ret = _pthread_mutex_init(&prwlock->lock, NULL)) != 0)
72 /* initialize the read condition signal */
73 ret = _pthread_cond_init(&prwlock->read_signal, NULL);
76 _pthread_mutex_destroy(&prwlock->lock);
79 /* initialize the write condition signal */
80 ret = _pthread_cond_init(&prwlock->write_signal, NULL);
83 _pthread_cond_destroy(&prwlock->read_signal);
84 _pthread_mutex_destroy(&prwlock->lock);
89 prwlock->blocked_writers = 0;
99 _pthread_rwlock_destroy (pthread_rwlock_t *rwlock)
106 pthread_rwlock_t prwlock;
110 _pthread_mutex_destroy(&prwlock->lock);
111 _pthread_cond_destroy(&prwlock->read_signal);
112 _pthread_cond_destroy(&prwlock->write_signal);
123 init_static(struct pthread *thread, pthread_rwlock_t *rwlock)
127 THR_LOCK_ACQUIRE(thread, &_rwlock_static_lock);
130 ret = rwlock_init(rwlock, NULL);
134 THR_LOCK_RELEASE(thread, &_rwlock_static_lock);
140 _pthread_rwlock_init (pthread_rwlock_t *rwlock, const pthread_rwlockattr_t *attr)
143 return (rwlock_init(rwlock, attr));
147 rwlock_rdlock_common (pthread_rwlock_t *rwlock, const struct timespec *abstime)
149 struct pthread *curthread = tls_get_curthread();
150 pthread_rwlock_t prwlock;
158 /* check for static initialization */
159 if (prwlock == NULL) {
160 if ((ret = init_static(curthread, rwlock)) != 0)
166 /* grab the monitor lock */
167 if ((ret = _pthread_mutex_lock(&prwlock->lock)) != 0)
170 /* check lock count */
171 if (prwlock->state == MAX_READ_LOCKS) {
172 _pthread_mutex_unlock(&prwlock->lock);
176 curthread = tls_get_curthread();
177 if ((curthread->rdlock_count > 0) && (prwlock->state > 0)) {
179 * To avoid having to track all the rdlocks held by
180 * a thread or all of the threads that hold a rdlock,
181 * we keep a simple count of all the rdlocks held by
182 * a thread. If a thread holds any rdlocks it is
183 * possible that it is attempting to take a recursive
184 * rdlock. If there are blocked writers and precedence
185 * is given to them, then that would result in the thread
186 * deadlocking. So allowing a thread to take the rdlock
187 * when it already has one or more rdlocks avoids the
188 * deadlock. I hope the reader can follow that logic ;-)
190 ; /* nothing needed */
192 /* give writers priority over readers */
193 while (prwlock->blocked_writers || prwlock->state < 0) {
195 ret = _pthread_cond_timedwait
196 (&prwlock->read_signal,
197 &prwlock->lock, abstime);
199 ret = _pthread_cond_wait(&prwlock->read_signal,
202 /* can't do a whole lot if this fails */
203 _pthread_mutex_unlock(&prwlock->lock);
209 curthread->rdlock_count++;
210 prwlock->state++; /* indicate we are locked for reading */
213 * Something is really wrong if this call fails. Returning
214 * error won't do because we've already obtained the read
215 * lock. Decrementing 'state' is no good because we probably
216 * don't have the monitor lock.
218 _pthread_mutex_unlock(&prwlock->lock);
224 _pthread_rwlock_rdlock (pthread_rwlock_t *rwlock)
226 return (rwlock_rdlock_common(rwlock, NULL));
230 _pthread_rwlock_timedrdlock (pthread_rwlock_t *rwlock,
231 const struct timespec *abstime)
233 return (rwlock_rdlock_common(rwlock, abstime));
237 _pthread_rwlock_tryrdlock (pthread_rwlock_t *rwlock)
239 struct pthread *curthread = tls_get_curthread();
240 pthread_rwlock_t prwlock;
248 /* check for static initialization */
249 if (prwlock == NULL) {
250 if ((ret = init_static(curthread, rwlock)) != 0)
256 /* grab the monitor lock */
257 if ((ret = _pthread_mutex_lock(&prwlock->lock)) != 0)
260 curthread = tls_get_curthread();
261 if (prwlock->state == MAX_READ_LOCKS)
263 else if ((curthread->rdlock_count > 0) && (prwlock->state > 0)) {
264 /* see comment for pthread_rwlock_rdlock() */
265 curthread->rdlock_count++;
268 /* give writers priority over readers */
269 else if (prwlock->blocked_writers || prwlock->state < 0)
272 curthread->rdlock_count++;
273 prwlock->state++; /* indicate we are locked for reading */
276 /* see the comment on this in pthread_rwlock_rdlock */
277 _pthread_mutex_unlock(&prwlock->lock);
283 _pthread_rwlock_trywrlock (pthread_rwlock_t *rwlock)
285 struct pthread *curthread = tls_get_curthread();
286 pthread_rwlock_t prwlock;
294 /* check for static initialization */
295 if (prwlock == NULL) {
296 if ((ret = init_static(curthread, rwlock)) != 0)
302 /* grab the monitor lock */
303 if ((ret = _pthread_mutex_lock(&prwlock->lock)) != 0)
306 if (prwlock->state != 0)
309 /* indicate we are locked for writing */
312 /* see the comment on this in pthread_rwlock_rdlock */
313 _pthread_mutex_unlock(&prwlock->lock);
319 _pthread_rwlock_unlock (pthread_rwlock_t *rwlock)
321 struct pthread *curthread;
322 pthread_rwlock_t prwlock;
333 /* grab the monitor lock */
334 if ((ret = _pthread_mutex_lock(&prwlock->lock)) != 0)
337 curthread = tls_get_curthread();
338 if (prwlock->state > 0) {
339 curthread->rdlock_count--;
341 if (prwlock->state == 0 && prwlock->blocked_writers)
342 ret = _pthread_cond_signal(&prwlock->write_signal);
343 } else if (prwlock->state < 0) {
346 if (prwlock->blocked_writers)
347 ret = _pthread_cond_signal(&prwlock->write_signal);
349 ret = _pthread_cond_broadcast(&prwlock->read_signal);
353 /* see the comment on this in pthread_rwlock_rdlock */
354 _pthread_mutex_unlock(&prwlock->lock);
360 rwlock_wrlock_common (pthread_rwlock_t *rwlock, const struct timespec *abstime)
362 struct pthread *curthread = tls_get_curthread();
363 pthread_rwlock_t prwlock;
371 /* check for static initialization */
372 if (prwlock == NULL) {
373 if ((ret = init_static(curthread, rwlock)) != 0)
379 /* grab the monitor lock */
380 if ((ret = _pthread_mutex_lock(&prwlock->lock)) != 0)
383 while (prwlock->state != 0) {
384 prwlock->blocked_writers++;
387 ret = _pthread_cond_timedwait(&prwlock->write_signal,
388 &prwlock->lock, abstime);
390 ret = _pthread_cond_wait(&prwlock->write_signal,
393 prwlock->blocked_writers--;
394 _pthread_mutex_unlock(&prwlock->lock);
398 prwlock->blocked_writers--;
401 /* indicate we are locked for writing */
404 /* see the comment on this in pthread_rwlock_rdlock */
405 _pthread_mutex_unlock(&prwlock->lock);
411 _pthread_rwlock_wrlock (pthread_rwlock_t *rwlock)
413 return (rwlock_wrlock_common (rwlock, NULL));
417 _pthread_rwlock_timedwrlock (pthread_rwlock_t *rwlock,
418 const struct timespec *abstime)
420 return (rwlock_wrlock_common (rwlock, abstime));