15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/*
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pthread_condattr_getpshared.c
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Description:
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This translation unit implements condition variables and their primitives.
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * --------------------------------------------------------------------------
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      Pthreads-win32 - POSIX Threads Library for Win32
115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      Copyright(C) 1998 John E. Bossom
125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      Copyright(C) 1999,2005 Pthreads-win32 contributors
135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      Contact Email: rpj@callisto.canberra.edu.au
155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      The current list of contributors is contained
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      in the file CONTRIBUTORS included with the source
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      code distribution. The list can also be seen at the
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      following World Wide Web location:
205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      http://sources.redhat.com/pthreads-win32/contributors.html
215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      This library is free software; you can redistribute it and/or
235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      modify it under the terms of the GNU Lesser General Public
245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      License as published by the Free Software Foundation; either
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      version 2 of the License, or (at your option) any later version.
265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      This library is distributed in the hope that it will be useful,
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      but WITHOUT ANY WARRANTY; without even the implied warranty of
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      Lesser General Public License for more details.
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      You should have received a copy of the GNU Lesser General Public
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      License along with this library in the file COPYING.LIB;
345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      if not, write to the Free Software Foundation, Inc.,
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "pthread.h"
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "implement.h"
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)pthread_condattr_getpshared (const pthread_condattr_t * attr, int *pshared)
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)     /*
455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * ------------------------------------------------------
465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * DOCPUBLIC
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      Determine whether condition variables created with 'attr'
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      can be shared between processes.
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * PARAMETERS
515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      attr
525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              pointer to an instance of pthread_condattr_t
535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      pshared
555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              will be set to one of:
565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *                      PTHREAD_PROCESS_SHARED
585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *                              May be shared if in shared memory
595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *                      PTHREAD_PROCESS_PRIVATE
615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *                              Cannot be shared.
625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * DESCRIPTION
655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      Condition Variables created with 'attr' can be shared
665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      between processes if pthread_cond_t variable is allocated
675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      in memory shared by these processes.
685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      NOTES:
695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      1)      pshared condition variables MUST be allocated in
705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              shared memory.
715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *      2)      The following macro is defined if shared mutexes
735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              are supported:
745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *                      _POSIX_THREAD_PROCESS_SHARED
755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * RESULTS
775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              0               successfully retrieved attribute,
785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *              EINVAL          'attr' or 'pshared' is invalid,
795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *
805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      * ------------------------------------------------------
815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      */
825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){
835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  int result;
845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  if ((attr != NULL && *attr != NULL) && (pshared != NULL))
865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    {
875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      *pshared = (*attr)->pshared;
885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      result = 0;
895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    }
905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  else
915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    {
925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      result = EINVAL;
935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    }
945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  return result;
965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}				/* pthread_condattr_getpshared */
98