Subversion Repositories HelenOS-historic

Rev

Rev 1502 | Rev 1705 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (C) 2001-2004 Jakub Jermar
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  *
  9.  * - Redistributions of source code must retain the above copyright
  10.  *   notice, this list of conditions and the following disclaimer.
  11.  * - Redistributions in binary form must reproduce the above copyright
  12.  *   notice, this list of conditions and the following disclaimer in the
  13.  *   documentation and/or other materials provided with the distribution.
  14.  * - The name of the author may not be used to endorse or promote products
  15.  *   derived from this software without specific prior written permission.
  16.  *
  17.  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18.  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20.  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21.  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26.  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27.  */
  28.  
  29.  /** @addtogroup sync Synchronization
  30.  * @ingroup kernel
  31.  * @{
  32.  */
  33.  
  34. /**
  35.  * @file
  36.  * @brief   Condition variables.
  37.  */
  38.  
  39. #include <synch/condvar.h>
  40. #include <synch/mutex.h>
  41. #include <synch/waitq.h>
  42. #include <synch/synch.h>
  43. #include <arch.h>
  44. #include <typedefs.h>
  45.  
  46. /** Initialize condition variable.
  47.  *
  48.  * @param cv Condition variable.
  49.  */
  50. void condvar_initialize(condvar_t *cv)
  51. {
  52.     waitq_initialize(&cv->wq);
  53. }
  54.  
  55. /**
  56.  * Signal the condition has become true
  57.  * to the first waiting thread by waking it up.
  58.  *
  59.  * @param cv Condition variable.
  60.  */
  61. void condvar_signal(condvar_t *cv)
  62. {
  63.     waitq_wakeup(&cv->wq, WAKEUP_FIRST);
  64. }
  65.  
  66. /**
  67.  * Signal the condition has become true
  68.  * to all waiting threads by waking them up.
  69.  *
  70.  * @param cv Condition variable.
  71.  */
  72. void condvar_broadcast(condvar_t *cv)
  73. {
  74.     waitq_wakeup(&cv->wq, WAKEUP_ALL);
  75. }
  76.  
  77. /** Wait for the condition becoming true.
  78.  *
  79.  * @param cv Condition variable.
  80.  * @param mtx Mutex.
  81.  * @param usec Timeout value in microseconds.
  82.  * @param flags Select mode of operation.
  83.  *
  84.  * For exact description of meaning of possible combinations
  85.  * of usec and flags, see comment for waitq_sleep_timeout().
  86.  * Note that when SYNCH_FLAGS_NON_BLOCKING is specified here,
  87.  * ESYNCH_WOULD_BLOCK is always returned.
  88.  *
  89.  * @return See comment for waitq_sleep_timeout().
  90.  */
  91. int _condvar_wait_timeout(condvar_t *cv, mutex_t *mtx, __u32 usec, int flags)
  92. {
  93.     int rc;
  94.     ipl_t ipl;
  95.  
  96.     ipl = waitq_sleep_prepare(&cv->wq);
  97.     mutex_unlock(mtx);
  98.  
  99.     cv->wq.missed_wakeups = 0;  /* Enforce blocking. */
  100.     rc = waitq_sleep_timeout_unsafe(&cv->wq, usec, flags);
  101.  
  102.     mutex_lock(mtx);
  103.     waitq_sleep_finish(&cv->wq, rc, ipl);
  104.  
  105.     return rc;
  106. }
  107.  
  108.  /** @}
  109.  */
  110.  
  111.