/usr/include/sipxtapi/os/OsWriteLock.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 90  | //
// 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 _OsWriteLock_h_
#define _OsWriteLock_h_
// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "OsRWMutex.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
//:Lock class allowing exclusive access for a writer within a critical section
// This class uses OsRWMutex objects for synchronization. The constructor
// for the class automatically blocks until the OsRWMutex is acquired
// for writing. Similarly, the destructor automatically releases the lock.
// <p>
// 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
// lock the resource for writing. When the OsWriteLock object goes out of
// scope, the writer lock will be automatically released.
// An example of this form of use is shown below.
// <p>
// <font face="courier">
//                         someMethod()                    <br>
//                         {                               <br>
//            OsWriteLock lock(myRWMutex);  <br>
//                                                                   <br>
//            < section that needs to be
//                                       locked for writing >        <br>
//                         }                               </font>
class OsWriteLock
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
/* ============================ CREATORS ================================== */
   OsWriteLock(OsRWMutex& rRWMutex)
                : mrRWMutex(rRWMutex) { rRWMutex.acquireWrite(); };
     //:Constructor
   virtual
   ~OsWriteLock()  { mrRWMutex.releaseWrite(); };
     //:Destructor
/* ============================ MANIPULATORS ============================== */
/* ============================ ACCESSORS ================================= */
/* ============================ INQUIRY =================================== */
/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
   OsRWMutex& mrRWMutex;
   OsWriteLock();
     //:Default constructor (not implemented for this class)
   OsWriteLock(const OsWriteLock& rOsWriteLock);
     //:Copy constructor (not implemented for this class)
   OsWriteLock& operator=(const OsWriteLock& rhs);
     //:Assignment operator (not implemented for this class)
};
/* ============================ INLINE METHODS ============================ */
#endif  // _OsWriteLock_h_
 |