C++ Signal Handling

• Signals are the interrupts which are delivered to a process by the operating system to stop its ongoing task and attend the task for which the interrupt has been generated.
• Signals can also be generated by the operating system on the basis of system or error condition.
• You can generate interrupts by pressing Ctrl+ C on Linux, UNIX, Mac OS X, or Windows system.

There are signals which cannot be caught by the program but there is a following list of signals which you can catch in your program and can take appropriate actions based on the signal.

These signals are defined in <csingnal> header file.

Here are the list of signals along with their description and working capability:

The signal() Function

C++ signal-handling library provides function signal to trap unexpected interrupts or events.

Syntax

Parameters

This function is set to handle the signal.

It specifies a way to handle the signals number specified by sig.

Parameter func specifies one of the three ways in which a signal can be handled by a program.

• Default handling (SIG_DFL): The signal handled by the default action for that particular signal.
• Ignore Signal (SIG_IGN): The signal is ignored and the code execution will continue even if not purposeful.
• Function handler: A particular function is defined to handle the signal.

We must keep in mind that the signal that we would like to catch must be registered using a signal function and it must be associated with a signal handling function.

Note: The signal handling function should be of the void type.

Return value

The return type of this function is the same as the type of parameter func.

If the request of this function is successful, the function returns a pointer to the particular handler function which was in charge of handling this signal before the call, if any.

Data Races

Data race is undefined. If you call this function in a multi- threaded program then it will cause undefined behavior.

Exceptions

This function never throws exception.

Example 1

Let's see a simple example to demonstrate the use of signal() function:

Output:

Signal is handled

Example 2

Let's see another simple example:

Output:

SignalValue: 0
Sending signal 2
SignalValue: 2

The raise() Function

The C++ signal raise() function is used to send signals to the current executing program.

<csignal> header file declared the function raise() to handle a particular signal.

Syntax

Parameters

sig: The signal number to be sent for handling. It can take one of the following values:

• SIGINT
• SIGABRT
• SIGFPE
• SIGILL
• SIGSEGV
• SIGTERM
• SIGHUP

Return value

On success, it returns 0 and on failure, a non-zero is returned.

Data Races

Concurrently calling this function is safe, causing no data races.

Exceptions

This function never throws exceptions, if no function handlers have been defined with signal to handle the raised signal.

Example 1

Let's see a simple example to illustrate the use of raise() function when SIGABRT is passed:

Output:

Before signal handler is called
Signal = 0
After signal handler is called
Signal = 6

Example 2

Let's see a simple example to illustrate the use of raise() function when SIGINT is passed:

Output:

Before called Signal = 0
After called Signal = 2

Example 3

Let's see a simple example to illustrate the use of raise() function when SIGTERM is passed:

Output:

Before called Signal = 0
After called Signal = 15

Example 4

Let's see a simple example to illustrate the use of raise() function when SIGSEGV is passed:

Output:

Before called Signal = 0
After called Signal = 11

Example 5

Let's see a simple example to illustrate the use of raise() function when SIGFPE is passed:

Output:

Before called Signal = 0
After called Signal = 8