Home | History | Annotate | Line # | Download | only in libpthread
pthread_cond.c revision 1.14.2.2
      1 /*	$NetBSD: pthread_cond.c,v 1.14.2.2 2004/10/04 05:21:59 jmc Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2001 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Nathan J. Williams.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *        This product includes software developed by the NetBSD
     21  *        Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 #include <sys/cdefs.h>
     40 __RCSID("$NetBSD: pthread_cond.c,v 1.14.2.2 2004/10/04 05:21:59 jmc Exp $");
     41 
     42 #include <errno.h>
     43 #include <sys/time.h>
     44 #include <sys/types.h>
     45 
     46 #include "pthread.h"
     47 #include "pthread_int.h"
     48 
     49 #ifdef PTHREAD_COND_DEBUG
     50 #define SDPRINTF(x) DPRINTF(x)
     51 #else
     52 #define SDPRINTF(x)
     53 #endif
     54 
     55 int	_sys_select(int, fd_set *, fd_set *, fd_set *, struct timeval *);
     56 
     57 extern int pthread__started;
     58 
     59 static void pthread_cond_wait__callback(void *);
     60 static int pthread_cond_wait_nothread(pthread_t, pthread_mutex_t *,
     61     const struct timespec *);
     62 
     63 __strong_alias(__libc_cond_init,pthread_cond_init)
     64 __strong_alias(__libc_cond_signal,pthread_cond_signal)
     65 __strong_alias(__libc_cond_broadcast,pthread_cond_broadcast)
     66 __strong_alias(__libc_cond_wait,pthread_cond_wait)
     67 __strong_alias(__libc_cond_timedwait,pthread_cond_timedwait)
     68 __strong_alias(__libc_cond_destroy,pthread_cond_destroy)
     69 
     70 int
     71 pthread_cond_init(pthread_cond_t *cond, const pthread_condattr_t *attr)
     72 {
     73 
     74 	pthread__error(EINVAL, "Invalid condition variable attribute",
     75 	    (attr == NULL) || (attr->ptca_magic == _PT_CONDATTR_MAGIC));
     76 
     77 	cond->ptc_magic = _PT_COND_MAGIC;
     78 	pthread_lockinit(&cond->ptc_lock);
     79 	PTQ_INIT(&cond->ptc_waiters);
     80 	cond->ptc_mutex = NULL;
     81 
     82 	return 0;
     83 }
     84 
     85 
     86 int
     87 pthread_cond_destroy(pthread_cond_t *cond)
     88 {
     89 
     90 	pthread__error(EINVAL, "Invalid condition variable",
     91 	    cond->ptc_magic == _PT_COND_MAGIC);
     92 	pthread__error(EBUSY, "Destroying condition variable in use",
     93 	    cond->ptc_mutex == NULL);
     94 
     95 	cond->ptc_magic = _PT_COND_DEAD;
     96 
     97 	return 0;
     98 }
     99 
    100 
    101 int
    102 pthread_cond_wait(pthread_cond_t *cond, pthread_mutex_t *mutex)
    103 {
    104 	pthread_t self;
    105 
    106 	pthread__error(EINVAL, "Invalid condition variable",
    107 	    cond->ptc_magic == _PT_COND_MAGIC);
    108 	pthread__error(EINVAL, "Invalid mutex",
    109 	    mutex->ptm_magic == _PT_MUTEX_MAGIC);
    110 	pthread__error(EPERM, "Mutex not locked in condition wait",
    111 	    mutex->ptm_lock == __SIMPLELOCK_LOCKED);
    112 
    113 	self = pthread__self();
    114 	PTHREADD_ADD(PTHREADD_COND_WAIT);
    115 
    116 	/* Just hang out for a while if threads aren't running yet. */
    117 	if (__predict_false(pthread__started == 0))
    118 		return pthread_cond_wait_nothread(self, mutex, NULL);
    119 
    120 	pthread_spinlock(self, &cond->ptc_lock);
    121 	SDPRINTF(("(cond wait %p) Waiting on %p, mutex %p\n",
    122 	    self, cond, mutex));
    123 	pthread_spinlock(self, &self->pt_statelock);
    124 	if (__predict_false(self->pt_cancel)) {
    125 		pthread_spinunlock(self, &self->pt_statelock);
    126 		pthread_spinunlock(self, &cond->ptc_lock);
    127 		pthread_exit(PTHREAD_CANCELED);
    128 	}
    129 #ifdef ERRORCHECK
    130 	if (cond->ptc_mutex == NULL)
    131 		cond->ptc_mutex = mutex;
    132 	else
    133 		pthread__error(EINVAL,
    134 		    "Multiple mutexes used for condition wait",
    135 		    cond->ptc_mutex == mutex);
    136 #endif
    137 	self->pt_state = PT_STATE_BLOCKED_QUEUE;
    138 	self->pt_sleepobj = cond;
    139 	self->pt_sleepq = &cond->ptc_waiters;
    140 	self->pt_sleeplock = &cond->ptc_lock;
    141 	pthread_spinunlock(self, &self->pt_statelock);
    142 	PTQ_INSERT_HEAD(&cond->ptc_waiters, self, pt_sleep);
    143 	pthread_mutex_unlock(mutex);
    144 
    145 	pthread__block(self, &cond->ptc_lock);
    146 	/* Spinlock is unlocked on return */
    147 	pthread_mutex_lock(mutex);
    148 #ifdef ERRORCHECK
    149 	pthread_spinlock(self, &cond->ptc_lock);
    150 	if (PTQ_EMPTY(&cond->ptc_waiters))
    151 		cond->ptc_mutex = NULL;
    152 	pthread_spinunlock(self, &cond->ptc_lock);
    153 #endif
    154 	if (__predict_false(self->pt_cancel))
    155 		pthread_exit(PTHREAD_CANCELED);
    156 
    157 	SDPRINTF(("(cond wait %p) Woke up on %p, mutex %p\n",
    158 	    self, cond, mutex));
    159 
    160 	return 0;
    161 }
    162 
    163 
    164 struct pthread_cond__waitarg {
    165 	pthread_t ptw_thread;
    166 	pthread_cond_t *ptw_cond;
    167 };
    168 
    169 int
    170 pthread_cond_timedwait(pthread_cond_t *cond, pthread_mutex_t *mutex,
    171     const struct timespec *abstime)
    172 {
    173 	pthread_t self;
    174 	struct pthread_cond__waitarg wait;
    175 	struct pt_alarm_t alarm;
    176 	int retval;
    177 
    178 	pthread__error(EINVAL, "Invalid condition variable",
    179 	    cond->ptc_magic == _PT_COND_MAGIC);
    180 	pthread__error(EINVAL, "Invalid mutex",
    181 	    mutex->ptm_magic == _PT_MUTEX_MAGIC);
    182 	pthread__error(EPERM, "Mutex not locked in condition wait",
    183 	    mutex->ptm_lock == __SIMPLELOCK_LOCKED);
    184 	pthread__error(EINVAL, "Invalid wait time",
    185 	    (abstime->tv_sec >= 0) &&
    186 	    (abstime->tv_nsec >= 0) && (abstime->tv_nsec < 1000000000));
    187 
    188 	self = pthread__self();
    189 	PTHREADD_ADD(PTHREADD_COND_TIMEDWAIT);
    190 
    191 	/* Just hang out for a while if threads aren't running yet. */
    192 	if (__predict_false(pthread__started == 0))
    193 		return pthread_cond_wait_nothread(self, mutex, abstime);
    194 
    195 	pthread_spinlock(self, &cond->ptc_lock);
    196 	wait.ptw_thread = self;
    197 	wait.ptw_cond = cond;
    198 	retval = 0;
    199 	SDPRINTF(("(cond timed wait %p) Waiting on %p until %d.%06ld\n",
    200 	    self, cond, abstime->tv_sec, abstime->tv_nsec/1000));
    201 
    202 	pthread_spinlock(self, &self->pt_statelock);
    203 	if (__predict_false(self->pt_cancel)) {
    204 		pthread_spinunlock(self, &self->pt_statelock);
    205 		pthread_spinunlock(self, &cond->ptc_lock);
    206 		pthread_exit(PTHREAD_CANCELED);
    207 	}
    208 #ifdef ERRORCHECK
    209 	if (cond->ptc_mutex == NULL)
    210 		cond->ptc_mutex = mutex;
    211 	else
    212 		pthread__error(EINVAL,
    213 		    "Multiple mutexes used for condition wait",
    214 		    cond->ptc_mutex == mutex);
    215 #endif
    216 
    217 	pthread__alarm_add(self, &alarm, abstime, pthread_cond_wait__callback,
    218 	    &wait);
    219 	self->pt_state = PT_STATE_BLOCKED_QUEUE;
    220 	self->pt_sleepobj = cond;
    221 	self->pt_sleepq = &cond->ptc_waiters;
    222 	self->pt_sleeplock = &cond->ptc_lock;
    223 	pthread_spinunlock(self, &self->pt_statelock);
    224 
    225 	PTQ_INSERT_HEAD(&cond->ptc_waiters, self, pt_sleep);
    226 	pthread_mutex_unlock(mutex);
    227 
    228 	pthread__block(self, &cond->ptc_lock);
    229 	/* Spinlock is unlocked on return */
    230 	SDPRINTF(("(cond timed wait %p) Woke up on %p, mutex %p\n",
    231 	    self, cond));
    232 	pthread__alarm_del(self, &alarm);
    233 	if (pthread__alarm_fired(&alarm))
    234 		retval = ETIMEDOUT;
    235 	SDPRINTF(("(cond timed wait %p) %s\n",
    236 	    self, (retval == ETIMEDOUT) ? "(timed out)" : ""));
    237 	pthread_mutex_lock(mutex);
    238 #ifdef ERRORCHECK
    239 	pthread_spinlock(self, &cond->ptc_lock);
    240 	if (PTQ_EMPTY(&cond->ptc_waiters))
    241 		cond->ptc_mutex = NULL;
    242 	pthread_spinunlock(self, &cond->ptc_lock);
    243 #endif
    244 	if (__predict_false(self->pt_cancel))
    245 		pthread_exit(PTHREAD_CANCELED);
    246 
    247 	return retval;
    248 }
    249 
    250 static void
    251 pthread_cond_wait__callback(void *arg)
    252 {
    253 	struct pthread_cond__waitarg *a;
    254 	pthread_t self;
    255 
    256 	a = arg;
    257 	self = pthread__self();
    258 
    259 	/*
    260 	 * Don't dequeue and schedule the thread if it's already been
    261 	 * queued up by a signal or broadcast (but hasn't yet run as far
    262 	 * as pthread__alarm_del(), or we wouldn't be here, and hence can't
    263 	 * have become blocked on some *other* queue).
    264 	 */
    265 	pthread_spinlock(self, &a->ptw_cond->ptc_lock);
    266 	if (a->ptw_thread->pt_state == PT_STATE_BLOCKED_QUEUE) {
    267 		PTQ_REMOVE(&a->ptw_cond->ptc_waiters, a->ptw_thread, pt_sleep);
    268 #ifdef ERRORCHECK
    269 		if (PTQ_EMPTY(&a->ptw_cond->ptc_waiters))
    270 			a->ptw_cond->ptc_mutex = NULL;
    271 #endif
    272 		pthread__sched(self, a->ptw_thread);
    273 	}
    274 	pthread_spinunlock(self, &a->ptw_cond->ptc_lock);
    275 }
    276 
    277 int
    278 pthread_cond_signal(pthread_cond_t *cond)
    279 {
    280 	pthread_t self, signaled;
    281 
    282 	pthread__error(EINVAL, "Invalid condition variable",
    283 	    cond->ptc_magic == _PT_COND_MAGIC);
    284 	PTHREADD_ADD(PTHREADD_COND_SIGNAL);
    285 
    286 	SDPRINTF(("(cond signal %p) Signaling %p\n",
    287 	    pthread__self(), cond));
    288 
    289 	if (!PTQ_EMPTY(&cond->ptc_waiters)) {
    290 		self = pthread__self();
    291 		pthread_spinlock(self, &cond->ptc_lock);
    292 		signaled = PTQ_FIRST(&cond->ptc_waiters);
    293 		if (signaled != NULL) {
    294 			PTQ_REMOVE(&cond->ptc_waiters, signaled, pt_sleep);
    295 			pthread__sched(self, signaled);
    296 			PTHREADD_ADD(PTHREADD_COND_WOKEUP);
    297 		}
    298 #ifdef ERRORCHECK
    299 		if (PTQ_EMPTY(&cond->ptc_waiters))
    300 			cond->ptc_mutex = NULL;
    301 #endif
    302 		pthread_spinunlock(self, &cond->ptc_lock);
    303 	}
    304 
    305 	return 0;
    306 }
    307 
    308 
    309 int
    310 pthread_cond_broadcast(pthread_cond_t *cond)
    311 {
    312 	pthread_t self;
    313 	struct pthread_queue_t blockedq;
    314 
    315 	pthread__error(EINVAL, "Invalid condition variable", cond->ptc_magic == _PT_COND_MAGIC);
    316 
    317 	PTHREADD_ADD(PTHREADD_COND_BROADCAST);
    318 	SDPRINTF(("(cond signal %p) Broadcasting %p\n",
    319 	    pthread__self(), cond));
    320 
    321 	if (!PTQ_EMPTY(&cond->ptc_waiters)) {
    322 		self = pthread__self();
    323 		pthread_spinlock(self, &cond->ptc_lock);
    324 		blockedq = cond->ptc_waiters;
    325 		PTQ_INIT(&cond->ptc_waiters);
    326 #ifdef ERRORCHECK
    327 		cond->ptc_mutex = NULL;
    328 #endif
    329 		pthread__sched_sleepers(self, &blockedq);
    330 		PTHREADD_ADD(PTHREADD_COND_WOKEUP);
    331 		pthread_spinunlock(self, &cond->ptc_lock);
    332 	}
    333 
    334 	return 0;
    335 
    336 }
    337 
    338 
    339 int
    340 pthread_condattr_init(pthread_condattr_t *attr)
    341 {
    342 
    343 	attr->ptca_magic = _PT_CONDATTR_MAGIC;
    344 
    345 	return 0;
    346 }
    347 
    348 
    349 int
    350 pthread_condattr_destroy(pthread_condattr_t *attr)
    351 {
    352 
    353 	pthread__error(EINVAL, "Invalid condition variable attribute",
    354 	    attr->ptca_magic == _PT_CONDATTR_MAGIC);
    355 
    356 	attr->ptca_magic = _PT_CONDATTR_DEAD;
    357 
    358 	return 0;
    359 }
    360 
    361 /* Utility routine to hang out for a while if threads haven't started yet. */
    362 static int
    363 pthread_cond_wait_nothread(pthread_t self, pthread_mutex_t *mutex,
    364     const struct timespec *abstime)
    365 {
    366 	struct timeval now, tv, *tvp;
    367 	int retval;
    368 
    369 	if (abstime == NULL)
    370 		tvp = NULL;
    371 	else {
    372 		tvp = &tv;
    373 		gettimeofday(&now, NULL);
    374 		TIMESPEC_TO_TIMEVAL(tvp, abstime);
    375 		timersub(tvp, &now, tvp);
    376 	}
    377 
    378 	/*
    379 	 * The libpthread select() wrapper has cancellation tests, but
    380 	 * we need to have the mutex locked when testing for
    381 	 * cancellation and unlocked while we sleep.  So, skip the
    382 	 * wrapper.
    383 	 */
    384 	pthread__testcancel(self);
    385 	pthread_mutex_unlock(mutex);
    386 	retval = _sys_select(0, NULL, NULL, NULL, tvp);
    387 	pthread_mutex_lock(mutex);
    388 	pthread__testcancel(self);
    389 
    390 	if (retval == 0)
    391 		return ETIMEDOUT;
    392 	else
    393 		/* spurious wakeup */
    394 		return 0;
    395 }
    396