/usr/include/terralib/kernel/TeSemaphore.h is in libterralib-dev 4.3.0+dfsg.2-10.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 | /************************************************************************************
TerraLib - a library for developing GIS applications.
Copyright © 2001-2007 INPE and Tecgraf/PUC-Rio.
This code is part of the TerraLib library.
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.1 of the License, or (at your option) any later version.
You should have received a copy of the GNU Lesser General Public
License along with this library.
The authors reassure the license terms regarding the warranties.
They specifically disclaim any warranties, including, but not limited to,
the implied warranties of merchantability and fitness for a particular purpose.
The library provided hereunder is on an "as is" basis, and the authors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.
In no event shall INPE and Tecgraf / PUC-Rio be held liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this library and its documentation.
*************************************************************************************/
#ifndef TESEMAPHORE_H
#define TESEMAPHORE_H
#include "TeDefines.h"
#include "TeAgnostic.h"
#include "TeDefines.h"
#if TePLATFORM == TePLATFORMCODE_MSWINDOWS
#include <windows.h>
#elif TePLATFORM == TePLATFORMCODE_LINUX || TePLATFORM == TePLATFORMCODE_AIX
#include <semaphore.h>
#else
#error "ERROR: Unsupported platform"
#endif
/**
* @brief Inter process communication semaphore.
* @author Emiliano F. Castejon <castejon@dpi.inpe.br>
* @ingroup MultProgToolsGroup
*/
class TL_DLL TeSemaphore
{
public :
/**
* @brief Creates an unnamed semaphore.
* @param count Semaphore initial counter value.
*/
TeSemaphore( unsigned int count );
/**
* @brief Creates an named semaphore.
* @param count Semaphore initial counter value.
* @param semName Semaphore name.
* @note Creates a new semaphore or opens an existing semaphore
* that can be shared among processes.
*/
TeSemaphore( unsigned int count, const std::string& semName );
/**
* @brief Default destructor.
*/
~TeSemaphore();
/**
* @brief Increments the semaphore's counter.
*/
inline void post()
{
#if TePLATFORM == TePLATFORMCODE_MSWINDOWS
TEAGN_TRUE_OR_THROW( ReleaseSemaphore( semHandlerPtr_, 1, 0 ),
"Error in semaphore post" );
#elif TePLATFORM == TePLATFORMCODE_LINUX || TePLATFORM == TePLATFORMCODE_AIX
TEAGN_TRUE_OR_THROW( 0 == sem_post( semHandlerPtr_ ),
"Error in semaphore post" );
#else
#error "Unsuported plataform"
#endif
};
/**
* @brief Wait the semaphore's counter to become zero.
* @note If the semaphore's value is greater than zero, then the
* decrement proceeds, and the function returns, immediately.
* If the semaphore currently has the value zero, then the call blocks
* until either it becomes possible to perform the decrement.
*/
inline void wait()
{
#if TePLATFORM == TePLATFORMCODE_MSWINDOWS
TEAGN_TRUE_OR_THROW( WAIT_OBJECT_0 == WaitForSingleObject(
semHandlerPtr_, INFINITE ), "Error waiting semaphore" );
#elif TePLATFORM == TePLATFORMCODE_LINUX || TePLATFORM == TePLATFORMCODE_AIX
TEAGN_TRUE_OR_THROW( 0 == sem_wait( semHandlerPtr_ ),
"Error in semaphore wait" );
#else
#error "Unsuported plataform"
#endif
};
/**
* @brief Wait the semaphore's counter to become zero.
* @param waitingTime The maximum waiting time in milliseconds
* ( 0 == INFINITE ).
* @return true if the semaphore's counter is zero or false
* if the waiting time has finished or an error occurred.
*/
bool wait( unsigned int waitingTime );
protected :
#if TePLATFORM == TePLATFORMCODE_MSWINDOWS
/** A pointer to the handler instance. */
HANDLE semHandlerPtr_;
#elif TePLATFORM == TePLATFORMCODE_LINUX || TePLATFORM == TePLATFORMCODE_AIX
/** A pointer to the handler instance. */
sem_t* semHandlerPtr_;
#else
#error "Unsuported plataform"
#endif
/** This instance name */
std::string semName_;
private :
/**
* Alternative constructor.
*/
TeSemaphore( const TeSemaphore& ) {};
/**
* operator= overload.
* @return A const reference to the current instance.
*/
const TeSemaphore& operator=( const TeSemaphore& ) { return *this; };
};
#endif
|