/usr/include/sipxtapi/tapi/SipXEventDispatcher.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 94 95 96 97 98 99 100 101 102 | //
// Copyright (C) 2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2006 Robert J. Andreasen, Jr.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
//////////////////////////////////////////////////////////////////////////////
#ifndef _SIPXEVENTDISPATCHER_H_
#define _SIPXEVENTDISPATCHER_H_
// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "os/OsServerTask.h"
#include "tapi/sipXtapi.h"
#include "tapi/sipXtapiEvents.h"
#include "utl/UtlHashMap.h"
#include "os/OsRWMutex.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// CONSTANTS
// STRUCTS
// TYPEDEFS
typedef struct
{
SIPX_INST hInst ;
SIPX_EVENT_CALLBACK_PROC pCallbackProc ;
void* pUserData ;
} SIPX_EVENT_LISTENER_CONTEXT ;
// MACROS
// FORWARD DECLARATIONS
class OsEventMsg ;
/**
* The SipXEventDispatcher adds a listener to sipXtapi and then redispatches
* all of the sipXtapi events on its own callback. Ideally, this should be
* part of sipXtapi -- however, I don't want to change the behavior at this
* time. Also, solutions for the TODOs below are needed.
*
* TODO:
*
* - The S/MIME (and TLS?) code expects a return value. This should be broken
* into a new/different callback. Right now, that functionality is lost
* and I believe we will accept all certificates (return true at end of
* SipXEventDispatcher::EventCallBack.
*
* - Some synchronization is required on the CALL_DESTROY (perhaps other
* final events). Right now, the call could be removed from sipXtapi's
* internal bookkeeping structures before the application has the ability
* to handle the event. I believe we should have some sort of "ACK" to the
* call final events (perhaps after it is dispatched from here) and the
* call should not be freed up in sipXtapi until after that ACK. Today,
* the call handle is freed in the fire***Event method in
* sipXtapiEvents.cpp.
*/
class SipXEventDispatcher : public OsServerTask
{
public:
/* ============================ CREATORS ================================== */
SipXEventDispatcher(SIPX_INST hInst);
virtual ~SipXEventDispatcher(void);
/* ============================ MANIPULATORS ============================== */
/**
* Implementation of OsServerTask's pure virtual method
*/
UtlBoolean handleMessage(OsMsg& rMsg);
bool addListener(SIPX_EVENT_CALLBACK_PROC pCallbackProc,
void* pUserData) ;
bool removeListener(SIPX_EVENT_CALLBACK_PROC pCallbackProc,
void* pUserData) ;
void removeAllListeners() ;
void serviceListeners(SIPX_EVENT_CATEGORY category,
void* pInfo) ;
void setInstanceHandle(SIPX_INST hNew) ;
protected:
static bool SIPX_CALLING_CONVENTION EventCallBack(SIPX_EVENT_CATEGORY category,
void* pInfo,
void* pUserData);
private:
SIPX_INST mhInst ;
UtlHashMap mListeners ;
OsRWMutex mListenerLock;
};
#endif // _SIPXEVENTDISPATCHER_H_
|