PipeWire  1.3.83
log.h
Go to the documentation of this file.
1 /* Simple Plugin API */
2 /* SPDX-FileCopyrightText: Copyright © 2022 Wim Taymans */
3 /* SPDX-License-Identifier: MIT */
4 
5 #ifndef SPA_DEBUG_LOG_H
6 #define SPA_DEBUG_LOG_H
7 
8 #ifdef __cplusplus
9 extern "C" {
10 #endif
11 
12 #include <stdio.h>
13 #include <stdarg.h>
14 
15 #include <spa/utils/defs.h>
16 #include <spa/support/log.h>
17 #include <spa/debug/context.h>
18 #include <spa/debug/dict.h>
19 #include <spa/debug/format.h>
20 #include <spa/debug/mem.h>
21 #include <spa/debug/pod.h>
22 
23 #ifndef SPA_API_DEBUG_LOG
24  #ifdef SPA_API_IMPL
25  #define SPA_API_DEBUG_LOG SPA_API_IMPL
26  #else
27  #define SPA_API_DEBUG_LOG static inline
28  #endif
29 #endif
30 
36 struct spa_debug_log_ctx {
37  struct spa_debug_context ctx;
38  struct spa_log *log;
39  enum spa_log_level level;
40  const struct spa_log_topic *topic;
41  const char *file;
42  int line;
43  const char *func;
44 };
45 
46 SPA_PRINTF_FUNC(2,3)
47 SPA_API_DEBUG_LOG void spa_debug_log_log(struct spa_debug_context *ctx, const char *fmt, ...)
48 {
50  va_list args;
51  va_start(args, fmt);
52  spa_log_logtv(c->log, c->level, c->topic, c->file, c->line, c->func, fmt, args);
53  va_end(args);
54 }
55 
56 #define SPA_LOGF_DEBUG_INIT(_l,_lev,_t,_file,_line,_func) \
57  (struct spa_debug_log_ctx){ { spa_debug_log_log }, _l, _lev, _t, \
58  _file, _line, _func }
59 
60 #define SPA_LOGT_DEBUG_INIT(_l,_lev,_t) \
61  SPA_LOGF_DEBUG_INIT(_l,_lev,_t,__FILE__,__LINE__,__func__)
62 
63 #define SPA_LOG_DEBUG_INIT(l,lev) \
64  SPA_LOGT_DEBUG_INIT(l,lev,SPA_LOG_TOPIC_DEFAULT)
65 
66 #define spa_debug_log_pod(l,lev,indent,info,pod) \
67 ({ \
68  struct spa_debug_log_ctx c = SPA_LOG_DEBUG_INIT(l,lev); \
69  if (SPA_UNLIKELY(spa_log_level_topic_enabled(c.log, c.topic, c.level))) \
70  spa_debugc_pod(&c.ctx, indent, info, pod); \
71 })
72 
73 #define spa_debug_log_format(l,lev,indent,info,format) \
74 ({ \
75  struct spa_debug_log_ctx c = SPA_LOG_DEBUG_INIT(l,lev); \
76  if (SPA_UNLIKELY(spa_log_level_topic_enabled(c.log, c.topic, c.level))) \
77  spa_debugc_format(&c.ctx, indent, info, format); \
78 })
79 
80 #define spa_debug_log_mem(l,lev,indent,data,len) \
81 ({ \
82  struct spa_debug_log_ctx c = SPA_LOG_DEBUG_INIT(l,lev); \
83  if (SPA_UNLIKELY(spa_log_level_topic_enabled(c.log, c.topic, c.level))) \
84  spa_debugc_mem(&c.ctx, indent, data, len); \
85 })
86 
87 #define spa_debug_log_dict(l,lev,indent,dict) \
88 ({ \
89  struct spa_debug_log_ctx c = SPA_LOG_DEBUG_INIT(l,lev); \
90  if (SPA_UNLIKELY(spa_log_level_topic_enabled(c.log, c.topic, c.level))) \
91  spa_debugc_dict(&c.ctx, indent, dict); \
92 })
93 
94 #define spa_debug_log_error_location(l,lev,loc,fmt,...) \
95 ({ \
96  struct spa_debug_log_ctx c = SPA_LOG_DEBUG_INIT(l,lev); \
97  if (SPA_UNLIKELY(spa_log_level_topic_enabled(c.log, c.topic, c.level))) { \
98  if (fmt) spa_debugc(&c.ctx, fmt, __VA_ARGS__); \
99  spa_debugc_error_location(&c.ctx, loc); \
100  } \
101 })
102 
107 #ifdef __cplusplus
108 } /* extern "C" */
109 #endif
110 
111 #endif /* SPA_DEBUG_LOG_H */
spa/debug/dict.h
spa/debug/format.h
spa/debug/pod.h
spa/utils/defs.h
uint32_t int int const char va_list args
Definition: core.h:434
va_end(args)
va_start(args, message)
SPA_API_DEBUG_LOG void spa_debug_log_log(struct spa_debug_context *ctx, const char *fmt,...)
Definition: log.h:54
spa_log_level
Definition: log.h:55
SPA_API_LOG void spa_log_logtv(struct spa_log *l, enum spa_log_level level, const struct spa_log_topic *topic, const char *file, int line, const char *func, const char *fmt, va_list args)
Definition: log.h:281
#define SPA_CONTAINER_OF(p, t, m)
Definition: defs.h:235
#define SPA_PRINTF_FUNC(fmt, arg1)
Definition: defs.h:295
spa/debug/context.h
#define SPA_API_DEBUG_LOG
Definition: log.h:34
spa/debug/mem.h
spa/support/log.h
Definition: context.h:45
Definition: log.h:43
const char * func
Definition: log.h:50
int line
Definition: log.h:49
struct spa_log * log
Definition: log.h:45
enum spa_log_level level
Definition: log.h:46
struct spa_debug_context ctx
Definition: log.h:44
const char * file
Definition: log.h:48
const struct spa_log_topic * topic
Definition: log.h:47
Identifier for a topic.
Definition: log.h:93
Definition: log.h:71