Logging

Logging — Logging Routines

Synopsis

enum                GoaLogLevel;
void                goa_log                             (GoaLogLevel level,
                                                         const gchar *function,
                                                         const gchar *location,
                                                         const gchar *format,
                                                         ...);

#define             goa_debug                           (args...)
#define             goa_info                            (args...)
#define             goa_notice                          (args...)
#define             goa_warning                         (args...)
#define             goa_error                           (args...)

Description

TODO: explain a bit more what these logging routines do - e.g. that GOA_LOG_LEVEL_NOTICE and higher goes to the syslog and so on etc. etc.

Details

enum GoaLogLevel

typedef enum
{
  GOA_LOG_LEVEL_DEBUG,
  GOA_LOG_LEVEL_INFO,
  GOA_LOG_LEVEL_NOTICE,
  GOA_LOG_LEVEL_WARNING,
  GOA_LOG_LEVEL_ERROR
} GoaLogLevel;

Logging levels.

GOA_LOG_LEVEL_DEBUG

Debug messages.

GOA_LOG_LEVEL_INFO

Informational messages.

GOA_LOG_LEVEL_NOTICE

Messages that the administrator should take notice of.

GOA_LOG_LEVEL_WARNING

Warning messages.

GOA_LOG_LEVEL_ERROR

Error messages.

goa_log ()

void                goa_log                             (GoaLogLevel level,
                                                         const gchar *function,
                                                         const gchar *location,
                                                         const gchar *format,
                                                         ...);

Low-level logging function used by goa_debug() and other macros.

level :

A GoaLogLevel.

function :

Pass G_STRFUNC here.

location :

Pass G_STRLOC here.

format :

printf()-style format.

... :

Arguments for format.

goa_debug()

#define goa_debug(args...)   goa_log(GOA_LOG_LEVEL_DEBUG, G_STRFUNC, G_STRLOC, args);

Logging macro for GOA_LOG_LEVEL_DEBUG.


goa_info()

#define goa_info(args...)    goa_log(GOA_LOG_LEVEL_INFO, G_STRFUNC, G_STRLOC, args);

Logging macro for GOA_LOG_LEVEL_INFO.


goa_notice()

#define goa_notice(args...)    goa_log(GOA_LOG_LEVEL_NOTICE, G_STRFUNC, G_STRLOC, args);

Logging macro for GOA_LOG_LEVEL_NOTICE.


goa_warning()

#define goa_warning(args...) goa_log(GOA_LOG_LEVEL_WARNING, G_STRFUNC, G_STRLOC, args);

Logging macro for GOA_LOG_LEVEL_WARNING.


goa_error()

#define goa_error(args...)   goa_log(GOA_LOG_LEVEL_ERROR, G_STRFUNC, G_STRLOC, args);

Logging macro for GOA_LOG_LEVEL_ERROR.