NAME

       iv_fatal, iv_set_fatal_msg_handler - ivykis fatal error condition handling

SYNOPSIS

       #include <iv.h>

       void iv_fatal(const char *fmt, ...);
       void iv_set_fatal_msg_handler(void (*handler)(const char *msg));

DESCRIPTION

       iv_fatal  aborts  the  running  program, after possibly emitting an error message. The fmt parameter is a
       printf(3)-style format string, the message to be logged.

       If no handler is set (the default), the formatted message will be sent to syslog, with critical severity.
       Otherwise the handler as set by iv_set_fatal_msg_handler will be used instead.

       iv_fatal is also used internally by ivykis, whenever a fatal situation is detected.

       iv_set_fatal_msg_handler can be used to set an alternative (as opposed to syslog) function to  call  from
       iv_fatal,  and  its  argument  should  be  a  function that does not return, and takes a single string as
       argument - the formatted error message.

SEE ALSO

       ivykis(3), iv_examples(3)

ivykis                                             2012-06-18                                        iv_fatal(3)