7 This file is part of PulseAudio.
9 Copyright 2004-2006 Lennart Poettering
10 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
12 PulseAudio is free software; you can redistribute it and/or modify
13 it under the terms of the GNU Lesser General Public License as published
14 by the Free Software Foundation; either version 2 of the License,
15 or (at your option) any later version.
17 PulseAudio is distributed in the hope that it will be useful, but
18 WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 General Public License for more details.
22 You should have received a copy of the GNU Lesser General Public License
23 along with PulseAudio; if not, write to the Free Software
24 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
30 #include <pulsecore/gccmacro.h>
32 /* A simple logging subsystem */
35 typedef enum pa_log_target {
36 PA_LOG_STDERR, /* default */
38 PA_LOG_USER, /* to user specified function */
39 PA_LOG_NULL /* to /dev/null */
42 typedef enum pa_log_level {
43 PA_LOG_ERROR = 0, /* Error messages */
44 PA_LOG_WARN = 1, /* Warning messages */
45 PA_LOG_NOTICE = 2, /* Notice messages */
46 PA_LOG_INFO = 3, /* Info messages */
47 PA_LOG_DEBUG = 4, /* debug message */
51 /* Set an identification for the current daemon. Used when logging to syslog. */
52 void pa_log_set_ident(const char *p);
54 /* Set another log target. If t is PA_LOG_USER you may specify a function that is called every log string */
55 void pa_log_set_target(pa_log_target_t t, void (*func)(pa_log_level_t t, const char*s));
57 /* Minimal log level */
58 void pa_log_set_maximal_level(pa_log_level_t l);
60 void pa_log_level_meta(
65 const char *format, ...) PA_GCC_PRINTF_ATTR(5,6);
66 void pa_log_levelv_meta(
74 void pa_log_level(pa_log_level_t level, const char *format, ...) PA_GCC_PRINTF_ATTR(2,3);
75 void pa_log_levelv(pa_log_level_t level, const char *format, va_list ap);
77 #if __STDC_VERSION__ >= 199901L
79 /* ISO varargs available */
81 #define pa_log_debug(...) pa_log_level_meta(PA_LOG_DEBUG, __FILE__, __LINE__, __func__, __VA_ARGS__)
82 #define pa_log_info(...) pa_log_level_meta(PA_LOG_INFO, __FILE__, __LINE__, __func__, __VA_ARGS__)
83 #define pa_log_notice(...) pa_log_level_meta(PA_LOG_NOTICE, __FILE__, __LINE__, __func__, __VA_ARGS__)
84 #define pa_log_warn(...) pa_log_level_meta(PA_LOG_WARN, __FILE__, __LINE__, __func__, __VA_ARGS__)
85 #define pa_log_error(...) pa_log_level_meta(PA_LOG_ERROR, __FILE__, __LINE__, __func__, __VA_ARGS__)
89 #define LOG_FUNC(suffix, level) \
90 PA_GCC_UNUSED static void pa_log_##suffix(const char *format, ...) { \
92 va_start(ap, format); \
93 pa_log_levelv_meta(level, NULL, 0, NULL, format, ap); \
97 LOG_FUNC(debug, PA_LOG_DEBUG)
98 LOG_FUNC(info, PA_LOG_INFO)
99 LOG_FUNC(notice, PA_LOG_NOTICE)
100 LOG_FUNC(warn, PA_LOG_WARN)
101 LOG_FUNC(error, PA_LOG_ERROR)
105 #define pa_log pa_log_error