Changeset 08a19ba in mainline for kernel/generic/src/synch/condvar.c

Timestamp:

2008-06-23T18:44:48Z (16 years ago)

Author:

Jakub Jermar <jakub@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

1a1744e

Parents:

deaf8d5

Message:

Support for active mutexes. Active mutexes implement busy waiting, pretty much
in the same way as spinlocks, but can be passed to condition variables, which is
the motivation for this enhancement.

File:

• kernel/generic/src/synch/condvar.c (modified) (4 diffs)

kernel/generic/src/synch/condvar.c

@@ -44 +44 @@
 /** Initialize condition variable.
  *
- * @param cv Condition variable.
+ * @param cv            Condition variable.
  */
 void condvar_initialize(condvar_t *cv)
@@ -51 +51 @@
 }
 
-/**
- * Signal the condition has become true
- * to the first waiting thread by waking it up.
+/** Signal the condition has become true to the first waiting thread by waking
+ * it up.
  *
- * @param cv Condition variable.
+ * @param cv            Condition variable.
  */
 void condvar_signal(condvar_t *cv)
@@ -62 +61 @@
 }
 
-/**
- * Signal the condition has become true
- * to all waiting threads by waking them up.
+/** Signal the condition has become true to all waiting threads by waking
+ * them up.
  *
- * @param cv Condition variable.
+ * @param cv            Condition variable.
  */
 void condvar_broadcast(condvar_t *cv)
@@ -75 +73 @@
 /** Wait for the condition becoming true.
  *
- * @param cv Condition variable.
- * @param mtx Mutex.
- * @param usec Timeout value in microseconds.
- * @param flags Select mode of operation.
+ * @param cv            Condition variable.
+ * @param mtx           Mutex.
+ * @param usec          Timeout value in microseconds.
+ * @param flags         Select mode of operation.
  *
- * For exact description of meaning of possible combinations
- * of usec and flags, see comment for waitq_sleep_timeout().
- * Note that when SYNCH_FLAGS_NON_BLOCKING is specified here,
- * ESYNCH_WOULD_BLOCK is always returned.
+ * For exact description of meaning of possible combinations of usec and flags,
+ * see comment for waitq_sleep_timeout().  Note that when
+ * SYNCH_FLAGS_NON_BLOCKING is specified here, ESYNCH_WOULD_BLOCK is always
+ * returned.
  *
- * @return See comment for waitq_sleep_timeout().
+ * @return              See comment for waitq_sleep_timeout().
  */
 int _condvar_wait_timeout(condvar_t *cv, mutex_t *mtx, uint32_t usec, int flags)