ACE  6.3.3
Public Member Functions | Static Public Member Functions | Public Attributes | Static Protected Member Functions | Static Protected Attributes | Static Private Attributes | List of all members
ACE_Sig_Handler Class Reference

This is the main dispatcher of signals for ACE. It improves the existing UNIX signal handling mechanism by allowing C++ objects to handle signals in a way that avoids the use of global/static variables and functions. More...

#include <Sig_Handler.h>

Inheritance diagram for ACE_Sig_Handler:
Inheritance graph
[legend]
Collaboration diagram for ACE_Sig_Handler:
Collaboration graph
[legend]

Public Member Functions

 ACE_Sig_Handler (void)
 Default constructor. More...
 
virtual ~ACE_Sig_Handler (void)
 Destructor. 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_Handlerhandler (int signum)
 Return the ACE_Sig_Handler associated with signum. More...
 
virtual ACE_Event_Handlerhandler (int signum, ACE_Event_Handler *)
 
void dump (void) const
 Dump the state of an object. More...
 

Static Public Member Functions

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...
 

Static Protected Member Functions

static ACE_Event_Handlerhandler_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

static sig_atomic_t sig_pending_ = 0
 Keeps track of whether a signal is pending. More...
 

Static Private Attributes

static ACE_Event_Handlersignal_handlers_ [ACE_NSIG]
 

Detailed Description

This is the main dispatcher of signals for ACE. It improves the existing UNIX signal handling mechanism by allowing C++ objects to handle signals in a way that avoids the use of global/static variables and functions.

Using this class a program can register an 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 method of the registered ACE_Event_Handler is invoked automatically.

Constructor & Destructor Documentation

ACE_Sig_Handler::ACE_Sig_Handler ( void  )
inline

Default constructor.

ACE_Sig_Handler::~ACE_Sig_Handler ( void  )
virtual

Destructor.

Member Function Documentation

void ACE_Sig_Handler::dispatch ( int  signum,
siginfo_t siginfo,
ucontext_t ucontext 
)
static

Callback routine registered with sigaction(2) that dispatches the <handle_signal> method of the appropriate pre-registered ACE_Event_Handler.

void ACE_Sig_Handler::dump ( void  ) const

Dump the state of an object.

ACE_Event_Handler * ACE_Sig_Handler::handler ( int  signum)
virtual

Return the ACE_Sig_Handler associated with signum.

Reimplemented in ACE_Sig_Handlers.

ACE_Event_Handler * ACE_Sig_Handler::handler ( int  signum,
ACE_Event_Handler new_sh 
)
virtual

Set a new ACE_Event_Handler that is associated with signum. Return the existing handler.

Reimplemented in ACE_Sig_Handlers.

ACE_Event_Handler * ACE_Sig_Handler::handler_i ( int  signum,
ACE_Event_Handler new_sh 
)
staticprotected

Set a new ACE_Event_Handler that is associated with signum. Return the existing handler. Does not acquire any locks so that it can be called from a signal handler, such as <dispatch>.

int ACE_Sig_Handler::in_range ( int  signum)
inlinestaticprotected

Check whether the SIGNUM is within the legal range of signals.

int ACE_Sig_Handler::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 >= 0 on success.

Reimplemented in ACE_Sig_Handlers.

int ACE_Sig_Handler::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 
)
staticprotected

This implementation method is called by <register_handler> and dispatch. It doesn't do any locking so that it can be called within a signal handler, such as dispatch. It adds 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 >= 0 on success.

int ACE_Sig_Handler::remove_handler ( int  signum,
ACE_Sig_Action new_disp = 0,
ACE_Sig_Action old_disp = 0,
int  sigkey = -1 
)
virtual

Remove the ACE_Event_Handler currently associated with signum. sigkey is ignored in this implementation since there is only one instance of a signal handler. Install the new disposition (if given) and return the previous disposition (if desired by the caller). Returns 0 on success and -1 if signum is invalid.

Reimplemented in ACE_Sig_Handlers.

int ACE_Sig_Handler::remove_handler_i ( int  signum,
ACE_Sig_Action new_disp = 0,
ACE_Sig_Action old_disp = 0,
int  sigkey = -1 
)
staticprotected
int ACE_Sig_Handler::sig_pending ( void  )
static

True if there is a pending signal.

void ACE_Sig_Handler::sig_pending ( int  pending)
static

Reset the value of <sig_pending_> so that no signal is pending.

Member Data Documentation

ACE_Sig_Handler::ACE_ALLOC_HOOK_DECLARE

Declare the dynamic allocation hooks.

sig_atomic_t ACE_Sig_Handler::sig_pending_ = 0
staticprotected

Keeps track of whether a signal is pending.

ACE_Event_Handler * ACE_Sig_Handler::signal_handlers_
staticprivate

Array used to store one user-defined Event_Handler for every signal.


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