3 /* log - a generic logging facility in the spirit of log4j */
5 /* Authors: Martin Quinson */
6 /* Copyright (C) 2003, 2004 Martin Quinson. */
8 /* This program is free software; you can redistribute it and/or modify it
9 under the terms of the license (GNU LGPL) which comes with this package. */
11 /* GRAS_LOG_MAYDAY: define this to replace the logging facilities with basic
12 printf function. Useful to debug the logging facilities themselves */
13 #undef GRAS_LOG_MAYDAY
14 //#define GRAS_LOG_MAYDAY
23 * gras_log_priority_t:
24 * @gras_log_priority_none: used internally (don't poke with)
25 * @gras_log_priority_debug: crufty output
26 * @gras_log_priority_verbose: verbose output for the user wanting more
27 * @gras_log_priority_info: output about the regular functionning
28 * @gras_log_priority_warning: minor issue encountered
29 * @gras_log_priority_error: issue encountered
30 * @gras_log_priority_critical: major issue encountered
31 * @gras_log_priority_infinite: value for GRAS_LOG_STATIC_THRESHOLD to not log
32 * @gras_log_priority_uninitialized: used internally (don't poke with)
34 * The different existing priorities.
37 gras_log_priority_none = 0,
38 gras_log_priority_debug = 1,
39 gras_log_priority_verbose = 2,
40 gras_log_priority_info = 3,
41 gras_log_priority_warning = 4,
42 gras_log_priority_error = 5,
43 gras_log_priority_critical = 6,
45 gras_log_priority_infinite = 7,
47 gras_log_priority_uninitialized = -1
48 } gras_log_priority_t;
52 * GRAS_LOG_STATIC_THRESHOLD:
54 * All logging with priority < GRAS_LOG_STATIC_THRESHOLD is disabled at
55 * compile time, i.e., compiled out.
57 #ifndef GRAS_LOG_STATIC_THRESHOLD
58 # define GRAS_LOG_STATIC_THRESHOLD gras_log_priority_none
62 /* Transforms a category name to a global variable name. */
63 #define _GRAS_LOGV(cat) _GRAS_LOG_CONCAT(_gras_this_log_category_does_not_exist__, cat)
64 #define _GRAS_LOG_CONCAT(x,y) x ## y
66 /* The root of the category hierarchy. */
67 #define GRAS_LOG_ROOT_CAT root
70 * GRAS_LOG_NEW_SUBCATEGORY:
71 * @catName: name of new category
72 * @parent: father of the new category in the tree
74 * Defines a new subcategory of the parent.
76 #define GRAS_LOG_NEW_SUBCATEGORY(catName, parent) \
77 extern gras_log_category_t _GRAS_LOGV(parent); \
78 gras_log_category_t _GRAS_LOGV(catName) = { \
79 &_GRAS_LOGV(parent), 0, 0, \
80 #catName, gras_log_priority_uninitialized, 1, \
85 * GRAS_LOG_NEW_CATEGORY:
86 * @catName: name of new category
88 * Creates a new subcategory of the root category.
90 #define GRAS_LOG_NEW_CATEGORY(catName) GRAS_LOG_NEW_SUBCATEGORY(catName, GRAS_LOG_ROOT_CAT)
93 * GRAS_LOG_DEFAULT_CATEGORY:
94 * @cname: name of the cat
96 * Indicates which category is the default one.
99 #ifdef GRAS_LOG_MAYDAY /* debuging the logs themselves */
100 # define GRAS_LOG_DEFAULT_CATEGORY(cname)
102 # define GRAS_LOG_DEFAULT_CATEGORY(cname) \
103 static gras_log_category_t* _GRAS_LOGV(default) = &_GRAS_LOGV(cname)
107 * GRAS_LOG_NEW_DEFAULT_CATEGORY:
108 * @cname: name of the cat
110 * Creates a new subcategory of the root category and makes it the default
111 * (used by macros that don't explicitly specify a category).
113 #define GRAS_LOG_NEW_DEFAULT_CATEGORY(cname) \
114 GRAS_LOG_NEW_CATEGORY(cname) \
115 GRAS_LOG_DEFAULT_CATEGORY(cname)
118 * GRAS_LOG_NEW_DEFAULT_SUBCATEGORY:
119 * @cname: name of the cat
120 * @parent: name of the parent
122 * Creates a new subcategory of the parent category and makes it the default
123 * (used by macros that don't explicitly specify a category).
125 #define GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(cname, parent) \
126 GRAS_LOG_NEW_SUBCATEGORY(cname, parent) \
127 GRAS_LOG_DEFAULT_CATEGORY(cname)
130 * GRAS_LOG_EXTERNAL_CATEGORY:
131 * @cname: name of the cat
133 * Indicates that a category you'll use in this file (to get subcategories of it,
134 * for example) really lives in another file.
137 #define GRAS_LOG_EXTERNAL_CATEGORY(cname) \
138 extern gras_log_category_t _GRAS_LOGV(cname)
140 // Functions you may call
142 extern gras_error_t gras_log_control_set(const char* cs);
144 // Forward declarations
145 typedef struct gras_log_appender_s gras_log_appender_t;
146 typedef struct gras_log_event_s gras_log_event_t;
147 typedef struct gras_log_category_s gras_log_category_t;
150 * Do NOT access any members of this structure directly.
152 struct gras_log_category_s {
153 gras_log_category_t *parent;
154 /*@null@*/ gras_log_category_t *firstChild;
155 /*@null@*/ gras_log_category_t *nextSibling;
158 int isThreshInherited;
159 /*@null@*/ gras_log_appender_t *appender;
164 struct gras_log_appender_s {
165 void (*do_append) (gras_log_appender_t* thisLogAppender,
166 gras_log_event_t* event, const char *fmt);
170 struct gras_log_event_s {
171 gras_log_category_t* cat;
172 gras_log_priority_t priority;
173 const char* fileName;
174 const char* functionName;
180 * gras_log_threshold_set:
181 * @cat: the category (not only its name, but the variable)
182 * @thresholdPriority: the priority
184 * Programatically alters a category's threshold priority (don't use).
186 extern void gras_log_threshold_set(gras_log_category_t* cat,
187 gras_log_priority_t thresholdPriority);
190 * gras_log_parent_set:
191 * @cat: the category (not only its name, but the variable)
192 * @parent: the parent cat
194 * Programatically alter a category's parent (don't use).
196 extern void gras_log_parent_set(gras_log_category_t* cat,
197 gras_log_category_t* parent);
200 * gras_log_appender_set:
201 * @cat: the category (not only its name, but the variable)
204 * Programatically sets the category's appender (don't use).
206 extern void gras_log_appender_set(gras_log_category_t* cat,
207 gras_log_appender_t* app);
209 // Functions that you shouldn't call.
210 extern void _gras_log_event_log(gras_log_event_t*ev,
214 __attribute__ ((format (printf, 2, 3)))
218 extern int _gras_log_cat_init(gras_log_priority_t priority,
219 gras_log_category_t* category);
222 extern gras_log_category_t _GRAS_LOGV(GRAS_LOG_ROOT_CAT);
223 GRAS_LOG_EXTERNAL_CATEGORY(GRAS);
224 extern gras_log_appender_t *gras_log_default_appender;
227 * GRAS_LOG_ISENABLED:
228 * @catName: name of the category
229 * @priority: minimal priority to be enabled to return true
231 * Returns true if the given priority is enabled for the category.
232 * If you have expensive expressions that are computed outside of the log
233 * command and used only within it, you should make its evaluation conditional
236 #define GRAS_LOG_ISENABLED(catName, priority) \
237 _GRAS_LOG_ISENABLEDV(_GRAS_LOGV(catName), priority)
240 * Helper function that implements GRAS_LOG_ISENABLED.
243 * First part is a compile-time constant.
244 * Call to _log_initCat only happens once.
246 #define _GRAS_LOG_ISENABLEDV(catv, priority) \
247 (priority >= GRAS_LOG_STATIC_THRESHOLD \
248 && priority >= catv.threshold \
249 && (catv.threshold != gras_log_priority_uninitialized \
250 || _gras_log_cat_init(priority, &catv)) )
254 * Some kludge macros to ease maintenance. See how they're used below.
256 * IMPLEMENTATION NOTE: To reduce the parameter passing overhead of an enabled
257 * message, the many parameters passed to the logging function are packed in a
258 * structure. Since these values will be usually be passed to at least 3
259 * functions, this is a win.
260 * It also allows adding new values (such as a timestamp) without breaking
262 * Setting the LogEvent's valist member is done inside _log_logEvent.
265 #define _GRAS_LOG_PRE(catv, priority) do { \
266 if (_GRAS_LOG_ISENABLEDV(catv, priority)) { \
267 gras_log_event_t _log_ev = \
268 {&(catv),priority,__FILE__,__FUNCTION__,__LINE__}; \
269 _gras_log_event_log(&_log_ev
271 #define _GRAS_LOG_POST \
278 #ifdef GRAS_LOG_MAYDAY
279 # define CLOG0(c, p, f) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__)
280 # define CLOG1(c, p, f,a1) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1)
281 # define CLOG2(c, p, f,a1,a2) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2)
282 # define CLOG3(c, p, f,a1,a2,a3) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3)
283 # define CLOG4(c, p, f,a1,a2,a3,a4) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4)
284 # define CLOG5(c, p, f,a1,a2,a3,a4,a5) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5)
285 # define CLOG6(c, p, f,a1,a2,a3,a4,a5,a6) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6)
286 # define CLOG7(c, p, f,a1,a2,a3,a4,a5,a6,a7) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6,a7)
287 # define CLOG8(c, p, f,a1,a2,a3,a4,a5,a6,a7,a8) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6,a7,a8)
289 # define CLOG0(c, p, f) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f _GRAS_LOG_POST
290 # define CLOG1(c, p, f,a1) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1 _GRAS_LOG_POST
291 # define CLOG2(c, p, f,a1,a2) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2 _GRAS_LOG_POST
292 # define CLOG3(c, p, f,a1,a2,a3) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3 _GRAS_LOG_POST
293 # define CLOG4(c, p, f,a1,a2,a3,a4) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3,a4 _GRAS_LOG_POST
294 # define CLOG5(c, p, f,a1,a2,a3,a4,a5) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3,a4,a5 _GRAS_LOG_POST
295 # define CLOG6(c, p, f,a1,a2,a3,a4,a5,a6) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3,a4,a5,a6 _GRAS_LOG_POST
296 # define CLOG7(c, p, f,a1,a2,a3,a4,a5,a6,a7) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3,a4,a5,a6,a7 _GRAS_LOG_POST
297 # define CLOG8(c, p, f,a1,a2,a3,a4,a5,a6,a7,a8) _GRAS_LOG_PRE(_GRAS_LOGV(c),p) ,f,a1,a2,a3,a4,a5,a6,a7,a8 _GRAS_LOG_POST
300 #define CDEBUG0(c, f) CLOG0(c, gras_log_priority_debug, f)
301 #define CDEBUG1(c, f,a1) CLOG1(c, gras_log_priority_debug, f,a1)
302 #define CDEBUG2(c, f,a1,a2) CLOG2(c, gras_log_priority_debug, f,a1,a2)
303 #define CDEBUG3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_debug, f,a1,a2,a3)
304 #define CDEBUG4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_debug, f,a1,a2,a3,a4)
305 #define CDEBUG5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_debug, f,a1,a2,a3,a4,a5)
306 #define CDEBUG6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6)
307 #define CDEBUG7(c, f,a1,a2,a3,a4,a5,a6,a7) CLOG7(c, gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6,a7)
308 #define CDEBUG8(c, f,a1,a2,a3,a4,a5,a6,a7,a8) CLOG8(c, gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6,a7,a8)
310 #define CVERB0(c, f) CLOG0(c, gras_log_priority_verbose, f)
311 #define CVERB1(c, f,a1) CLOG1(c, gras_log_priority_verbose, f,a1)
312 #define CVERB2(c, f,a1,a2) CLOG2(c, gras_log_priority_verbose, f,a1,a2)
313 #define CVERB3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_verbose, f,a1,a2,a3)
314 #define CVERB4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_verbose, f,a1,a2,a3,a4)
315 #define CVERB5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_verbose, f,a1,a2,a3,a4,a5)
316 #define CVERB6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_verbose, f,a1,a2,a3,a4,a5,a6)
318 #define CINFO0(c, f) CLOG0(c, gras_log_priority_info, f)
319 #define CINFO1(c, f,a1) CLOG1(c, gras_log_priority_info, f,a1)
320 #define CINFO2(c, f,a1,a2) CLOG2(c, gras_log_priority_info, f,a1,a2)
321 #define CINFO3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_info, f,a1,a2,a3)
322 #define CINFO4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_info, f,a1,a2,a3,a4)
323 #define CINFO5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_info, f,a1,a2,a3,a4,a5)
324 #define CINFO6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_info, f,a1,a2,a3,a4,a5,a6)
326 #define CWARN0(c, f) CLOG0(c, gras_log_priority_warning, f)
327 #define CWARN1(c, f,a1) CLOG1(c, gras_log_priority_warning, f,a1)
328 #define CWARN2(c, f,a1,a2) CLOG2(c, gras_log_priority_warning, f,a1,a2)
329 #define CWARN3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_warning, f,a1,a2,a3)
330 #define CWARN4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_warning, f,a1,a2,a3,a4)
331 #define CWARN5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_warning, f,a1,a2,a3,a4,a5)
332 #define CWARN6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_warning, f,a1,a2,a3,a4,a5,a6)
334 #define CERROR0(c, f) CLOG0(c, gras_log_priority_error, f)
335 #define CERROR1(c, f,a1) CLOG1(c, gras_log_priority_error, f,a1)
336 #define CERROR2(c, f,a1,a2) CLOG2(c, gras_log_priority_error, f,a1,a2)
337 #define CERROR3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_error, f,a1,a2,a3)
338 #define CERROR4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_error, f,a1,a2,a3,a4)
339 #define CERROR5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_error, f,a1,a2,a3,a4,a5)
340 #define CERROR6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_error, f,a1,a2,a3,a4,a5,a6)
344 * @c: the category to log into
345 * @f: the format string
346 * @a1: first argument of the format
347 * @a2: second argument of the format
348 * @a3: third argument of the format
349 * @a4: fourth argument of the format
350 * @a5: fifth argument of the format
351 * @a6: sixth argument of the format
353 * Log something to the current default category under the warning priority.
355 * The macros CCRITICAL0 ... CCRITICAL5 naturally also exist, but are not listed here
356 * for sake of clarity. They just differ in the number of arguments passed
357 * along with the format string.
360 #define CCRITICAL0(c, f) CLOG0(c, gras_log_priority_critical, f)
361 #define CCRITICAL1(c, f,a1) CLOG1(c, gras_log_priority_critical, f,a1)
362 #define CCRITICAL2(c, f,a1,a2) CLOG2(c, gras_log_priority_critical, f,a1,a2)
363 #define CCRITICAL3(c, f,a1,a2,a3) CLOG3(c, gras_log_priority_critical, f,a1,a2,a3)
364 #define CCRITICAL4(c, f,a1,a2,a3,a4) CLOG4(c, gras_log_priority_critical, f,a1,a2,a3,a4)
365 #define CCRITICAL5(c, f,a1,a2,a3,a4,a5) CLOG5(c, gras_log_priority_critical, f,a1,a2,a3,a4,a5)
366 #define CCRITICAL6(c, f,a1,a2,a3,a4,a5,a6) CLOG6(c, gras_log_priority_critical, f,a1,a2,a3,a4,a5,a6)
368 #ifdef GRAS_LOG_MAYDAY
369 # define LOG0(p, f) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__)
370 # define LOG1(p, f,a1) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1)
371 # define LOG2(p, f,a1,a2) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2)
372 # define LOG3(p, f,a1,a2,a3) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3)
373 # define LOG4(p, f,a1,a2,a3,a4) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4)
374 # define LOG5(p, f,a1,a2,a3,a4,a5) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5)
375 # define LOG6(p, f,a1,a2,a3,a4,a5,a6) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6)
376 # define LOG7(p, f,a1,a2,a3,a4,a5,a6,a7) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6,a7)
377 # define LOG8(p, f,a1,a2,a3,a4,a5,a6,a7,a8) fprintf(stderr,"%s:%d:" f "\n",__FILE__,__LINE__,a1,a2,a3,a4,a5,a6,a7,a8)
379 # define LOG0(p, f) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f _GRAS_LOG_POST
380 # define LOG1(p, f,a1) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1 _GRAS_LOG_POST
381 # define LOG2(p, f,a1,a2) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2 _GRAS_LOG_POST
382 # define LOG3(p, f,a1,a2,a3) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3 _GRAS_LOG_POST
383 # define LOG4(p, f,a1,a2,a3,a4) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3,a4 _GRAS_LOG_POST
384 # define LOG5(p, f,a1,a2,a3,a4,a5) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3,a4,a5 _GRAS_LOG_POST
385 # define LOG6(p, f,a1,a2,a3,a4,a5,a6) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3,a4,a5,a6 _GRAS_LOG_POST
386 # define LOG7(p, f,a1,a2,a3,a4,a5,a6,a7) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3,a4,a5,a6,a7 _GRAS_LOG_POST
387 # define LOG8(p, f,a1,a2,a3,a4,a5,a6,a7,a8) _GRAS_LOG_PRE((*_GRAS_LOGV(default)),p) ,f,a1,a2,a3,a4,a5,a6,a7,a8 _GRAS_LOG_POST
392 * @f: the format string
393 * @a1: first argument of the format
394 * @a2: second argument of the format
395 * @a3: third argument of the format
396 * @a4: fourth argument of the format
397 * @a5: fifth argument of the format
398 * @a6: sixth argument of the format
400 * Log something to the current default category under the debug priority.
402 * The macros DEBUG0 ... DEBUG5 naturally also exist, but are not listed here
403 * for sake of clarity. They just differ in the number of arguments passed
404 * along with the format string.
407 #define DEBUG0(f) LOG0(gras_log_priority_debug, f)
408 #define DEBUG1(f,a1) LOG1(gras_log_priority_debug, f,a1)
409 #define DEBUG2(f,a1,a2) LOG2(gras_log_priority_debug, f,a1,a2)
410 #define DEBUG3(f,a1,a2,a3) LOG3(gras_log_priority_debug, f,a1,a2,a3)
411 #define DEBUG4(f,a1,a2,a3,a4) LOG4(gras_log_priority_debug, f,a1,a2,a3,a4)
412 #define DEBUG5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_debug, f,a1,a2,a3,a4,a5)
413 #define DEBUG6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6)
414 #define DEBUG7(f,a1,a2,a3,a4,a5,a6,a7) LOG7(gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6,a7)
415 #define DEBUG8(f,a1,a2,a3,a4,a5,a6,a7,a8) LOG8(gras_log_priority_debug, f,a1,a2,a3,a4,a5,a6,a7,a8)
419 * @f: the format string
420 * @a1: first argument of the format
421 * @a2: second argument of the format
422 * @a3: third argument of the format
423 * @a4: fourth argument of the format
424 * @a5: fifth argument of the format
425 * @a6: sixth argument of the format
427 * Log something to the current default category under the verbose priority.
429 * The macros VERB0 ... VERB5 naturally also exist, but are not listed here
430 * for sake of clarity. They just differ in the number of arguments passed
431 * along with the format string.
434 #define VERB0(f) LOG0(gras_log_priority_verbose, f)
435 #define VERB1(f,a1) LOG1(gras_log_priority_verbose, f,a1)
436 #define VERB2(f,a1,a2) LOG2(gras_log_priority_verbose, f,a1,a2)
437 #define VERB3(f,a1,a2,a3) LOG3(gras_log_priority_verbose, f,a1,a2,a3)
438 #define VERB4(f,a1,a2,a3,a4) LOG4(gras_log_priority_verbose, f,a1,a2,a3,a4)
439 #define VERB5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_verbose, f,a1,a2,a3,a4,a5)
440 #define VERB6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_verbose, f,a1,a2,a3,a4,a5,a6)
444 * @f: the format string
445 * @a1: first argument of the format
446 * @a2: second argument of the format
447 * @a3: third argument of the format
448 * @a4: fourth argument of the format
449 * @a5: fifth argument of the format
450 * @a6: sixth argument of the format
452 * Log something to the current default category under the info priority.
454 * The macros INFO0 ... INFO5 naturally also exist, but are not listed here
455 * for sake of clarity. They just differ in the number of arguments passed
456 * along with the format string.
459 #define INFO0(f) LOG0(gras_log_priority_info, f)
460 #define INFO1(f,a1) LOG1(gras_log_priority_info, f,a1)
461 #define INFO2(f,a1,a2) LOG2(gras_log_priority_info, f,a1,a2)
462 #define INFO3(f,a1,a2,a3) LOG3(gras_log_priority_info, f,a1,a2,a3)
463 #define INFO4(f,a1,a2,a3,a4) LOG4(gras_log_priority_info, f,a1,a2,a3,a4)
464 #define INFO5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_info, f,a1,a2,a3,a4,a5)
465 #define INFO6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_info, f,a1,a2,a3,a4,a5,a6)
469 * @f: the format string
470 * @a1: first argument of the format
471 * @a2: second argument of the format
472 * @a3: third argument of the format
473 * @a4: fourth argument of the format
474 * @a5: fifth argument of the format
475 * @a6: sixth argument of the format
477 * Log something to the current default category under the warning priority.
479 * The macros WARN0 ... WARN5 naturally also exist, but are not listed here
480 * for sake of clarity. They just differ in the number of arguments passed
481 * along with the format string.
484 #define WARN0(f) LOG0(gras_log_priority_warning, f)
485 #define WARN1(f,a1) LOG1(gras_log_priority_warning, f,a1)
486 #define WARN2(f,a1,a2) LOG2(gras_log_priority_warning, f,a1,a2)
487 #define WARN3(f,a1,a2,a3) LOG3(gras_log_priority_warning, f,a1,a2,a3)
488 #define WARN4(f,a1,a2,a3,a4) LOG4(gras_log_priority_warning, f,a1,a2,a3,a4)
489 #define WARN5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_warning, f,a1,a2,a3,a4,a5)
490 #define WARN6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_warning, f,a1,a2,a3,a4,a5,a6)
494 * @f: the format string
495 * @a1: first argument of the format
496 * @a2: second argument of the format
497 * @a3: third argument of the format
498 * @a4: fourth argument of the format
499 * @a5: fifth argument of the format
500 * @a6: sixth argument of the format
502 * Log something to the current default category under the error priority.
504 * The macros ERROR0 ... ERROR5 naturally also exist, but are not listed here
505 * for sake of clarity. They just differ in the number of arguments passed
506 * along with the format string.
509 #define ERROR0(f) LOG0(gras_log_priority_error, f)
510 #define ERROR1(f,a1) LOG1(gras_log_priority_error, f,a1)
511 #define ERROR2(f,a1,a2) LOG2(gras_log_priority_error, f,a1,a2)
512 #define ERROR3(f,a1,a2,a3) LOG3(gras_log_priority_error, f,a1,a2,a3)
513 #define ERROR4(f,a1,a2,a3,a4) LOG4(gras_log_priority_error, f,a1,a2,a3,a4)
514 #define ERROR5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_error, f,a1,a2,a3,a4,a5)
515 #define ERROR6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_error, f,a1,a2,a3,a4,a5,a6)
519 * @f: the format string
520 * @a1: first argument of the format
521 * @a2: second argument of the format
522 * @a3: third argument of the format
523 * @a4: fourth argument of the format
524 * @a5: fifth argument of the format
525 * @a6: sixth argument of the format
527 * Log something to the current default category under the critical priority.
529 * The macros CRITICAL0 ... CRITICAL5 naturally also exist, but are not listed here
530 * for sake of clarity. They just differ in the number of arguments passed
531 * along with the format string.
533 #define CRITICAL0(f) LOG0(gras_log_priority_critical, f)
534 #define CRITICAL1(f,a1) LOG1(gras_log_priority_critical, f,a1)
535 #define CRITICAL2(f,a1,a2) LOG2(gras_log_priority_critical, f,a1,a2)
536 #define CRITICAL3(f,a1,a2,a3) LOG3(gras_log_priority_critical, f,a1,a2,a3)
537 #define CRITICAL4(f,a1,a2,a3,a4) LOG4(gras_log_priority_critical, f,a1,a2,a3,a4)
538 #define CRITICAL5(f,a1,a2,a3,a4,a5) LOG5(gras_log_priority_critical, f,a1,a2,a3,a4,a5)
539 #define CRITICAL6(f,a1,a2,a3,a4,a5,a6) LOG6(gras_log_priority_critical, f,a1,a2,a3,a4,a5,a6)
541 #define GRAS_IN DEBUG0(">> begin of function")
542 #define GRAS_OUT DEBUG0("<< end of function")
544 #endif /* ! _GRAS_LOG_H_ */