csignals.H File Reference

---

Detailed Description

trivial wrapper for catching ANSI C signals

Definition in file csignals.H.

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	catchsignals (volatile int *dest) throw ()
	Install signal handlers to catch non-fatal signals.
const char *	signame (int signum) throw ()
	Get a string name for a given signal number (e.g., "SIGINT", "SIGTERM").

---

Function Documentation

void catchsignals (  volatile int *  dest  )  throw ()

Install signal handlers to catch non-fatal signals. Parameters: dest  Location where the number of a caught signal will be stored. This is marked as 'volatile' because it will be modified by signal handlers. Typically, applications will pass a pointer to a local int variable in to catchsignals(), and then check the value of that variable in each iteration through the main loop of the application, and taking steps to exit the application if the value becomes non-zero. Note that catchsignals() only installs handlers for non-fatal signals (such as SIGHUP, SIGINT [control-c], SIGTERM [kill] and SIGALRM). The idea is that the user can interrupt an application that would otherwise be in an perpetual loop, but still give the application a chance to shut down cleanly (flushing open files, computing final stats, etc.). However, we don't trap more serious signals such as SIGQUIT, SIGABRT, SIGBUS, SIGFPE, SIGKILL, or SIGSEGV -- these usually represent a programming bug and/or the desire to generate a core dump, so catching the signal would avoid a core dump and hinder the ability to debug the context in which the signal was generated. Definition at line 64 of file csignals.C. References handlesignal(), and signum_return. Referenced by main(), Simulation::run(), run_slave(), and submain().

const char* signame (  int  signum  )  throw ()

Get a string name for a given signal number (e.g., "SIGINT", "SIGTERM"). Definition at line 102 of file csignals.C. Referenced by handlesignal(), main(), Simulation::run(), and submain().

---