signal: reserve signal subsystems >= INT_MAX/2 for libraries

[osmocom-bb.git] / include / osmocom / core / signal.h

diff --git a/include/osmocom/core/signal.h b/include/osmocom/core/signal.h
index 02d83d2..7c32c77 100644 (file)
--- a/include/osmocom/core/signal.h
+++ b/include/osmocom/core/signal.h
@@ -1,15 +1,37 @@
-#ifndef OSMOCORE_SIGNAL_H
-#define OSMOCORE_SIGNAL_H
+#ifndef OSMO_SIGNAL_H
+#define OSMO_SIGNAL_H
 
-typedef int signal_cbfn(unsigned int subsys, unsigned int signal,
-                       void *handler_data, void *signal_data);
+#include <stdint.h>
+
+/* subsystem signaling numbers: we split the numberspace for applications and
+ * libraries: from 0 to UINT_MAX/2 for applications, from UINT_MAX/2 to
+ * UINT_MAX for libraries. */
+#define OSMO_SIGNAL_SS_APPS            0
+#define OSMO_SIGNAL_SS_RESERVED                2147483648
+
+/* signal subsystems. */
+enum {
+       SS_GLOBAL               = OSMO_SIGNAL_SS_RESERVED,
+       SS_INPUT,
+};
+
+/* application-defined signal types. */
+#define OSMO_SIGNAL_T_APPS             0
+#define OSMO_SIGNAL_T_RESERVED         2147483648
+
+/* signal types. */
+enum {
+       S_GLOBAL_SHUTDOWN       = OSMO_SIGNAL_T_RESERVED,
+};
+
+typedef int osmo_signal_cbfn(unsigned int subsys, unsigned int signal, void *handler_data, void *signal_data);
 
 
 /* Management */
-int register_signal_handler(unsigned int subsys, signal_cbfn *cbfn, void *data);
-void unregister_signal_handler(unsigned int subsys, signal_cbfn *cbfn, void *data);
+int osmo_signal_register_handler(unsigned int subsys, osmo_signal_cbfn *cbfn, void *data);
+void osmo_signal_unregister_handler(unsigned int subsys, osmo_signal_cbfn *cbfn, void *data);
 
 /* Dispatch */
-void dispatch_signal(unsigned int subsys, unsigned int signal, void *signal_data);
+void osmo_signal_dispatch(unsigned int subsys, unsigned int signal, void *signal_data);
 
-#endif /* OSMOCORE_SIGNAL_H */
+#endif /* OSMO_SIGNAL_H */