gphoto2-port-log.h
Go to the documentation of this file.
#ifndef __GPHOTO2_PORT_LOG_H__
#define __GPHOTO2_PORT_LOG_H__
#include <stdarg.h>
typedef enum {
GP_LOG_ERROR = 0,
GP_LOG_VERBOSE = 1,
GP_LOG_DEBUG = 2,
GP_LOG_DATA = 3
} GPLogLevel;
#define GP_LOG_ALL GP_LOG_DATA
typedef void (* GPLogFunc) (GPLogLevel level, const char *domain,
const char *format, va_list args, void *data)
#if (__GNUC__ >= 3)
__attribute__((__format__(printf,3,0)))
#endif
;
#ifndef DISABLE_DEBUGGING
int gp_log_add_func (GPLogLevel level, GPLogFunc func, void *data);
int gp_log_remove_func (int id);
/* Logging */
void gp_log (GPLogLevel level, const char *domain,
const char *format, ...)
#ifdef __GNUC__
__attribute__((__format__(printf,3,4)))
#endif
;
void gp_logv (GPLogLevel level, const char *domain, const char *format,
va_list args)
#ifdef __GNUC__
__attribute__((__format__(printf,3,0)))
#endif
;
void gp_log_data (const char *domain, const char *data, unsigned int size);
/*
* GP_DEBUG:
* msg: message to log
* params: params to message
*
* Logs message at log level #GP_LOG_DEBUG by calling #gp_log() with
* an automatically generated domain
* You have to define GP_MODULE as "mymod" for your module
* mymod before using #GP_DEBUG().
*/
#ifdef _GPHOTO2_INTERNAL_CODE
#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
#define GP_DEBUG(...) \
gp_log(GP_LOG_DEBUG, GP_MODULE "/" __FILE__, __VA_ARGS__)
#elif defined(__GNUC__) && __GNUC__ >= 2
#define GP_DEBUG(msg, params...) \
gp_log(GP_LOG_DEBUG, GP_MODULE "/" __FILE__, msg, ##params)
#else
# ifdef __GNUC__
# warning Disabling GP_DEBUG because variadic macros are not allowed
# endif
#define GP_DEBUG (void)
#endif
#endif /* _GPHOTO2_INTERNAL_CODE */
#else /* DISABLE_DEBUGGING */
/* Stub these functions out if debugging is disabled */
#define gp_log_add_func(level, func, data) (0)
#define gp_log_remove_func(id) (0)
#define gp_log(level, domain, format, args...)
#define gp_logv(level, domain, format, args)
#define gp_log_data(domain, data, size)
#ifdef _GPHOTO2_INTERNAL_CODE
#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
#define GP_DEBUG(...) /* no-op */
#elif defined(__GNUC__)
#define GP_DEBUG(msg, params...) /* no-op */
#else
#define GP_DEBUG (void)
#endif
#endif /* _GPHOTO2_INTERNAL_CODE */
#endif /* DISABLE_DEBUGGING */
#ifdef _GPHOTO2_INTERNAL_CODE
typedef struct StringFlagItem {
char *str;
unsigned int flag;
} StringFlagItem;
typedef void (*string_item_func) (const char *str, void *data);
const char *
gpi_enum_to_string(const unsigned int _enum,
const StringFlagItem *map);
int
gpi_string_to_enum(const char *str,
unsigned int *result,
const StringFlagItem *map);
void
gpi_flags_to_string_list(const unsigned int flags,
const StringFlagItem *map,
string_item_func func, void *data);
int
gpi_string_or_to_flags(const char *str,
unsigned int *flags,
const StringFlagItem *map);
unsigned int
gpi_string_to_flag(const char *str,
const StringFlagItem *map);
unsigned int
gpi_string_list_to_flags(const char *str[],
const StringFlagItem *map);
#endif /* _GPHOTO2_INTERNAL_CODE */
#endif /* __GPHOTO2_PORT_LOG_H__ */
GP_LOG_DATA
Log message is a data hex dump.
Definition: gphoto2-port-log.h:34
gp_logv
void gp_logv(GPLogLevel level, const char *domain, const char *format, va_list args)
Log a debug or error message with va_list.
Definition: gphoto2-port-log.c:260
GPLogFunc
void(* GPLogFunc)(GPLogLevel level, const char *domain, const char *format, va_list args, void *data)
Logging function hook.
Definition: gphoto2-port-log.h:62
GP_LOG_VERBOSE
Log message is an verbose debug infomation.
Definition: gphoto2-port-log.h:32
gp_log_add_func
int gp_log_add_func(GPLogLevel level, GPLogFunc func, void *data)
Add a function to get logging information.
Definition: gphoto2-port-log.c:80
GP_LOG_DEBUG
Log message is an debug infomation.
Definition: gphoto2-port-log.h:33
GPLogLevel
GPLogLevel
Logging level Specifies the logging severity level.
Definition: gphoto2-port-log.h:30
GP_LOG_ERROR
Log message is an error infomation.
Definition: gphoto2-port-log.h:31
gp_log
void gp_log(GPLogLevel level, const char *domain, const char *format,...)
Log a debug or error message.
Definition: gphoto2-port-log.c:293
gp_log_data
void gp_log_data(const char *domain, const char *data, unsigned int size)
Log data.
Definition: gphoto2-port-log.c:178
gp_log_remove_func
int gp_log_remove_func(int id)
Remove a logging receiving function.
Definition: gphoto2-port-log.c:115