Mercurial > trustbridge
view common/logging.h @ 615:2a4f7364ab81
Add first simple event logging functions
author | Andre Heinecke <andre.heinecke@intevation.de> |
---|---|
date | Thu, 19 Jun 2014 11:53:07 +0200 |
parents | 5e2af38266f6 |
children | 5042ace08cba |
line wrap: on
line source
/* Copyright (C) 2014 by Bundesamt für Sicherheit in der Informationstechnik * Software engineering by Intevation GmbH * * This file is Free Software under the GNU GPL (v>=2) * and comes with ABSOLUTELY NO WARRANTY! * See LICENSE.txt for details. */ #ifndef COMMON_LOGGING_H #define COMMON_LOGGING_H #ifdef __cplusplus extern "C" { #endif /* * @file * @brief Logging and debugging functions */ #include <stdio.h> /** @def Maximum length of log messages */ #define MAX_LOG 511 /** @def The name used for logging */ #define LOG_NAME "TrustBridge" #ifdef WIN32 #include <windows.h> /** @brief Gets the localized error message for the last error * returned by GetLastError * * @returns utf8 error message that needs to be freed by the caller. **/ char *getLastErrorMsg(); #endif /** * @def DEBUGOUTPUT * @brief If defined code for extra debugging output will be generated. * * Will be defined if current build is not an RELEASE_BUILD. */ #ifndef RELEASE_BUILD #define DEBUGOUTPUT #endif /** * @def DEBUGPREFIX * @brief A string prepended to debug output. * * Should be defined to indicate which module created the output. */ #ifndef DEBUGPREFIX #define DEBUGPREFIX "" #endif /** * @def DEBUGPRINTF(fmt, ...) * @brief Debug printf * * Prints to stderr if DEBUGOUTPUT is defined. */ #ifdef DEBUGOUTPUT # ifndef WIN32 # define DEBUGPRINTF(fmt, ...) fprintf(stderr, DEBUGPREFIX "DEBUG: " fmt, ##__VA_ARGS__); # else /* WIN32 */ # define DEBUGPRINTF(fmt, ...) \ { \ char buf[512]; \ snprintf(buf, 511, "DEBUG: " fmt, ##__VA_ARGS__); \ buf[511] = '\0'; \ OutputDebugStringA(buf); \ } # endif /* WIN32 */ #else # define DEBUGPRINTF(fmt, ...) #endif /** * @def ERRORPRINTF(fmt, ...) * @brief Debug printf * * Prints an error to stderr */ #ifdef WIN32 # define ERRORPRINTF(fmt, ...) \ { \ char buf[512]; \ snprintf(buf, 511, "ERROR: " fmt, ##__VA_ARGS__); \ buf[511] = '\0'; \ OutputDebugStringA(buf); \ } #else # define ERRORPRINTF(fmt, ...) fprintf(stderr, DEBUGPREFIX "ERROR: " fmt, ##__VA_ARGS__); #endif /** * @def PRINTLASTERROR(msg) * @brief Prints the last windows error with a custom message * * Prints an error to stderr */ #define PRINTLASTERROR(msg) \ char *my_error = getLastErrorMsg(); \ if (my_error) { \ ERRORPRINTF(msg" : %s\n", my_error); \ free (my_error); \ } \ ERRORPRINTF ("Failed to get error information\n"); /** * @brief log an informational message into the syslog / event log * * The message length is limited to MAX_LOG characters. Log messages * are expected to be in UTF-8 encoding. * * Function paramters are the same as for the printf familiy. */ void syslog_info_printf(const char *format, ...); /** * @brief log an error message into the syslog / event log * * The message length is limited to MAX_LOG characters. Log messages * are expected to be in UTF-8 encoding. * * Function paramters are the same as for the printf familiy. */ void syslog_error_printf(const char *format, ...); #ifdef __cplusplus } #endif #endif /* COMMON_LOGGING_H */