Home | History | Annotate | Download | only in pthreads-win32
      1 /*
      2  * pthread_condattr_getpshared.c
      3  *
      4  * Description:
      5  * This translation unit implements condition variables and their primitives.
      6  *
      7  *
      8  * --------------------------------------------------------------------------
      9  *
     10  *      Pthreads-win32 - POSIX Threads Library for Win32
     11  *      Copyright(C) 1998 John E. Bossom
     12  *      Copyright(C) 1999,2005 Pthreads-win32 contributors
     13  *
     14  *      Contact Email: rpj (at) callisto.canberra.edu.au
     15  *
     16  *      The current list of contributors is contained
     17  *      in the file CONTRIBUTORS included with the source
     18  *      code distribution. The list can also be seen at the
     19  *      following World Wide Web location:
     20  *      http://sources.redhat.com/pthreads-win32/contributors.html
     21  *
     22  *      This library is free software; you can redistribute it and/or
     23  *      modify it under the terms of the GNU Lesser General Public
     24  *      License as published by the Free Software Foundation; either
     25  *      version 2 of the License, or (at your option) any later version.
     26  *
     27  *      This library is distributed in the hope that it will be useful,
     28  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
     29  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     30  *      Lesser General Public License for more details.
     31  *
     32  *      You should have received a copy of the GNU Lesser General Public
     33  *      License along with this library in the file COPYING.LIB;
     34  *      if not, write to the Free Software Foundation, Inc.,
     35  *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
     36  */
     37 
     38 #include "pthread.h"
     39 #include "implement.h"
     40 
     41 
     42 int
     43 pthread_condattr_getpshared (const pthread_condattr_t * attr, int *pshared)
     44      /*
     45       * ------------------------------------------------------
     46       * DOCPUBLIC
     47       *      Determine whether condition variables created with 'attr'
     48       *      can be shared between processes.
     49       *
     50       * PARAMETERS
     51       *      attr
     52       *              pointer to an instance of pthread_condattr_t
     53       *
     54       *      pshared
     55       *              will be set to one of:
     56       *
     57       *                      PTHREAD_PROCESS_SHARED
     58       *                              May be shared if in shared memory
     59       *
     60       *                      PTHREAD_PROCESS_PRIVATE
     61       *                              Cannot be shared.
     62       *
     63       *
     64       * DESCRIPTION
     65       *      Condition Variables created with 'attr' can be shared
     66       *      between processes if pthread_cond_t variable is allocated
     67       *      in memory shared by these processes.
     68       *      NOTES:
     69       *      1)      pshared condition variables MUST be allocated in
     70       *              shared memory.
     71       *
     72       *      2)      The following macro is defined if shared mutexes
     73       *              are supported:
     74       *                      _POSIX_THREAD_PROCESS_SHARED
     75       *
     76       * RESULTS
     77       *              0               successfully retrieved attribute,
     78       *              EINVAL          'attr' or 'pshared' is invalid,
     79       *
     80       * ------------------------------------------------------
     81       */
     82 {
     83   int result;
     84 
     85   if ((attr != NULL && *attr != NULL) && (pshared != NULL))
     86     {
     87       *pshared = (*attr)->pshared;
     88       result = 0;
     89     }
     90   else
     91     {
     92       result = EINVAL;
     93     }
     94 
     95   return result;
     96 
     97 }				/* pthread_condattr_getpshared */
     98