Adjust for changed macro names in libgpg-error master.
[gnupg.git] / common / logging.h
1 /* logging.h
2  * Copyright (C) 1999, 2000, 2001, 2004, 2006,
3  *               2010 Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
7  * GnuPG is free software; you can redistribute and/or modify this
8  * part of GnuPG under the terms of either
9  *
10  *   - the GNU Lesser General Public License as published by the Free
11  *     Software Foundation; either version 3 of the License, or (at
12  *     your option) any later version.
13  *
14  * or
15  *
16  *   - the GNU General Public License as published by the Free
17  *     Software Foundation; either version 2 of the License, or (at
18  *     your option) any later version.
19  *
20  * or both in parallel, as here.
21  *
22  * GnuPG is distributed in the hope that it will be useful, but
23  * WITHOUT ANY WARRANTY; without even the implied warranty of
24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25  * General Public License for more details.
26  *
27  * You should have received a copies of the GNU General Public License
28  * and the GNU Lesser General Public License along with this program;
29  * if not, see <https://www.gnu.org/licenses/>.
30  */
31
32 #ifndef GNUPG_COMMON_LOGGING_H
33 #define GNUPG_COMMON_LOGGING_H
34
35 #include <stdio.h>
36 #include <stdarg.h>
37 #include <gpg-error.h>
38 #include "mischelp.h"
39 #include "w32help.h"
40
41 #if defined(GPGRT_ENABLE_LOG_MACROS) && defined(log_debug_string)
42   /* We use the libgpg-error provided log functions.  but we need one
43    * more function:  */
44 # ifdef GPGRT_HAVE_MACRO_FUNCTION
45 #  define BUG() bug_at ( __FILE__, __LINE__, __FUNCTION__)
46 static inline void bug_at (const char *file, int line, const char *func)
47                            GPGRT_ATTR_NORETURN;
48 static inline void
49 bug_at (const char *file, int line, const char *func)
50 {
51   gpgrt_log (GPGRT_LOGLVL_BUG, "there is a bug at %s:%d:%s\n",
52              file, line, func);
53   abort ();
54 }
55 # else
56 #  define BUG() bug_at ( __FILE__, __LINE__)
57 static inline void bug_at (const char *file, int line)
58                            GPGRT_ATTR_NORETURN;
59 static inline void
60 bug_at (const char *file, int line)
61 {
62   gpgrt_log (GPGRT_LOGLVL_BUG, "there is a bug at %s:%d\n", file, line);
63   abort ();
64 }
65 # endif /*!GPGRT_HAVE_MACRO_FUNCTION*/
66
67
68 #else /* Use gnupg internal logging functions.  */
69
70 int  log_get_errorcount (int clear);
71 void log_inc_errorcount (void);
72 void log_set_file( const char *name );
73 void log_set_fd (int fd);
74 void log_set_socket_dir_cb (const char *(*fnc)(void));
75 void log_set_pid_suffix_cb (int (*cb)(unsigned long *r_value));
76 void log_set_prefix (const char *text, unsigned int flags);
77 const char *log_get_prefix (unsigned int *flags);
78 int log_test_fd (int fd);
79 int  log_get_fd(void);
80 estream_t log_get_stream (void);
81
82 #ifdef GPGRT_HAVE_MACRO_FUNCTION
83   void bug_at (const char *file, int line, const char *func)
84                GPGRT_ATTR_NORETURN;
85   void _log_assert (const char *expr, const char *file, int line,
86                     const char *func) GPGRT_ATTR_NORETURN;
87 # define BUG() bug_at( __FILE__ , __LINE__, __FUNCTION__)
88 # define log_assert(expr)                                       \
89   ((expr)                                                       \
90    ? (void) 0                                                   \
91    : _log_assert (#expr, __FILE__, __LINE__, __FUNCTION__))
92 #else /*!GPGRT_HAVE_MACRO_FUNCTION*/
93   void bug_at (const char *file, int line);
94   void _log_assert (const char *expr, const char *file, int line);
95 # define BUG() bug_at( __FILE__ , __LINE__ )
96 # define log_assert(expr)                                       \
97   ((expr)                                                       \
98    ? (void) 0                                                   \
99    : _log_assert (#expr, __FILE__, __LINE__))
100 #endif /*!GPGRT_HAVE_MACRO_FUNCTION*/
101
102 /* Flag values for log_set_prefix. */
103 #define GPGRT_LOG_WITH_PREFIX  1
104 #define GPGRT_LOG_WITH_TIME    2
105 #define GPGRT_LOG_WITH_PID     4
106 #define GPGRT_LOG_RUN_DETACHED 256
107 #define GPGRT_LOG_NO_REGISTRY  512
108
109 /* Log levels as used by log_log.  */
110 enum jnlib_log_levels {
111     GPGRT_LOG_BEGIN,
112     GPGRT_LOG_CONT,
113     GPGRT_LOG_INFO,
114     GPGRT_LOG_WARN,
115     GPGRT_LOG_ERROR,
116     GPGRT_LOG_FATAL,
117     GPGRT_LOG_BUG,
118     GPGRT_LOG_DEBUG
119 };
120 #define GPGRT_LOGLVL_BEGIN  GPGRT_LOG_BEGIN
121 #define GPGRT_LOGLVL_CONT   GPGRT_LOG_CONT
122 #define GPGRT_LOGLVL_INFO   GPGRT_LOG_INFO
123 #define GPGRT_LOGLVL_WARN   GPGRT_LOG_WARN
124 #define GPGRT_LOGLVL_ERROR  GPGRT_LOG_ERROR
125 #define GPGRT_LOGLVL_FATAL  GPGRT_LOG_FATAL
126 #define GPGRT_LOGLVL_BUG    GPGRT_LOG_BUG
127 #define GPGRT_LOGLVL_DEBUG  GPGRT_LOG_DEBUG
128
129 void log_log (int level, const char *fmt, ...) GPGRT_ATTR_PRINTF(2,3);
130 void log_logv (int level, const char *fmt, va_list arg_ptr);
131 void log_logv_prefix (int level, const char *prefix,
132                       const char *fmt, va_list arg_ptr);
133 void log_string (int level, const char *string);
134 void log_bug (const char *fmt, ...)    GPGRT_ATTR_NR_PRINTF(1,2);
135 void log_fatal (const char *fmt, ...)  GPGRT_ATTR_NR_PRINTF(1,2);
136 void log_error (const char *fmt, ...)  GPGRT_ATTR_PRINTF(1,2);
137 void log_info (const char *fmt, ...)   GPGRT_ATTR_PRINTF(1,2);
138 void log_debug (const char *fmt, ...)  GPGRT_ATTR_PRINTF(1,2);
139 void log_debug_string (const char *string, const char *fmt,
140                        ...) GPGRT_ATTR_PRINTF(2,3);
141 void log_printf (const char *fmt, ...) GPGRT_ATTR_PRINTF(1,2);
142 void log_flush (void);
143
144 /* Print a hexdump of BUFFER.  With TEXT passes as NULL print just the
145    raw dump, with TEXT being an empty string, print a trailing
146    linefeed, otherwise print an entire debug line with TEXT followed
147    by the hexdump and a final LF.  */
148 void log_printhex (const void *buffer, size_t length, const char *text);
149
150 void log_clock (const char *fmt, ...) GPGRT_ATTR_PRINTF(1,2);
151
152 #endif /* Use gnupg internal logging functions.  */
153 #endif /*GNUPG_COMMON_LOGGING_H*/