Add log level and log callback support to the RAOP API

[deb_shairplay.git] / src / include / raop.h

diff --git a/src/include/raop.h b/src/include/raop.h
index aa1a47f9d7376ec48470721da3444a64a534396b..1a7ebc2325ab43610a8069a8103cbbab89e293a2 100644 (file)
--- a/src/include/raop.h
+++ b/src/include/raop.h
@@ -11,26 +11,46 @@
 extern "C" {
 #endif
 
+
+/* Define syslog style log levels */
+#define RAOP_LOG_EMERG       0       /* system is unusable */
+#define RAOP_LOG_ALERT       1       /* action must be taken immediately */
+#define RAOP_LOG_CRIT        2       /* critical conditions */
+#define RAOP_LOG_ERR         3       /* error conditions */
+#define RAOP_LOG_WARNING     4       /* warning conditions */
+#define RAOP_LOG_NOTICE      5       /* normal but significant condition */
+#define RAOP_LOG_INFO        6       /* informational */
+#define RAOP_LOG_DEBUG       7       /* debug-level messages */
+
+
 typedef struct raop_s raop_t;
 
+typedef void (*raop_log_callback_t)(int level, const char *msg);
+
 struct raop_callbacks_s {
        void* cls;
+
+       /* Compulsory callback functions */
        void* (*audio_init)(void *cls, int bits, int channels, int samplerate);
+       void  (*audio_process)(void *cls, void *session, const void *buffer, int buflen);
+       void  (*audio_destroy)(void *cls, void *session);
+
+       /* Optional but recommended callback functions */
+       void  (*audio_flush)(void *cls, void *session);
        void  (*audio_set_volume)(void *cls, void *session, float volume);
        void  (*audio_set_metadata)(void *cls, void *session, const void *buffer, int buflen);
        void  (*audio_set_coverart)(void *cls, void *session, const void *buffer, int buflen);
-       void  (*audio_process)(void *cls, void *session, const void *buffer, int buflen);
-       void  (*audio_flush)(void *cls, void *session);
-       void  (*audio_destroy)(void *cls, void *session);
 };
 typedef struct raop_callbacks_s raop_callbacks_t;
 
 RAOP_API raop_t *raop_init(raop_callbacks_t *callbacks, const char *pemkey);
 RAOP_API raop_t *raop_init_from_keyfile(raop_callbacks_t *callbacks, const char *keyfile);
 
-RAOP_API int raop_is_running(raop_t *raop);
+RAOP_API void raop_set_log_level(raop_t *raop, int level);
+RAOP_API void raop_set_log_callback(raop_t *raop, raop_log_callback_t callback);
 
 RAOP_API int raop_start(raop_t *raop, unsigned short *port, const char *hwaddr, int hwaddrlen, const char *password);
+RAOP_API int raop_is_running(raop_t *raop);
 RAOP_API void raop_stop(raop_t *raop);
 
 RAOP_API void raop_destroy(raop_t *raop);