/usr/include/x86_64-linux-gnu/qcc/windows/RWLock.h is in liballjoyn-common-dev-1504 15.04b-8.
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 | /**
* @file
*
* Define a class that abstracts Windows file locks.
*/
/******************************************************************************
* Copyright AllSeen Alliance. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
******************************************************************************/
#ifndef _OS_QCC_RWLOCK_H
#define _OS_QCC_RWLOCK_H
#include <qcc/platform.h>
#include <Status.h>
namespace qcc {
/**
* The Windows implementation of a Rwlock abstraction class.
*/
class RWLock {
public:
/**
* The constructor initializes the underlying rwlock implementation.
*/
RWLock() { Init(); }
/**
* The destructor will destroy the underlying rwlock.
*/
~RWLock();
/**
* Acquires a lock on the rwlock. If another thread is holding the lock,
* then this function will block until the other thread has released its
* lock.
*
* @return ER_OK if the lock was acquired, ER_INIT_FAILED if there was a
* failure to initialize the lock.
*/
QStatus RDLock();
QStatus WRLock();
/**
* Releases a lock on the rwlock. This will only release a lock for the
* current thread if that thread was the one that aquired the lock in the
* first place.
*
* @return ER_OK if the lock was released, ER_INIT_FAILED if there was a
* failure to initialize the lock.
*/
QStatus Unlock();
/**
* Attempt to acquire a lock on a rwlock. If another thread is holding the lock
* this function return false otherwise the lock is acquired and the function returns true.
*
* @return True if the lock was acquired.
*/
bool TryRDLock();
bool TryWRLock();
/**
* Rwlock copy constructor creates a new rwlock.
*/
RWLock(const RWLock&) { Init(); }
/**
* Rwlock assignment operator.
*/
RWLock& operator=(const RWLock&) { Init(); return *this; }
private:
SRWLOCK rwlock; ///< The Windows "slim reader/writer" (SRW) lock object.
bool isInitialized; ///< true iff rwlock was successfully initialized.
bool isWriteLock; ///< true if the lock is being used to write.
void Init(); ///< Initialize underlying OS rwlock
};
} /* namespace */
#endif
|