json: Add guard in create_keylist_patterns
[gpgme.git] / src / debug.h
index 29c5a32..6bde998 100644 (file)
@@ -1,18 +1,18 @@
 /* debug.h - interface to debugging functions
    Copyright (C) 2002, 2004, 2005, 2007 g10 Code GmbH
+
    This file is part of GPGME.
 
    GPGME is free software; you can redistribute it and/or modify it
    under the terms of the GNU Lesser General Public License as
    published by the Free Software Foundation; either version 2.1 of
    the License, or (at your option) any later version.
-   
+
    GPGME is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.
-   
+
    You should have received a copy of the GNU Lesser General Public
    License along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
@@ -26,6 +26,9 @@
 #include <stdint.h>
 #endif
 
+#include "gpgme.h"  /* Required for gpgme_error stuff.  */
+
+
 /* Indirect stringification, requires __STDC__ to work.  */
 #define STRINGIFY(v) #v
 #define XSTRINGIFY(v) STRINGIFY(v)
@@ -54,11 +57,14 @@ _gpgme_debug_srcname (const char *file)
   return s? s+1:file;
 }
 
+/* Initialization helper function; see debug.c.  */
+int _gpgme_debug_set_debug_envvar (const char *value);
+
 /* Called early to initialize the logging.  */
 void _gpgme_debug_subsystem_init (void);
 
 /* Log the formatted string FORMAT at debug level LEVEL or higher.  */
-void _gpgme_debug (int level, const char *format, ...);
+int  _gpgme_debug (int level, const char *format, ...);
 
 /* Start a new debug line in *LINE, logged at level LEVEL or higher,
    and starting with the formatted string FORMAT.  */
@@ -76,8 +82,15 @@ void _gpgme_debug_buffer (int lvl, const char *const fmt,
                          size_t len);
 
 void _gpgme_debug_frame_begin (void);
-void _gpgme_debug_frame_end (void);
+int  _gpgme_debug_frame_end (void);
 
+static inline gpgme_error_t
+_gpgme_trace_gpgme_error (gpgme_error_t err, const char *file, int line)
+{
+  _gpgme_debug (DEBUG_ENGINE, "%s:%d: returning error: %s\n",
+                _gpgme_debug_srcname (file), line, gpgme_strerror (err));
+  return err;
+}
 
 \f
 /* Trace support.  */
@@ -95,87 +108,85 @@ void _gpgme_debug_frame_end (void);
 #define TRACE_BEG(lvl, name, tag)                         \
   _TRACE (lvl, name, tag);                                \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p\n", \
-               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag), 0
+               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag)
 #define TRACE_BEG0(lvl, name, tag, fmt)                                        \
   _TRACE (lvl, name, tag);                                             \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n",     \
-               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag), 0
+               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag)
 #define TRACE_BEG1(lvl, name, tag, fmt, arg1)                          \
   _TRACE (lvl, name, tag);                                             \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n",     \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1), 0
+               arg1)
 #define TRACE_BEG2(lvl, name, tag, fmt, arg1, arg2)                \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2), 0
+               arg1, arg2)
 #define TRACE_BEG3(lvl, name, tag, fmt, arg1, arg2, arg3)          \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3), 0
+               arg1, arg2, arg3)
 #define TRACE_BEG4(lvl, name, tag, fmt, arg1, arg2, arg3, arg4)            \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4), 0
+               arg1, arg2, arg3, arg4)
 #define TRACE_BEG5(lvl, name, tag, fmt, arg1, arg2, arg3, arg4, arg5) \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4, arg5), 0
+               arg1, arg2, arg3, arg4, arg5)
 #define TRACE_BEG7(lvl, name, tag, fmt, arg1, arg2, arg3, arg4,            \
                   arg5, arg6, arg7)                                \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4, arg5,       \
-               arg6, arg7), 0
+               arg1, arg2, arg3, arg4, arg5, arg6, arg7)
 #define TRACE_BEG8(lvl, name, tag, fmt, arg1, arg2, arg3, arg4,            \
                   arg5, arg6, arg7, arg8)                          \
   _TRACE (lvl, name, tag);                                         \
   _gpgme_debug (_gpgme_trace_level, "%s: enter: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4, arg5,       \
-               arg6, arg7, arg8), 0
+               arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)
 
 #define TRACE(lvl, name, tag)                                          \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p\n",                              \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag),       \
-  _gpgme_debug_frame_end (), 0
+  _gpgme_debug_frame_end ()
 #define TRACE0(lvl, name, tag, fmt)                                    \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p, " fmt "\n",                     \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag),       \
-  _gpgme_debug_frame_end (), 0
+  _gpgme_debug_frame_end ()
 #define TRACE1(lvl, name, tag, fmt, arg1)                             \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p, " fmt "\n",                    \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag, arg1), \
-  _gpgme_debug_frame_end (), 0
+  _gpgme_debug_frame_end ()
 #define TRACE2(lvl, name, tag, fmt, arg1, arg2)                               \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p, " fmt "\n",                    \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag, arg1, \
-               arg2), _gpgme_debug_frame_end (), 0
+               arg2), _gpgme_debug_frame_end ()
 #define TRACE3(lvl, name, tag, fmt, arg1, arg2, arg3)                 \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p, " fmt "\n",                    \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag, arg1, \
-               arg2, arg3), _gpgme_debug_frame_end (), 0
+               arg2, arg3), _gpgme_debug_frame_end ()
 #define TRACE6(lvl, name, tag, fmt, arg1, arg2, arg3, arg4, arg5, arg6)        \
   _gpgme_debug_frame_begin (),                                         \
   _gpgme_debug (lvl, "%s: call: %s=%p, " fmt "\n",                     \
                name, STRINGIFY (tag), (void *) (uintptr_t) tag, arg1, \
                arg2, arg3, arg4, arg5, arg6),                         \
-  _gpgme_debug_frame_end (), 0
+  _gpgme_debug_frame_end ()
 
 #define TRACE_ERR(err)                                                 \
   err == 0 ? (TRACE_SUC ()) :                                          \
-    (_gpgme_debug (_gpgme_trace_level, "%s: error: %s <%s>\n",         \
-                  _gpgme_trace_func, gpgme_strerror (err),             \
+    (_gpgme_debug (_gpgme_trace_level, "%s:%d: error: %s <%s>\n",      \
+                  _gpgme_trace_func, __LINE__,  gpgme_strerror (err),  \
                   gpgme_strsource (err)), _gpgme_debug_frame_end (), (err))
 /* The cast to void suppresses GCC warnings.  */
 #define TRACE_SYSRES(res)                                              \
@@ -190,49 +201,52 @@ void _gpgme_debug_frame_end (void);
 
 #define TRACE_SUC()                                             \
   _gpgme_debug (_gpgme_trace_level, "%s: leave\n",       \
-               _gpgme_trace_func), _gpgme_debug_frame_end (), 0
+               _gpgme_trace_func), _gpgme_debug_frame_end ()
 #define TRACE_SUC0(fmt)                                                        \
   _gpgme_debug (_gpgme_trace_level, "%s: leave: " fmt "\n",    \
-               _gpgme_trace_func), _gpgme_debug_frame_end (), 0
+               _gpgme_trace_func), _gpgme_debug_frame_end ()
 #define TRACE_SUC1(fmt, arg1)                                          \
   _gpgme_debug (_gpgme_trace_level, "%s: leave: " fmt "\n",    \
-               _gpgme_trace_func, arg1), _gpgme_debug_frame_end (), 0
+               _gpgme_trace_func, arg1), _gpgme_debug_frame_end ()
 #define TRACE_SUC2(fmt, arg1, arg2)                                    \
   _gpgme_debug (_gpgme_trace_level, "%s: leave: " fmt "\n",    \
-               _gpgme_trace_func, arg1, arg2), _gpgme_debug_frame_end (), 0
+               _gpgme_trace_func, arg1, arg2), _gpgme_debug_frame_end ()
 #define TRACE_SUC5(fmt, arg1, arg2, arg3, arg4, arg5)                  \
   _gpgme_debug (_gpgme_trace_level, "%s: leave: " fmt "\n",    \
                _gpgme_trace_func, arg1, arg2, arg3, arg4, arg5), \
-    _gpgme_debug_frame_end (), 0
+    _gpgme_debug_frame_end ()
+#define TRACE_SUC6(fmt, arg1, arg2, arg3, arg4, arg5, arg6)    \
+  _gpgme_debug (_gpgme_trace_level, "%s: leave: " fmt "\n",    \
+               _gpgme_trace_func, arg1, arg2, arg3, arg4, arg5, arg6), \
+    _gpgme_debug_frame_end ()
 
 #define TRACE_LOG(fmt)                                                 \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n",     \
-               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag), 0
+               _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag)
 #define TRACE_LOG1(fmt, arg1)                                          \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n",     \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1), 0
+               arg1)
 #define TRACE_LOG2(fmt, arg1, arg2)                                \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2), 0
+               arg1, arg2)
 #define TRACE_LOG3(fmt, arg1, arg2, arg3)                          \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3), 0
+               arg1, arg2, arg3)
 #define TRACE_LOG4(fmt, arg1, arg2, arg3, arg4)                            \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4), 0
+               arg1, arg2, arg3, arg4)
 #define TRACE_LOG5(fmt, arg1, arg2, arg3, arg4, arg5)              \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4, arg5), 0
+               arg1, arg2, arg3, arg4, arg5)
 #define TRACE_LOG6(fmt, arg1, arg2, arg3, arg4, arg5, arg6)        \
   _gpgme_debug (_gpgme_trace_level, "%s: check: %s=%p, " fmt "\n", \
                _gpgme_trace_func, _gpgme_trace_tagname, _gpgme_trace_tag, \
-               arg1, arg2, arg3, arg4, arg5,       \
-               arg6), 0
+               arg1, arg2, arg3, arg4, arg5, arg6)
 
 #define TRACE_LOGBUF(buf, len)                                 \
   _gpgme_debug_buffer (_gpgme_trace_level, "%s: check: %s",    \
@@ -241,7 +255,7 @@ void _gpgme_debug_frame_end (void);
 #define TRACE_SEQ(hlp,fmt)                                             \
   _gpgme_debug_begin (&(hlp), _gpgme_trace_level,                      \
                       "%s: check: %s=%p, " fmt, _gpgme_trace_func,     \
-                      _gpgme_trace_tagname, _gpgme_trace_tag)          
+                      _gpgme_trace_tagname, _gpgme_trace_tag)
 #define TRACE_ADD0(hlp,fmt) \
   _gpgme_debug_add (&(hlp), fmt)
 #define TRACE_ADD1(hlp,fmt,a) \
@@ -255,4 +269,11 @@ void _gpgme_debug_frame_end (void);
   _gpgme_debug_end (&(hlp))
 #define TRACE_ENABLED(hlp) (!!(hlp))
 
+/* And finally a simple macro to trace the location of an error code.
+   This macro is independent of the other trace macros and may be used
+   without any preconditions.  */
+#define trace_gpg_error(e) \
+  _gpgme_trace_gpgme_error (gpg_error (e), __FILE__, __LINE__)
+
+
 #endif /* DEBUG_H */