sc/signal/README.md

Signal handling

Overview

• Signal handling for shutdown and fatal signals.
• Provides signal safe snprintf/vsnprintf.
• On shutdown signal, writes 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.

Usage

#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));
    // Press CTRL+C.
    printf("Received shutdown signal \n");


    return 0;
}