PipeWire  0.3.67
src/pipewire/log.h
Go to the documentation of this file.
1 /* PipeWire */
2 /* SPDX-FileCopyrightText: Copyright © 2018 Wim Taymans */
3 /* SPDX-License-Identifier: MIT */
4 
5 #ifndef PIPEWIRE_LOG_H
6 #define PIPEWIRE_LOG_H
7 
8 #include <spa/support/log.h>
9 
10 #ifdef __cplusplus
11 extern "C" {
12 #endif
13 
28 extern enum spa_log_level pw_log_level;
29 
30 extern struct spa_log_topic *PW_LOG_TOPIC_DEFAULT;
31 
35 void pw_log_set(struct spa_log *log);
36 
38 struct spa_log *pw_log_get(void);
39 
42 
44 void
46  const struct spa_log_topic *topic,
47  const char *file,
48  int line, const char *func,
49  const char *fmt, ...) SPA_PRINTF_FUNC(6, 7);
50 
52 void
54  const struct spa_log_topic *topic,
55  const char *file,
56  int line, const char *func,
57  const char *fmt, va_list args) SPA_PRINTF_FUNC(6, 0);
58 
59 
60 
62 void
64  const char *file,
65  int line, const char *func,
66  const char *fmt, ...) SPA_PRINTF_FUNC(5, 6);
67 
69 void
71  const char *file,
72  int line, const char *func,
73  const char *fmt, va_list args) SPA_PRINTF_FUNC(5, 0);
74 
83 void
84 _pw_log_topic_new(struct spa_log_topic *topic);
85 
97 #define PW_LOG_TOPIC_STATIC(var, topic) \
98  static struct spa_log_topic var##__LINE__ = SPA_LOG_TOPIC(0, topic); \
99  static struct spa_log_topic *(var) = &(var##__LINE__)
100 
105 #define PW_LOG_TOPIC_EXTERN(var) \
106  extern struct spa_log_topic *var
107 
112 #define PW_LOG_TOPIC(var, topic) \
113  struct spa_log_topic var##__LINE__ = SPA_LOG_TOPIC(0, topic); \
114  struct spa_log_topic *(var) = &(var##__LINE__)
115 
116 #define PW_LOG_TOPIC_INIT(var) \
117  spa_log_topic_init(pw_log_get(), var);
118 
120 #define pw_log_level_enabled(lev) (pw_log_level >= (lev))
121 #define pw_log_topic_enabled(lev,t) ((t) && (t)->has_custom_level ? (t)->level >= (lev) : pw_log_level_enabled((lev)))
122 
123 #define pw_logtv(lev,topic,fmt,ap) \
124 ({ \
125  if (SPA_UNLIKELY(pw_log_topic_enabled(lev,topic))) \
126  pw_log_logtv(lev,topic,__FILE__,__LINE__,__func__,fmt,ap); \
127 })
128 
129 #define pw_logt(lev,topic,...) \
130 ({ \
131  if (SPA_UNLIKELY(pw_log_topic_enabled(lev,topic))) \
132  pw_log_logt(lev,topic,__FILE__,__LINE__,__func__,__VA_ARGS__); \
133 })
134 
135 #define pw_log(lev,...) pw_logt(lev,PW_LOG_TOPIC_DEFAULT,__VA_ARGS__)
136 
137 #define pw_log_error(...) pw_log(SPA_LOG_LEVEL_ERROR,__VA_ARGS__)
138 #define pw_log_warn(...) pw_log(SPA_LOG_LEVEL_WARN,__VA_ARGS__)
139 #define pw_log_info(...) pw_log(SPA_LOG_LEVEL_INFO,__VA_ARGS__)
140 #define pw_log_debug(...) pw_log(SPA_LOG_LEVEL_DEBUG,__VA_ARGS__)
141 #define pw_log_trace(...) pw_log(SPA_LOG_LEVEL_TRACE,__VA_ARGS__)
142 
143 #define pw_logt_error(t,...) pw_logt(SPA_LOG_LEVEL_ERROR,t,__VA_ARGS__)
144 #define pw_logt_warn(t,...) pw_logt(SPA_LOG_LEVEL_WARN,t,__VA_ARGS__)
145 #define pw_logt_info(t,...) pw_logt(SPA_LOG_LEVEL_INFO,t,__VA_ARGS__)
146 #define pw_logt_debug(t,...) pw_logt(SPA_LOG_LEVEL_DEBUG,t,__VA_ARGS__)
147 #define pw_logt_trace(t,...) pw_logt(SPA_LOG_LEVEL_TRACE,t,__VA_ARGS__)
148 
149 #ifndef FASTPATH
150 #define pw_log_trace_fp(...) pw_log(SPA_LOG_LEVEL_TRACE,__VA_ARGS__)
151 #else
152 #define pw_log_trace_fp(...)
153 #endif
154 
159 #ifdef __cplusplus
160 }
161 #endif
162 #endif /* PIPEWIRE_LOG_H */
void void pw_log_logtv(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) 1(6
Log a message for a topic.
void pw_log_set(struct spa_log *log)
Configure a logging module.
Definition: log.c:64
void void void void pw_log_logv(enum spa_log_level level, const char *file, int line, const char *func, const char *fmt, va_list args) 1(5
Log a message for the default topic.
struct spa_log * pw_log_get(void)
Get the log interface.
Definition: log.c:79
void pw_log_set_level(enum spa_log_level level)
Configure the logging level.
Definition: log.c:88
struct spa_log_topic * PW_LOG_TOPIC_DEFAULT
Definition: log.c:29
enum spa_log_level pw_log_level
The global log level.
Definition: log.c:24
void pw_log_logt(enum spa_log_level level, const struct spa_log_topic *topic, const char *file, int line, const char *func, const char *fmt,...) 1(6
Log a message for a topic.
void void void pw_log_log(enum spa_log_level level, const char *file, int line, const char *func, const char *fmt,...) 1(5
Log a message for the default topic.
void void void void void _pw_log_topic_new(struct spa_log_topic *topic)
Initialize the log topic.
Definition: log.c:238
spa_log_level
Definition: spa/include/spa/support/log.h:45
#define SPA_PRINTF_FUNC(fmt, arg1)
Definition: defs.h:273
spa/support/log.h
Identifier for a topic.
Definition: spa/include/spa/support/log.h:83
Definition: spa/include/spa/support/log.h:61
enum spa_log_level level
Logging level, everything above this level is not logged.
Definition: spa/include/spa/support/log.h:70