This file is indexed.

/usr/include/sipxtapi/os/OsLock.h is in libsipxtapi-dev 3.3.0~test17-2.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>
 * &nbsp;&nbsp;                      someMethod()                    <br>
 * &nbsp;&nbsp;                      {                               <br>
 * &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;      OsLock lock(myBSemaphore);    <br>
 *                                                                   <br>
 * &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;      < critical section >          <br>
 * &nbsp;&nbsp;                      }                               
 * </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_