Changeset 235:8773740401a5 in freeDiameter for include

Timestamp:

Mar 5, 2010, 7:01:48 PM (14 years ago)

Author:

Sebastien Decugis <sdecugis@nict.go.jp>

Branch:

default

Phase:

public

Message:

Centralized signal handlers management in the library

File:

• include/freeDiameter/libfreeDiameter.h (modified) (2 diffs)

include/freeDiameter/libfreeDiameter.h

@@ -75 +75 @@
 #include <libgen.h>     /* for basename if --dbg_file is specified */
 #endif /* DEBUG */
+
+
+/*============================================================*/
+/*                          INIT                              */
+/*============================================================*/
+
+/* This function must be called first, before any call to another library function */
+/* If the parameter is not 0, the support for signals (fd_sig_register) is enabled, otherwise it is disabled */
+/* The function must be called while the application is single-threaded to enable support for signals */
+int fd_lib_init(int support_signals);
+
+/* Call this one when the application terminates, to destroy internal threads */
+void fd_lib_fini(void);
+
+
+
 
 /*============================================================*/
@@ -559 +575 @@
 
 /*============================================================*/
+/*                          SIGNALS                           */
+/*============================================================*/
+
+/* Register a new callback to be called on reception of a given signal (it receives the signal as parameter) */
+/* EALREADY will be returned if there is already a callback registered on this signal */
+/* NOTE: the signal handler will be called from a new detached thread */
+int fd_sig_register(int signal, char * modname, void (*callback)(int signal));
+
+/* Remove the handler for a given signal */
+int fd_sig_unregister(int signal);
+
+/* Dump list of handlers */
+void fd_sig_dump(int level, int indent);
+
+/* Name of signals */
+#ifdef HAVE_SIGNALENT_H
+extern const char *const fd_sig_str[];
+extern const int fd_sig_nstr;
+# define SIGNALSTR(sig) (((sig) < fd_sig_nstr) ? fd_sig_str[(sig)] : "[unknown signal]")
+#else /* HAVE_SIGNALENT_H */
+# define SIGNALSTR(sig) ("[no sig names]")
+#endif /* HAVE_SIGNALENT_H */
+
+
+/*============================================================*/
 /*                          LISTS                             */
 /*============================================================*/