Provide a standard ACE service for managing all the services configured in an ACE_Service_Repository. More...

#include <Service_Manager.h>

Inheritance diagram for ACE_Service_Manager:

Collaboration diagram for ACE_Service_Manager:

Public Member Functions
	ACE_Service_Manager (void)
	Constructor.

virtual	~ACE_Service_Manager (void)
	Destructor.

Public Member Functions inherited from ACE_Service_Object
	ACE_Service_Object (ACE_Reactor *=0)
	Constructor.

virtual	~ACE_Service_Object (void)
	Destructor.

Public Member Functions inherited from ACE_Event_Handler
virtual	~ACE_Event_Handler (void)
	Destructor is virtual to enable proper cleanup.

virtual void	set_handle (ACE_HANDLE)
	Set the I/O handle.

virtual int	priority (void) const

virtual void	priority (int priority)
	Set the priority of the Event_Handler.

virtual int	handle_output (ACE_HANDLE fd=ACE_INVALID_HANDLE)

virtual int	handle_exception (ACE_HANDLE fd=ACE_INVALID_HANDLE)
	Called when an exceptional events occur (e.g., SIGURG).

virtual int	handle_timeout (const ACE_Time_Value &current_time, const void *act=0)

virtual int	handle_exit (ACE_Process *)
	Called when a process exits.

virtual int	resume_handler (void)

virtual int	handle_qos (ACE_HANDLE=ACE_INVALID_HANDLE)

virtual int	handle_group_qos (ACE_HANDLE=ACE_INVALID_HANDLE)

virtual void	reactor (ACE_Reactor *reactor)
	Set the event demultiplexors.

virtual ACE_Reactor *	reactor (void) const
	Get the event demultiplexors.

virtual ACE_Reactor_Timer_Interface *	reactor_timer_interface (void) const
	Get only the reactor's timer related interface.

virtual Reference_Count	add_reference (void)
	Increment reference count on the handler.

virtual Reference_Count	remove_reference (void)
	Decrement reference count on the handler.

Reference_Counting_Policy &	reference_counting_policy (void)
	Current Reference_Counting_Policy.

Public Member Functions inherited from ACE_Shared_Object
	ACE_Shared_Object (void)
	Constructor.

virtual	~ACE_Shared_Object (void)
	Destructor.

Protected Member Functions
virtual int	reconfigure_services (void)

virtual int	list_services (void)

virtual int	init (int argc, ACE_TCHAR *argv[])
	Initializes object when dynamic linking occurs.

virtual int	info (ACE_TCHAR **info_string, size_t length) const
	Returns information on a service object.

virtual int	fini (void)
	Terminates object when dynamic unlinking occurs.

virtual int	suspend (void)
	Temporarily disable a service without removing it completely.

virtual int	resume (void)
	Re-enable a previously suspended service.

void	dump (void) const
	Dump the state of an object.

int	open (const ACE_INET_Addr &sia)

virtual ACE_HANDLE	get_handle (void) const
	Get the I/O handle.

virtual int	handle_input (ACE_HANDLE fd)
	Called when input events occur (e.g., connection or data).

virtual int	handle_close (ACE_HANDLE fd, ACE_Reactor_Mask)

virtual int	handle_signal (int signum, siginfo_t , ucontext_t )

virtual void	process_request (ACE_TCHAR *request)
	Handle one request.

Protected Attributes
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks.

ACE_SOCK_Stream	client_stream_

ACE_SOCK_Acceptor	acceptor_
	Acceptor instance.

bool	debug_
	Keep track whether we debug or not.

int	signum_
	The signal used to trigger reconfiguration.

Static Protected Attributes
static u_short	DEFAULT_PORT_ = 10000
	Default port for the Acceptor to listen on.

Additional Inherited Members
Public Types inherited from ACE_Event_Handler
enum	{ LO_PRIORITY = 0, HI_PRIORITY = 10, NULL_MASK = 0, READ_MASK = (1 << 0), WRITE_MASK = (1 << 1), EXCEPT_MASK = (1 << 2), ACCEPT_MASK = (1 << 3), CONNECT_MASK = (1 << 4), TIMER_MASK = (1 << 5), QOS_MASK = (1 << 6), GROUP_QOS_MASK = (1 << 7), SIGNAL_MASK = (1 << 8), ALL_EVENTS_MASK, RWE_MASK, DONT_CALL = (1 << 9) }

enum	{ ACE_EVENT_HANDLER_NOT_RESUMED = -1, ACE_REACTOR_RESUMES_HANDLER = 0, ACE_APPLICATION_RESUMES_HANDLER }

typedef long	Reference_Count
	Reference count type.

Static Public Member Functions inherited from ACE_Event_Handler
static ACE_THR_FUNC_RETURN	read_adapter (void *event_handler)

static int	register_stdin_handler (ACE_Event_Handler eh, ACE_Reactor reactor, ACE_Thread_Manager *thr_mgr, int flags=THR_DETACHED)

static int	remove_stdin_handler (ACE_Reactor reactor, ACE_Thread_Manager thr_mgr)
	Performs the inverse of the register_stdin_handler() method.

Protected Types inherited from ACE_Event_Handler
typedef ACE_Atomic_Op < ACE_SYNCH_MUTEX, Reference_Count >	Atomic_Reference_Count
	Typedef for implementation of reference counting.

Detailed Description

Provide a standard ACE service for managing all the services configured in an ACE_Service_Repository.

This implementation is simple and just handles each client request one at a time. There are currently 3 types of requests:

List services: If the string "help" is sent, return a list of all the services supported by the Service Configurator.
Reconfigure: If the string "reconfigure" is sent trigger a reconfiguration, which will re-read the local <svc.conf> file.
Process directive: If neither "help" nor "reconfigure" is sent, simply treat the incoming string as a process directive and pass it along to <ACE_Service_Config::process_directive>. This allows remote configuration via command-line instructions like % echo suspend My_Remote_Service | telnet hostname 3911

Each request is associated with a new connection, which is closed when the request is processed. In addition, you must be using the singleton <ACE_Reactor::instance> in order to trigger reconfigurations.

Constructor & Destructor Documentation

ACE_Service_Manager::ACE_Service_Manager ( void )

Constructor.

ACE_Service_Manager::~ACE_Service_Manager ( void )

virtual

Destructor.

Member Function Documentation

void ACE_Service_Manager::dump ( void ) const

protected

Dump the state of an object.

int ACE_Service_Manager::fini ( void )

protectedvirtual

Terminates object when dynamic unlinking occurs.

Reimplemented from ACE_Shared_Object.

ACE_HANDLE ACE_Service_Manager::get_handle ( void ) const

protectedvirtual

Get the I/O handle.

Reimplemented from ACE_Event_Handler.

int ACE_Service_Manager::handle_close	(	ACE_HANDLE	handle,
		ACE_Reactor_Mask	close_mask
	)

protectedvirtual

Called when a handle_*() method returns -1 or when the remove_handler() method is called on an ACE_Reactor. The close_mask indicates which event has triggered the handle_close() method callback on a particular handle.

Reimplemented from ACE_Event_Handler.

int ACE_Service_Manager::handle_input ( ACE_HANDLE fd )

protectedvirtual

Called when input events occur (e.g., connection or data).

Reimplemented from ACE_Event_Handler.

int ACE_Service_Manager::handle_signal	(	int	signum,
		siginfo_t *	,
		ucontext_t *
	)

protectedvirtual

Called when object is signaled by OS (either via UNIX signals or when a Win32 object becomes signaled).

Reimplemented from ACE_Event_Handler.

int ACE_Service_Manager::info	(	ACE_TCHAR **	info_string,
		size_t	length
	)		const

protectedvirtual

Returns information on a service object.

Reimplemented from ACE_Shared_Object.

int ACE_Service_Manager::init	(	int	argc,
		ACE_TCHAR *	argv[]
	)

protectedvirtual

Initializes object when dynamic linking occurs.

Reimplemented from ACE_Shared_Object.

int ACE_Service_Manager::list_services ( void )

protectedvirtual

Determine all the services offered by this daemon and return the information back to the client.

int ACE_Service_Manager::open ( const ACE_INET_Addr & sia )

protected

void ACE_Service_Manager::process_request ( ACE_TCHAR * request )

protectedvirtual

Handle one request.

int ACE_Service_Manager::reconfigure_services ( void )

protectedvirtual

Trigger a reconfiguration of the Service Configurator by re-reading its local <svc.conf> file.

int ACE_Service_Manager::resume ( void )

protectedvirtual

Re-enable a previously suspended service.

Reimplemented from ACE_Service_Object.

int ACE_Service_Manager::suspend ( void )

protectedvirtual

Temporarily disable a service without removing it completely.

Reimplemented from ACE_Service_Object.

Member Data Documentation

ACE_SOCK_Acceptor ACE_Service_Manager::acceptor_

protected

Acceptor instance.

ACE_Service_Manager::ACE_ALLOC_HOOK_DECLARE

protected

Declare the dynamic allocation hooks.

ACE_SOCK_Stream ACE_Service_Manager::client_stream_

protected

Connection to the client (we only support one client connection at a time).

bool ACE_Service_Manager::debug_

protected

Keep track whether we debug or not.

u_short ACE_Service_Manager::DEFAULT_PORT_ = 10000

staticprotected

Default port for the Acceptor to listen on.

int ACE_Service_Manager::signum_

protected

The signal used to trigger reconfiguration.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation