Base Code merged to SPIN 2.4
[platform/upstream/connman.git] / include / log.h
1 /*
2  *
3  *  Connection Manager
4  *
5  *  Copyright (C) 2007-2013  Intel Corporation. All rights reserved.
6  *
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License version 2 as
9  *  published by the Free Software Foundation.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  */
21
22 #ifndef __CONNMAN_LOG_H
23 #define __CONNMAN_LOG_H
24
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28
29 /**
30  * SECTION:log
31  * @title: Logging premitives
32  * @short_description: Functions for logging error and debug information
33  */
34
35 void connman_info(const char *format, ...)
36                                 __attribute__((format(printf, 1, 2)));
37 void connman_warn(const char *format, ...)
38                                 __attribute__((format(printf, 1, 2)));
39 void connman_error(const char *format, ...)
40                                 __attribute__((format(printf, 1, 2)));
41 void connman_debug(const char *format, ...)
42                                 __attribute__((format(printf, 1, 2)));
43
44 #define connman_warn_once(fmt, arg...) do {             \
45         static bool printed;                            \
46         if (!printed) {                                 \
47                 connman_warn(fmt, ## arg);              \
48                 printed = true;                         \
49         }                                               \
50 } while (0)
51
52 struct connman_debug_desc {
53         const char *name;
54         const char *file;
55 #if defined TIZEN_EXT
56 #define CONNMAN_DEBUG_FLAG_DEFAULT (1)
57 #else
58 #define CONNMAN_DEBUG_FLAG_DEFAULT (0)
59 #endif
60 #define CONNMAN_DEBUG_FLAG_PRINT   (1 << 0)
61 #define CONNMAN_DEBUG_FLAG_ALIAS   (1 << 1)
62         unsigned int flags;
63 } __attribute__((aligned(8)));
64
65 #define CONNMAN_DEBUG_DEFINE(name) \
66         static struct connman_debug_desc __debug_alias_ ## name \
67         __attribute__((used, section("__debug"), aligned(8))) = { \
68                 #name, __FILE__, CONNMAN_DEBUG_FLAG_ALIAS \
69         };
70
71 /**
72  * DBG:
73  * @fmt: format string
74  * @arg...: list of arguments
75  *
76  * Simple macro around connman_debug() which also include the function
77  * name it is called in.
78  */
79 #define DBG(fmt, arg...) do { \
80         static struct connman_debug_desc __connman_debug_desc \
81         __attribute__((used, section("__debug"), aligned(8))) = { \
82                 .file = __FILE__, .flags = CONNMAN_DEBUG_FLAG_DEFAULT, \
83         }; \
84         if (__connman_debug_desc.flags & CONNMAN_DEBUG_FLAG_PRINT) \
85                 connman_debug("%s:%s() " fmt, \
86                                         __FILE__, __FUNCTION__ , ## arg); \
87 } while (0)
88
89 #ifdef __cplusplus
90 }
91 #endif
92
93 #endif /* __CONNMAN_LOG_H */