/usr/include/sipxtapi/os/OsProtectEvent.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 | //
// 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 _OsProtectedEvent_h_
#define _OsProtectedEvent_h_
#include "os/OsEvent.h"
#include "os/OsBSem.h"
#include "os/OsTime.h"
#include "utl/UtlString.h"
//#define TAO_DEBUG
class OsProtectedEvent : public OsEvent
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
/* ============================ CREATORS ================================== */
OsProtectedEvent(const intptr_t userData=0);
virtual ~OsProtectedEvent();
/* ============================ MANIPULATORS ============================== */
virtual OsStatus signal(const intptr_t eventData);
//:Set the event data and signal the occurrence of the event
// Return OS_ALREADY_SIGNALED if the event has already been signaled
// (and has not yet been cleared), otherwise return OS_SUCCESS.
virtual OsStatus reset(void);
//:Reset the event so that it may be signaled again
// Return OS_NOT_SIGNALED if the event has not been signaled (or has
// already been cleared), otherwise return OS_SUCCESS.
virtual OsStatus wait(int msgId, const OsTime& rTimeout=OsTime::OS_INFINITY);
//:Wait for the event to be signaled
// Return OS_BUSY if the timeout expired, otherwise return OS_SUCCESS.
void setStringData(UtlString& rStringData);
void setIntData(intptr_t rIntData);
void setIntData2(intptr_t rIntData);
void setInUse(UtlBoolean inUse);
/* ============================ ACCESSORS ================================= */
OsStatus getStringData(UtlString& data);
//:Return the user data specified when this object was constructed.
// Always returns OS_SUCCESS.
OsStatus getIntData(intptr_t& data);
OsStatus getIntData2(intptr_t& data);
//:Return the user data specified when this object was constructed.
// Always returns OS_SUCCESS.
/* ============================ INQUIRY =================================== */
virtual UtlBoolean isInUse();
//:Return TRUE if the event has been signaled, otherwise FALSE
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
OsBSem mRefSem; ///< semaphore used to protect mRef
UtlString mStringData;
intptr_t mIntData;
intptr_t mIntData2;
int mRef; ///< reference count
};
#endif // _OsProtectedEvent_h_
|