Subversion Repositories openrisc

#ifndef CYGONCE_POSIX_MUTEX_H

#define CYGONCE_POSIX_MUTEX_H

//=============================================================================

//

//      mutex.h

//

//      POSIX mutex and condition variable function definitions

//

//=============================================================================

// ####ECOSGPLCOPYRIGHTBEGIN####                                            

// -------------------------------------------                              

// This file is part of eCos, the Embedded Configurable Operating System.   

// Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.

//

// eCos is free software; you can redistribute it and/or modify it under    

// the terms of the GNU General Public License as published by the Free     

// Software Foundation; either version 2 or (at your option) any later      

// version.                                                                 

//

// eCos 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 General Public License    

// for more details.                                                        

//

// You should have received a copy of the GNU General Public License        

// along with eCos; if not, write to the Free Software Foundation, Inc.,    

// 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.            

//

// As a special exception, if other files instantiate templates or use      

// macros or inline functions from this file, or you compile this file      

// and link it with other works to produce a work based on this file,       

// this file does not by itself cause the resulting work to be covered by   

// the GNU General Public License. However the source code for this file    

// must still be made available in accordance with section (3) of the GNU   

// General Public License v2.                                               

//

// This exception does not invalidate any other reasons why a work based    

// on this file might be covered by the GNU General Public License.         

// -------------------------------------------                              

// ####ECOSGPLCOPYRIGHTEND####                                              

//=============================================================================

//#####DESCRIPTIONBEGIN####

//

// Author(s):     nickg,jlarmour

// Contributors:  

// Date:          2001-09-10

// Purpose:       POSIX mutex and condition variable function definitions

// Description:   This header contains POSIX API definitions for mutexes

//                and cond vars.

//              

// Usage:         #include <pthread.h>

//              

//

//####DESCRIPTIONEND####

//

//=============================================================================

#include <pkgconf/posix.h>

#include <sys/types.h>   // pthread_* types

#include <time.h>

//=============================================================================

// Mutexes

//-----------------------------------------------------------------------------

// Mutex attributes manipulation functions

// Initialize attribute object

externC int pthread_mutexattr_init ( pthread_mutexattr_t *attr);

// Destroy attribute object

externC int pthread_mutexattr_destroy ( pthread_mutexattr_t *attr);

#if defined(_POSIX_THREAD_PRIO_INHERIT) || defined(_POSIX_THREAD_PRIO_PROTECT)

// Set priority inversion protection protocol

externC int pthread_mutexattr_setprotocol ( pthread_mutexattr_t *attr,

                                            int protocol);

// Get priority inversion protection protocol

externC int pthread_mutexattr_getprotocol ( pthread_mutexattr_t *attr,

                                            int *protocol);

#if defined(_POSIX_THREAD_PRIO_PROTECT)

// Set priority for priority ceiling protocol

externC int pthread_mutexattr_setprioceiling ( pthread_mutexattr_t *attr,

                                               int prioceiling);

// Get priority for priority ceiling protocol

externC int pthread_mutexattr_getprioceiling ( pthread_mutexattr_t *attr,

                                               int *prioceiling);

// Set priority ceiling of given thread, returning old ceiling.

externC int pthread_mutex_setprioceiling( pthread_mutex_t *mutex,

                                          int prioceiling,

                                          int *old_ceiling);

// Get priority ceiling of given thread

externC int pthread_mutex_getprioceiling( pthread_mutex_t *mutex,

                                          int *prioceiling);

#endif

#endif

//-----------------------------------------------------------------------------

// Mutex functions

// Initialize mutex. If mutex_attr is NULL, use default attributes.

externC int pthread_mutex_init (pthread_mutex_t *mutex,

                                const pthread_mutexattr_t *mutex_attr);

// Destroy mutex.

externC int pthread_mutex_destroy (pthread_mutex_t *mutex);

// Lock mutex, waiting for it if necessary.

externC int pthread_mutex_lock (pthread_mutex_t *mutex);

// Try to lock mutex.

externC int pthread_mutex_trylock (pthread_mutex_t *mutex);

// Unlock mutex.

externC int pthread_mutex_unlock (pthread_mutex_t *mutex);

//=============================================================================

// Condition Variables

//-----------------------------------------------------------------------------

// Attribute manipulation functions

// We do not actually support any attributes at present, so these do nothing.

// Initialize condition variable attributes

externC int pthread_condattr_init (pthread_condattr_t *attr);

// Destroy condition variable attributes

externC int pthread_condattr_destroy (pthread_condattr_t *attr);

//-----------------------------------------------------------------------------

// Condition variable functions

// Initialize condition variable.

externC int pthread_cond_init (pthread_cond_t *cond,

                               const pthread_condattr_t *attr);

// Destroy condition variable.

externC int pthread_cond_destroy (pthread_cond_t *cond);

// Wake up one thread waiting for condition variable

externC int pthread_cond_signal (pthread_cond_t *cond);

// Wake up all threads waiting for condition variable

externC int pthread_cond_broadcast (pthread_cond_t *cond);

// Block on condition variable until signalled. The mutex is

// assumed to be locked before this call, will be unlocked

// during the wait, and will be re-locked on wakeup.

externC int pthread_cond_wait (pthread_cond_t *cond,

                               pthread_mutex_t *mutex);

// Block on condition variable until signalled, or the timeout expires.

externC int pthread_cond_timedwait (pthread_cond_t *cond,

                                    pthread_mutex_t *mutex,

                                    const struct timespec *abstime);

//-----------------------------------------------------------------------------

#endif // ifndef CYGONCE_POSIX_MUTEX_H

// End of mutex.h