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 *str, void *data);

#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_log_with_source_location(
                  GPLogLevel level, const char *file, int line, const char *func,
                  const char *format, ...)
#ifdef __GNUC__
        __attribute__((__format__(printf,5,6)))
#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,
                  const char *format, ...)
#ifdef __GNUC__
__attribute__((__format__(printf,4,5)))
#endif
;

/*
 * 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__)

/*
 * GP_LOG_D/E:
 * simple helper macros for convenient and consistent logging of error
 * and debug messages including information about the source location.
 */
#define GP_LOG_D(...) gp_log(GP_LOG_DEBUG, __func__, __VA_ARGS__)
#define GP_LOG_E(...) gp_log_with_source_location(GP_LOG_ERROR, __FILE__, __LINE__, __func__, __VA_ARGS__)
#define GP_LOG_DATA(DATA, SIZE, MSG, ...) gp_log_data(__func__, DATA, SIZE, MSG, ##__VA_ARGS__)

#elif defined(__GNUC__) &&  __GNUC__ >= 2
#define GP_DEBUG(msg, params...) \
        gp_log(GP_LOG_DEBUG, GP_MODULE "/" __FILE__, msg, ##params)
/*
 * GP_LOG_D/E:
 * simple helper macros for convenient and consistent logging of error
 * and debug messages including information about the source location.
 */
#define GP_LOG_D(...) gp_log(GP_LOG_DEBUG, __func__, __VA_ARGS__)
#define GP_LOG_E(...) gp_log_with_source_location(GP_LOG_ERROR, __FILE__, __LINE__, __func__, __VA_ARGS__)
#define GP_LOG_DATA(DATA, SIZE, MSG, ...) gp_log_data(__func__, DATA, SIZE, MSG, ##__VA_ARGS__)

#else
# ifdef __GNUC__
#  warning Disabling GP_DEBUG because variadic macros are not allowed
# endif
#define GP_DEBUG (void) 
#define GP_LOG_D(...) /* no-op */
#define GP_LOG_E(...) /* no-op */
#define GP_LOG_DATA(DATA, SIZE, ...) /* no-op */
#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_log_with_source_location(level, file, line, func, format, ...)
#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 */
#define GP_LOG_D(...) /* no-op */
#define GP_LOG_E(...) /* no-op */
#define GP_LOG_DATA(DATA, SIZE, ...) /* no-op */

#elif defined(__GNUC__)
#define GP_DEBUG(msg, params...) /* no-op */
#define GP_LOG_D(...) /* no-op */
#define GP_LOG_E(...) /* no-op */
#define GP_LOG_DATA(DATA, SIZE, ...) /* no-op */
#else
#define GP_DEBUG (void)
#define GP_LOG_D (void /* no-op */
#define GP_LOG_E (void) /* no-op */
#define GP_LOG_DATA(void) /* no-op */
#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);

  /* Allocates a sufficiently large buffer and interpolates the format
   * string with the proveded va_list args. The returned memory has to
   * be freed by the caller. */
  char*
  gpi_vsnprintf (const char* format, va_list args);

#define C_MEM(MEM) do {\
        if ((MEM) == NULL) {\
                GP_LOG_E ("Out of memory: '%s' failed.", #MEM);\
                return GP_ERROR_NO_MEMORY;\
        }\
} while(0)

#define C_PARAMS(PARAMS) do {\
        if (!(PARAMS)) {\
                GP_LOG_E ("Invalid parameters: '%s' is NULL/FALSE.", #PARAMS);\
                return GP_ERROR_BAD_PARAMETERS;\
        }\
} while(0)

#define C_PARAMS_MSG(PARAMS, MSG, ...) do {\
        if (!(PARAMS)) {\
                GP_LOG_E ("Invalid parameters: " #MSG " ('%s' is NULL/FALSE.)", ##__VA_ARGS__, #PARAMS);\
                return GP_ERROR_BAD_PARAMETERS;\
        }\
} while(0)

#endif /* _GPHOTO2_INTERNAL_CODE */

#endif /* __GPHOTO2_PORT_LOG_H__ */