sjero.net Git - iperf/blob - include/Condition.h

   1 /*---------------------------------------------------------------
   2  * Copyright (c) 1999,2000,2001,2002,2003
   3  * The Board of Trustees of the University of Illinois
   4  * All Rights Reserved.
   5  *---------------------------------------------------------------
   6  * Permission is hereby granted, free of charge, to any person
   7  * obtaining a copy of this software (Iperf) and associated
   8  * documentation files (the "Software"), to deal in the Software
   9  * without restriction, including without limitation the
  10  * rights to use, copy, modify, merge, publish, distribute,
  11  * sublicense, and/or sell copies of the Software, and to permit
  12  * persons to whom the Software is furnished to do
  13  * so, subject to the following conditions:
  14  *
  15  *
  16  * Redistributions of source code must retain the above
  17  * copyright notice, this list of conditions and
  18  * the following disclaimers.
  19  *
  20  *
  21  * Redistributions in binary form must reproduce the above
  22  * copyright notice, this list of conditions and the following
  23  * disclaimers in the documentation and/or other materials
  24  * provided with the distribution.
  25  *
  26  *
  27  * Neither the names of the University of Illinois, NCSA,
  28  * nor the names of its contributors may be used to endorse
  29  * or promote products derived from this Software without
  30  * specific prior written permission.
  31  *
  32  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  33  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  34  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  35  * NONINFRINGEMENT. IN NO EVENT SHALL THE CONTIBUTORS OR COPYRIGHT
  36  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  37  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  38  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  39  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  40  * ________________________________________________________________
  41  * National Laboratory for Applied Network Research
  42  * National Center for Supercomputing Applications
  43  * University of Illinois at Urbana-Champaign
  44  * http://www.ncsa.uiuc.edu
  45  * ________________________________________________________________
  46  *
  47  * Condition.h
  48  * by Mark Gates <mgates@nlanr.net>
  49  * -------------------------------------------------------------------
  50  * An abstract class for waiting on a condition variable. If
  51  * threads are not available, this does nothing.
  52  * ------------------------------------------------------------------- */
  53
  54 #ifndef CONDITION_H
  55 #define CONDITION_H
  56
  57 #include "headers.h"
  58 #include "Mutex.h"
  59 #include "util.h"
  60
  61 #if   defined( HAVE_POSIX_THREAD )
  62 typedef struct Condition {
  63     pthread_cond_t mCondition;
  64     pthread_mutex_t mMutex;
  65 } Condition;
  66 #else
  67 typedef struct Condition {
  68     int mCondition;
  69     int mMutex;
  70 } Condition;
  71 #endif
  72
  73 #define Condition_Lock( Cond ) Mutex_Lock( &Cond.mMutex )
  74
  75 #define Condition_Unlock( Cond ) Mutex_Unlock( &Cond.mMutex )
  76
  77     // initialize condition
  78 #if   defined( HAVE_POSIX_THREAD )
  79     #define Condition_Initialize( Cond ) do {             \
  80         Mutex_Initialize( &(Cond)->mMutex );              \
  81         pthread_cond_init( &(Cond)->mCondition, NULL );   \
  82     } while ( 0 )
  83 #else
  84     #define Condition_Initialize( Cond )
  85 #endif
  86
  87     // destroy condition
  88 #if   defined( HAVE_POSIX_THREAD )
  89     #define Condition_Destroy( Cond ) do {            \
  90         pthread_cond_destroy( &(Cond)->mCondition );  \
  91         Mutex_Destroy( &(Cond)->mMutex );             \
  92     } while ( 0 )
  93 #else
  94     #define Condition_Destroy( Cond )
  95 #endif
  96
  97     // sleep this thread, waiting for condition signal
  98 #if   defined( HAVE_POSIX_THREAD )
  99     #define Condition_Wait( Cond ) pthread_cond_wait( &(Cond)->mCondition, &(Cond)->mMutex )
 100 #else
 101     #define Condition_Wait( Cond )
 102 #endif
 103
 104     // sleep this thread, waiting for condition signal,
 105     // but bound sleep time by the relative time inSeconds.
 106 #if   defined( HAVE_POSIX_THREAD )
 107     #define Condition_TimedWait( Cond, inSeconds ) do {                         \
 108         struct timespec absTimeout;                                             \
 109         absTimeout.tv_sec  = time( NULL ) + inSeconds;                          \
 110         absTimeout.tv_nsec = 0;                                                 \
 111        pthread_cond_timedwait( &(Cond)->mCondition, &(Cond)->mMutex, &absTimeout ); \
 112     } while ( 0 )
 113 #else
 114     #define Condition_TimedWait( Cond, inSeconds )
 115 #endif
 116
 117     // send a condition signal to wake one thread waiting on condition
 118     // in Win32, this actually wakes up all threads, same as Broadcast
 119     // use PulseEvent to auto-reset the signal after waking all threads
 120 #if   defined( HAVE_POSIX_THREAD )
 121     #define Condition_Signal( Cond ) pthread_cond_signal( &(Cond)->mCondition )
 122 #else
 123     #define Condition_Signal( Cond )
 124 #endif
 125
 126     // send a condition signal to wake all threads waiting on condition
 127 #if   defined( HAVE_POSIX_THREAD )
 128     #define Condition_Broadcast( Cond ) pthread_cond_broadcast( &(Cond)->mCondition )
 129 #else
 130     #define Condition_Broadcast( Cond )
 131 #endif
 132
 133 #endif // CONDITION_H