C raise() Function

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

Introduction

The raise() function in C is a standard library function that sends a signal to the calling process or thread. It is part of the C standard library (signal.h). This function is useful for generating signals within a program, allowing you to test signal handlers or trigger specific behaviors.

raise() Function Syntax

The syntax for the raise() function is as follows:

#include <signal.h>
int raise(int sig);

Parameters:

• sig: The signal number to be generated. Common signals include SIGINT, SIGTERM, SIGSEGV, etc.

Returns:

• The function returns 0 on success. If an error occurs, it returns a non-zero value.

Examples

Generating a Signal

To demonstrate how to use raise() to generate a signal, we will write a simple program that raises the SIGINT signal (typically generated by pressing Ctrl+C).

Example

#include <stdio.h>
#include <signal.h>

// Signal handler function
void handle_sigint(int sig) {
    printf("Caught signal %d (SIGINT). Exiting...\n", sig);
    _exit(0);
}

int main() {
    // Set up the signal handler for SIGINT
    if (signal(SIGINT, handle_sigint) == SIG_ERR) {
        perror("signal");
        return 1;
    }

    // Raise the SIGINT signal
    printf("Raising SIGINT signal...\n");
    raise(SIGINT);

    // This line will not be reached
    printf("This line will not be printed.\n");

    return 0;
}

Output:

Raising SIGINT signal...
Caught signal 2 (SIGINT). Exiting...

Using raise() to Test Signal Handlers

This example shows how to use raise() to test a custom signal handler for SIGTERM.

Example

#include <stdio.h>
#include <signal.h>

// Signal handler function for SIGTERM
void handle_sigterm(int sig) {
    printf("Caught signal %d (SIGTERM). Performing cleanup...\n", sig);
    // Perform any necessary cleanup here
    _exit(0);
}

int main() {
    // Set up the signal handler for SIGTERM
    if (signal(SIGTERM, handle_sigterm) == SIG_ERR) {
        perror("signal");
        return 1;
    }

    // Raise the SIGTERM signal
    printf("Raising SIGTERM signal...\n");
    raise(SIGTERM);

    // This line will not be reached
    printf("This line will not be printed.\n");

    return 0;
}

Output:

Raising SIGTERM signal...
Caught signal 15 (SIGTERM). Performing cleanup...

Real-World Use Case

Simulating Signal Events

In real-world applications, the raise() function can be used to simulate signal events for testing purposes, ensuring that signal handlers work correctly and perform necessary actions.

Example: Simulating a Termination Signal

#include <stdio.h>
#include <signal.h>

// Signal handler function for SIGTERM
void handle_sigterm(int sig) {
    printf("Caught signal %d (SIGTERM). Performing cleanup...\n", sig);
    // Perform any necessary cleanup here
    _exit(0);
}

int main() {
    // Set up the signal handler for SIGTERM
    if (signal(SIGTERM, handle_sigterm) == SIG_ERR) {
        perror("signal");
        return 1;
    }

    // Simulate receiving a SIGTERM signal
    printf("Simulating SIGTERM signal...\n");
    raise(SIGTERM);

    // This line will not be reached
    printf("This line will not be printed.\n");

    return 0;
}

Output:

Simulating SIGTERM signal...
Caught signal 15 (SIGTERM). Performing cleanup...

Conclusion

The raise() function is essential for generating signals within a program in C. It is useful in various applications, particularly for testing signal handlers and simulating signal events. By using raise(), you can ensure that your program correctly responds to signals and performs necessary actions when they occur.

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF