orte/liborte/rtl/ptw32_rwlock_check_need_init.c

   1 /*
   2  * pthread_rwlock_check_need_init.c
   3  *
   4  * Description:
   5  * This translation unit implements read/write lock primitives.
   6  *
   7  * --------------------------------------------------------------------------
   8  *
   9  *      Pthreads-win32 - POSIX Threads Library for Win32
  10  *      Copyright(C) 1998 John E. Bossom
  11  *      Copyright(C) 1999,2002 Pthreads-win32 contributors
  12  *
  13  *      Contact Email: rpj@ise.canberra.edu.au
  14  *
  15  *      The current list of contributors is contained
  16  *      in the file CONTRIBUTORS included with the source
  17  *      code distribution. The list can also be seen at the
  18  *      following World Wide Web location:
  19  *      http://sources.redhat.com/pthreads-win32/contributors.html
  20  *
  21  *      This library is free software; you can redistribute it and/or
  22  *      modify it under the terms of the GNU Lesser General Public
  23  *      License as published by the Free Software Foundation; either
  24  *      version 2 of the License, or (at your option) any later version.
  25  *
  26  *      This library is distributed in the hope that it will be useful,
  27  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  28  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  29  *      Lesser General Public License for more details.
  30  *
  31  *      You should have received a copy of the GNU Lesser General Public
  32  *      License along with this library in the file COPYING.LIB;
  33  *      if not, write to the Free Software Foundation, Inc.,
  34  *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
  35  */
  36
  37 //#include "pthread.h"
  38 //#include "implement.h"
  39
  40 #include "orte_all.h"
  41
  42 inline int
  43 ptw32_rwlock_check_need_init(pthread_rwlock_t *rwlock)
  44 {
  45   int result = 0;
  46
  47   /*
  48    * The following guarded test is specifically for statically
  49    * initialised rwlocks (via PTHREAD_RWLOCK_INITIALIZER).
  50    *
  51    * Note that by not providing this synchronisation we risk
  52    * introducing race conditions into applications which are
  53    * correctly written.
  54    *
  55    * Approach
  56    * --------
  57    * We know that static rwlocks will not be PROCESS_SHARED
  58    * so we can serialise access to internal state using
  59    * Win32 Critical Sections rather than Win32 Mutexes.
  60    *
  61    * If using a single global lock slows applications down too much,
  62    * multiple global locks could be created and hashed on some random
  63    * value associated with each mutex, the pointer perhaps. At a guess,
  64    * a good value for the optimal number of global locks might be
  65    * the number of processors + 1.
  66    *
  67    */
  68 //  EnterCriticalSection(&ptw32_rwlock_test_init_lock);
  69
  70   /*
  71    * We got here possibly under race
  72    * conditions. Check again inside the critical section
  73    * and only initialise if the rwlock is valid (not been destroyed).
  74    * If a static rwlock has been destroyed, the application can
  75    * re-initialise it only by calling pthread_rwlock_init()
  76    * explicitly.
  77    */
  78   if (*rwlock == PTHREAD_RWLOCK_INITIALIZER)
  79     {
  80       result = pthread_rwlock_init(rwlock, NULL);
  81     }
  82   else if (*rwlock == NULL)
  83     {
  84       /*
  85        * The rwlock has been destroyed while we were waiting to
  86        * initialise it, so the operation that caused the
  87        * auto-initialisation should fail.
  88        */
  89       result = EINVAL;
  90     }
  91
  92 //  LeaveCriticalSection(&ptw32_rwlock_test_init_lock);
  93
  94   return result;
  95 }