sc/signal/README.md

# Signal handling

#### Overview

- Signal handling for shutdown signals and fatal signals.
- Provides signal-safe snprintf/vsnprintf.
- On shutdown signal, write 1 byte to a fd which is set by user, so your app   
  can shutdown properly. 
- Double shutdown signal handling: e.g user presses CTRL+C twice, exits without  
  waiting graceful shutdown.
- Fatal signal handling. Prints backtrace with program counter indicator. You   
  should compile with debug symbols or with -rdynamic for GCC.
- If log fd is set, it will print logs to your log file.
  
- Just copy <b>sc_signal.h</b> and <b>sc_signal.c</b> to your project.


##### Usage


```c
#include "sc_signal.h"

#include <stdio.h>
#include <unistd.h>

int main()
{
    char tmp[1];
    int fds[2];

    sc_signal_init();

    pipe(fds);

    sc_signal_shutdown_fd = fds[1];

    read(fds[0], tmp, sizeof(tmp));
    printf("Received shutdown signal \n");


    return 0;
}
```