1 /*
2  * Copyright 2017 Google
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21  * IN THE SOFTWARE.
22  */
23 
24 #ifndef MESA_LOG_H
25 #define MESA_LOG_H
26 
27 #include <stdarg.h>
28 
29 #include "util/macros.h"
30 
31 #ifdef __cplusplus
32 extern "C" {
33 #endif
34 
35 #ifndef MESA_LOG_TAG
36 #define MESA_LOG_TAG "MESA"
37 #endif
38 
39 enum mesa_log_level {
40    MESA_LOG_ERROR,
41    MESA_LOG_WARN,
42    MESA_LOG_INFO,
43    MESA_LOG_DEBUG,
44 };
45 
46 void PRINTFLIKE(3, 4)
47 mesa_log(enum mesa_log_level, const char *tag, const char *format, ...);
48 
49 void
50 mesa_log_v(enum mesa_log_level, const char *tag, const char *format,
51             va_list va);
52 
53 #define mesa_loge(fmt, ...) mesa_log(MESA_LOG_ERROR, (MESA_LOG_TAG), (fmt), ##__VA_ARGS__)
54 #define mesa_logw(fmt, ...) mesa_log(MESA_LOG_WARN, (MESA_LOG_TAG), (fmt), ##__VA_ARGS__)
55 #define mesa_logi(fmt, ...) mesa_log(MESA_LOG_INFO, (MESA_LOG_TAG), (fmt), ##__VA_ARGS__)
56 #ifdef DEBUG
57 #define mesa_logd(fmt, ...) mesa_log(MESA_LOG_DEBUG, (MESA_LOG_TAG), (fmt), ##__VA_ARGS__)
58 #else
59 #define mesa_logd(fmt, ...) __mesa_log_use_args((fmt), ##__VA_ARGS__)
60 #endif
61 
62 #define mesa_loge_v(fmt, va) mesa_log_v(MESA_LOG_ERROR, (MESA_LOG_TAG), (fmt), (va))
63 #define mesa_logw_v(fmt, va) mesa_log_v(MESA_LOG_WARN, (MESA_LOG_TAG), (fmt), (va))
64 #define mesa_logi_v(fmt, va) mesa_log_v(MESA_LOG_INFO, (MESA_LOG_TAG), (fmt), (va))
65 #ifdef DEBUG
66 #define mesa_logd_v(fmt, va) mesa_log_v(MESA_LOG_DEBUG, (MESA_LOG_TAG), (fmt), (va))
67 #else
68 #define mesa_logd_v(fmt, va) __mesa_log_use_args((fmt), (va))
69 #endif
70 
71 struct log_stream {
72    char *msg;
73    const char *tag;
74    size_t pos;
75    enum mesa_log_level level;
76 };
77 
78 struct log_stream *_mesa_log_stream_create(enum mesa_log_level level, char *tag);
79 #define mesa_log_streame() _mesa_log_stream_create(MESA_LOG_ERROR, (MESA_LOG_TAG))
80 #define mesa_log_streamw() _mesa_log_stream_create(MESA_LOG_WARN, (MESA_LOG_TAG))
81 #define mesa_log_streami() _mesa_log_stream_create(MESA_LOG_INFO, (MESA_LOG_TAG))
82 void mesa_log_stream_destroy(struct log_stream *stream);
83 void mesa_log_stream_printf(struct log_stream *stream, const char *format, ...);
84 
85 void _mesa_log_multiline(enum mesa_log_level level, const char *tag, const char *lines);
86 #define mesa_log_multiline(level, lines) _mesa_log_multiline(level, (MESA_LOG_TAG), lines)
87 
88 #ifndef DEBUG
89 /* Suppres -Wunused */
90 static inline void PRINTFLIKE(1, 2)
__mesa_log_use_args(UNUSED const char * format,...)91 __mesa_log_use_args(UNUSED const char *format, ...) { }
92 #endif
93 
94 #ifdef __cplusplus
95 }
96 #endif
97 
98 #endif /* MESA_LOG_H */
99