SysTutorials

Linux Manual Pages › Section 3

stdraise(3)

std::raise - std::raise

Synopsis

Defined in header<csignal>
    int raise(int sig);

Sends signal sig to the program. The signal handler (specified using the std::signal() function) is invoked. If the user-defined signal handling strategy is not set using std::signal() yet, it is implementation-defined whether the signal will be ignored or default handler will be invoked.

Parameters

      the signal to be sent. It can be an implementation-defined value or one of the following values:

      SIGABRT       SIGFPE defines signal types sig - SIGILL (macro constant)       SIGINT       SIGSEGV       SIGTERM

Return value

0 upon success, non-zero value on failure.

Example

// Run this code

#include <csignal>
#include <iostream>
void signal_handler(int signal)
{
std::cout << "Received signal " << signal << ‘\n’;
}
int main()
{
// Install a signal handler
std::signal(SIGTERM, signal_handler);
std::cout << "Sending signal " << SIGTERM << ‘\n’;
std::raise(SIGTERM);
}

Possible output:

  Sending signal 15   Received signal 15

See also

       sets a signal handler for particular signal signal (function)