/usr/include/sipxtapi/os/OsLock.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 91 92 93 | //
// Copyright (C) 2006 SIPez LLC.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// 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 _OsLock_h_
#define _OsLock_h_
// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "OsSyncBase.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
/**
* @brief Lock class for mutual exclusion in a critical section.
*
* This class uses OsSyncBase objects for synchronization.
* The constructor for the class automatically blocks until the designated
* semaphore is acquired. Similarly, the destructor automatically releases
* the lock. The easiest way to use this object as a guard for a critical
* section is to create the object as a variable on the stack just before
* the critical section. When the variable goes out of scope, the lock will
* be automatically released. An example of this form of use is shown below.
*
* <code>
* someMethod() <br>
* { <br>
* OsLock lock(myBSemaphore); <br>
* <br>
* < critical section > <br>
* }
* </code>
*/
class OsLock
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
/* ============================ CREATORS ================================== */
/// Constructor
OsLock(OsSyncBase& rSemaphore)
: mrSemaphore(rSemaphore) { rSemaphore.acquire(); };
/// Destructor
virtual
~OsLock() { mrSemaphore.release(); };
/* ============================ MANIPULATORS ============================== */
/* ============================ ACCESSORS ================================= */
/* ============================ INQUIRY =================================== */
/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
OsSyncBase& mrSemaphore;
/// Default constructor (not implemented for this class)
OsLock();
/// Copy constructor (not implemented for this class)
OsLock(const OsLock& rOsLock);
/// Assignment operator (not implemented for this class)
OsLock& operator=(const OsLock& rhs);
};
/* ============================ INLINE METHODS ============================ */
#endif // _OsLock_h_
|