ACE_Sig_Handlers Class Reference

This is an alternative signal handling dispatcher for ACE. It allows a list of signal handlers to be registered for each signal. It also makes SA_RESTART the default mode. More...

#include <Sig_Handler.h>

Inheritance diagram for ACE_Sig_Handlers:

Collaboration diagram for ACE_Sig_Handlers:

Public Member Functions
	ACE_Sig_Handlers (void)
	Default constructor. More...
virtual int	register_handler (int signum, ACE_Event_Handler *new_sh, ACE_Sig_Action *new_disp=0, ACE_Event_Handler **old_sh=0, ACE_Sig_Action *old_disp=0)
virtual int	remove_handler (int signum, ACE_Sig_Action *new_disp=0, ACE_Sig_Action *old_disp=0, int sigkey=-1)
virtual ACE_Event_Handler *	handler (int signum)
virtual ACE_Event_Handler *	handler (int signum, ACE_Event_Handler *)
void	dump (void) const
	Dump the state of an object. More...
Public Member Functions inherited from ACE_Sig_Handler
	ACE_Sig_Handler (void)
	Default constructor. More...
virtual	~ACE_Sig_Handler (void)
	Destructor. More...
void	dump (void) const
	Dump the state of an object. More...

Static Public Member Functions
static void	dispatch (int signum, siginfo_t *, ucontext_t *)
Static Public Member Functions inherited from ACE_Sig_Handler
static int	sig_pending (void)
	True if there is a pending signal. More...
static void	sig_pending (int)
	Reset the value of <sig_pending_> so that no signal is pending. More...
static void	dispatch (int, siginfo_t *, ucontext_t *)

Public Attributes
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks. More...
Public Attributes inherited from ACE_Sig_Handler
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks. More...

Static Private Attributes
static int	sigkey_ = 0
static bool	third_party_sig_handler_ = false

Additional Inherited Members
Static Protected Member Functions inherited from ACE_Sig_Handler
static ACE_Event_Handler *	handler_i (int signum, ACE_Event_Handler *)
static int	register_handler_i (int signum, ACE_Event_Handler *new_sh, ACE_Sig_Action *new_disp=0, ACE_Event_Handler **old_sh=0, ACE_Sig_Action *old_disp=0)
static int	remove_handler_i (int signum, ACE_Sig_Action *new_disp=0, ACE_Sig_Action *old_disp=0, int sigkey=-1)
static int	in_range (int signum)
	Check whether the SIGNUM is within the legal range of signals. More...
Static Protected Attributes inherited from ACE_Sig_Handler
static sig_atomic_t	sig_pending_ = 0
	Keeps track of whether a signal is pending. More...

Detailed Description

This is an alternative signal handling dispatcher for ACE. It allows a list of signal handlers to be registered for each signal. It also makes SA_RESTART the default mode.

Using this class a program can register one or more ACE_Event_Handler with the ACE_Sig_Handler in order to handle a designated signum. When a signal occurs that corresponds to this signum, the <handle_signal> methods of all the registered ACE_Event_Handlers are invoked automatically.

Constructor & Destructor Documentation

ACE_Sig_Handlers::ACE_Sig_Handlers

(

void

)

Default constructor.

Member Function Documentation

void ACE_Sig_Handlers::dispatch ( int  signum, siginfo_t *  siginfo, ucontext_t *  ucontext  )

static

Callback routine registered with sigaction(2) that dispatches the <handle_signal> method of all the pre-registered ACE_Event_Handlers for signum

void ACE_Sig_Handlers::dump

(

void

)

const

Dump the state of an object.

ACE_Event_Handler * ACE_Sig_Handlers::handler ( int  signum )

virtual

Return the head of the list of <ACE_Sig_Handler>s associated with SIGNUM.

Reimplemented from ACE_Sig_Handler.

ACE_Event_Handler * ACE_Sig_Handlers::handler ( int  signum, ACE_Event_Handler *  new_sh  )

virtual

Set a new ACE_Event_Handler that is associated with SIGNUM at the head of the list of signals. Return the existing handler that was at the head.

Reimplemented from ACE_Sig_Handler.

int ACE_Sig_Handlers::register_handler ( int  signum, ACE_Event_Handler *  new_sh, ACE_Sig_Action *  new_disp = 0, ACE_Event_Handler **  old_sh = 0, ACE_Sig_Action *  old_disp = 0  )

virtual

Add a new ACE_Event_Handler and a new sigaction associated with signum. Passes back the existing ACE_Event_Handler and its sigaction if pointers are non-zero. Returns -1 on failure and a <sigkey> that is >= 0 on success.

Reimplemented from ACE_Sig_Handler.

int ACE_Sig_Handlers::remove_handler ( int  signum, ACE_Sig_Action *  new_disp = 0, ACE_Sig_Action *  old_disp = 0, int  sigkey = -1  )

virtual

Remove an ACE_Event_Handler currently associated with signum. We remove the handler if (1) its sigkey> matches the sigkey passed as a parameter or (2) if we've been told to remove all the handlers, i.e., sigkey == -1. If a new disposition is given it is installed and the previous disposition is returned (if desired by the caller). Returns 0 on success and -1 if signum is invalid.

Reimplemented from ACE_Sig_Handler.

Member Data Documentation

ACE_Sig_Handlers::ACE_ALLOC_HOOK_DECLARE

Declare the dynamic allocation hooks.

int ACE_Sig_Handlers::sigkey_ = 0

staticprivate

Keeps track of the id that uniquely identifies each registered signal handler. This id can be used to cancel a timer via the <remove_handler> method.

bool ACE_Sig_Handlers::third_party_sig_handler_ = false

staticprivate

If this is true then a 3rd party library has registered a handler...

---

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

• Sig_Handler.h
• Sig_Handler.cpp