# SIG_ERR

> C++ Atlas: `cppatlas.com/w/c/program/SIG_ERR` | Source: https://en.cppreference.com/w/c/program/SIG_ERR | Domain: Program support utilities

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

## Official Specification Summary (cppreference)

```cpp
// 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

```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:

```text
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

- [`signal`](https://en.cppreference.com/w/c/program/signal): sets a signal handler for particular signal (function)
- [C++ documentation for `SIG_ERR`](https://en.cppreference.com/w/cpp/utility/program/SIG_ERR)

---
Attribution: content from https://en.cppreference.com/w/c/program/SIG_ERR (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.