Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

SIG_ERR

A value of type void (*)(int). When returned by signal, indicates that an error has occurred.

NotebookLM
Defined in header <signal.h>
#define SIG_ERR /* implementation defined */

A value of type void (*)(int). When returned by signal, indicates that an error has occurred.

Example

example.c
#include <stdio.h>
#include <stdlib.h>
#include <signal.h>
 
void signal_handler(int sig)
{
    printf("Received signal: %d\n", sig);
}
 
int main(void)
{
    /* Install a signal handler. */
    if (signal(SIGTERM, signal_handler) == SIG_ERR)
    {
        printf("Error while installing a signal handler.\n");
        exit(EXIT_FAILURE);
    }
 
    printf("Sending signal: %d\n", SIGTERM);
    if (raise(SIGTERM) != 0)
    {
        printf("Error while raising the SIGTERM signal.\n");
        exit(EXIT_FAILURE);
    }
 
    printf("Exit main()\n");
    return EXIT_SUCCESS;
}
Output
Sending signal: 15
Received signal: 15
Exit main()

References

  • C17 standard (ISO/IEC 9899:2018):
  • 7.14/3 Signal handling <signal.h> (p: 194)
  • C11 standard (ISO/IEC 9899:2011):
  • 7.14/3 Signal handling <signal.h> (p: 265)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.14/3 Signal handling <signal.h> (p: 246)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.7 SIGNAL HANDLING <signal.h>

See also

sets a signal handler for particular signal
(function)
C++ documentation for SIG_ERR

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.