Add string pseudonyms for debug output
[gpgol.git] / src / debug.h
1 #ifndef DEBUG_H
2 #define DEBUG_H
3 /* debug.h - Debugging / Log helpers for GpgOL
4  * Copyright (C) 2018 by by Intevation GmbH
5  *
6  * This file is part of GpgOL.
7  *
8  * GpgOL is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public License
10  * as published by the Free Software Foundation; either version 2.1
11  * of the License, or (at your option) any later version.
12  *
13  * GpgOL is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public License
19  * along with this program; if not, see <http://www.gnu.org/licenses/>.
20  */
21
22 #ifdef HAVE_CONFIG_H
23 #include <config.h>
24 #endif
25
26 #ifdef __cplusplus
27 extern "C" {
28 #if 0
29 }
30 #endif
31 #endif
32
33 /* Bit values used for extra log file verbosity.  Value 1 is reserved
34    to enable debug menu options.
35
36    Note that the high values here are used for compatibility with
37    old howtos of how to enable debug flags. Based on the old
38    very split up logging categories.
39
40    Categories are meant to be:
41
42    DBG -> Generally useful information.
43    DBG_MEMORY -> Very verbose tracing of Releases / Allocs / Refs.
44    DBG_OOM -> Outlook Object Model events tracing.
45    DBG_DATA -> Including potentially private data and mime parser logging.
46
47    Common values are:
48    32 -> Only memory debugging.
49    544 -> OOM and Memory.
50    800 -> Full debugging.
51    */
52 #define DBG_MEMORY         (1<<5) // 32
53 #define DBG_MIME_PARSER    (1<<7) // 128 Unified as DBG_DATA
54 #define DBG_MIME_DATA      (1<<8) // 256 Unified as DBG_DATA
55 #define DBG_DATA           (DBG_MIME_PARSER | DBG_MIME_DATA)
56 #define DBG_OOM_VAL        (1<<9) // 512 Unified as DBG_OOM
57 #define DBG_OOM_EXTRA      (1<<10)// 1024 Unified as DBG_OOM
58 #define DBG_SUPERTRACE     (1<<11)// 2048 Very verbose tracing.
59 #define DBG_OOM            (DBG_OOM_VAL | DBG_OOM_EXTRA)
60
61 #define debug_oom        ((opt.enable_debug & DBG_OOM) || \
62                           (opt.enable_debug & DBG_OOM_EXTRA))
63 #define debug_oom_extra  (opt.enable_debug & DBG_OOM_EXTRA)
64 void log_debug (const char *fmt, ...) __attribute__ ((format (printf,1,2)));
65 void log_error (const char *fmt, ...) __attribute__ ((format (printf,1,2)));
66 void log_vdebug (const char *fmt, va_list a);
67 void log_debug_w32 (int w32err, const char *fmt,
68                     ...) __attribute__ ((format (printf,2,3)));
69 void log_error_w32 (int w32err, const char *fmt,
70                     ...) __attribute__ ((format (printf,2,3)));
71 void log_hexdump (const void *buf, size_t buflen, const char *fmt,
72                   ...)  __attribute__ ((format (printf,3,4)));
73
74 const char *anonstr (const char *data);
75 #define log_oom if (opt.enable_debug & DBG_OOM) log_debug
76 #define log_data if (opt.enable_debug & DBG_DATA) log_debug
77 #define log_memory if (opt.enable_debug & DBG_MEMORY) log_debug
78
79 #define gpgol_release(X) \
80 { \
81   if (X && opt.enable_debug & DBG_OOM_EXTRA) \
82     { \
83       log_debug ("%s:%s:%i: Object: %p released ref: %lu \n", \
84                  SRCNAME, __func__, __LINE__, X, X->Release()); \
85       memdbg_released (X); \
86     } \
87   else if (X) \
88     { \
89       X->Release(); \
90     } \
91 }
92
93 const char *log_srcname (const char *s);
94 #define SRCNAME log_srcname (__FILE__)
95
96 #define TRACEPOINT log_debug ("%s:%s:%d: tracepoint\n", \
97                               SRCNAME, __func__, __LINE__);
98 #define TSTART if (opt.enable_debug & DBG_SUPERTRACE) \
99                     log_debug ("%s:%s: enter\n", SRCNAME, __func__);
100 #define TRETURN(X) if (opt.enable_debug & DBG_SUPERTRACE) \
101                         log_debug ("%s:%s:%d: return\n", SRCNAME, __func__, \
102                                    __LINE__); \
103                    return X
104
105
106 const char *get_log_file (void);
107 void set_log_file (const char *name);
108
109 #ifdef _WIN64
110 #define SIZE_T_FORMAT "%I64u"
111 #else
112 # ifdef HAVE_W32_SYSTEM
113 #  define SIZE_T_FORMAT "%u"
114 # else
115 #  define SIZE_T_FORMAT "%lu"
116 # endif
117 #endif
118
119 #ifdef __cplusplus
120 }
121 #endif
122
123 #endif // DEBUG_H