/usr/include/sipxtapi/os/OsServerTask.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 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 | //
// 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 _OsServerTask_h_
#define _OsServerTask_h_
// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "os/OsDefs.h"
#include "os/OsStatus.h"
#include "os/OsTask.h"
#include "os/OsTime.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
class OsMsg;
//:Abstract base class for tasks that process incoming msgs from an OsMsgQ
class OsServerTask : public OsTask
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
static const int DEF_MAX_MSGS;
/* ============================ CREATORS ================================== */
/// @brief Main constructor for OsServerTask
OsServerTask(const UtlString& name="",
void* pArg=NULL,
const int maxRequestQMsgs=DEF_MAX_MSGS,
const int priority=DEF_PRIO,
const int options=DEF_OPTIONS,
const int stackSize=DEF_STACKSIZE);
/**<
* @param[in] name - the name of this OsServerTask
* @param[in] pArg - argument that is passed to the new thread as a
parameter of the thread run method.
* @param[in] maxRequestQMsgs - defines the size of the request message queue.
* @param[in] priority - the thread priority to use. high = 0, low = 255
* @param[in] options - Thread execution options to set, such as whether
* to allow breakpoint debugging.
* @param[in] stackSize - The stack size to use for this task.
*/
virtual
~OsServerTask();
//:Destructor
// As part of destroying the task, flush all messages from the incoming
// OsMsgQ.
/* ============================ MANIPULATORS ============================== */
virtual UtlBoolean handleMessage(OsMsg& rMsg) = 0;
//:Handles an incoming message
// If the message is not one that the object is prepared to process,
// the handleMessage() method in the derived class should return FALSE
// which will cause the OsMessageTask::handleMessage() method to be
// invoked on the message.
virtual OsStatus postMessage(const OsMsg& rMsg,
const OsTime& rTimeout=OsTime::OS_INFINITY,
UtlBoolean sentFromISR=FALSE);
//:Posts a message to this task
// Return the result of the message send operation.
virtual void requestShutdown(void);
//:Call OsTask::requestShutdown() and then post an OS_SHUTDOWN message
//:to the incoming message queue to unblock the task
/* ============================ ACCESSORS ================================= */
OsMsgQ* getMessageQueue();
//:Get the pointer to the incoming message queue
/* ============================ INQUIRY =================================== */
/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
OsMsgQ mIncomingQ; // Queue for incoming messages.
virtual OsStatus receiveMessage(OsMsg*& rpMsg);
//:Waits for a message to arrive on the task's incoming message queue
virtual OsStatus receiveMessage(OsMsg*& rpMsg,
const OsTime& rTimeout);
//:Waits for a message to arrive on the task's incoming message queue,
// with timeout.
virtual int run(void* pArg);
//:The entry point for the task
// This method executes a message processing loop until either
// requestShutdown(), deleteForce(), or the destructor for this object
// is called.
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
OsServerTask(const OsServerTask& rOsServerTask);
//:Copy constructor (not implemented for this class)
OsServerTask& operator=(const OsServerTask& rhs);
//:Assignment operator (not implemented for this task)
};
/* ============================ INLINE METHODS ============================ */
#endif // _OsServerTask_h_
|