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