/* * condvar_attr_destroy.c * * Description: * This translation unit implements condition variables and their primitives. * * * -------------------------------------------------------------------------- * * Pthreads-embedded (PTE) - POSIX Threads Library for embedded systems * Copyright(C) 2008 Jason Schmidlapp * * Contact Email: jschmidlapp@users.sourceforge.net * * * Based upon Pthreads-win32 - POSIX Threads Library for Win32 * Copyright(C) 1998 John E. Bossom * Copyright(C) 1999,2005 Pthreads-win32 contributors * * Contact Email: rpj@callisto.canberra.edu.au * * The original list of contributors to the Pthreads-win32 project * is contained in the file CONTRIBUTORS.ptw32 included with the * source code distribution. The list can also be seen at the * following World Wide Web location: * http://sources.redhat.com/pthreads-win32/contributors.html * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library in the file COPYING.LIB; * if not, write to the Free Software Foundation, Inc., * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA */ #include #include "pthread.h" #include "implement.h" int pthread_condattr_destroy (pthread_condattr_t * attr) /* * ------------------------------------------------------ * DOCPUBLIC * Destroys a condition variable attributes object. * The object can no longer be used. * * PARAMETERS * attr * pointer to an instance of pthread_condattr_t * * * DESCRIPTION * Destroys a condition variable attributes object. * The object can no longer be used. * * NOTES: * 1) Does not affect condition variables created * using 'attr' * * RESULTS * 0 successfully released attr, * EINVAL 'attr' is invalid. * * ------------------------------------------------------ */ { int result = 0; if (attr == NULL || *attr == NULL) result = EINVAL; else { (void) free (*attr); *attr = NULL; result = 0; } return result; } int pthread_condattr_getpshared (const pthread_condattr_t * attr, int *pshared) /* * ------------------------------------------------------ * DOCPUBLIC * Determine whether condition variables created with 'attr' * can be shared between processes. * * PARAMETERS * attr * pointer to an instance of pthread_condattr_t * * pshared * will be set to one of: * * PTHREAD_PROCESS_SHARED * May be shared if in shared memory * * PTHREAD_PROCESS_PRIVATE * Cannot be shared. * * * DESCRIPTION * Condition Variables created with 'attr' can be shared * between processes if pthread_cond_t variable is allocated * in memory shared by these processes. * NOTES: * 1) pshared condition variables MUST be allocated in * shared memory. * * 2) The following macro is defined if shared mutexes * are supported: * _POSIX_THREAD_PROCESS_SHARED * * RESULTS * 0 successfully retrieved attribute, * EINVAL 'attr' or 'pshared' is invalid, * * ------------------------------------------------------ */ { int result; if ((attr != NULL && *attr != NULL) && (pshared != NULL)) { *pshared = (*attr)->pshared; result = 0; } else result = EINVAL; return result; } int pthread_condattr_init (pthread_condattr_t * attr) /* * ------------------------------------------------------ * DOCPUBLIC * Initializes a condition variable attributes object * with default attributes. * * PARAMETERS * attr * pointer to an instance of pthread_condattr_t * * * DESCRIPTION * Initializes a condition variable attributes object * with default attributes. * * NOTES: * 1) Use to define condition variable types * 2) It is up to the application to ensure * that it doesn't re-init an attribute * without destroying it first. Otherwise * a memory leak is created. * * RESULTS * 0 successfully initialized attr, * ENOMEM insufficient memory for attr. * * ------------------------------------------------------ */ { pthread_condattr_t attr_result; int result = 0; attr_result = (pthread_condattr_t) calloc (1, sizeof (*attr_result)); if (attr_result == NULL) result = ENOMEM; *attr = attr_result; return result; } int pthread_condattr_setpshared (pthread_condattr_t * attr, int pshared) /* * ------------------------------------------------------ * DOCPUBLIC * Mutexes created with 'attr' can be shared between * processes if pthread_mutex_t variable is allocated * in memory shared by these processes. * * PARAMETERS * attr * pointer to an instance of pthread_mutexattr_t * * pshared * must be one of: * * PTHREAD_PROCESS_SHARED * May be shared if in shared memory * * PTHREAD_PROCESS_PRIVATE * Cannot be shared. * * DESCRIPTION * Mutexes creatd with 'attr' can be shared between * processes if pthread_mutex_t variable is allocated * in memory shared by these processes. * * NOTES: * 1) pshared mutexes MUST be allocated in shared * memory. * * 2) The following macro is defined if shared mutexes * are supported: * _POSIX_THREAD_PROCESS_SHARED * * RESULTS * 0 successfully set attribute, * EINVAL 'attr' or pshared is invalid, * ENOSYS PTHREAD_PROCESS_SHARED not supported, * * ------------------------------------------------------ */ { int result; if ((attr != NULL && *attr != NULL) && ((pshared == PTHREAD_PROCESS_SHARED) || (pshared == PTHREAD_PROCESS_PRIVATE))) { if (pshared == PTHREAD_PROCESS_SHARED) { #if !defined( _POSIX_THREAD_PROCESS_SHARED ) result = ENOSYS; pshared = PTHREAD_PROCESS_PRIVATE; #else result = 0; #endif /* _POSIX_THREAD_PROCESS_SHARED */ } else result = 0; (*attr)->pshared = pshared; } else result = EINVAL; return result; }