C++ Signal Handling

C++ Signal Handling with C++ tutorial for beginners and professionals with examples on constructor, if-else, switch, break, continue, comments, arrays, object and class, exception, static, structs, inheritance, aggregation etc.

<< Back to CPP

next → ← prev

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:

Signals	Description
SIGABRT	(Signal Abort) Abnormal termination of the program, such as a call to abort.
SIGFPE	(Signal floating- point exception) An erroneous arithmetic operation, such as a divide by zero or an operation resulting in overflow.
SIGILL	(Signal Illegal Instruction) It is used for detecting an illegal instruction.
SIGINT	(Signal Interrupt) It is used to receipt an interactive program interrupt signal.
SIGSEGV	(Signal segmentation Violation) An invalid access to storage.
SIGTERM	(Signal Termination) A termination request sent to the program.
SIGHUP	(Signal Hang up) Hang Up (POSIX), its report that user's terminal is disconnected. It is used to report the termination of the controlling process.
SIGQUIT	Used to terminate a process and generate a core dump.
SIGTRAP	Trace trap.
SIGBUS	This is a BUS error which indicates an access to an invalid address.
SIGUSR1	User defined signal 1.
SIGUSR2	User defined signal 2.
SIGALRM	Alarm clock, which indicates an access to an invalid address.
SIGTERM	Used for termination. This signal can be blocked, handled, and ignored. Generated by kill command.
SIGCOUNT	This signal sent to process to make it continue.
SIGSTOP	Stop, unblockable. This signal is used to stop a process. This signal cannot be handled, ignored or blocked.

The signal() Function

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

Syntax

void (*signal (int sig, void (*func)(int)))(int);

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:

#include <iostream>
#include <csignal>
 
using namespace std;

sig_atomic_t signalled = 0;

void handler(int sig)
{
    signalled = 1;
}

int main()
{
    signal(SIGINT, handler);
    
    raise(SIGINT);
    if (signalled)
        cout << "Signal is handled";
    else
        cout << "Signal is not handled";

    return 0;
}

Output:

Signal is handled

Example 2

Let's see another simple example:

#include <csignal>
#include <iostream>
 
namespace
{
  volatile std::sig_atomic_t gSignalStatus;
}
 
void signal_handler(int signal)
{
  gSignalStatus = signal;
}
 
int main()
{
  // Install a signal handler
  std::signal(SIGINT, signal_handler);
 
  std::cout << "SignalValue: " << gSignalStatus << '\n';
  std::cout << "Sending signal " << SIGINT << '\n';
  std::raise(SIGINT);
  std::cout << "SignalValue: " << gSignalStatus << '\n';
}

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

int raise (int sig);

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:

#include <iostream>
#include <csignal>
 
using namespace std;

sig_atomic_t sig_value = 0;

void handler(int sig)
{
    sig_value = sig;
}

int main()
{
    signal(SIGABRT, handler);
    cout << "Before signal handler is called" << endl;
    cout << "Signal = " << sig_value << endl; 
    raise(SIGABRT);
    cout << "After signal handler is called" << endl;
    cout << "Signal = " << sig_value << endl;

    return 0;
}

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:

#include <csignal> 
#include <iostream> 
using namespace std; 
  
sig_atomic_t s_value = 0; 
void handle(int signal_) 
{ 
    s_value = signal_; 
} 
  
int main() 
{ 
    signal(SIGINT, handle); 
    cout << "Before called Signal = " << s_value << endl; 
    raise(SIGINT); 
    cout << "After called Signal = " << s_value << endl; 
    return 0; 
}

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:

#include <csignal> 
#include <iostream> 
using namespace std; 
  
sig_atomic_t s_value = 0; 
void handle(int signal_) 
{ 
    s_value = signal_; 
} 
  
int main() 
{ 
    signal(SIGTERM, handle); 
    cout << "Before called Signal = " << s_value << endl; 
    raise(SIGTERM); 
    cout << "After called Signal = " << s_value << endl; 
    return 0; 
}

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:

#include <csignal> 
#include <iostream> 
using namespace std; 
  
sig_atomic_t s_value = 0; 
void handle(int signal_) 
{ 
    s_value = signal_; 
} 
  
int main() 
{ 
    signal(SIGSEGV, handle); 
    cout << "Before called Signal = " << s_value << endl; 
    raise(SIGSEGV); 
    cout << "After called Signal = " << s_value << endl; 
    return 0; 
}

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:

#include <csignal> 
#include <iostream> 
using namespace std; 
  
sig_atomic_t s_value = 0; 
void handle(int signal_) 
{ 
    s_value = signal_; 
} 
  
int main() 
{ 
    signal(SIGFPE, handle); 
    cout << "Before called Signal = " << s_value << endl; 
    raise(SIGFPE); 
    cout << "After called Signal = " << s_value << endl; 
    return 0; 
}

Output:

Before called Signal = 0
After called Signal = 8

Next TopicC++ Files and Streams

← prev next →

.Net

.NET Array Dictionary List String 2D Async DataTable Dates DateTime Enum File For Foreach Format IEnumerable If IndexOf Lambda LINQ Parse Path Process Property Regex Replace Sort Split Static StringBuilder Substring Switch Tuple

Java

Core Array ArrayList HashMap String 2D Cast Character Console Deque Duplicates File For Format HashSet If IndexOf Lambda Math ParseInt Process Random Regex Replace Sort Split StringBuilder Substring Switch Vector While

TheDeveloperBlog.com

C++ Signal Handling

C++ Signal Handling

The signal() Function

Syntax

Parameters

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

Return value

Data Races

Exceptions

Example 1

Example 2

The raise() Function

Syntax

Parameters

Return value

Data Races

Exceptions

Example 1

Example 2

Example 3

Example 4

Example 5

Related Links:

.Net

Java

Related Links