version 1.47, 2005/05/18 15:56:51
|
version 1.67, 2008/11/03 09:45:23
|
|
|
//%2005//////////////////////////////////////////////////////////////////////// |
//%2006//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development | // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. | // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
|
|
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. | // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; | // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
// EMC Corporation; VERITAS Software Corporation; The Open Group. | // EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy | // Permission is hereby granted, free of charge, to any person obtaining a copy |
// of this software and associated documentation files (the "Software"), to | // of this software and associated documentation files (the "Software"), to |
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Mike Day (mdday@us.ibm.com) |
|
// |
|
// Modified By: David Dillard, VERITAS Software Corp. |
|
// (david.dillard@veritas.com) |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#ifndef Pegasus_MessageQueue_Service_h | #ifndef Pegasus_MessageQueue_Service_h |
|
|
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
#include <Pegasus/Common/Message.h> | #include <Pegasus/Common/Message.h> |
#include <Pegasus/Common/InternalException.h> | #include <Pegasus/Common/InternalException.h> |
#include <Pegasus/Common/IPC.h> |
|
#include <Pegasus/Common/Thread.h> | #include <Pegasus/Common/Thread.h> |
|
#include <Pegasus/Common/ThreadPool.h> |
#include <Pegasus/Common/AsyncOpNode.h> | #include <Pegasus/Common/AsyncOpNode.h> |
#include <Pegasus/Common/Cimom.h> | #include <Pegasus/Common/Cimom.h> |
|
#include <Pegasus/Common/Mutex.h> |
#include <Pegasus/Common/CimomMessage.h> | #include <Pegasus/Common/CimomMessage.h> |
#include <Pegasus/Common/Linkage.h> | #include <Pegasus/Common/Linkage.h> |
|
#include <Pegasus/Common/Mutex.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
extern const Uint32 CIMOM_Q_ID; | extern const Uint32 CIMOM_Q_ID; |
| |
class message_module; | class message_module; |
|
class cimom; |
| |
class PEGASUS_COMMON_LINKAGE MessageQueueService : public MessageQueue |
|
|
class PEGASUS_COMMON_LINKAGE MessageQueueService : |
|
public Linkable, public MessageQueue |
{ | { |
public: | public: |
| |
typedef MessageQueue Base; | typedef MessageQueue Base; |
| |
MessageQueueService(const char *name, |
MessageQueueService( |
Uint32 queueID = MessageQueue::getNextQueueId(), |
const char* name, |
Uint32 capabilities = 0, |
Uint32 queueID = MessageQueue::getNextQueueId()); |
Uint32 mask = message_mask::type_cimom | |
|
message_mask::type_service | |
|
message_mask::ha_request | |
|
message_mask::ha_reply | |
|
message_mask::ha_async ); |
|
| |
virtual ~MessageQueueService(); | virtual ~MessageQueueService(); |
| |
virtual Boolean isAsync() const { return true; } | virtual Boolean isAsync() const { return true; } |
| |
// enqueue may throw an IPCException |
|
virtual void enqueue(Message *); | virtual void enqueue(Message *); |
| |
AsyncReply *SendWait(AsyncRequest *request); | AsyncReply *SendWait(AsyncRequest *request); |
|
|
MessageQueue *callback_q, | MessageQueue *callback_q, |
void *callback_ptr); | void *callback_ptr); |
| |
Boolean SendAsync(Message *msg, |
|
Uint32 destination, |
|
void (*callback)(Message *response, void *handle, void *parameter), |
|
void *handle, |
|
void *parameter); |
|
|
|
Boolean SendForget(Message *msg); | Boolean SendForget(Message *msg); |
Boolean ForwardOp(AsyncOpNode *, Uint32 destination); |
|
|
|
| |
Boolean register_service(String name, Uint32 capabilities, Uint32 mask); |
|
Boolean update_service(Uint32 capabilities, Uint32 mask); | Boolean update_service(Uint32 capabilities, Uint32 mask); |
Boolean deregister_service(); | Boolean deregister_service(); |
virtual void _shutdown_incoming_queue(); |
|
| |
void find_services(String name, |
Uint32 find_service_qid(const String &name); |
Uint32 capabilities, |
|
Uint32 mask, |
|
Array<Uint32> *results); |
|
void enumerate_service(Uint32 queue, message_module *result); |
|
Uint32 get_next_xid(); |
|
static AsyncOpNode *get_op(); | static AsyncOpNode *get_op(); |
void return_op(AsyncOpNode *op); | void return_op(AsyncOpNode *op); |
|
Boolean isRunning() const { return _isRunning; } |
| |
Boolean operator ==(const MessageQueueService & svce) const |
|
{ |
|
return operator==((const void *)&svce); |
|
} |
|
|
|
Boolean operator ==(const void *svce) const |
|
{ |
|
if((const void *)this == svce) |
|
return true; |
|
return false; |
|
} |
|
|
|
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL polling_routine(void *); |
|
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL kill_idle_threads(void *); |
|
static ThreadPool *get_thread_pool(); | static ThreadPool *get_thread_pool(); |
| |
Uint32 _mask; |
|
AtomicInt _die; | AtomicInt _die; |
|
AtomicInt _threads; |
|
Uint32 getIncomingCount() {return _incoming.count(); } |
| |
protected: | protected: |
|
virtual void _shutdown_incoming_queue(); |
virtual Boolean accept_async(AsyncOpNode *op); | virtual Boolean accept_async(AsyncOpNode *op); |
virtual Boolean messageOK(const Message *msg); | virtual Boolean messageOK(const Message *msg); |
virtual void handleEnqueue() = 0; | virtual void handleEnqueue() = 0; |
virtual void handleEnqueue(Message *) = 0; | virtual void handleEnqueue(Message *) = 0; |
Boolean _enqueueResponse(Message *, Message *); | Boolean _enqueueResponse(Message *, Message *); |
// virtual void _handle_incoming_operation(AsyncOpNode *operation, Thread *thread, MessageQueue *queue); |
|
virtual void _handle_incoming_operation(AsyncOpNode *); | virtual void _handle_incoming_operation(AsyncOpNode *); |
| |
virtual void _handle_async_request(AsyncRequest *req); | virtual void _handle_async_request(AsyncRequest *req); |
virtual void _handle_async_callback(AsyncOpNode *operation); | virtual void _handle_async_callback(AsyncOpNode *operation); |
virtual void _make_response(Message *req, Uint32 code); | virtual void _make_response(Message *req, Uint32 code); |
| |
virtual void handle_heartbeat_request(AsyncRequest *req); |
|
virtual void handle_heartbeat_reply(AsyncReply *rep); |
|
|
|
virtual void handle_AsyncIoctl(AsyncIoctl *req); | virtual void handle_AsyncIoctl(AsyncIoctl *req); |
virtual void handle_CimServiceStart(CimServiceStart *req); | virtual void handle_CimServiceStart(CimServiceStart *req); |
virtual void handle_CimServiceStop(CimServiceStop *req); | virtual void handle_CimServiceStop(CimServiceStop *req); |
virtual void handle_CimServicePause(CimServicePause *req); |
|
virtual void handle_CimServiceResume(CimServiceResume *req); |
|
| |
virtual void handle_AsyncOperationStart(AsyncOperationStart *req); |
void _completeAsyncResponse( |
virtual void handle_AsyncOperationResult(AsyncOperationResult *rep); |
AsyncRequest* request, |
virtual void handle_AsyncLegacyOperationStart(AsyncLegacyOperationStart *req); |
AsyncReply* reply); |
virtual void handle_AsyncLegacyOperationResult(AsyncLegacyOperationResult *rep); |
void _complete_op_node(AsyncOpNode *); |
|
|
void _completeAsyncResponse(AsyncRequest *request, |
|
AsyncReply *reply, |
|
Uint32 state, |
|
Uint32 flag); |
|
void _complete_op_node(AsyncOpNode *, Uint32, Uint32, Uint32); |
|
| |
static cimom *_meta_dispatcher; | static cimom *_meta_dispatcher; |
static AtomicInt _service_count; | static AtomicInt _service_count; |
static Mutex _meta_dispatcher_mutex; | static Mutex _meta_dispatcher_mutex; |
|
static ThreadPool* _thread_pool; |
|
Boolean _isRunning; |
private: | private: |
AsyncDQueue<AsyncOpNode> _incoming; |
Boolean _sendAsync(AsyncOpNode* op, |
|
Uint32 destination, |
|
void (*callback)(AsyncOpNode*, MessageQueue*, void*), |
|
MessageQueue* callback_q, |
|
void* callback_ptr, |
|
Uint32 flags); |
|
|
|
static ThreadReturnType PEGASUS_THREAD_CDECL polling_routine(void *); |
|
|
|
AsyncQueue<AsyncOpNode> _incoming; |
static Thread* _polling_thread; | static Thread* _polling_thread; |
static Semaphore _polling_sem; | static Semaphore _polling_sem; |
static AtomicInt _stop_polling; | static AtomicInt _stop_polling; |
static AtomicInt _check_idle_flag; |
|
| |
static DQueue<MessageQueueService> _polling_list; |
typedef List<MessageQueueService, Mutex> PollingList; |
|
static PollingList* _polling_list; |
|
static Mutex _polling_list_mutex; |
|
|
|
PollingList* _get_polling_list(); |
| |
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL _req_proc(void *); |
static ThreadReturnType PEGASUS_THREAD_CDECL _req_proc(void *); |
| |
static void _sendwait_callback(AsyncOpNode *, MessageQueue *, void *); | static void _sendwait_callback(AsyncOpNode *, MessageQueue *, void *); |
| |
AtomicInt _incoming_queue_shutdown; | AtomicInt _incoming_queue_shutdown; |
| |
protected: |
|
static ThreadPool *_thread_pool; |
|
|
|
private: |
|
struct timeval _default_op_timeout; |
|
static AtomicInt _xid; |
|
friend class cimom; | friend class cimom; |
friend class CIMServer; |
|
}; | }; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |