ACE
6.3.3
|
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>
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_Handler * | handler (int signum) |
Return the ACE_Sig_Handler associated with signum. More... | |
virtual ACE_Event_Handler * | handler (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_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 | |
static sig_atomic_t | sig_pending_ = 0 |
Keeps track of whether a signal is pending. More... | |
Static Private Attributes | |
static ACE_Event_Handler * | signal_handlers_ [ACE_NSIG] |
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.
|
inline |
Default constructor.
|
virtual |
Destructor.
|
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.
|
virtual |
Return the ACE_Sig_Handler associated with signum.
Reimplemented in ACE_Sig_Handlers.
|
virtual |
Set a new ACE_Event_Handler that is associated with signum. Return the existing handler.
Reimplemented in ACE_Sig_Handlers.
|
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>.
|
inlinestaticprotected |
Check whether the SIGNUM is within the legal range of signals.
|
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.
|
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.
|
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.
|
staticprotected |
|
static |
True if there is a pending signal.
|
static |
Reset the value of <sig_pending_> so that no signal is pending.
ACE_Sig_Handler::ACE_ALLOC_HOOK_DECLARE |
Declare the dynamic allocation hooks.
|
staticprotected |
Keeps track of whether a signal is pending.
|
staticprivate |
Array used to store one user-defined Event_Handler for every signal.