/usr/include/sipxtapi/os/OsReadLock.h is in libsipxtapi-dev 3.3.0~test17-1.
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 | //
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
#ifndef _OsReadLock_h_
#define _OsReadLock_h_
// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "OsRWMutex.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
//:Lock class allowing multiple simultaneous readers within a critical section
// This class uses OsRWMutex objects for synchronization.
// The constructor for the class automatically blocks until the OsRWMutex
// is acquired for reading. Similarly, the destructor automatically releases
// the lock. The easiest way to use this object as a guard is to create the
// object as a variable on the stack just before the section that needs to
// support multiple simultaneous readers. When the OsReadLock object goes out
// of scope, the reader lock will be automatically released.
// An example of this form of use is shown below.
// <p>
// <font face="courier">
// someMethod() <br>
// { <br>
// OsReadLock lock(myRWMutex); <br>
// <br>
// < section allowing multiple
// simultaneous readers > <br>
// } </font>
class OsReadLock
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
/* ============================ CREATORS ================================== */
OsReadLock(OsRWMutex& rRWMutex)
: mrRWMutex(rRWMutex) { rRWMutex.acquireRead(); };
//:Constructor
virtual
~OsReadLock() { mrRWMutex.releaseRead(); };
//:Destructor
/* ============================ MANIPULATORS ============================== */
/* ============================ ACCESSORS ================================= */
/* ============================ INQUIRY =================================== */
/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
OsRWMutex& mrRWMutex;
OsReadLock();
//:Default constructor (not implemented for this class)
OsReadLock(const OsReadLock& rOsReadLock);
//:Copy constructor (not implemented for this class)
OsReadLock& operator=(const OsReadLock& rhs);
//:Assignment operator (not implemented for this class)
};
/* ============================ INLINE METHODS ============================ */
#endif // _OsReadLock_h_
|